Lo scopo delle funzioni consiste nel manipolare i dati che vengono assegnati agli oggetti etichetta. Le funzioni elaborano i valori dell'origine dati esistente e memorizzano il risultato nelle origini dati generati dalle funzioni.
Ciascuna funzione può essere collegata direttamente a un oggetto e usata nell'ambito di un'altra funzione.
Suggerimento
Tutte le funzioni delle etichette o delle soluzioni sono elencate in Dynamic Data Explorer e Dynamic Data Manager.
Per aggiungere una nuova funzione a un file di etichette o soluzioni, fare clic su Aggiungi nuova funzione e selezionare la funzione appropriata dall'elenco. Non appena si aggiunge una nuova funzione viene visualizzata una finestra di dialogo di configurazione, la quale consente di modificare la funzione in base alle proprie esigenze. Le opzioni di configurazione sono descritte nelle sezioni dedicate per ciascun tipo di funzione.
Desktop Designer include i seguenti tipi di funzioni:
-
Sottoinsieme: estrae una parte specifica dei dati in base alle regole specificate dall'utente.
-
Concatena: unisce due o più valori di origine dati in un unico valore.
-
Offset data: cambia la data corrente.
-
Lineare: trasforma il valore corrente usando più tipi di funzioni lineari.
-
VBScript: consente di eseguire trasformazioni di valori complessi.
-
Espressione VBScript è una versione semplificata della funzione VBScript.
-
Script Python: consente di eseguire trasformazioni di valori complessi.
-
HIBC: codifica i dati in conformità con lo standard di codici a barre dell'industria medica.
-
GS1-128: codifica i dati in conformità con lo standard di codici a barre GS-128.
-
ANSI MH10.8.2: codifica i dati in conformità con lo standard ANSI MH10.8.2-2006.
-
Sintassi di trasferimento dati per supporto ADC ad alta capacità: consente agli utenti ADC di usare un'unica utilità di mappatura, a prescindere dal supporto ADC ad alta capacità usato.
-
La funzione Leggi dal file: legge il contenuto da un file specificato e lo visualizza in un oggetto.
-
La funzione Messaggio NDEF consente di definire un formato di incapsulamento del messaggio per lo scambio di informazioni sui dati tramite un collegamento Near Field Communication (NFC).
La funzione Sottoinsieme estrae una parte specifica dei dati in base alle regole specificate dall'utente.
Il gruppo Informazioni su identifica la funzione.
Origini dati input definisce l'origine dei dati di input esistenti o aggiunti (variabile, funzione o record di database). Il valore finale (output) è estratto dal valore dell'origine dati di input selezionata.
Il gruppo Definizione offre due metodi per estrarre i dati dall'origine dati di input.
Lunghezza fissa estrae un numero fisso di caratteri dall'origine dati di input.
-
Offset: numero di caratteri da ignorare dall'inizio del valore.
-
Lunghezza: lunghezza del valore estratto.
Delimitato viene usato quando si estraggono i dati, separati dal delimitatore specificato dall'utente.
-
Delimitatore: carattere (per impostazione predefinita una virgola) che separa i campi dei valori di input.
-
Qualificatore di testo: carattere che racchiude i valori all’interno dei campi (per impostazione predefinita una virgoletta).
Suggerimento
Se si utilizza un qualificatore di testo, anche il delimitatore all'interno dei qualificatori di testo appartiene al valore dei dati. Il qualificatore del testo può essere lasciato vuoto.
-
Numero campo: il numero del campo che viene estratto dall’origine dati di input.
Esempio 36. Esempio:
Valore di input: "A", "B", "C", "D"
Delimitatore: ,
Qualificatori di testo: "
Campo numerico: 3
Valore sottoinsieme: C
La funzione Concatena: unisce due o più valori di origine dati in un unico valore.
Il gruppo Informazioni su identifica la funzione.
Il gruppo Origini dati input definisce l'origine dei dati di input esistenti o aggiunti (variabile, funzione o record di database) che saranno usati nella funzione.
Il gruppo Opzioni di output definisce il formato del valore di output.
Delimitatore rappresenta un carattere che viene inserito tra i valori concatenati. Il carattere di delimitazione può essere immesso manualmente o selezionato da una delle opzioni aggiuntive:
-
Nuova riga (CR/LF): carattere di nuova riga.
-
Inserisci carattere speciale: viene immesso un carattere speciale.
Nota
Il delimitatore è un valore opzionale. Senza aver definito un delimitatore, i valori concatenati vengono uniti in uno spazio o carattere di delimitazione.
-
Ignora valori vuoti: ignora i valori di origine dati vuoti. Questi valori sono esclusi dalla concatenazione.
Suggerimento
Questa opzione è utile se si desidera evitare delimitatori duplicati nel caso in cui appaiano valori vuoti.
Esempio 37. Esempio:
Valore origine dati 1: A, B, C, D
Valore origine dati 2: <empty>
Valore origine dati 3: E, F, G
Delimitatore: ,
Valore concatenato con e senza Ignora valori vuoti: A, B, C, D, E, F, G e A, B, C, D, E, F, G
Nota
L'opzione Ignora valori vuoti diventa attiva solo dopo aver eseguito un comando di stampa. Quando si memorizza un'etichetta in modalità di stampa Memorizza/richiama oppure quando si esporta un'etichetta, i valori vuoti non vengono ignorati. I delimitatori appaiono duplicati.
La funzione Offset data definisce il numero di giorni, mese e/o anni da aggiungere o sottrarre dalla data specificata (potrebbe essere la data corrente o qualsiasi data passata/futura).
Il gruppo Informazioni su identifica la funzione.
Origine dati input definisce l'origine dei dati di input dalla quale saranno usati i dati nella funzione.
Offset è il numero di giorni, mesi o anni da aggiungere o sottrarre dall'origine dati di input.
Il gruppo Formattazione output definisce l'output della funzione.
-
Formato di output: definisce il formato della data da usare nell'oggetto collegato.
-
Esempio: la data corrente nel Formato di output selezionato.
La funzione Lineare moltiplica o divide un valore di origine dei dati di input per un Moltiplicatore definito. Può essere aggiunto anche un valore opzionale (Aggiunta).
Il gruppo Informazioni su identifica la funzione.
Origine dati input definisce l'origine dei dati di input dalla quale saranno usati i dati nella funzione.
I valori di Parametri funzione lineare sono:
-
Modalità: tipo di funzione lineare.
-
a: moltiplicatore di funzione.
-
b: aggiunta di funzione.
Il gruppo Formattazione output definisce il formato di output della funzione.
Formato di output: è il formato di un valore modificato. altro... apre altre opzioni di formattazione:
-
Separatore decimale: carattere che segna il confine tra le parti integrali e frazionali di un numero decimale.
-
Posizioni decimali: numero di posizioni dietro il separatore decimale.
-
Usa separatore 1000: le migliaia sono separate o meno da un delimitatore.
-
Delimitatore: carattere che separa le migliaia dal resto del numerale.
-
Esempio: anteprima del valore di output formattato.
La funzione VBScript consente di leggere, scrivere e manipolare i dati che appartengono alle origini dati collegate.
Il gruppo Informazioni su identifica la funzione.
-
Tipo funzione: mostra il tipo di script selezionato.
Il gruppo VBScript consente di definire lo script.
-
Inserisci origine dati: inserisce nello script un'origine dati appena creata.
-
Verifica: convalida la sintassi dello script immessa.
-
Editor di script: apre l'editor, che rende la creazione di script più facile ed efficiente.
Nota
Il risultato dello script deve essere salvato nel "Risultato". Il valore di 'Risultato' è inserito nel nome della funzione. Tale funzione è disponibile come origine dati dinamici per l'uso futuro.
Esempio 39. Esempio:
La variabile NAME fornisce il nome e il cognome di una persona. La funzione VBScript dovrebbe scomporre i nomi e usare solo il nome come risultato della funzione.
Valore iniziale della variabile NAME: Mario Rossi
Dim Spc Spc = InStr(NAME, " ") if NAME <> "" then Result = Mid(NAME, 1, Spc-1) end if
Risultato di VBScript: Mario
Nota
Per verificare se una variabile di data è vuota, utilizzare la sintassi:
Datevariable.Value == Nessuno
Espressione VBScript è una versione online semplificata della funzione VBScript. Questa funzione Desktop Designer consente di:
-
manipolare le variabili esistenti
-
estrarre sottostringhe
-
eseguire calcoli rapidi
Espressione VBScript riduce la necessità di scrivere VBScript dedicati. Invece di scrivere un intero script, inserire un'espressione di una singola riga nel campo di modifica, convalidata al momento della stampa.
Suggerimento
Rispetto ai comandi VBScript, un comando di espressione VBScript non richiede che il valore finale sia memorizzato in Risultato.
Informazioni su
Espressione VBScript
-
Inserisci origine dati: inserisce nell'espressione un'origine dati appena creata.
-
Verifica: convalida della sintassi dello script immessa.
-
Editor: campo per la scrittura e la modifica dello script.
NiceLabel 10 fornisce un editor di script che semplifica la creazione di script Python o VBScript senza errori e in tempi brevi.
La selezione di linguaggi di script che va usata nell’editor di script differisce NiceLabel Designer Pro tra e Automation Builder:
-
InDesktop Designer, fare doppio clic sulla superficie del progetto del modulo per aprire Proprietà modulo > Impostazioni aggiuntive > Linguaggio di script del modulo.
-
InAutomation Builder, passare a Elementi di configurazione > fare clic su Modifica per aprire le proprietà del trigger > Impostazioni > Altro > Script.
Suggerimento
NiceLabel 10 usa la variante .NET di Python denominata IronPython. Funziona come un’implementazione totalmente compatibile del linguaggio di script Python, che supporta anche i metodi .NET.
La barra multifunzione dell'editor include i comandi utilizzati più di frequente, i quali sono distribuiti su più gruppi funzionali.
-
Il gruppo Appunti fornisce i comandi Taglia, Copia, Incolla e Elimina.
-
Il gruppo Annulla Ripristina consente di annullare o ripetere le azioni di modifica dello script.
-
Il gruppo File consente di caricare e salvare gli script in un file.
-
Carica da file: carica uno script da un file di testo esterno salvato in precedenza.
-
Salva nel file: memorizza in un file di testo lo script modificato correntemente.
-
-
Il gruppo Modifica consente di trovare e sostituire le stringhe in uno script.
-
Trova: individua la stringa immessa nello script.
-
Sostituisci: sostituisce la stringa nello script.
-
-
Gruppo Inserisci: il comando Origine dati inserisce nello script le origini dati esistenti o appena definite.
-
Gruppo Script: il comando Convalida script convalida la sintassi dello script immessa.
Gli Elementi script disponibili contengono tutti gli elementi di script disponibili e utilizzabili al momento della creazione di uno script. Fare doppio clic sull'elemento oppure fare clic sul pulsante Inserisci per inserire l'elemento nella posizione del cursore all'interno dello script.
Descrizione elemento fornisce informazioni di base sull'elemento dello script inserito.
Elenco errori include gli errori segnalati dopo l'esecuzione del comando Convalida script.
La funzione Script Python supporta anche le manipolazioni di dati più complesse su un'etichetta o un modulo.
Suggerimento
Rispetto a VBScript, è un'opzione più idonea per i sistemi a 64 bit. Inoltre, essa risulta essere un'alternativa di script molto più veloce.
Il gruppo Informazioni su identifica la funzione.
-
Tipo funzione: mostra il tipo di script selezionato.
Script Python
-
Inserisci origine dati: inserisce nello script un'origine dati appena creata.
-
Verifica: convalida la sintassi dello script immessa.
-
Editor di script: apre l'editor, che rende la creazione di script più facile ed efficiente.
Esempio 40. Esempio:
La variabile NAME fornisce il nome e il cognome di una persona. La funzione Script Python dovrebbe scomporre i nomi e usare solo il nome come risultato della funzione.
Valore iniziale della variabile NAME: Mario Rossi
name = NAME.Value Spc = name.find(' ') if name != '' and Spc != -1: Result.Value = name[0:Spc] else: Result.Value = name
Risultato dello script Python: Mario
HIBC è uno standard di codice a barre usato specificamente nell'industria medica, come previsto dall'organizzazione HIBCC. Questo standard supporta codici a barre composti e l'uso di più elementi, come codici di elementi, quantità e numero di batch in un unico codice a barre.
Suggerimento
Per ulteriori informazioni sullo standard, visitare il sito Web HIBCC.
Il gruppo Informazioni su identifica la funzione.
Il gruppo Struttura seleziona la versione standard e uno dei tre Tipi di codici a barre HIBC disponibili:
-
Versione: selettore della versione HIBC. Le etichette che includono vecchi dati HIBC si aprono con la versione 2.5. Se si crea una nuova etichetta, la codifica funziona in base alla versione HIBC selezionata: 2.5 o 2.6.
-
Tipo: selettore del tipo di struttura di dati.
-
Primario: struttura di dati fissa che identifica l'elemento e il suo fornitore.
-
Secondario: la struttura di dati opzionale che è indicata usando il delimitatore "/". Potrebbe avere una struttura variabile (ma predefinita) per contenere numero di serie o di batch, quantità e data di scadenza.
-
Definizione principale: elemento obbligatorio quando si definisce la struttura di dati Secondario. I tre campi di dati Primario di una funzione HIBC devono essere aggiunti alla struttura di dati Secondario. Definizione principale seleziona la funzione HIBC esistente appropriata.
-
-
Concatenato: unisce i primi due tipi di struttura in un'unica struttura di dati.
-
Il gruppo Definizione definisce il contenuto dei campi di codici a barre HIBC:
Campi della struttura di dati Primario:
-
Codice ID utente etichette (LIC): campo assegnato e gestito dall'HIBCC. Il primo carattere di questo campo è sempre un carattere alfabetico. Il LIC può identificare un utente etichette fino al punto di filiali e divisioni separate all'interno di un'organizzazione principale.
-
Numero del prodotto o del catalogo...: numero del prodotto o del catalogo compresso.
-
Unità di misura...: rappresentazione numerica del livello di packaging (da 0 a 9), dove 0 è il livello più basso, o l'“unità d'uso”.
Esempio 41. Esempio:
Un'azienda potrebbe imballare gli elementi di unità d'uso in una scatola, scatole in un cartone e cartoni in una cassetta. Un metodo di etichettatura sarebbe, unità d'uso = 0; Scatola = 1; Cartone = 3; e Cassa = 5.
Campi della struttura di dati Secondario:
-
Quantità: campo da due o cinque cifre che descrive il numero di unità d'uso incluse nel pacchetto identificato dall'etichetta del codice a barre.
-
Formato data: formato data preferito da usare con un'etichetta HIBC. Se in un'etichetta non si deve includere nessuna data, selezionare uno dei formati contenenti "Nessuna data".
-
Data: visualizza la data attuale.
-
Lotto/batch: il campo può essere alfanumerico e può variare in lunghezza fino a un massimo di 18 caratteri. Se il campo non è obbligatorio, va lasciato vuoto.
-
Numero di serie: il campo può essere alfanumerico e può variare in lunghezza fino a un massimo di 18 caratteri. Se il campo non è obbligatorio, va lasciato vuoto.
-
Data di produzione: Identificatore dati nel formato AAAAMMGG.
La funzione GS1-128 codifica i dati del codice a barre usando lo standard GS1-128. Lo standard supporta la codifica di dati testuali, numeri, funzioni e set interi di 128 caratteri ASCII.
GS1-128 codifica i dati e ne definisce il significato definendo un elenco di identificatori d'applicazione (IA). Questi identificatori definiscono il contenuto e la lunghezza dei dati che includono.
Gli IA includono un campo di dati contenente un numero di caratteri fisso o variabile.
Suggerimento
Per ulteriori informazioni sullo standard GS-128 e i principi di codifica, visitare il sito Web GS1.
L'elenco di IA è disponibile qui.
Informazioni su
Il campo Identificatori d'applicazione visualizza gli IA selezionati.
Il pulsante Modifica definizione funzione apre una finestra di dialogo di modifica degli identificatori. La finestra di dialogo Definizione funzione consente all'utente di aggiungere, eliminare, spostare e modificare gli identificatori selezionati. Esistono quattro colonne con le proprietà dell'identificatore:
-
Identificatore: colonna con numero e descrizione dell'IA dell'identificatore.
-
Valore: colonna con un valore definito manualmente o dinamicamente, come indicato dall'Origine dati selezionata.
Suggerimento
La colonna Valore fa in modo che i valori siano conformi allo standard GS1-128. I valori vengono riformattati automaticamente in base al formato e alla lunghezza dell'IA.
-
Opzioni: colonna con opzioni di identificazione aggiuntive (se disponibili).
Il gruppo Delimitatore definisce i caratteri di delimitazione per separare gli IA.
Un singolo codice a barre può includere più IA. Questi campi sono separati mediante il Delimitatore sinistro e destro. Per impostazione predefinita, vengono usate le prime due cifre dell'IA. I delimitatori personalizzati possono essere definiti inserendo caratteri alfanumerici.
Il gruppo Output funzioni aggiuntivi definisce una funzione subordinata.
-
Crea funzione di output con contenuto non formattato crea una funzione subordinata che utilizza i dati non formattati codificati dalla funzione GS1-128 principale.
-
Nome funzione: il nome della funzione subordinata appena creata.
La funzione ANSI MH10.8.2 (ASC) codifica i dati del codice a barre usando lo standard ANSI MH10.8.2-2006. Questo standard fornisce un intervallo di identificatori di dati MH 10/SC 8 e identificatori di applicazioni GS1. Esso consente di assegnare nuovi identificatori di dati e definisce la correlazione o la mappatura degli identificatori di dati rispetto agli identificatori dell'applicazione.
Suggerimento
Per ulteriori informazioni sullo standard ANSI MH10.8.2 (ASC), visitare il sito Web ufficiale. ANSI MH10.8.2 appartiene allo standard ISO/IEC 15418, il quale è accessibile qui.
Il gruppo Informazioni su identifica la funzione.
Identificatori d'applicazione: consente l'uso standardizzato degli identificatori dell'applicazione. Sono usati con qualsiasi vettore dati alfanumerico.
Il pulsante Modifica definizione funzione apre la finestra di dialogo Definizione funzione. La finestra consente all'utente di aggiungere, eliminare, spostare e modificare gli identificatori selezionati.
Esistono tre colonne con le proprietà dell'identificatore:
-
Identificatore: colonna con l'ID dell'identificatore.
-
Valore: colonna con valore inserito manualmente o un valore definito automaticamente, come indicato dall'Origine dati selezionata.
Nota
Ciascuna colonna Valore consente l'inserimento di un numero di caratteri limitato. La limitazione (formato) è definita dallo standard e varia in base all'identificatore selezionato.
Questa funzione supporta lo standard internazionale ISO/IEC FDIS 15434 per "Informatica – Tecniche di identificazione e cattura automatica dei dati – Sintassi per supporti ADC ad alta capacità".
Lo standard definisce il modo in cui i dati vengono trasferiti al supporto di cattura automatica dei dati ad alta capacità (ADC) dal sistema informativo del fornitore e il modo in cui i dati vengono trasferiti al sistema informativo del destinatario.
Lo standard utilizza le tecnologie ad alta capacità, come i simboli bidirezionali, per codificare campi dati multipli. Di solito questi campi vengono analizzati dal sistema informativo del destinatario e mappati su campi dati specifici nel sistema informativo del destinatario.
Questa funzione consente di codificare i dati negli oggetti dell'etichetta. È possibile combinare più informazioni in un unico messaggio. Ciascuna parte inizia con un'intestazione ed è seguita dal messaggio. In ciascun campo dati potrebbe essere stato immesso un valore manualmente, oppure esso può essere connesso a una variabile.
Nota
Assicurarsi che la variabile abbia lo stesso formato dati richiesto dall'identificatore di dati. Di solito gli identificatori dei dati hanno un rigido formato definito dallo standard.
Il gruppo Informazioni su identifica la funzione.
-
Identificatori d'applicazione: serie di identificazione di dati standardizzati del settore.
Suggerimento
Lo scopo degli identificatori è fornire un'identificazione univoca dell'elemento. Per gestire gli identificatori, fare clic su Modifica definizione funzione.
La finestra di dialogo Definizione funzione consente all'utente di aggiungere, eliminare e modificare gli identificatori selezionati.
-
La colonna Involucro formato: definisce le posizioni iniziali e finali di un elemento di dati in un determinato formato. Ciascun Involucro formato contiene un'intestazione di formato, dati e un Format Trailer.
Esempio 42. Esempio:
-
Involucro formato 02 rappresenta i dati di messaggio/transazione IDI completi.
-
Involucro formato 06 rappresenta i dati che vengono codificati utilizzando gli identificatori di dati ASC MH 101.
-
La colonna Elementi dati: definisce il contenuto dell'identificatore. Inserire i dati da codificare manualmente oppure definire un'origine dati.
-
Dati intestazione formato: definisce due elementi di intestazione del formato obbligatori.
-
Versione: organizzazione che controlla la struttura dei dati.
Nota
Ciascun identificatore consente di aggiungere più elementi.
-
Rilascio: numero di versione dello standard del supporto ADC.
-
La funzione Leggi dal file legge il contenuto da un file specificato. Il file può essere accessato in locale o in remoto tramite la connessione di rete.
Il gruppo Informazioni su identifica la funzione.
Il gruppo Leggi da parametri file imposta i dettagli della connessione al file.
Nome del file imposta la connessione al file.
Codifica specifica il tipo di codifica per i dati inviati.
-
Automatico: codifica definita automaticamente.
Suggerimento
Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
La funzione Messaggio NDEF consente di definire un formato di incapsulamento del messaggio per lo scambio di informazioni sui dati tramite un collegamento Near Field Communication (NFC). Tale collegamento viene stabilito tra due dispositivi NFC oppure tra un dispositivo NFC e un tag.
Suggerimento
NFC è una serie di protocolli di comunicazione che consentono a due dispositivi di stabilire una comunicazione portandoli a 4 cm (2 pollici) di distanza gli uni dagli altri.
Il messaggio NDEF incapsula uno o più record definiti dall'applicazione che appaiono in diversi tipi e dimensioni. Questi record sono combinati in un unico messaggio.
Nota
L'output di questa funzione è nel formato HEX.
Il gruppo Informazioni su identifica la funzione.
Il gruppo Struttura messaggio NDEF visualizza i record NDEF che sono inclusi nel messaggio.
Fare clic su Modifica definizione funzione per aprire la finestra di dialogo Messaggio NDEF. Questa finestra di dialogo Definizione funzione consente all'utente di aggiungere, eliminare, spostare e modificare i record NDEF. Esistono due colonne con le proprietà del record:
-
Tipo record NDEF: identifica il tipo di record. In Desktop Designer sono disponibili i seguenti tipi di record standard:
-
Uri: contiene una stringa di caratteri che identifica una risorsa Web.
-
Testo: contiene il contenuto testuale con informazioni sulla codifica del testo e il codice della lingua.
-
Poster intelligente: include più record secondari: URI, titolo, azioni consigliate, icona, dimensioni e tipo.
Nota
Il contenuto Poster intelligente è rappresentato come contenuto di un unico record, anche se internamente la struttura viene creata come più record secondari all'interno di un singolo record.
-
Seleziona trasferimento BlueTooth: una serie di record comprensivi di vari elementi: versione trasferimento, stringa indirizzo dispositivo, stringa locale completa, classe dispositivo e classe servizio.
-
Personalizzato: tipo di record che consente di codificare i dati NFC non nativi.
Suggerimento
Trascinare e rilasciare i record nella finestra di dialogo Messaggio NDEF per cambiarne velocemente la posizione.
Suggerimento
Le descrizioni dettagliate dei tipi di record NDEF sono disponibili nelle specifiche tecniche del forum NFC.
-
-
Definizione record: impostazioni definite dallo standard NDEF. Le opzioni disponibili dipendono dal tipo di record selezionato.
Includi contenitore capacità aggiunge un contenitore di capacità ai dati codificati. Il contenitore di capacità memorizza i dati di controllo per gestire i dati NFC in un tag o in un dispositivo. Esso indica al dispositivo NFC che i dati ricevuti sono un messaggio NFC. Nei casi in cui il contenuto NFC deve essere codificato in un tag RFID ad alta frequenza (HF), attivare l'opzione Includi contenitore capacità. Ciò segnala al dispositivo di lettura che il contenuto NFC è memorizzato nel tag. Alcuni tag conformi allo standard NFC includono già il contenitore capacità nel tag, il che significa che non è necessario includerlo all'interno del contenuto generato.