Dalla cella ai dati che ti servono.

Una connessione indica a CellLens quale database raggiungere. Una ricerca salvata (lookup) definisce la tabella o la query, il campo da confrontare con il valore di Excel e le colonne da mostrare. Più ricerche possono riutilizzare la stessa connessione.

Servono Windows, Excel desktop, i prerequisiti Microsoft indicati nella pagina del prodotto, accesso di rete al database e credenziali autorizzate. Chiedi all’amministratore un account con accesso in sola lettura alle tabelle o viste necessarie.

1. Scarica CellLens dalla pagina del prodotto e chiudi Excel. Se manca .NET Framework 4.8, scegli Download and install nel programma di installazione. Servono una connessione Internet e l’autorizzazione di un amministratore. Se è richiesto un riavvio, salva il lavoro, riavvia Windows e riapri il programma di installazione. Riapri Excel al termine dell’installazione di CellLens.
2. Apri la scheda CellLens della barra multifunzione e scegli Settings.
3. Prepara una cella con un codice prodotto noto. Se contiene zeri iniziali, conserva il codice come testo.

Gli esempi usano due connessioni indipendenti: Inventory demo — SQL Server e Sales demo — PostgreSQL. I database dimostrativi non sono inclusi nel componente aggiuntivo. Manteniamo i nomi dei comandi in inglese per aiutarti a riconoscerli nell’interfaccia.

1. Apri Settings → Connections e scegli Add. Usa un nome come Magazzino o Ordini clienti.
2. Apri l’editor della connessione, scegli il tipo di database e inserisci server, database e autenticazione forniti dall’amministratore.
3. Premi Test connection. Il test verifica l’accesso al server; per leggere una determinata tabella servono comunque i relativi permessi.
4. Salva la connessione e applica le impostazioni. Ripeti per la seconda sorgente.

SQL Server: usa il server o l’istanza configurati, con credenziali del database oppure autenticazione Windows. PostgreSQL: indica server, porta, database e utente; i nomi delle tabelle includono spesso uno schema come public. Sono supportate anche connessioni MySQL e Firebird.

Mantieni attiva la verifica del certificato per SQL Server e PostgreSQL. Considera attendibile un certificato solo se il server è stato verificato dall’amministratore. Le password salvate usano la protezione dell’utente Windows: ogni utente deve configurare il proprio accesso.

1. In Settings → Lookups, aggiungi una ricerca e chiamala Product & stock.
2. Scegli la connessione del magazzino e la modalità Simple.
3. Seleziona Table / view, per esempio dbo.stock_variants. Usa Refresh from database per aggiornare tabelle e colonne.
4. Imposta Match mode su Exact.
5. Sposta SKU nell’elenco di destra e contrassegnalo sotto Search on: sarà confrontato con il valore selezionato in Excel.
6. Aggiungi le colonne utili. Imposta un Result limit ragionevole, per esempio 50; sono ammessi valori da 1 a 500.
7. Conferma l’editor e applica le modifiche nelle impostazioni.

SKU è il campo di ricerca di questo esempio. Per usarne un altro, fai clic sul suo cerchio sotto Search on, salva e seleziona in Excel un valore corrispondente. Vedi come cambiare il campo di ricerca per un esempio passo passo.

Uno SKU può restituire più righe. Nella tabella dimostrativa ogni riga rappresenta una combinazione di colore, taglia e sede: otto righe sono otto record di magazzino dello stesso prodotto.

Dopo aver scelto la tabella, la connessione della ricerca viene fissata. Per un’altra sorgente crea una nuova ricerca; se lo stesso database cambia server, aggiorna la connessione.

In Columns to show, a sinistra trovi i campi disponibili nel database; a destra le colonne da mostrare.

1. Seleziona un campo a sinistra e premi ▶ per aggiungerlo. Funziona anche il doppio clic. Usa Ctrl o Maiusc per selezionare più campi.
2. Seleziona una colonna a destra e premi ◀ per rimuoverla dalla visualizzazione.
3. Usa ▲ e ▼ accanto all’elenco scelto per cambiare posizione. L’ordine dall’alto in basso diventa l’ordine da sinistra a destra nella tabella dei risultati.
4. Tieni lo SKU all’inizio, poi raggruppa descrizioni e quantità. Salva la ricerca per conservare l’ordine.

L’elenco di destra vuoto significa mostrare tutte le colonne. Per un risultato prevedibile, selezionale esplicitamente. Queste operazioni non modificano la struttura del database.

