NiceLabel Automation usa i filtri per definire la struttura dei dati ricevuti dai trigger. Ogni volta che un trigger riceve dati, uno o più filtri analizzano i dati ricevuti. Questo processo estrae i valori pertinenti per la configurazione. Ciascun filtro include le regole per identificare i campi all’interno dei dati ricevuti.
Nota
Di conseguenza, il filtro fornisce un elenco di campi e i relativi valori (coppie name:value
).
Tipi di filtri
Per ulteriori informazioni, vedere le sezioni Filtro Testo strutturato, Filtro dati non strutturati, filtro XML e filtro JSON.
Struttura dati
La complessità del filtro dipende dalla struttura dei dati. I file con dati strutturati, come i file CSV o XML semplificano l'estrazione dei dati. In questo caso, i nomi di campo sono già definiti dai dati. L'estrazione delle coppie name:value
è veloce. Nel caso dei dati senza una struttura chiara, per definire le regole di estrazione è necessario un tempo maggiore. Ci si potrebbe imbattere in tali dati durante l'esportazione di documenti e rapporti dai vecchi sistemi, dalle comunicazioni intercettate tra i dispositivi e da i flussi di stampa acquisiti.
Il filtro definisce un elenco di campi che vengono estratti dai dati in entrata dopo aver eseguito il filtro.
NiceLabel Automation supporta vari tipi di dati di input che possono essere tutti analizzati da uno dei tipi di filtri supportati. Assicurarsi di scegliere il filtro corretto corrispondente al tipo di dati in entrata. Ad esempio, usare Filtro dati testo strutturato per i dati CSV in entrata, Filtro JSON per i dati JSON in entrata e Filtro XML per i dati XML in entrata. Per i dati non strutturati, usare Filtro dati non strutturati. Per ulteriori informazioni, vedere la sezione Strutture di dati.
Estrazione dei dati
Il filtro è un insieme di regole e di per se stesso non esegue alcuna estrazione. Per eseguire il filtro, eseguire l'azione Usa filtro dati. L'azione esegue le regole del filtro rispetto ai dati ed estrae i valori.
Ciascun tipo di trigger può eseguire tutte le azioni Usa filtro dati necessarie. Se si ricevono dati di input composti che non possono essere analizzati da un singolo filtro, definire più filtri ed eseguire le relative regole usando una sequenza delle azioni Usa filtro dati. Infine, usare i valori estratti da tutte le azioni sulla stessa etichetta.
Mappatura dei campi sulle variabili
Per usare i valori estratti è necessario memorizzarli nelle variabili. L’azione Usa filtro dati esegue entrambe le operazioni: estrae i valori e li salva nelle variabili. Per configurare questo processo, mappare ciascuna variabile con il rispettivo campo. Il valore del campo viene quindi salvato nella variabile mappata.
Suggerimento
È buona norma definire campi e variabili con gli stessi nomi. In questo caso, la funzionalità di mappatura automatica collega le variabili ai campi degli stessi nomi, eliminando la necessità di mappatura manuale.
La mappatura automatica è disponibile per tutti i tipi di filtri supportati. Con la mappatura automatica attivata, l'azione Usa filtro dati estrae i valori e li mappa automaticamente alle variabili con gli stessi nomi e nomi di campo. Per ulteriori informazioni, vedere la sezione Attivazione della struttura dinamica per il filtro Testo strutturato, Definizione dell'area di assegnazione per il filtro Dati non strutturati e Definizione dell'area di assegnazione per il filtri XML o JSON.
Esecuzione di azioni con dati estratti
Di solito, è opportuno eseguire azioni utilizzando i dati estratti, come Apri etichetta, Stampa etichetta o alcune delle azioni di connettività in uscita. È di fondamentale importanza nidificare le azioni nell'azione Usa filtro dati. In tal modo le azioni nidificate vengono eseguite per ciascuna estrazione di dati.
Esempio 1. Esempio
Se si dispone di un file CSV con 5 righe, anche le azioni nidificate vengono eseguite 5 volte; una per ciascuna estrazione di dati. Se le azioni non sono nidificate, vengono eseguite una sola volta e contengono solo i dati dell'ultima estrazione di dati. Per quanto riguarda l’esempio precedente, la 5a riga del file CSV verrebbe stampata tralasciando le prime quattro righe non stampate. Se si usano aree secondarie, assicurarsi di nidificare l'azione sotto il segnaposto corretto.