1. Fai doppio clic su una colonna nell’elenco scelto a destra.
2. Scrivi l’intestazione desiderata: per esempio, da available_qty a Disponibile.
3. Premi Invio o fai clic altrove per confermare; Esc annulla la modifica.
4. Salva la ricerca. Svuota l’intestazione personalizzata per ripristinare il nome originale.

Cambia solo il nome mostrato nel pannello: il campo letto nel database rimane lo stesso. In modalità Advanced puoi definire le intestazioni con gli alias SQL.

Search on sceglie il campo del database in cui cercare. CellLens confronta il valore della cella selezionata in Excel con quel campo. Nella schermata, il cerchio pieno accanto a SKU indica che la ricerca usa il codice prodotto.

1. Per cercare in un altro campo, individualo nell’elenco a destra, Shown in the panel. Se manca, aggiungilo dalle colonne disponibili con ▶.
2. Fai clic sul suo cerchio sotto Search on. La selezione precedente si disattiva automaticamente: la modalità Simple usa un solo campo di ricerca per lookup.
3. Salva la ricerca e applica le modifiche nelle impostazioni. In Excel, seleziona una cella contenente un valore del nuovo campo.

Esempio: seleziona warehouse (Location) sotto Search on e mantieni Exact come modalità di confronto. Una cella contenente Main showroom restituisce le righe di magazzino di quella sede, anche per prodotti diversi, fino al Result limit impostato. Se selezioni una cella con uno SKU, la ricerca continua a usare Location finché non cambi di nuovo l’impostazione. Puoi salvare ricerche separate per campi diversi.

La casella sopra le colonne disponibili restringe l’elenco dei nomi dei campi mentre configuri la ricerca. Non filtra i record restituiti. Svuotala per rivedere tutti i campi.

• Exact: cerca un codice completo. È il punto di partenza consigliato per gli SKU.
• Starts with: cerca un prefisso per ottenere più codici correlati.
• Contains: cerca una parte del valore, utile quando il codice è dentro un testo più lungo. Può restituire molte righe ed essere più lento su tabelle grandi.

Search on identifica l’unico campo confrontato con la cella. I confronti testuali dipendono anche dai tipi di dato e dalle regole del database.

Per condizioni aggiuntive come disponibilità maggiore di zero o solo ordini confermati, usa una vista preparata dall’amministratore oppure una ricerca Advanced con una condizione WHERE. La ricerca dei nomi delle colonne non è un filtro dei record.

Nell’elenco delle colonne scelte, fai clic sul contrassegno sotto Order by. Ogni clic passa da crescente → decrescente → nessun ordinamento.

1. Attiva prima Colore: il numero 1 indica l’ordinamento principale.
2. Poi Taglia: 2 ordina le righe con lo stesso colore.
3. Infine Sede: 3 distingue le righe ancora equivalenti.

Per cambiare priorità, rimuovi i contrassegni interessati e riattivali nella sequenza desiderata. Spostare una colonna con ▲ o ▼ cambia la disposizione visiva, non la priorità di ordinamento.

Per vedere prima gli ordini recenti, imposta la data in ordine decrescente. Il comando A–Z sopra i campi disponibili ordina solo quell’elenco. Se limiti i risultati, scegli un ordinamento significativo. In modalità Advanced, scrivilo nella clausola ORDER BY.

1. Seleziona una cella con uno SKU noto, per esempio TESSA74X.
2. Premi CellLens → Lookup: la ricerca attiva legge il valore e mostra i record corrispondenti.
3. Apri il menu dell’ingranaggio e scegli Product & stock o un’altra ricerca salvata.
4. Seleziona un altro SKU. Il pannello lo segue se il comportamento automatico è attivo nelle impostazioni; altrimenti premi di nuovo Lookup.
5. Usa Refresh nel menu per richiedere nuovamente i dati.

Controlla nella barra inferiore il valore cercato, il numero di record e l’indicazione database o cache. Il limite può far sì che le righe mostrate siano solo una parte delle corrispondenze.

Nella demo, giacenze e ordini provengono da database diversi. Passare da una ricerca all’altra ti permette di restare in Excel; non unisce le sorgenti in un’unica tabella.

Crea una seconda ricerca chiamata Customer orders sulla connessione delle vendite. In Simple scegli la tabella o vista degli ordini, contrassegna SKU sotto Search on e aggiungi Ordine, Cliente, Data, Quantità, Prezzo unitario e Stato. Ordina la data in senso decrescente.

Usa nomi chiari: le giacenze possono provenire da SQL Server, gli ordini da PostgreSQL. Ciascuna ricerca richiede una connessione valida e i permessi sulle proprie tabelle.

Provale entrambe con uno SKU presente nelle due sorgenti. La presenza di una giacenza non significa che esistano ordini per quel prodotto.

Usa Advanced quando la scelta di una tabella non basta. Duplica prima una ricerca funzionante per conservarne l’originale. Scegli la connessione corretta, passa alla modalità Advanced e inserisci una query nella sintassi del database selezionato.

Scrivi @value nel punto in cui serve il valore di Excel, senza virgolette. CellLens lo invia come parametro. Non sostituirlo ogni volta con uno SKU scritto nella query.

Questo esempio PostgreSQL presuppone l’esistenza della tabella e dei campi indicati. Adatta i nomi al tuo database con l’amministratore:

SELECT sku AS "SKU",
       customer_name AS "Cliente",
       order_date AS "Data ordine",
       quantity AS "Quantità",
       unit_price AS "Prezzo EUR",
       quantity * unit_price AS "Totale EUR",
       status AS "Stato"
FROM public.order_lines
WHERE sku = @value
  AND status = 'Confirmed'
ORDER BY order_date DESC, order_id DESC

• SELECT definisce colonne e ordine da sinistra a destra.
• AS assegna intestazioni leggibili.
• WHERE sku = @value cerca il codice selezionato; la seconda condizione limita i risultati agli ordini Confirmed.
• ORDER BY ordina le righe. Un secondo campo stabile distingue gli ordini con la stessa data.

SQL Server usa i propri schemi e convenzioni, per esempio dbo.order_lines e AS [Cliente]. Usa la sintassi della connessione scelta. Un JOIN combina normalmente tabelle raggiungibili da quella connessione: una ricerca non collega automaticamente SQL Server e PostgreSQL tra loro.

Mantieni le query in sola lettura e un limite ragionevole. Chiedi all’amministratore di verificare join e prestazioni su tabelle grandi. Un account database in sola lettura definisce i permessi effettivi. Salva, prova uno SKU noto e controlla righe e totali prima di usare il risultato.

Dal menu dell’ingranaggio scegli Move panel to, oppure imposta posizione e dimensioni in Settings → Panel. Il pannello in alto è adatto alle tabelle ampie; quello a destra affianca i risultati alle celle.

Trascina i bordi delle intestazioni per regolare la larghezza delle colonne. Con il clic destro su un’intestazione puoi scegliere il colore della colonna. Usa pochi colori, per esempio su SKU o Disponibile. Per salvare ordine e nomi delle colonne, modifica Columns to show nella ricerca.

Scegli Open in window per aprire un visualizzatore separato. Il foglio rimane disponibile mentre leggi.

Leggere i record con CellLens non modifica il database. Nel pannello, Write value to sheet e il doppio clic possono inserire un valore in Excel quando l’azione è abilitata nelle impostazioni.

Prima scegli la destinazione nel foglio. Controlla la cella attiva, soprattutto se contiene lo SKU usato per la ricerca, e salva il file per conservare il valore inserito. Usa un clic singolo se vuoi soltanto selezionare un risultato e leggerlo.

Nessun record trovato

Verifica SKU, Search on, Match mode, tabella e connessione. Controlla spazi, zeri iniziali e presenza del codice nella sorgente.

Compare una sola riga

La tabella potrebbe contenere una sola anagrafica per SKU. Per colori, taglie, sedi o righe d’ordine scegli una tabella che contenga davvero quei record. Controlla anche Result limit.

Manca una colonna

Svuota la ricerca dei nomi dei campi, aggiorna l’elenco dal database e verifica le colonne scelte. In Advanced controlla SELECT e gli alias.

Il test della connessione fallisce

Verifica server, rete o VPN, credenziali, certificati e permessi con l’amministratore.

La query Advanced dà errore

Controlla schemi, campi, sintassi del database e @value senza virgolette. L’account deve poter leggere tutte le tabelle o viste usate.

Dati incompleti o non aggiornati

Controlla limite, ordinamento e indicatore della cache; usa Refresh e verifica i dati alla sorgente.

Per assistenza, scrivi a hello@rigacell.com indicando versioni di CellLens ed Excel, tipo di database, messaggio d’errore e passaggi per riprodurlo. In About trovi Save diagnostics…. Prima di condividere file o schermate, controllali e rimuovi password e dati dei clienti.