Le Azioni sono una parte essenziale delle soluzioni di etichettatura automatizzata. Quando si verifica un evento definito, ciascuna azione esegue un comando predefinito (o una serie di comandi).
Desktop Designer include un'ampia gamma di azioni. Il loro scopo consiste nell'eliminare la necessità di iniziare da zero la programmazione della soluzione.
Gestire le azioni usando la finestra di dialogo Editor di azioni.
I concetti e le proprietà di base Azione sono descritti qui di seguito.
-
Azioni disponibili: l'intervallo di azioni incluse in Desktop Designer. Queste azioni sono raggruppate in serie funzionali.
-
Definizione delle azioni: un'azione viene definita in Editor azioni facendo clic sull'icona di azione appropriata nel gruppo del nastro Aggiungi. Il nastro principale contiene le azioni usate di frequente e – successivamente – le azioni definite come azioni comuni. Per visualizzare tutte le azioni disponibili, fare clic su Tutte le azioni.
-
Azioni nidificate: azioni che non possono essere usate da sole. Le loro caratteristiche specifiche prevedono che siano nidificate all'interno di un'altra azione. Usare i pulsanti del nastro Ordine azioni per cambiare la posizione delle azioni. Ciascuna azione è identificata con un numero ID che indica la sua posizione nell'elenco, tra cui la nidificazione. Tale numero ID è visualizzato nel messaggio di errore potenziale, quindi è possibile trovare più velocemente l'azione problematica.
L'azione Stampa l'etichetta è un esempio di tale azione. Questa azione è nidificata sotto l'azione Apri etichetta, quindi fa riferimento all'etichetta esatta da stampare.
-
Esecuzione azione: le azioni elencate (attive) sono eseguite una volta per ciascuna evento. L'ordine delle azioni è di fondamentale importanza: l'esecuzione inizia nella parte superiore e si sposta verso la parte inferiore dell'elenco.
-
Azioni condizionali: le azioni condizionale vengono eseguite solo quando le condizioni fornite ne consentono l'esecuzione. La condizione è definita con un'espressione VBScript o uno script Python di una sola riga.
-
Errori nelle azioni: se un'azione non è configurata completamente, è contrassegnata con un'icona di esclamazione rossa. Tale azione può essere inclusa nell'elenco di eventi, ma non può essere eseguita.
Nota
Se una delle azioni nidificate segnala un errore, anche tutte le azioni principali sono colorate di rosso. Ciò indica un errore di azione nidificata.
-
Disattivazione azioni: impedisce che un'azione venga eseguita. Per impostazione predefinita, ciascuna azione aggiunta è attivata. Le azioni non necessarie possono essere disattivate e mantenute nella configurazione. La scelta rapida per attivare e disattivare un'azione è rappresentata dalla casella di controllo davanti al nome dell'azione nell'elenco di azioni definite.
-
Copia di azioni: qualsiasi azione può essere copiata e incollata. Usare le scelte rapide della tastiera di Windows oppure fare clic sull'azione con il pulsante destro del mouse.
Editor di azioni è una finestra di dialogo per la gestione delle azioni in una Desktop Designer soluzione.
Le azioni possono essere definite per:
-
Modulo: queste azioni vengono attivate con eventi di modulo. Sono applicabili ai seguenti eventi:
-
Al caricamento del modulo: le azioni vengono eseguite dopo il caricamento di un modulo.
-
Alla chiusura del modulo: le azioni vengono eseguite dopo la chiusura di un modulo.
-
Timer sul modulo: le azioni vengono eseguite dopo un intervallo di tempo specificato.
-
Inattività sul modulo le azioni vengono eseguite dopo che il modulo è restato inattivo per un determinato intervallo di tempo.
-
-
Oggetto modulo: queste azioni vengono attivate con eventi relativi agli oggetti.
-
Variabile: queste azioni vengono attivate in base ai valori ricevuti.
La barra multifunzione della finestra di dialogo Editor di azioni include i comandi per aggiungere, rimuovere e ordinare le azioni. Inoltre, essa consente di accedere direttamente alle azioni usate frequentemente.
Le icone del gruppo Appunti attivano le seguenti azioni:
-
Incolla: incolla i dati degli Appunti.
-
Taglia: taglia la selezione negli Appunti.
-
Copia: copia la selezione negli Appunti.
-
Elimina: elimina gli elementi selezionati.
Il gruppo Annulla e ripeti consente di annullare o ripetere le azioni.
-
Annulla: Desktop Designer consente all'utente di annullare l'intera sequenza di azioni dall'ultima apertura dell'editor.
-
Ripeti: ripete l'intervallo di azioni richieste.
Il gruppo Ordine azioni definisce l'ordine di esecuzione delle azioni selezionate.
-
Le frecce Su e Giù: posizionano l'azione selezionata prima o dopo qualsiasi altra azione esistente.
-
Destra: la freccia nidifica l'azione selezionata sotto l'azione esistente precedente.
Nota
Un'azione nidificata è qualsiasi azione che inizia quando l'azione principale è già in corso.
-
Sinistra: la freccia rende un'azione nidificata indipendente dall'azione precedente.
Nota
Alcune azioni non possono esistere in modo indipendente. Se tale azione viene aggiunta all'elenco di azioni, viene visualizzata un'avvertenza. L'avvertenza definisce in quale azione deve essere nidificata l'azione interessata.
Aggiungi assegna le azioni all'oggetto modulo selezionato.
-
Il pulsante Tutte le azioni consente di accedere all'intera gamma di Desktop Designer azioni. Le azioni del tipo Utilizzato di recente sono elencate in cima all'elenco. Usare il campo Cerca... per individuare rapidamente qualsiasi azione immettendo il relativo nome.
-
Quattro pulsanti consentono di accedere direttamente alle azioni usate più spesso:
-
Il pulsante Apri etichetta: aggiunge l'azione Apri etichetta all'elenco di eventi.
-
Il pulsante Stampa etichetta: aggiunge l'azione Stampa etichetta all'elenco di eventi.
-
Il pulsante Imposta stampante: aggiunge l'azione Imposta stampante all'elenco di eventi.
-
Il pulsante Esci: aggiunge l'azione Esci all’elenco di eventi.
-
Esplora azioni è uno strumento per l'aggiunta, la rimozione e l'ordinamento delle azioni assegnate. Usare i comandi della barra multifunzione per manipolare le azioni esistenti o aggiungere nuove azioni.
Le colonne di esplorazione forniscono una panoramica istantanea sulle opzioni di esecuzione delle azioni e le relative descrizioni.
-
Attivato: attiva o disattiva l'azione inclusa.
-
Condizione: visualizza la condizione per l'esecuzione di un'azione (se impostata).
-
Descrizione: visualizza le informazioni su un'azione definita dall'utente.
Esplora azioni consente di effettuare una selezione di più azioni ed eseguire le operazioni Copia, Incolla ed Elimina. Per effettuare una selezione, usare Ctrl/Maiusc + Clic sulle azioni desiderate.
Nota
Le azioni multiple possono essere selezionate solo nella stessa azione principale, ossia, tutte le azioni selezionate devono trovarsi sullo stesso livello. Vedere l'immagine seguente.
Campo di modifica consente di modificare le proprietà avanzate dell'azione.
-
Le proprietà principali dell'azione selezionata possono essere modificate nella parte superiore del campo principale/di modifica. Le proprietà principali variano con ciascuna azione: per ulteriori informazioni, leggere le apposite sezioni sulla descrizione delle azioni.
-
Il gruppo Informazioni su consente di descrivere tutte le azioni di NiceLabel 10.
-
Nome: per impostazione predefinita, il nome dell'azione è definito dal tipo e pertanto non è univoco. Definire un nome personalizzato per renderlo riconoscibile immediatamente tra le altre azioni, nei registri e nei potenziali messaggi di errore.
-
Descrizione: note dell'utente relative all'azione selezionata. La descrizione è visualizzata in Esplora azioni.
-
Tipo di azione: campo di sola lettura che visualizza il tipo di azione.
Nota
Quando si aggiornano le vecchie soluzioni (create con NiceLabel V6 e versioni precedenti), aggiornare i nomi delle azioni in base alla lingua selezionata correntemente. La versione della soluzione viene aggiornata.
-
-
Le proprietà nascoste definiscono le proprietà definite con minore frequenza. Le proprietà nascoste variano con ciascuna azione: per ulteriori informazioni, leggere le apposite sezioni sulla descrizione delle azioni.
Le azioni Desktop Designer sono raggruppate in più serie funzionali. Di seguito sono elencati i gruppi con descrizioni di azioni di base.
Il gruppo Generale contiene i comandi relativi all'apertura e all'attivazione delle etichette usate di frequente:
Il gruppo Stampante contiene le azioni relative alla stampa:
Il gruppo Modulo definisce le azioni relative agli oggetti modulo:
Il gruppo Variabili definisce le azioni relative alle variabili:
Il gruppo Dati e connettività definisce le azioni relative a database, invio di dati, lettura e ricezione e networking.
Il gruppo Operazioni sui file definisce le azioni relative al file attivo:
Il gruppo Controllo di flusso definisce varie sequenze di azioni:
Il gruppo Altro contiene azioni specifiche per l'esecuzione dei comandi, l'invio di comandi personalizzati e la verifica delle licenze:
L'azione Apri etichetta specifica il file di etichetta che verrà stampato. Quando l'azione viene eseguita, il modello di etichetta si apre nella cache di memoria. L'etichetta resta nella cache fino a quando i trigger gli eventi la utilizzano.
Non vi è alcun limite al numero di etichette che possono essere aperte simultaneamente. Se l'etichetta è già caricata e viene richiesta di nuovo, NiceLabel Automation verifica se è disponibile una versione più recente e approvata per la stampa, quindi la apre.
In questo esempio, carica l'etichetta label.nlbl
dalla cartella C:\ProjectA\Labels
.
C:\ProjectA\Labels\label.nlbl
Se non si riesce a trovare l'etichetta specificata, NiceLabel 10 cerca di trovarla in posizioni alternative. Per ulteriori informazioni, vedere la sezione Ordine di ricerca dei file richiesti nella guida dell'utente di NiceLabel Desktop Designer.
Uso di percorsi relativi
NiceLabel 10 supporta l'uso di percorsi relativi per fare riferimento al file di etichetta. La cartella principale è sempre la cartella in cui viene memorizzata la soluzione (o la configurazione nel caso in cui l'azione sia utilizzata in una configurazione NiceLabel Automation).
Con la sintassi seguente, l'etichetta si carica relativamente dalla posizione del file di configurazione.Automation Builder cerca l'etichetta nella cartella ProjectA
, che si trova due livelli al di sopra della cartella corrente e quindi nella cartella Labels
.
..\..\ProjectA\Labels\label.nlbl
Il gruppo Impostazioni seleziona il file di etichetta.
-
Nome etichetta: specifica il nome della variabile. Può essere hardcoded e ogni volta sarà stampata la stessa etichetta. L'opzione Origine dati consente di definire dinamicamente il contenuto del messaggio. Selezionare o aggiungere una variabile contenente il percorso e/o nome di file se viene eseguito un trigger o si verifica un evento.
Suggerimento
Di solito, il valore rispetto alla variabile viene assegnato da un filtro.
Nota
Usare la sintassi UNC per le risorse di rete.
Questa azione esegue la stampa dell'etichetta. Deve essere sempre nidificata nell'azione Apri etichetta. La nidificazione consente di ottenere il riferimento all'etichetta che verrà stampata. Ciò consente inoltre di tenere aperte contemporaneamente più etichette, in modo da poter specificare quale etichetta dovrebbe essere stampata.
Quando si invia questa azione, l'etichetta viene stampata usando il driver della stampante definito nel modello di etichetta. Se il driver della stampante definito non viene rilevato nel sistema, l'etichetta viene stampata usando il driver della stampante predefinito del sistema. È possibile escludere la selezione del driver della stampante tramite l'azione Imposta stampante.
Per stampare etichette con prestazioni elevate, per impostazione predefinita attiva due impostazioni:
-
Elaborazione parallela. Vengono eseguiti simultaneamente più processi. Il numero di thread di stampa in background dipende dall'hardware, in particolare dal tipo di processore. Ciascun core di processore contiene un unico thread di stampa. Questa impostazione predefinita può essere modificata. Per ulteriori informazioni, vedere la sezione Elaborazione parallela nella guida dell'utente di NiceLabel Automation.
-
Modalità asincrona. Non appena viene completata la pre-elaborazione del trigger e le istruzioni per il motore di stampa sono disponibili, il thread di stampa ne assume il controllo in background. Il controllo viene restituito al trigger, in modo tale che esso possa accettare prima possibile il flusso di dati in entrata successivo. Se la modalità sincrona è attivata, il controllo non viene restituito al trigger fino al completamento del processo di stampa. L'operazione può durante a lungo, ma il trigger ha il vantaggio di rimandare il feedback all'applicazione che fornisce i dati. Per ulteriori informazioni, vedere la sezione Modalità sincrona nella guida dell'utente di NiceLabel Automation.
Nota
Usando l'opzione Salva errore su variabile in Esecuzione dell'azione e gestione degli errori non verrà restituito nessun risultato in modalità asincrona, in quanto il trigger non riceverà feedback dal processo di stampa. Per catturare il feedback dal processo di stampa, abilitare prima la modalità sincrona.
Nota
Se l'azione Stampa etichetta è nidificata nell'azione Per ciclo, Automation la esegue nella modalità di stampa della sessione. Questa modalità funge da modalità di ottimizzazione della stampa che stampa tutte le etichette di un ciclo utilizzando un singolo file di processo di stampa. Per ulteriori informazioni, vedere la sezione Stampa della sessione nella Guida dell'utente di NiceLabel Automation.
Il gruppo Quantità definisce il numero di etichette da stampare usando il modulo attivo.
-
Etichette: imposta il numero di etichette stampate. Origine dati specifica o aggiunge una variabile che definisce dinamicamente la quantità di stampa di etichette.
Nota
Di solito il valore della variabile viene assegnato dall'azione Usa filtro datie deve essere un numero intero.
Tutto (quantità illimitata): a seconda del progetto di modello di etichette, le etichette vengono stampate in quantità diverse.
Quantità illimitata
Di solito questa opzione viene usata in due scenari.
-
Ordinare alla stampante di stampare in continuazione la stessa etichetta fino a quando la stampante non verrà spenta oppure dopo che avrà ricevuto un comando di cancellazione del suo buffer di memoria.
Avvertimento
Questo scenario richiede che il driver stampante Loftware venga installato e usato per la stampa di etichette.
Se si stampa un'etichetta fissa, alla stampante viene inviato solo un processo di stampa, con la quantità impostata su "Illimitato". Le etichette della stampante dispongono di un parametro di comando che indica la stampa "illimitata".
Se l'etichetta non è fissa, ma include oggetti che cambiano durante la stampa, come i contatori, la quantità stampata viene impostata su quella massima supportata dalla stampante. Il driver della stampante Loftware è consapevole del limite della quantità della stampante e stampa quante etichette possibile.
Esempio 70. Esempio
La quantità massima di stampe supportata è 32.000. Questa è la quantità di etichette che vengono stampate dopo aver selezionato l'opzione Tutto (quantità illimitata).
-
Il trigger non fornisce dati, ma segnala solo che l"evento si è verificato". La logica per acquisire i dati necessari è inclusa sull'etichetta. Di solito, sull'etichetta è configurata una connessione a un database e in ciascun trigger l'etichetta deve connettersi al database e acquisire tutti i record dal database. In questo caso, l'opzione Tutto (quantità illimitata) viene interpretata come "stampa tutti i record dal database".
-
Quantità variabile (definita dalla variabile dell‘etichetta): specifica una variabile di etichetta che definisce la quantità di etichette da stampare.
Il trigger non riceve il numero di etichette da stampare, quindi invia la decisione al modello di etichetta. L'etichetta potrebbe contenere una connessione a un database, la quale fornirà la quantità di etichette oppure vi è un'altra origine di informazioni sulla quantità. Una singola variabile di etichetta deve essere definita come "quantità variabile".
Il gruppo Avanzato definisce i dettagli di stampa dell'etichetta. Fare clic su Mostra opzioni avanzate di stampa per definire le opzioni di stampa Avanzato:
Questa sezione specifica le impostazioni relative alla quantità di etichette non usate di frequente.
-
Numero di etichette ignorate: specifica il numero di etichette che vengono ignorate nella prima pagina delle etichette. Il foglio di etichette potrebbe essere già stato stampato una volta, ma non interamente. È possibile riutilizzare lo stesso foglio spostando la posizione iniziale. Questa opzione è applicabile se si stampano etichette su fogli di etichette, non rotoli, quindi è efficace per le stampanti da ufficio, ma non per le stampanti di etichette.
-
Copie di etichette identiche: specifica il numero di copie di etichette da stampare per ciascuna etichetta univoca. Per le etichette fisse, questa opzione produce lo stesso risultato dell'opzione principale Numero di etichette. Per le etichette di variabili, come ad esempio le etichette che usano contatori, è possibile ottenere copie reali dell'etichetta.
-
Set di etichette: specifica quante volte dovrebbe essere ripetuto l'intero processo di stampa di etichette.
Esempio 71. Esempio
Il trigger o l'evento riceverà il contenuto con 3 righe di dati in formato CSV, quindi si prevede che vengano stampate 3 etichette (1, 2, 3). Se si imposta questa opzione su 3, la stampa avverrà nell'ordine seguente: 1, 2, 3, 1, 2, 3, 1, 2, 3.
Suggerimento
Tutti i valori del gruppo Avanzate possono essere hardcoded oppure forniti dinamicamente da una variabile esistente o appena aggiunta.
Questa azione fornisce un'interfaccia con un'applicazione esterna e la apre usando una riga di comando.
Le applicazioni esterne possono eseguire operazioni di elaborazione aggiuntive e rimandare il risultato a NiceLabel 10. Questa azione consente a un'applicazione di legarsi a software di terze parti in grado di eseguire ulteriori operazioni di elaborazione o di acquisire dati. Il software esterno può fornire una risposta di dati salvando gli stessi in un file, da dove possono essere letti come variabili.
È possibile inserire nel programma il valore delle variabili, elencandole nella riga di comando tra parentesi quadre.
C:\Applications\Processing.exe [variable1] [variable2]
Nota
Usando questa azione nelle soluzioni NiceLabel 10, è possibile aprire pagine Web o creare messaggi e-mail direttamente dai moduli. Vedere la sezione Creazione di collegamenti ipertestuali e invio di e-mail sul modulo nella Guida dell'utente di NiceLabel 10.
Il gruppo File definisce il file da aprire.
-
Nome file: posizione e nome del file o dell'applicazione da aprire.
Il nome del file selezionato può essere hardcoded e ogni volta verrà usato lo stesso file. Se è definito solo un nome file senza percorso, viene usata la cartella con il file di configurazione (.MISX) NiceLabel Automation. È possibile usare il riferimento relativo al nome del file, nel quale la cartella con il file .MISX viene usata come cartella principale.
Origine dati: attiva il nome di file di variabile. Selezionare una variabile contenente il percorso e/o il nome di file oppure combinare più variabili che creano il nome di file. Per ulteriori informazioni, vedere la sezione Uso di valori composti nella guida dell'utente di NiceLabel Automation.
Nota
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Il gruppo Opzioni di esecuzione imposta i dettagli di apertura del programma.
-
Nascondi la finestra: rende invisibile la finestra del programma aperto. Poiché NiceLabel 10 viene eseguito come un'applicazione di servizio all'interno della propria sessione, non può interagire con il desktop, anche se viene eseguito con i privilegi dell'utente connesso corrente. Microsoft ha impedito questa interazione in Windows Vista e nei sistemi operativi più recenti per motivi di sicurezza.
-
Aspettare la terminazione: specifica che l'esecuzione dell'azione deve attendere il completamento di questa azione, prima di continuare con l'azione pianificata successiva.
Suggerimento
Attivare questa opzione se l'azione che segue dipende dal risultato dell'applicazione esterna.
Questa azione migliora la funzionalità del software usando gli script personalizzati VBScript o Python. Usare questa funzione se le azioni incorporate non soddisfano i requisiti di manipolazione dei dati.
Gli script possono includere le variabili del trigger, sia le variabili interne che le variabili definite o importate dalle etichette.
Assicurarsi che l'account Windows sotto il quale viene eseguito il servizio disponga dei privilegi per eseguire i comandi nello script.
Nota
Il tipo di script è configurato per il trigger presente nelle proprietà del trigger. Tutte le azioni Esegui script all'interno di un singolo trigger devono essere dello stesso tipo.
L'editor Script dispone delle seguenti funzionalità:
-
Inserisci origine dati: inserisce nello script una variabile esistente o 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.
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 traNiceLabel Designer Pro 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.
Questa azione specifica il nome della stampante da usare per stampare l'etichetta attiva.
Nota
Questa azione esclude la stampante selezionata nelle proprietà dell'etichetta.
Questa azione è utile quando si stampa un'etichetta identica su più stampanti. Nidificare sempre questa azione sotto l'azione Apri etichetta per fornire all'etichetta il riferimento per la stampante preferita.
Questa azione legge impostazioni predefinite quali velocità e scurezza dal driver stampante selezionato e le applica all'etichetta. Se non si usa l'azione Imposta stampante, l'etichetta viene stampata sulla stampante definita nel modello di etichetta.
Avvertimento
Fare attenzione nel passare da una stampante a un'altra di tipo diverso, ad esempio da una Zebra a una SATO, o da un modello di stampante all'altro della stessa marca. Le impostazioni della stampante potrebbero non essere compatibili e le stampe di etichette potrebbero non essere identiche. Inoltre, le ottimizzazioni del progetto di etichette per la stampante originale, come ad esempio contatori e caratteri interni, potrebbero non essere disponibili sulla nuova stampante selezionata.
Il gruppo Stampante specifica il nome della stampante da usare per il processo di stampa corrente.
-
Nome della stampante: selezionare il nome dall'elenco di driver stampante installati localmente, oppure immettere manualmente un nome di stampante. Selezionare Origine dati per selezionare dinamicamente la stampante mediante una variabile. Se è attivata, selezionare o creare una variabile contenente il nome della stampante usata quando viene eseguita un'azione.
Questa azione apre la finestra di dialogo delle proprietà del driver stampante relativa alla stampante selezionata. Le impostazioni vengono salvate nel file di etichette e hanno effetto solo per l'etichetta corrente.
Nota
Le modifiche che l'utente apporta usando questa azione sono temporanee e interessano solo il processo di stampa corrente. Le modifiche non vengono salvate in un'etichetta o in un modello.
Il gruppo Impostazioni definisce una variabile per le impostazioni della stampante.
-
Impostazioni stampante: seleziona o crea una variabile per memorizzare le impostazioni della stampante di output ricevute. Se le impostazioni della stampante sono incluse nella variabile, vengono visualizzate nella finestra di dialogo Proprietà stampante.
Questa azione specifica il nome del file del processo di stampa così come esso appare nello spooler di Windows. Il nome del processo di stampa predefinito è il nome del file di etichetta usato. Questa azione lo esclude.
Nota
Nidificare sempre l'azione sotto l'azione Apri etichetta, in modo tale che essa si applichi al file di etichetta corretto.
Il gruppo Processo di stampa definisce il nome del processo di stampa.
-
Nome: imposta il nome del processo di stampa. Esso può essere hardcoded e lo stesso nome viene usato per ciascuna azione di stampa. Variabile consente di usare un nome di file di variabile. Selezionare o creare una variabile contenente il percorso e/o il nome di file se si verifica un evento o viene attivato un trigger.
Nota
Nel modulo Automation Builder, di solito il valore della variabile viene assegnato da un filtro.
Questa azione devia il processo di stampa su un file. Invece di inviare alla porta della stampante il file di stampa creato, come definito nel driver della stampante, la stampa viene reindirizzata su un file. È possibile aggiungere i dati a un file esistente oppure sovrascriverlo.
Questa azione consente di catturare i comandi della stampante in un file separato.
L'azione indica al modulo Automation Builder di reindirizzare la stampa – di conseguenza, le etichette non verranno stampate. Assicurarsi che l'azione sia seguita dall'azione Stampa etichetta.
Nota
NiceLabel Automation viene eseguito come servizio sotto l'account utente Windows definito. Assicurarsi che questo account utente disponga dei privilegi di accesso alla cartella specificata con le autorizzazioni di lettura/scrittura. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
L'azione Reindirizza stampa su file è utile anche per stampare più etichette diverse (file .LBL) su una stampante di rete, conservando l'ordine corretto delle etichette. Se vengono stampati più file dallo stesso trigger, Automation Builder invia ciascuna etichetta alla stampante in un processo di stampa separato, anche se la stampante di destinazione è identica per entrambe le etichette. Se viene usata una stampante di rete, il processo di un altro utente può essere inserito tra due processi che il trigger deve inviare insieme. Usando questa azione è possibile aggiungere i dati di stampa nello stesso file e inviarne il contenuto alla stampante usando l'azione Invia dati a stampante.
Il gruppo di impostazioni File definisce il modo in cui viene eseguita la selezione di file per il reindirizzamento.
-
Nome file: specifica il nome del file. Può essere hardcoded oppure definito dinamicamente usando una variabile esistente o appena creata.
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Nota
Quando si usa questa azione, assicurarsi che l'account utente disponga di privilegi sufficienti per accedere alla cartella specificata con le autorizzazioni di lettura/scrittura.
Il gruppo di impostazioni Modalità scrittura file seleziona come viene trattato il file in caso di reindirizzamenti ripetuti.
-
Sovrascrivi il file: se il file specificato esiste già sul disco, esso verrà sovrascritto.
-
Aggiungi dati al file: il file del processo viene aggiunto ai dati esistenti nell'apposito file.
Il gruppo Persistenza controlla la continuità dell'azione di reindirizzamento. L'opzione definisce il numero di azioni Stampa l'etichetta interessate dall'azione Redirezione stampante su file.
-
Applica alla prossima azione di stampa: specifica che il reindirizzamento della stampa deve essere applicabile solo all'azione Stampa l'etichetta successiva (evento singolo).
-
Applica a tutte le azioni di stampa successive: specifica che il reindirizzamento della stampa deve essere applicabile a tutte le azioni Stampa l'etichetta definite dopo l'azione Redirezione stampante su file corrente.
Nota
L'azione reindirizza solo la stampa. Assicurarsi che sia seguita dall'azione Stampa l'etichetta.
Questa azione consente di mettere a punto i parametri relativi al driver della stampante. Sono inclusi parametri quali velocità e scurezza per stampanti di etichette o il vassoio della carta per le stampanti laser.
Le impostazioni della stampante vengono applicate solo alla stampa corrente e non vengono ricordate durante il prossimo evento.
Avvertimento
I parametri dell'azione Imposta parametro di stampa non si applicano quando si visualizza l'anteprima o si ristampano le etichette dal Control Center.
È possibile evitarlo con Usare le proprietà della stampante salvate in: Opzioni etichetta. Le proprietà della stampante possono variare da driver a driver e anche da stampante a stampante.
Nota
Se si usa l'azione Imposta stampante per modificare il nome della stampante, assicurarsi che l'azione Imposta parametro di stampa venga usata subito dopo. Prima di poter applicare la struttura DEVMODE al driver della stampante è necessario caricare prima le impostazioni predefinite del driver. Questa operazione viene eseguita mediante l'azione Imposta stampante. DEVMODE è compatibile solo con DEVMODE sullo stesso driver della stampante.
Il gruppo Parametri di stampa consente di definire le impostazioni prima di stampare.
-
Contenitore carta: nome del contenitore della carta che contiene il supporto etichetta. Di solito questa opzione viene usata con stampanti laser e a getto d'inchiostro con più contenitori carta. Il nome del contenitore carta specificato deve corrispondere al nome del contenitore presente nel driver della stampante. Per ulteriori informazioni, controllare le proprietà del driver della stampante.
-
Velocità di stampa: definisce la velocità di stampa. Questa impostazione esclude l'impostazione definita con l'etichetta. Il valore specificato deve essere compreso nell'intervallo di valori accettati.
Esempio 79. Esempio
Il primo modello di stampante accetta una serie di valori da 0 a 30, mentre il secondo valori da -15 a 15. Per ulteriori informazioni, vedere le proprietà del driver della stampante.
-
Scurezza: definisce la scurezza degli oggetti stampati sulla carta ed esclude l'impostazione dall'etichetta. Il valore specificato deve essere compreso nell'intervallo di valori accettati.
-
Stampa offset X: applica l'offset orizzontale. La stampa dell'etichetta sarà riposizionata dal numero di punti specificati nella direzione orizzontale. È possibile definire l'offset negativo.
-
Stampa offset Y: applica l'offset verticale. La stampa dell'etichetta sarà riposizionata dal numero di punti specificati nella direzione verticale. È possibile definire l'offset negativo.
Suggerimento
Tutti i parametri di stampa possono essere hardcoded oppure definiti dinamicamente usando una variabile esistente o appena creata.
Il gruppo Avanzato personalizza le impostazioni della stampante che vengono inviate con il processo di stampa.
Le impostazioni della stampante, come velocità di stampa, scurezza, tipo di supporto, offset e simili, possono essere definite come segue:
-
Definite in un'etichetta
-
Richiamate da un driver della stampante
-
Richiamate da una stampante al momento della stampa
I metodi supportati dipendono dal driver e dalle capacità della stampante. La modalità di stampa (impostazioni di richiamo dall'etichetta, dal driver o dalla stampante) è configurabile nel progetto dell'etichetta. Potrebbe essere necessario applicare queste impostazioni della stampante al momento della stampa; esse possono variare a seconda della stampa.
Esempio 80. Esempio
Ciascuna etichetta va stampata con stampanti diverse, ma ciascuna stampante richiede parametri leggermente diversi. Le stampanti di produttori diversi non usano gli stessi valori per impostare la velocità di stampa o la temperatura. Inoltre, per stampare l'etichetta sulla posizione corretta, per alcune stampanti è necessario un offset verticale o orizzontale. Durante la fase di test, è possibile determinare le impostazioni ottimali per ciascuna stampante che si intende usare e applicarle a un unico modello di etichetta immediatamente prima della stampa. Questa opzione applicherà le impostazioni corrispondenti a ciascuna stampante definita.
Questa azione prevede la ricezione delle impostazioni della stampante in una struttura DEVMODE. Questa è una struttura dati standard di Windows, con informazioni sull'inizializzazione e l'ambiente di una stampante.
L'opzione Impostazioni stampante applica le impostazioni personalizzate della stampante. Sono disponibili gli input seguenti:
-
DEVMODE codificata base 64 dati fissi. In questo caso, specificare la stringa codificata base 64 DEVMODE direttamente nel campo di modifica. Se viene eseguita, l'azione riconverte i dati codificati base 64 al formato binario.
-
DEVMODE codificata base 64 dati variabili. In questo caso, l'origine dati selezionata deve contenere la stringa DEVMODE codificata base 64. Attivare Origine dati e selezionare la variabile appropriata dall'elenco. Se viene eseguita, l'azione riconverte i dati codificati base 64 al formato binario.
-
DEVMODE binario dati variabili (disponibile in Automation Builder). In questo caso, la variabile selezionata deve contenere DEVMODE nella sua forma binaria nativa. Attivare Origine dati e selezionare la variabile appropriata dall'elenco. Se viene eseguita, l'azione usa DEVMODE così com'è, senza conversione.
Nota
Se la variabile non fornisce una stringa DEVMODE binaria, assicurarsi che la variabile selezionata sia definita come una variabile binaria nella configurazione.
Nota
Assicurarsi che l'azione Imposta stampante sia definita prima di questa azione.
Impostazioni etichetta sovrascrive le proprietà dell'etichetta definite in Proprietà etichetta in Designer. Utilizzare questa opzione quando si stampano le etichette su una stampante o un supporto con proprietà diverse, come definito in Proprietà etichetta in Designer. Con questa opzione è possibile:
-
Cambiare le dimensioni dell’etichetta (larghezza e altezza).
-
Aggiungere o cambiare i margini dell’etichetta.
-
Disabilitare il taglierino.
-
Disattivare la stampa in batch.
-
Applicare supporti diversi modificando il parametro Etichette trasversali (conteggio orizzontale e verticale, spazi vuoti, ordine di elaborazione).
-
Ridefinire l'orientamento Verticale o Orizzontale.
-
Ruotare le etichette di 180°.
PowerForms applica Impostazioni etichetta al momento della stampa. I parametri delle impostazioni dell'etichetta non vengono salvati nei modelli di etichetta. È possibile fornire le Impostazioni etichetta come un payload XML.
Impostazioni etichetta di esempio XML
L'esempio seguente illustra la vista strutturale delle impostazioni dell'etichetta e i relativi attributi.
<LabelSettings> <Width>100</Width> <Height>30</Height> <Margin> <Left>2</Left> <Right>3</Right> <Top>4</Top> <Bottom>5</Bottom> </Margin> <LabelsAcross> <Horizontal> <Count>2</Count> <Gap>4</Gap> </Horizontal> <Vertical> <Count>3</Count> <Gap>5</Gap> </Vertical> <ProcessingOrder>HorizontalTopRight</ProcessingOrder> </LabelsAcross> <Orientation>Landscape</Orientation> <Rotated>true</Rotated> <DisableCutter/> <DisableBatchPrinting/> <PaperType>Roll or Sheet</PaperType> <PaperName>A5</PaperName> </LabelSettings>
Specifica XML delle impostazioni dell'etichetta
Questa sezione contiene una descrizione della struttura del file XML per definire i parametri e i valori delle Impostazioni etichetta.
<?xml version="1.0" encoding="utf-8"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:simpleType name="nonNegativeFloat"> <xs:restriction base="xs:float"> <xs:minInclusive value="0"/> </xs:restriction> </xs:simpleType> <xs:element name="LabelSettings"> <xs:complexType> <xs:all> <xs:element name="DisableCutter" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:sequence/> </xs:complexType> </xs:element> <xs:element name="DisableBatchPrinting" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:sequence/> </xs:complexType> </xs:element> <xs:element name="Width" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> <xs:element name="Height" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> <xs:element name="Margin" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:all> <xs:element name="Left" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> <xs:element name="Right" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> <xs:element name="Top" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> <xs:element name="Bottom" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> </xs:all> </xs:complexType> </xs:element> <xs:element name="LabelsAcross" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:all> <xs:element name="Horizontal" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:all> <xs:element name="Count" type="xs:nonNegativeInteger" minOccurs="0" maxOccurs="1" /> <xs:element name="Gap" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> </xs:all> </xs:complexType> </xs:element> <xs:element name="Vertical" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:all> <xs:element name="Count" type="xs:nonNegativeInteger" minOccurs="0" maxOccurs="1" /> <xs:element name="Gap" type="nonNegativeFloat" minOccurs="0" maxOccurs="1"/> </xs:all> </xs:complexType> </xs:element> <xs:element name="ProcessingOrder" minOccurs="0" maxOccurs="1"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:enumeration value="HorizontalTopLeft"/> <xs:enumeration value="HorizontalTopRight"/> <xs:enumeration value="HorizontalBottomLeft"/> <xs:enumeration value="HorizontalBottomRight"/> <xs:enumeration value="VerticalTopLeft"/> <xs:enumeration value="VerticalTopRight"/> <xs:enumeration value="VerticalBottomLeft"/> <xs:enumeration value="VerticalBottomRight"/> </xs:restriction> </xs:simpleType> </xs:element> </xs:all> </xs:complexType> </xs:element> <xs:element name="Orientation" minOccurs="0" maxOccurs="1"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:enumeration value="Portrait"/> <xs:enumeration value="Landscape"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="Rotated" type="xs:boolean" minOccurs="0" maxOccurs="1"/> </xs:all> </xs:complexType> </xs:element> </xs:schema>
Questa azione devia il processo di stampa su un documento PDF. Il documento PDF creato mantiene le dimensioni esatte dell'etichetta definite durante la progettazione della stessa. La qualità del rendering della grafica nel PDF corrisponde alla risoluzione della stampante di destinazione e delle dimensioni di stampa desiderate.
I dati del flusso di stampa possono essere aggiunti a un file esistente oppure possono sovrascriverlo.
L'azione indica a NiceLabel 10 di reindirizzare la stampa – di conseguenza, le etichette non vengono stampate. Assicurarsi che l'azione sia seguita dall'azione Stampa etichetta.
Nota
Il modulo NiceLabel Automation viene eseguito come servizio sotto un account utente Windows definito. Assicurarsi che questo account utente disponga dei privilegi di accesso alla cartella specificata con le autorizzazioni di lettura/scrittura. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Il gruppo File definisce il file di reindirizzamento.
-
Nome del file: specifica il nome del file al quale reindirizzare il lavoro di stampa. Se è hardcoded, la stampa viene reindirizzata ogni volta al file specificato. Per definirlo dinamicamente, usare una variabile esistente o crearne una nuova.
-
Sovrascrivi il file: se il file specificato esiste già sul disco, esso verrà sovrascritto (selezionato, per impostazione predefinita).
-
Aggiungi dati al file: il file del lavoro viene aggiunto ai dati esistenti nell'apposito file (deselezionato, per impostazione predefinita).
-
Incorpora font in PDF: Se si utilizza un font non standard, la soluzione potrebbe produrre un output PDF diverso sui computer senza questo font. Con l’opzione Incorpora font in PDF attivata, si incorpora il font non standard nella soluzione e la soluzione crea lo stesso PDF su tutti i computer.
L’opzione Incorpora font in PDF crea documenti conformi a PDF per l'archiviazione (PDF/A). Lo standard PDF/A garantisce che i documenti vengano riprodotti esattamente allo stesso modo, indipendentemente dal software che si utilizza. Le informazioni richieste per visualizzare i contenuti come immagini, font e informazioni sui colori sono incorporate nel file PDF.
Nota
Il file PDF di output consuma più spazio quando viene salvato con questa opzione abilitata.
Il gruppo Persistenza consente di controllare la persistenza dell'azione di reindirizzamento. Definire il numero di azioni Stampa l'etichetta interessate dall'azione Redirezione stampante su file.
-
Applica alla prossima azione di stampa: specifica che il reindirizzamento della stampa deve essere applicabile solo all'azione Stampa l'etichetta successiva (evento singolo).
-
Applica a tutte le azioni di stampa successive: specifica che il reindirizzamento della stampa deve essere applicabile a tutte le azioni Stampa l'etichetta definite dopo l'azione Redirezione stampante su file corrente.
Questa azione comunica con la stampante per acquisirne lo stato in tempo reale e contatta lo spooler Windows per ottenere ulteriori informazioni sulla stampante e i sui processi.
Di conseguenza, vengono raccolte le informazioni su errori, stato dello spooler e numero di processi nello spooler. Questo evidenzia i potenziali errori e li rende facilmente identificabili.
Possibili scenari di casi d'uso. (1) Verifica dello stato della stampante prima di stampare. Se la stampante è nella condizione di errore, l'etichetta verrà stampata su una stampante di riserva. (2) Conteggio del numero di processi in attesa in uno spooler della stampante principale. Se il numero di processi è eccessivo, l'etichetta verrà stampata sulla stampante alternativa. (3) Prima di stampare verrà verificato lo stato della stampante. Se la stampante si trova nello stato di errore, le etichette non saranno stampate, ma l'errore verrà segnalato al sistema mediante una delle azioni in uscita, come Invia dati alla porta TCP/IP, Invia dati su HTTP, Esegui istruzione SQL, Servizio Web oppure come risposta del trigger.
Prerequisiti dello stato della stampante live
Per rendere possibile il monitoraggio dello stato della stampante live, seguire queste istruzioni:
-
Usare il driver della stampante Loftware per ricevere informazioni dettagliate sullo stato. Se si usa un qualsiasi altro driver stampante, è possibile monitorare solo i parametri recuperati dallo spooler di Windows.
-
La stampante deve essere in grado di riferire il suo stato live. Per informazioni sui modelli di stampante che supportano la comunicazione bidirezionale, vedere Pagina Web di download.
-
La stampante deve essere collegata a un'interfaccia con supporto della comunicazione bidirezionale.
-
Il supporto bidirezionale deve essere attivato in Pannello di controllo > Hardware e suoni > Dispositivi e stampanti > driver > Proprietà stampante > scheda Porte > Attiva il supporto bidirezionale.
-
Se si usa una stampante di etichette collegata alla rete, assicurarsi che sia usata l'opzione Porta TCP/IP avanzata, non Porta TCP/IP standard. Per ulteriori informazioni, consultare la knowledge base, articolo KB189.
Il gruppo Stampante seleziona la stampante.
-
Nome della stampante specifica il nome della stampante da usare per il processo di stampa corrente.
È possibile selezionare una stampante nell'elenco di driver stampante installati localmente oppure immettere manualmente un nome di stampante. Origine dati attiva il nome di stampante variabile. Quando l'opzione è attivata, selezionare o creare una variabile contenente il nome della stampante quando viene eseguito un trigger o si verifica un evento. Di solito, il valore della variabile viene assegnato da un filtro.
Il gruppo Mappatura dati imposta i parametri che vengono restituiti in seguito all'azione Stato della stampante.
Avvertimento
La maggior parte dei parametri seguenti è supportata sola con il driver della stampante Loftware. Se si usa un qualsiasi altro driver stampante è possibile usare solo i parametri relativi allo spooler.
-
Stato della stampante: specifica lo stato live della stampante formattato come una stringa.
Se la stampante indica più stati, tutti sono uniti in un'unica stringa, delimitata da una virgola ",". Se non vengono segnalati problemi della stampante, questo campo è vuoto. Lo stato della stampante può essere impostato su Disconnesso, Etichette esaurite o Quasi senza nastro. Poiché non esiste un protocollo di reporting standardizzato, ciascun produttore di stampanti utilizza messaggi di stato proprietari.
-
Errore stampante: valore booleano (vero/falso) dello stato di errore della stampante.
-
Stampante offline: valore booleano (vero/falso) dello stato offline della stampante.
-
Driver messo in pausa: valore booleano (vero/falso) dello stato di pausa del driver.
-
Driver Loftware specifica il valore booleano (vero/falso) dello stato del driver stampante. Fornisce informazioni se il driver selezionato è un driver Loftware.
-
Stato spooler: specifica lo stato dello spooler sotto forma di stringa, come segnalato dal sistema Windows. Lo spooler può segnalare simultaneamente diversi stati. In questo caso, gli stati vengono uniti con una virgola ",".
-
ID stato spooler: specifica lo stato dello spooler formattato come numero, come segnalato dal sistema Windows. Lo spooler può segnalare simultaneamente diversi stati. In questo caso, gli ID di stato restituiti contengono tutti gli ID come indicatori. Ad esempio, il valore 5 rappresenta gli ID di stato 4 e 1, il che determina la visualizzazione di un messaggio simile a "Errore della stampante. La stampante è in pausa". Consultare la tabella seguente.
Suggerimento
L'azione restituisce un valore decimale. I valori nella tabella seguente sono in formato esadecimale quindi, prima di analizzare la risposta, sarà necessario effettuare la conversione.
-
Tabella degli ID di stato dello spooler e descrizioni corrispondenti
ID stato spooler (in esadecimali)
Descrizione stato spooler
0
Nessuno stato.
1
La stampante è in pausa.
2
La stampante sta stampando.
4
La stampante è in uno stato di errore.
8
La stampante non è disponibile.
10
Manca carta nella stampante.
20
È necessaria l'alimentazione manuale.
40
La stampante ha un problema con la carta.
80
La stampante è offline.
100
Stato input/output attivo.
200
La stampante è occupata.
400
Carta inceppata.
800
Il vassoio di uscita è pieno.
2000
La stampante è in attesa.
4000
La stampante sta elaborando.
10000
La stampante si sta riscaldando.
20000
Il livello di toner/inchiostro è basso.
40000
Nella stampante non è rimasto toner.
80000
Impossibile stampare la pagina corrente.
100000
È necessario l'intervento dell'utente.
200000
Memoria della stampante esaurita.
400000
Lo sportello è aperto.
800000
Errore sconosciuto.
1000000
La stampante è in modalità risparmio energetico.
-
Numero di processi nello spooler: specifica il numero di processi presenti nello spooler per la stampante selezionata.
-
Stato stampante esteso del driver Loftware: restituisce lo stato della stampante e i dati sugli errori in formato JSON. I dati includono anche i parametri della stampante come la versione del firmware, la distanza della testina di stampa e il livello di inchiostro.
Nota
È necessario il driver Loftware più recente per ottenere lo stato della stampante esteso del driver Loftware.
Esempio 83. Esempio
NiceLabel Automation restituisce il seguente contenuto JSON:
{ "printerName":"Production_printer_09", "version":"1", "responseType":"status3", "overallStatus":"error", "operationState":"pause", "printerType":"Thermal Transfer Label Printer", "deviceStatus": [ { "item": "fatalError", "type": "string", "internalId":"ERR_PAPER_OUT", "shortString":"Paper Out", "longString":"Printer is out of paper." }, { "item": "error", "type": "string", "internalId": "ERR_RIBBON_OUT", "shortString": "Ribbon Out", "longString": "Printer is out of Ribbon." } ], "deviceParameters": [ { "item":"state", "type":"float", "internalId":"INFO_PRINTHEAD_DISTANCE", "unit": "meter", "value": 789, "shortDescription":"Printhead distance", "longDescription":"Distance of printhead usage." }, { "item": "state", "type": "string", "internalId": "INFO_FW", "unit": "", "value": "FW27.3.13", "shortDescription": "Firmware version", "longDescription": "The version of the Firmware loaded on the printer." }, { "item": "property", "type": "integer", "internalId": "INFO_PRINT_DISTANCE", "unit": "seconds", "value": 16004, "shortDescription": "Print Distance", "longDescription": "Print Distance that the printer printed since odometer reset." } ] }
Questa azione salva un modello di etichetta nella memoria della stampante. L'azione costituisce una parte fondamentale della modalità di stampa, mediante la quale prima si memorizza un modello di etichetta nella memoria della stampante e quindi lo si richiama. Le parti non modificabili di un progetto di etichetta sono già memorizzate nella stampante, quindi è sufficiente fornire i dati per gli oggetti etichetta variabile al momento della stampa. Per ulteriori informazioni, vedere la sezione Uso della modalità di stampa Memorizza/richiama nella guida dell'utente di NiceLabel Automation.
Nota
Il tempo di trasferimento dei dati dell'etichetta necessari si riduce notevolmente, in quanto si deve inviare un minor numero di informazioni. Questa azione viene usata comunemente per gli scenari di stampa autonomi, nei quali l'etichetta viene memorizzata nella stampante o nell'applicatore nella linea di produzione e successivamente richiamata da un trigger software o hardware, come ad esempio uno scanner di codici a barre o una fotocellula.
Il gruppo Opzioni avanzate per memorizzare l'etichetta nella stampante consente di selezionare un'etichetta e la variante di memorizzazione preferita.
-
Nome etichetta da usare nella stampante: specifica il nome da usare per memorizzare il modello di etichetta nella memoria della stampante. Immettere il nome manualmente oppure attivare Origine dati per definire il nome dinamicamente usando una variabile esistente o appena creata.
Avvertimento
Quando si memorizza l'etichetta su una stampante, è consigliabile lasciare vuoto il nome dell'etichetta sotto le opzioni avanzate. Ciò impedisce che il nome dell'etichetta generi conflitti durante il processo di richiamo dell'etichetta.
-
Memorizza variante: definisce la posizione della memoria della stampante per i modelli di etichette memorizzati. Immettere la posizione manualmente oppure attivare Origine dati per definire il nome dinamicamente usando una variabile esistente o appena creata.
L'azione Stampa documento PDF stampa i documenti PDF statici che non sono collegati alle etichette nelle soluzioni PowerForms. Usare questa azione per stampare qualsiasi documento PDF direttamente dalle proprie soluzioni. I documenti PDF possono essere memorizzati su:
-
Computer
-
NiceLabel Control Center
-
Server Web
-
Unità di rete condivise
Suggerimento
L'azione è utile se si prevede di dotare i pacchetti di report PDF stampati sugli articoli inclusi, o se si desidera stampare la documentazione della confezione senza aprire il browser.
Il gruppo Stampante specifica il nome della stampante da usare per il processo di stampa corrente.
-
Nome della stampante: selezionare il nome dall'elenco di driver stampante installati localmente, oppure immettere manualmente un nome di stampante. Selezionare Origine dati per selezionare dinamicamente la stampante mediante una variabile. Se è attivata, selezionare o creare una variabile contenente il nome della stampante usata quando viene eseguita un'azione.
Il gruppo File definisce il file di reindirizzamento.
-
Nome file: specifica quale PDF stampare.
Nota
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Questa azione apre un altro modulo dalla stessa soluzione oppure un modulo dal disco.
Il gruppo Impostazioni include le seguenti opzioni:
-
Torna al modulo aperto in precedenza: riapre il modulo precedente quando viene eseguita l'operazione Apri un altro modulo.
-
Apri modulo: definisce un modulo da aprire quando viene eseguita l'azione Apri un altro modulo.
Un modulo può essere aperto in quattro modi:
-
Immettere il percorso di file assoluto.
-
Selezionare un modulo esistente dalla soluzione.
-
Fare clic su Apri per individuare il file sul disco.
-
Usare un'origine dati per definire dinamicamente il percorso del file
Il gruppo Origini dati modulo consente di gestire i valori delle variabili quando si passa da un modulo all’altro.
-
Reimposta valori variabili: per impostazione predefinita, se il contenuto dell’oggetto di un modulo è un valore di variabile, passando a un altro modulo il valore corrente viene mantenuto. Se si attiva l’opzione Reimposta valori variabili, il valore della variabile viene reimpostato sul valore iniziale dopo l’apertura di un altro modulo.
-
Nota
L’azione Apri un altro modulo conserva solo i valori delle variabili utilizzati come origini dati dell’oggetto. Se le variabili sono elencate solo in Dynamic Data Manager, i loro valori non vengono trasferiti.
Nota
Se la variabile non ha un valore iniziale, l’oggetto appare vuoto.
Esempio 87. Esempio
Questa opzione può risultare utile per le soluzioni di gestione dei dati. Quando si modificano i dati, è opportuno mantenere i valori esistenti. Quando si aggiungono nuovi dati è necessario reimpostare i dati. Se si usa il primo modulo per la modifica dei dati e il secondo per l’aggiunta di nuovi dati, tenere disattivata l’opzione Reimposta valori variabili per il modulo di modifica dei dati e attivare questa opzione per il modulo di aggiunta dei dati.
Questa azione sposta lo stato attivo su un oggetto specificato su un modulo.
Il gruppo Impostazioni definisce il movimento dello stato attivo:
-
Sposta lo stato attivo sul primo oggetto nell'ordine delle schede: imposta lo stato attivo sul primo oggetto nell'ordine definito dopo l'esecuzione del modulo.
-
Sposta stato attivo sull'oggetto selezionato posiziona lo stato attivo dopo aver eseguito il modulo sull'oggetto selezionato.
Questa azione consente di recuperare il numero di righe selezionate oppure i valori di campo selezionati nell'oggetto modulo Tabella di database. I valori sono memorizzati in un variabile esistente o appena creata. L'azione Ottieni riga tabella selezionata funziona come controparte dell'azione Seleziona riga tabella.
Il gruppo Tabella modulo consente di scegliere l'oggetto Tabella di database nel modulo e di selezionare i valori da memorizzare in una variabile.
-
Tabella: definisce quale oggetto Tabella di database presente nel modulo viene usato con questa azione.
-
Numeri riga selezionati: memorizza i numeri delle righe di tabella selezionati nella variabile Righe selezionate.
-
Contenuto campo tabella per righe selezionate: memorizza il valore correlato al campo delle righe di tabella selezionate.
-
Campo tabella: definisce il campo di tabella dal quale i valori vengono prelevati e memorizzati in Variabile righe selezionate.
-
Nota
Se vengono selezionate più righe, i valori memorizzati (numeri di riga o valori di campo) sono separati da virgole. Per attivare la selezione di più righe, aprire la proprietà oggetto Tabella di database > Impostazioni e attivare Attiva selezione righe multiple.
Nota
Se i valori memorizzati (numeri di riga o valori di campo) contengono una virgola, sono racchiusi tra virgolette.
-
-
Variabile righe selezionata: seleziona o crea una variabile che memorizza il campo Tabella o il valore Numeri riga selezionati.
Suggerimento
Usare questa variabile come origine dati per visualizzare i valori selezionati in un oggetto forma.
Suggerimento
Per visualizzare la selezione di record immediatamente dopo l'esecuzione del modulo, usare l'evento Al caricamento del modulo. Passare a Proprietà modulo > Eventi > Al caricamento del modulo e fare clic su Azioni.... Aggiungere l'azione Seleziona riga tabella e definire le righe, come spiegato in questa sezione.
Questa azione consente di definire quale riga di un oggetto modulo Tabella database è selezionata. Funziona in contrapposizione con l'azione Ottieni riga tabella selezionata.
Il gruppo Tabella modulo consente di scegliere l'oggetto Tabella database nel modulo e di selezionare la modalità con la quale viene selezionata la tabella scelta.
-
Tabella: definisce quale oggetto Tabella di database presente nel modulo viene usato con questa azione.
-
Modalità di selezione: definisce la modalità di selezione del record di database.
-
Prima riga: seleziona la prima riga dell'oggetto Tabella database.
-
Ultima riga: seleziona l'ultima riga dell'oggetto Tabella database.
-
Numero righe: consente di selezionare il numero di righe di tabelle di database selezionate. Immettere i numeri di riga o definirli dinamicamente usando un'origine dati. Per selezionare più righe, immettere i numeri di riga separati da virgole.
-
Valore campo: seleziona tutti i record nella tabella di database con un valore di dati corrispondente.
-
Campo tabella: campo di database con valori selezionati in caso di corrispondenza.
-
Valore campo: valore che seleziona la riga (o il record) in caso di corrispondenza.
-
Nota
Le opzioni Numero righe e Valore campo consentono di selezionare la riga di tabella senza tenere conto dell'ordinamento corrente delle righe di tabella. Ad esempio, "numero riga 3" resta selezionato anche se l'ordinamento delle tabelle riposiziona il "numero riga 3" su qualsiasi altra riga.
-
Seleziona tutte le righe: seleziona tutte le righe della tabella.
-
Deseleziona tutte le righe: deseleziona tutte le righe della tabella.
Nota
Vengono selezionate più righe, se la tabella le supporta. In caso contrario, viene selezionata solo la prima riga.
-
Quando si seleziona una riga di tabella, il numero di riga può essere memorizzato in una variabile. Per attivare questa opzione, usare l'opzione Memorizza numero riga selezionato sulla variabile nelle proprietà Tabella database.
Nota
L'azione Seleziona riga tabella definisce l'intervallo di selezione nel set di dati. Ciò significa che i record vengono selezionati direttamente dal database connesso e non dalla tabella. Se per l'oggetto Tabella database è attivato un filtro, esso non interessa l'azione Seleziona riga tabella.
Questa azione imposta le proprietà dell'oggetto modulo, come larghezza, altezza e colore.
Il gruppo Impostazioni definisce le proprietà da impostare:
-
Nome oggetto: l'oggetto modulo da modificare. L'elenco a discesa contiene oggetti sul modulo.
-
Proprietà: definisce la proprietà dell'oggetto modulo da impostare. La disponibilità delle proprietà dipende dall'oggetto selezionato correntemente
Suggerimento
Le impostazioni hanno effetto dopo che il modulo viene eseguito e l'evento assegnato si svolge.
Proprietà
Ruolo
Applicabilità
X
Imposta la distanza dal bordo del modulo sinistro/destro.
Tutti gli oggetti modulo.
Y
Imposta la distanza dal bordo del modulo superiore/inferiore.
Tutti gli oggetti modulo.
Larghezza
Imposta la larghezza dell'oggetto.
Tutti gli oggetti modulo.
Altezza
Imposta l'altezza dell'oggetto.
Tutti gli oggetti modulo.
Abilitato
Abilita o disabilità l'oggetto.
Tutti gli oggetti modulo.
Visibile
Rende l'oggetto visibile o invisibile.
Tutti gli oggetti modulo.
Nome carattere
Cambia il nome del carattere impostando quello selezionato.
Tutti gli oggetti modulo con contenuto testuale.
Dimensione carattere
Cambia le dimensioni del carattere sul valore selezionato.
Tutti gli oggetti modulo con contenuto testuale.
Stile carattere
Cambia lo stile del carattere impostando quello selezionato.
Tutti gli oggetti modulo con contenuto testuale.
Colore caratteri
Cambia il colore del carattere impostando quello selezionato.
Tutti gli oggetti modulo con contenuto testuale.
Colore
Cambia il colore dell'oggetto impostando quello selezionato.
Tutti gli oggetti modulo, ad eccezione di Navigatore database, Immagine.
Colonne visibili
Rende visibile una selezione di colonne di tabella.
Le colonne sono visibili nello stesso ordine immesso nel campo Valore.
Tabella database.
-
Valore: valori separati da virgola. Se il nome del valore include una virgola, usare il carattere “.
Suggerimento
Un esempio di definizione della proprietà dell'oggetto è descritto nella sezione sull'oggetto modulo in Tabella database della guida dell'utente di per progettisti.
Questa azione traduce nella lingua selezionata tutte le stringhe di un modulo. Il file di traduzione che contiene stringhe nella lingua di origine e le stringhe tradotte sono obbligatori per questa azione. Se si deve creare un nuovo file di traduzione, attenersi alle regole di formattazione seguenti.
Il gruppo Traduci impostazioni modulo seleziona la lingua e seleziona o crea un nuovo file di traduzione.
-
Lingua: lingua da usare nel modulo tradotto. Il nome della lingua è definito nella prima riga del file di traduzione.
Suggerimento
Il nome della lingua nel file di traduzione è configurabile dall'utente. Nell'azione, usare lo stesso ID (nome) definito nel file di traduzione. Il nome della lingua può essere fisso o variabile. Il suo uso dipende dalla lingua scelta e usata nel modulo.
Nome fisso: nome di lingua hardcoded che deve corrispondere al nome nella prima riga del file di traduzione.
Nome variabile: l'esempio è una casella a discesa con i nomi delle lingue. Quando l'utente cambia la lingua nell'elenco, l'evento onChange esegue l'azione Traduci modulo. La casella a discesa salva la selezione dell'utente in una variabile, usata per l'azione.
-
File di traduzione: il file che contiene le stringhe di origine e le traduzioni in varie lingue. Questo è un file di testo strutturato, simile a un file CSV.
-
Crea file traduzione: fare clic su questo pulsante per creare il file di traduzione contenente le stringhe di origine e quelle tradotte.
Struttura file di traduzione: un file di testo con dati codificati UTF-8. È simile ai valori separati da virgola (CSV).
Le regole di formattazione sono obbligatorie. Attenersi sempre alle regole elencate di seguito.
-
La prima riga contiene l'ID della lingua.
-
Il primo campo ha sempre il nome Origine. Non modificarlo.
-
I nomi degli altri campi nella prima riga sono configurabili dall'utente. Usare i nomi suggeriti, come "Lingua 2" e "Lingua 3", oppure sostituirli con qualsiasi descrizione più idonea per indicare la lingua, come "Tedesco", "Francese", "Cinese", ecc.
-
Tutte le righe che seguono la prima riga sono righe con le traduzioni della lingua originale. Il primo campo contiene la stringa originale, i campi successivi della stessa riga contengono la traduzione nelle altre lingue. La prima riga specifica in quale ordine la traduzione dovrebbe seguire la stringa di origine.
-
Tutti i valori sono racchiusi tra virgolette (").
-
Tutti i valori sono delimitati da un punto e virgola (;).
-
Se il modulo contiene oggetti di testo con più righe, il ritorno a capo (<CR><LF>) sarà codificato come stringa speciale $NEWLINE$.
-
Se si lascia vuota la traduzione, viene usata la stringa di origine.
Esempio di file di traduzione:
Source";"DE" "&Print";"&Druck" "Customize$NEWLINE$your$NEWLINE$printing$NEWLINE$forms";" Anpassen$NEWLINE$Sie$NEWLINE$Ihre$NEWLINE$Druckformen" "Printer:";"Drucker" "Quantity";"Menge" "SAMPLE";"PROBE" "Se&ttings";"Einstellungen" "Translate";"Übersetzen" "www.loftware.com/solutions";""
Stringhe di traduzione
Quando si usa l'azione Traduci modulo in qualsiasi punto del modulo, tutte le stringhe dello stesso vengono salvate automaticamente nel file di traduzione ogni volta che il modulo viene salvato. In tal modo il file di traduzione è sempre aggiornato rispetto al modulo.
Il file di traduzione è un file di testo Unicode. È possibile modificarlo in qualsiasi editor di testo, ma si potrebbero avere dei problemi di riconoscimento dei campi, in quanto i relativi valori sono separati da un punto e virgola e non allineati uno sotto all'altro.
Il file può essere aperto anche in un'applicazione foglio di calcolo, come Microsoft Excel. In questo caso, i campi appartenenti a una lingua particolare sono visualizzati nella stessa colonna di dati e possono essere modificati molto più facilmente.
Nota
Le applicazioni foglio di calcolo possono modificare la struttura del file di input del file di traduzione. In questo caso, riformattare i dati da soli dopo aver salvato il file di traduzione.
Esempio 94. Esempio
Microsoft Excel salverà il file di traduzione nel formato CSV. I campi perdono le virgolette che racchiudono i valori e saranno delimitati da una virgola (,) invece che da un punto e virgola (;). Sarà necessario convertire le virgole in punti e virgole e mettere le virgolette attorno ai campi. Questa operazione può essere eseguita con alcune operazioni di ricerca & e sostituzione.
Traduzione dei valori di etichetta in una soluzione
I moduli a volte mostrano valori che provengono da etichette contenute nello stesso documento della soluzione. L'azione Traduci modulo non traduce automaticamente questi valori dell'etichetta in quanto è necessario aggiungerli manualmente al file di traduzione.
Aggiungere i valori di etichetta al file di traduzione utilizzando le stesse regole di formattazione descritte sopra.
Esempio 95. Esempio
La soluzione contiene un modulo e un’etichetta. Il modulo include l’oggetto Inizializzazione dati per assegnare i valori alle variabili di etichetta. Si desidera visualizzare il modulo originale inglese in lingua tedesca utilizzando l'azione Traduci modulo (ossia, facendo clic su un pulsante sul modulo).
Il testo di richiesta originale per le variabili è "Define variable value"
. Per visualizzare la traduzione tedesca, aggiungere questa riga al file di traduzione: "Define variable value";"Definieren Sie den Variablenwert";
Dopo aver fatto clic sul pulsante con l'azione Traduci modulo assegnata, il testo della richiesta appare in tedesco.
L’azione Messaggio crea finestre pop-up con messaggi personalizzati nelle Soluzioni in modo che si possa fornire agli operatori:
-
Avvertenze specifiche
-
Messaggi di errore
-
Informazione
-
Domande
È possibile assegnare valori fissi alle azioni Acquisizione e Messaggio o connettersi a origini dati dinamiche. È possibile salvare le risposte ai messaggi ("OK", "Annulla", "Sì" o "No") come variabili. È inoltre possibile utilizzare Messaggi come strumenti di debug quando si progettano e si testano i moduli mostrando i risultati delle funzioni nei messaggi.
I messaggi contengono simboli grafici corrispondenti a diversi messaggi:
-
Informazione
-
Errori
-
Avvertimenti
-
Domande
Aggiungi messaggi con l’azione Messaggi per evitare confusione e informare gli operatori degli errori di elaborazione dei dati durante l'esecuzione delle soluzioni.
Questa azione assegna un nuovo valore alla variabile selezionata.
Di solito le variabili ottengono i loro valori mediante l'azione Usa filtro dati (disponibile in Automation Builder), la quale estrarrà i campi dai dati ricevuti e li mapperà sulle variabili. Potrebbe anche essere necessario impostare manualmente i valori delle variabili, di solito per finalità di risoluzione dei problemi. In Automation Builder, i valori delle variabili non vengono ricordati da un trigger all'altro, ma vengono conservati mentre viene elaborato lo stesso trigger.
Il gruppo Variabile definisce il nome di variabile e il suo valore.
-
Nome: nome di variabile che dovrebbe memorizzare il valore modificato.
-
Valore: valore da impostare come variabile. Può essere definito manualmente oppure dinamicamente usando una variabile esistente o appena creata.
Questa azione salva i valori di una o più variabili in un file di dati associato.
Nel modulo NiceLabel Automation, questa azione consente lo scambio di dati tra trigger. Per rileggere i dati nel trigger, usare l'azione Carica dati variabili.
Suggerimento
I valori vengono salvati in un file CSV con la prima riga che contiene i nomi delle variabili. Se le variabili contengono valori con più righe, i caratteri di a capo (CR/LF) vengono codificati come \n\r
.
Il gruppo Impostazioni definisce il nome del file.
-
Nome del file: file di dati in cui salvare i dati variabili. Se il nome è hardcoded, i valori vengono salvati sempre nello stesso file di dati.
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Il gruppo Se il file esiste mette a disposizione ulteriori opzioni per salvare i valori.
-
Sovrascrivi il file: sovrascrive i dati esistenti con i nuovi dati variabili. Il vecchio contenuto va perduto.
-
Aggiungi dati al file: aggiunge i valori variabili ai file di dati esistenti.
Il gruppo Struttura file definisce i parametri del file di dati delle variabili CSV:
-
Delimitatore: specifica il tipo di delimitatore (tabulazione, punto e virgola, virgola o carattere personalizzato). Il delimitatore è un carattere che separa i valori delle variabili memorizzati.
-
Qualificatore del testo: specifica il carattere che qualifica il contenuto memorizzato come testo.
-
Codifica file: specifica il tipo di codifica file da usare nel file di dati. Automatico definisce automaticamente la codifica. Se necessario, è possibile selezionare il tipo di codifica preferito nell'elenco a discesa.
Suggerimento
UTF-8 è una buona selezione predefinita.
-
Aggiungi nomi di variabili nella prima riga: posiziona il nome della variabile nella prima riga del file.
Il gruppo Variabili definisce le variabili il cui valore va letto dal file di dati. I valori delle variabili esistenti vengono sovrascritti con i valori del file.
-
Tutte le variabili: vengono letti i dati delle variabili di tutte le variabili del file di dati.
-
Variabili selezionate: i dati delle variabili delle variabili elencate vengono letti dal file di dati.
Questa azione carica i valori di una o più variabili dal file di dati associato, così come erano stati salvati dall'azione Salva dati variabile . Usare questa azione per scambiare i dati tra i trigger. È possibile caricare una variabile particolare o tutte le variabili memorizzate nel file di dati.
Il gruppo Impostazioni definisce il nome del file.
-
Nome del file: specifica il file dei dati delle variabili da cui eseguire il caricamento. Se il nome è hardcoded, i valori vengono caricati sempre dallo stesso file.
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Le impostazioni del gruppo Struttura file devono riflettere la struttura del file salvato dall'azione Salvare i valori delle variabili.
-
Delimitatore: specifica il tipo di delimitatore (tabulazione, punto e virgola, virgola o carattere personalizzato). Il delimitatore è un carattere che separa i valori.
-
Qualificatore del testo: specifica il carattere che qualifica il contenuto come testo.
-
Codifica file: specifica il tipo di codifica di caratteri usato nel file di dati. Automatico definisce automaticamente la codifica. Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
Suggerimento
UTF-8 è una buona selezione predefinita.
Il gruppo Variabili definisce le variabili i cui valori vanno caricati dal file di dati.
-
Tutte le variabili: specifica tutte le variabili definite nel file di dati da leggere.
-
Variabili selezionate: specifica la selezione di singole variabili che devono essere lette dal file di dati.
Questa azione definisce il modo in cui devono essere formattati i valori delle variabili selezionate.
Le azioni di manipolazione delle stringhe più comuni sono: eliminazione di spazi iniziali e finali, ricerca e sostituzione di caratteri ed eliminazione di virgolette di apertura e chiusura.
Spesso questa funzionalità è necessaria se un trigger riceve un file di dati non strutturato o vecchi dati. in questi casi, i dati devono essere analizzati mediante il filtro Dati non strutturati. L'azione Manipolazione stringa consente di definire il valore dei dati.
Nota
Se questa azione non fornisce una capacità di manipolazione delle stringhe sufficiente per un caso particolare, usare l'azione Esegui script invece di manipolare i dati usando gli script Visual Basic Script o Python.
Il gruppo Variabili definisce le variabili di cui si desidera formattare i valori.
-
Tutte le variabili: specifica tutte le variabili definite in un file di dati da formattare.
-
Variabili selezionate: specifica una serie di variabili da formattare a partire dal file di dati.
Il gruppo Formatta testo definisce le funzioni di manipolazione della stringa che si applicano alle variabili o ai campi selezionati. Si possono usare funzioni multiple. Le funzioni si applicano nello stesso ordine visibile nell'editor, dall'alto verso il basso.
-
Cancella spazi all'inizio: elimina tutti i caratteri spazio (codice decimale ASCII 32) dall'inizio della stringa.
-
Cancella spazi alla fine: elimina tutti i caratteri spazio (valore decimale ASCII 32) dalla fine della stringa.
-
Cancella caratteri di apertura e chiusura: elimina la prima occorrenza dell'apertura selezionata e i caratteri di chiusura presenti nella stringa.
Esempio 100. Esempio
se si usa "{" come carattere di apertura e "}" come carattere di chiusura, la stringa di input
{{selection}}
viene convertita in{selection}
.
-
Cerca e sostituisci: esegue la funzione di ricerca e sostituzione standard in base ai valori specificati per cerca e Sostituisci con. Sono supportate le espressioni regolari.
Nota
Sono presenti diverse implementazioni delle espressioni regolari. NiceLabel 10 usa la sintassi .NET Framework per le espressioni regolari. Per ulteriori informazioni, consultare la knowledge base, articolo KB250.
-
Sostituisce caratteri non stampabili con spazi: sostituisce tutti i caratteri di controllo presenti nella stringa con il carattere "spazio" (codice decimale ASCII 32). I caratteri non stampabili sono caratteri con valori ASCII decimali compresi tra 0–31 e 127–159.
-
Cancella caratteri non stampabili: cancella tutti i caratteri di controllo della stringa. I caratteri non stampabili sono caratteri con valori ASCII decimali compresi tra 0–31 e 127–159.
-
Decodifica caratteri speciali: decodifica i caratteri (o i codici di controllo) che non sono disponibili sulla tastiera, come Ritorno a capo o Avanzamento riga. NiceLabel 10 usa una notazione per codificare caratteri in forma leggibile, come <CR> per Ritorno a capo e <LF> per Avanzamento riga. Questa opzione converte i caratteri speciali dalla sintassi NiceLabel in caratteri binari veri e propri.
Esempio 101. Esempio
quando si ricevono i dati "<CR><LF>", Desktop Designer li usa come stringa normale da 8 caratteri. Sarà necessario attivare questa opzione per interpretare e usare i dati ricevuti come due caratteri binari
CR
(Ritorno a capo – codice ASCII 13) eLF
(Avanzamento riga – codice ASCII 10).
-
Cerca ed elimina tutto prima: trova la stringa fornita ed elimina tutti i caratteri che precedono la stringa definita. La stringa può anche essere eliminata.
-
Cerca ed elimina tutto dopo: trova la stringa fornita ed elimina tutti i caratteri che seguono la stringa definita. La stringa può anche essere eliminata.
Questa azione invia i comandi SQL a un server SQL connesso e raccoglie i risultati. Usare i comandi SELECT, INSERT, UPDATE e DELETE.
Usare l'azione Esegui istruzione SQL per raggiungere questi due obiettivi:
-
Ottenere dati aggiuntivi da un database: Si desidera stampare etichette con i dati del database, ma non con tutti i valori richiesti. Ad esempio, solo i valori per
ID prodotto
eDescrizione
, ma non perPrezzo
. Creare un'istruzione SQL per cercare i valori perPrezzo
nel database SQL.SELECT Price FROM Products WHERE ID = :(Product ID)
L'
ID
è il campo nel database,Product ID
è una variabile definita nel trigger.
-
Aggiornare o eliminare i record di un database: Dopo che le etichette sono state stampate, aggiornare i record del database e informare il sistema che i record specifici sono già stati elaborati. Esempio di codice SQL: Impostare il valore del campo di tabella
AlreadyPrinted
suTrue
per il record elaborato correntemente.UPDATE Products SET AlreadyPrinted = True WHERE ID = :(Product ID)
Oppure, eliminare il record corrente da un database, in quanto esso non è più necessario.
DELETE FROM Products WHERE ID = :(Product ID)
L'
ID
è il campo nel database,Product ID
è una variabile definita nel trigger.
Nota
Per usare il valore di una variabile all'interno dell'istruzione SQL è necessario inserire i due punti (:) davanti al suo nome. Questo segnala che i nomi di una variabile seguono.
Importante
Quando si crea la soluzione con una connessione al database, usare le variabili prompt sulle etichette invece dei campi del database.
Utilizzare gli stessi nomi per le variabili prompt definite per i campi del database, per esempio:
Campo del database: food_products_1c.ProdCode
Variabile prompt sull’etichetta: ProdCode
NiceLabel quindi mappa automaticamente le variabili corrispondenti con i campi del database.
Il gruppo Connessione al database definisce la connessione al database che sarà usata per l'istruzione.
Suggerimento
Prima di poter inviare l'istruzione SQL a un database, impostare la connessione ad esso. Fare clic sul pulsante Definisci e seguire le istruzioni visualizzate sullo schermo. È possibile connettersi a un'origine dati controllabile con i comandi SQL, quindi non è possibile usare file di testo (CSV) o file Excel.
Il gruppo Istruzione SQL definisce un'istruzione o una query SQL da eseguire.
Suggerimento
Le istruzioni di Data Manipulation Language (DML) sono consentite per eseguire query sulle tabelle di database esistenti.
Usare istruzioni SQL standard, come SELECT, INSERT, DELETE e UPDATE, tra cui unioni, funzioni e parole chiave. Le istruzioni del linguaggio DDL usate per creare database e tabelle (CREATE DATABASE, CREATE TABLE) o per eliminarli (DROP TABLE) non sono consentite.
-
Prova: apre la sezione Anteprima dati. L'opzione Simula esecuzione (selezionata per impostazione predefinita) prova l'esecuzione delle istruzioni SQL. Fare clic su Esegui per eseguire la simulazione.
Suggerimento
La sezione Anteprima dati consente di provare l'esecuzione dell'istruzione SQL su un set di dati live. Per proteggere i dati contro gli aggiornamenti accidentali, assicurarsi che l'opzione Simula esecuzione sia attivata. Le istruzioni INSERT, DELETE e UPDATE verranno aggiornate. Ciò consente di ottenere informazioni su quanti record saranno interessati, dopodiché tutte le transazioni verranno invertite.
Se si usano variabili nell'istruzione SQL, sarà possibile immettere i loro valori per l'esecuzione del test.
-
Inserisci origine dati: inserisce le variabili predefinite o appena create in un'istruzione SQL.
-
Esporta/Importa: consente l'esportazione e l'importazione delle istruzioni SQL in/da un file esterno.
-
Modalità di esecuzione: specifica la modalità di esecuzione esplicita dell'istruzione SQL.
Suggerimento
Nei casi di query SQL complesse, diventa sempre più difficile determinare automaticamente l'azione presupposta. Se la logica incorporata evidenzia dei problemi di identificazione dell'intento, selezionare manualmente l'azione principale.
-
Automatico: determina automaticamente l'azione.
-
Restituisce un insieme di record (SELECT): riceve il set di dati con i record.
-
Non restituisce il set di record (INSERT, DELETE, UPDATE): usare questa opzione se si sta eseguendo una query che non restituisce i record. Inserire nuovi record, eliminare o aggiornare i record esistenti. Il risultato è una risposta di stato la quale indica che il numero di righe è stato interessato dalla query.
-
-
Timeout esecuzione: consente di definire il ritardo di invio dei comandi al server SQL. Utilizzare il timeout di esecuzione se si inviano più comandi SQL consecutivi che richiedono tempo di elaborazione più lungo.
Digitare la durata del timeout richiesta in secondi. Per impostazione predefinita, la durata del timeout di esecuzione è di 60 sec. Se si desidera che il fornitore del database definisca il timeout, digitare 0 s.
Il gruppo Risultato consente di impostare il modo in cui deve venire memorizzato il risultato dell'istruzione SQL e di definire l'iterazione dell'azione.
-
Salva risultato su variabile: seleziona o crea una variabile per memorizzare il risultato dell'istruzione SQL. Questa opzione dipende dalla Modalità di esecuzione selezionata.
-
Risultato dell'istruzione SELECT. Dopo aver eseguito un'istruzione SELECT, il risultato è un set di dati di record. Si riceve un contenuto di testo in formato CSV. La prima riga contiene i nomi di campo restituiti in un risultato. Le righe successive contengono record.
Per estrarre i valori dal set di dati restituito e usarli in altre azioni, definire ed eseguire l'azione Usa filtro dati sul contenuto di questa variabile (questa azione è disponibile in Automation Builder).
-
Risultato delle istruzioni INSERT, DELETE e UPDATE. Se si usano le istruzioni INSERT, DELETE e UPDATE, il risultato è un numero che indica il numero di record interessati nella tabella.
-
-
Ripeti per ciascun record. Se l'opzione è attivata, NiceLabel aggiunge automaticamente una nuova azione Per tutti i record. Scoprire di più su questa azione in un argomento dedicato.
Tutte le azioni nidificate sono ripetute per ciascun record che è stato restituito utilizzando l'istruzione SQL.
Nota
La mappatura automatica è attivata. L'azione Per tutti i record non può essere eliminata.
Campo del database:
food_products_1c.ProdCode
Variabile prompt sull’etichetta:
ProdCode
Il gruppo Riprova in caso di errore consente di configurare l'azione per riprovare in continuazione a stabilire la connessione a un server di database nel caso in cui il primo tentativo non abbia successo. Se l'azione non riesce a connettersi entro il numero di tentativi definito, viene segnalato un errore.
-
Tentativi di prova: specifica il numero di tentativi di connessione al server di database.
-
Intervallo tentativi: specifica il lasso di tempo che trascorre tra singoli tentativi.
Avvertimento
Non inserire l'oggetto Tabella del database nel modulo di stampa se si utilizza l'azione Esegui istruzione SQL. I risultati potrebbero essere sbagliati.
Esempio 103. Esempio
Se si desidera stampare etichette con i dati del database food_products_1c
, ma solo i record con valore di campo predefinitoUseBy
.
Definire il valore UseBy
con variabile ProdUser
. In questo caso, il valore ProdUser è "3".
Dopo che ogni etichetta è stata stampata, NiceLabel scrive i valori del database in un file di testo sul disco. Utilizzare le seguenti azioni:
Vengono stampate solo le etichette il cui valore UseBy
è uguale a "3" e i valori vengono scritti in un file di testo:
Questa azione reindirizza la tabella di database specificata.
Il gruppo Tabella seleziona la tabella di database da rileggere.
-
Tabella: definisce una tabella esistente da rileggere oppure ne crea una nuova mediante Database guidato passo-passo.
Questa azione legge i dati da un file di testo CSV formattato e li importa in un database SQL.
Nota
Prima di usare questa azione, deve essere già impostata una connessione al database SQL. L'azione non funziona con i database basati su file, come quelli di Microsoft Access, né con i file di dati come quelli di Microsoft Excel, né con i file di testo normale. Usare un database SQL basato sul server, come Microsoft SQL Server.
A questa azione si applicano le regole seguenti:
-
La tabella deve già essere presente all'interno del database SQL.
-
La tabella deve contenere una CHIAVE PRIMARIA.
-
La prima riga di un file di testo deve definire i nomi di campo.
-
I nomi di campo del file di testo devono corrispondere ai nomi di campo della tabella di database.
-
Se il file di testo non fornisce un valore per qualche campo, nel database viene scritta l'indicazione NULL. Se il campo non accetta valori NULL, viene scritta una stringa vuota ("").
-
I valori di impostazione per i campi a incremento automatico vengono ignorati. Il database fornisce il valore per tale campo.
-
Se il valore del file di testo non corrisponde alla struttura del campo, l'azione viene annullata e viene visualizzato un messaggio di errore. Ad esempio, quando si tenta di immettere un valore alfanumerico in un campo numerico.
-
Se si filtrano i record sul modulo e si visualizzano solo quelli corrispondenti a una determinata condizione, è possibile importare solo i record che non forniscono valore per il campo del filtro oppure che forniscono lo stesso valore per il filtro definito con il modulo.
-
Sono consentiti solo i filtri con la condizione "uguale", non "maggiore di", "inferiore a", "contiene" o simili.
-
Se il file di testo contiene campi non definiti nel database SQL, l'importazione li ignorerà. Saranno importati solo i campi conosciuti.
Il gruppo Impostazioni seleziona la tabella.
-
Tabella definisce una tabella predefinita dal menu a discesa oppure ne crea una nuova mediante Database guidato passo-passo.
Il gruppo Struttura testo file specifica i parametri del database di testo:
-
Delimitatore: specifica il tipo di delimitatore nel file di dati. Selezionare un delimitatore predefinito oppure crearne uno personalizzato.
-
Qualificatore del testo: specifica il qualificatore del testo. Selezionare un delimitatore predefinito oppure inserirne uno personalizzato.
-
Codifica file: specifica il tipo di codifica di caratteri usato nel file di dati. Automatico definisce automaticamente la codifica. Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
Questa azione invia i dati a qualsiasi dispositivo esterno che supporti una connessione TCP/IP su un numero di porta predefinito.
Invia dati alla porta TCP/IP stabilisce la connessione a un dispositivo, invia i dati e interrompe la connessione. La connessione e la comunicazione sono disciplinati dall'handshake tra client e server al momento dell'avvio o dell'interruzione della connessione TCP.
Il gruppo Impostazioni connessione consente di impostare i dettagli della connessione.
-
Rispondi al mittente: consente di inviare una risposta diretta al socket dal quale hanno origine i dati del trigger. Usare questa opzione per fornire feedback sul processo di stampa.
Nota
Questa opzione è disponibile in NiceLabel Automation.
I prerequisiti per l'impostazione Rispondi al mittente sono:
-
L'utente remoto non chiude il canale di comunicazione, una volta che il messaggio viene consegnato.
-
L’azione Invia dati alla porta TCP/IP è usata all'interno del trigger Server TCP/IP.
-
Non configurare l’evento di esecuzione nel trigger Server TCP/IP come Quando il client si disconnette.
-
-
Destinazione (Indirizzo IP:porta): indirizzo di destinazione e porta del server TCP/IP. Impostare come hardcoded i parametri di connessione e usare il nome host o l'indirizzo IP fisso oppure usare parametri di connessione variabili facendo clic sulla freccia destra e selezionando una variabile predefinita. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel Automation.
Esempio 107. Esempio
Se il valore
hostname
della variabile fornisce il nome del server TCP/IP e il valoreport
della variabile fornisce il numero di porta, immettere il seguente parametro per la destinazione:[hostname]:[port]
-
Ritardo disconnessione: prolunga la connessione con il socket di destinazione per gli intervalli di tempo definiti dopo che i dati sono stati consegnati. L'elaborazione dei dati richiede un tempo maggiore per l'elaborazione dei dati. Inserire manualmente il valore del ritardo oppure fare clic sulle frecce per aumentarlo o diminuirlo.
-
Salva risposta dati in una variabile: seleziona o crea una variabile che memorizza la risposta del server. Qualsiasi dato ricevuto dal server TCP/IP dopo che il "ritardo disconnessione" è memorizzato in questa variabile.
Nota
L’azione Invia dati alla porta TCP/IP viene eseguita su Web Printing Server e non su Web Printing Client.
Se si utilizza Invia dati alla porta TCP/IP in NiceLabel Web Client e si desidera eseguire localmente (ignorando il Web Printing Server), aggiungere il prefisso "LOCAL_" al nome dell'azione.
Il gruppo Contenuto definisce il contenuto da inviare a un server TCP/IP.
Suggerimento
È possibile usare contenuto fisso, una miscela di contenuto fisso e variabile oppure solo contenuto variabile. Per immettere contenuto variabile, fare clic sul pulsante con la freccia a destra dell'area dei dati e inserire una variabile dall'elenco. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel Automation.
-
Dati: contenuto da inviare in uscita.
-
Codifica: tipo di codifica per i dati inviati. Automatico definisce automaticamente la codifica. Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
Questa azione invia i dati a una porta seriale. Consente di comunicare con dispositivi della porta seriale esterna.
Suggerimento
Assicurarsi che le impostazioni della porta corrispondano a entrambe le estremità, nell'azione configurata e nel dispositivo della porta seriale. La porta seriale può essere usata da un'unica applicazione nel sistema. Per usare con successo la porta da questa azione, nessun'altra applicazione può usare la porta contemporaneamente, nemmeno un driver della stampante.
Il gruppo Porta definisce la porta seriale.
-
Nome porta: nome della porta alla quale si connette il dispositivo esterno. Può trattarsi di una porta COM hardware oppure di una porta COM virtuale.
Il gruppo Impostazione porta definisce le impostazioni di connessione aggiuntive della porta.
-
Bit al secondo: velocità usata dal dispositivo esterno per comunicare con il PC. L'alias tipico usato con l'impostazione è "velocità di trasmissione". Selezionare il valore dal menu a discesa.
-
Bit di dati: numero di bit di dati in ciascun carattere. 8 bit di dati sono usati praticamente sempre nei dispositivi più recenti. Selezionare il valore dal menu a discesa.
-
Parità: metodo di rilevamento degli errori in una trasmissione. L'impostazione di parità più comune è "nessuno", con il rilevamento degli errori gestito da un protocollo di comunicazione (controllo di flusso). Selezionare il valore dal menu a discesa.
-
Bit di stop: blocca i bit inviati alla fine di ciascun carattere, consentendo all'hardware del segnale ricevente di rilevare la fine di un carattere e di risincronizzarlo con il flusso di caratteri. Di solito i dispositivi elettronici utilizzano un singolo bit di stop. Selezionare il valore dal menu a discesa.
-
Controllo flusso: la porta seriale può usare segnali di interfaccia per effettuare una pausa e riprendere la trasmissione dei dati.
Il gruppo Contenuto definisce il contenuto da inviare alla porta seriale.
Suggerimento
È consentito contenuto fisso, una miscela di contenuto fisso e variabile oppure solo contenuto variabile. Per immettere contenuto variabile, fare clic sul pulsante con la freccia a destra dell'area dei dati e inserire una variabile dall'elenco. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel Automation.
-
Dati: contenuto da inviare in uscita.
Questa azione raccoglie i dati ricevuti tramite la porta seriale (RS-232) e li salva in una variabile selezionata. Usare questa azione per comunicare con dispositivi muniti di una porta seriale esterna.
Il gruppo Porta definisce la porta seriale.
-
Nome porta: nome della porta alla quale si connette un dispositivo esterno. Può trattarsi di una porta COM hardware oppure di una porta COM virtuale.
Il gruppo Impostazione porta definisce le impostazioni di connessione aggiuntive della porta.
-
Bit al secondo: velocità usata da un dispositivo esterno per comunicare con il PC. L'alias tipico usato con l'impostazione è "velocità di trasmissione".
-
Bit di dati: specifica il numero di bit di dati in ciascun carattere. 8 bit di dati sono usati praticamente sempre nei dispositivi più recenti.
-
Parità: specifica il metodo di rilevamento degli errori in una trasmissione. L'impostazione di parità più comune è "nessuno", con il rilevamento degli errori gestito da un protocollo di comunicazione (controllo di flusso).
-
Bit di stop: blocca i bit inviati alla fine di ciascun carattere, consentendo all'hardware del segnale ricevente di rilevare la fine di un carattere e di risincronizzarlo con il flusso di caratteri. Di solito i dispositivi elettronici utilizzano un singolo bit di stop.
-
Controllo flusso: la porta seriale può usare segnali di interfaccia per effettuare una pausa e riprendere la trasmissione dei dati.
Esempio 110. Esempio
Un dispositivo lento potrebbe richiedere l'esecuzione dell'handshaking con la porta seriale per indicare che i dati devono essere messi in pausa mentre i processi del dispositivo ricevevano i dati.
Il gruppo Opzioni include le seguenti impostazioni:
-
Ritardo lettura: ritardo opzionale quando si leggono i dati dalla porta seriale. Dopo il ritardo viene letto l'intero contenuto del buffer della porta seriale. Inserire manualmente il ritardo oppure fare clic sulle frecce per aumentare o diminuire il valore.
-
Invia dati di inizializzazione: specifica la stringa che viene inviata alla porta seriale selezionata prima che i dati vengano letti. Questa opzione attiva l'azione di inizializzazione del dispositivo per fornire i dati. L'opzione può essere usata anche per inviare una domanda specifica al dispositivo e per ricevere una risposta specifica. Fare clic sul pulsante freccia per immettere caratteri speciali.
Il gruppo Estrazione dati definisce il modo in cui vengono estratte le parti definite dei dati ricevuti.
-
Posizione di avvio: posizione iniziale per l'estrazione dei dati.
-
Posizione finale: posizione finale per l'estrazione dei dati.
Il gruppo Risultato definisce una variabile per la memorizzazione dei dati.
-
Salva dati su variabile: selezionare o creare una variabile per memorizzare i dati ricevuti.
Questa azione invia i dati a una stampante selezionata. Essa consente di inviare flussi della stampante pregenerati a qualsiasi stampante disponibile.
Il modulo NiceLabel Automation utilizza il driver della stampante installato in modalità pass-through per poter inviare i dati alla porta di destinazione, come LPT, COM, TCP/IP o USB, alla quale è connessa la stampante.
Nota
Scenario possibile. I dati ricevuti dal trigger devono essere stampati sulla stessa stampante di rete, ma su modelli di etichetta diversi (file di etichetta .NLBL). La stampante può accettare i dati provenienti dalle varie workstation e di solito stampa i processi nell'ordine in cui vengono ricevuti. Il modulo Automation Builder invia ciascun modello di etichetta in un processo di stampa separato, consentendo a un'altra workstation di inserire il suo processo tra i processi creati nel modulo Automation Builder. Invece di inviare ciascun processo separatamente alla stampante, unire tutti i processi delle etichette (usando l'azione Reindirizza stampa su file), quindi inviare alla stampante un unico e "grande" processo di stampa.
Il gruppo Stampante seleziona la stampante.
-
Nome della stampante: nome della stampante alla quale inviare i dati. Selezionare la stampante nell'elenco a discesa dei driver stampante installati localmente, immettere un nome stampante personalizzato oppure definirlo dinamicamente usando una variabile esistente o appena creata.
Il gruppo Origine dati definisce il contenuto da inviare alla stampante.
-
Utilizza dati ricevuti dal trigger: vengono usati i dati ricevuti dal trigger. In questo caso, si desidera che il flusso della stampante ricevuto venga usato come input per il filtro. L'obiettivo consiste nel reindirizzarlo a una stampante senza apportare modifiche. Lo stesso risultato può essere ottenuto attivando la variabile interna
DataFileName
e usando il contenuto del file al quale essa si riferisce. Per ulteriori informazioni, vedere la sezione Uso di valori composti nella guida dell'utente di NiceLabel Automation. -
Nome del file: percorso e nome del file del contenente un flusso della stampante. Il contenuto del file specificato viene inviato a una stampante. Selezionare Origine dati per definire dinamicamente il nome del file mediante un valore di variabile.
-
Variabile: variabile (esistente o nuova) contenente il flusso della stampante.
-
Personalizzato: definisce il contenuto personalizzato da inviare a una stampante. È consentito contenuto fisso, una miscela di contenuto fisso e variabile oppure solo contenuto variabile. Per immettere contenuto variabile, fare clic sul pulsante con la freccia a destra dell'area dei dati e inserire una variabile dall'elenco. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel 10.
Questa azione invia i dati al server Web di destinazione usando il metodo HTTP selezionato. Sono consentiti gli schemi URI HTTP e HTTPS.
HTTP funziona come un protocollo di risposta alla richiesta nel modello di elaborazione client–server. In questa azione, funge da client che comunica con un server remoto. Questa azione invia a un server un messaggio di richiesta HTTP selezionato. Il server restituisce un messaggio di risposta, il quale può contenere informazioni sullo stato di completamento della richiesta e può fornire anche il contenuto richiesto nel corpo del messaggio.
Il gruppo Impostazioni connessione imposta i parametri di connessione.
Nota
Questa operazione supporta il protocollo Internet versione 6 (IPv6).
-
Destinazione: indirizzo, porta e destinazione (percorso) del server Web.
Nota
Se un server Web viene eseguito sulla porta 80 predefinita, ignorare il numero di porta. Impostare come hardcoded i parametri di connessione e usare un nome host o un indirizzo IP fisso. Usare un valore di variabile per definire dinamicamente questa opzione. Per ulteriori informazioni, vedere la sezione Uso di valori composti nella guida dell'utente di NiceLabel Automation.
Esempio 113. Esempio
Se il valore
hostname
della variabile fornisce il nome del server Web e il valoreport
della variabile fornisce il numero di porta, è possibile immettere i seguenti dati per la destinazione:[hostname]:[port]
-
Metodo richiesta: metodi di richiesta disponibili.
-
Timeout: durata del timeout (in ms) durante il quale è necessario stabilire la connessione al server e la risposta ricevuta.
-
Salva lo stato della risposta su variabile: variabile per memorizzare il codice di stato ricevuto dal server.
Suggerimento
Il codice di stato nell'intervallo 2XX è un codice di successo. La risposta comune "OK" è il codice 200. I codici 5XX sono errori del server.
-
Salva risposta dati in una variabile: variabile per memorizzare i dati ricevuti dal server.
Il gruppo Autenticazione consente di proteggere la connessione al server Web.
-
Abilita autenticazione di base: consente di immettere le credenziali necessarie per connettersi al server Web. Nome utente e password possono essere fissi o forniti mediante una variabile.
L'autenticazione base (BA) HTTP utilizza intestazioni HTTP standard statiche. Il meccanismo BA non fornisce nessuna protezione della riservatezza per le credenziali trasmesse. Esse vengono semplicemente codificate con Base64 in transito, ma non crittografate o contrassegnate dal simbolo hash in alcun modo. L'autenticazione base va usata su HTTPS.
-
Mostra password: disabilita il mascheramento dei caratteri della password.
Nota
L’azione Richiesta HTTP viene eseguita su Web Printing Server e non su Web Printing Client.
Se si utilizza Richiesta HTTP in NiceLabel Web Client e si desidera eseguire localmente (ignorando il Web Printing Server), aggiungere il prefisso "LOCAL_" al nome dell'azione.
Il gruppo Contenuto definisce il contenuto da inviare a un server Web.
-
Dati: contenuto da inviare in uscita. È consentito contenuto fisso, una miscela di contenuto fisso e variabile oppure solo contenuto variabile. Per immettere contenuto variabile, fare clic sul pulsante con la freccia a destra dell'area dei dati e inserire la variabile dall'elenco. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel 10.
-
Codifica: tipo di codifica per i dati inviati.
Suggerimento
Automatico definisce automaticamente la codifica. Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
-
Tipo: proprietà del tipo di contenuto del messaggio HTTP. Se non è selezionato nessun tipo, verrà usato il tipo predefinito
application/x-www-form-urlencoded
. Se non è elencato un tipo appropriato, definirne uno personalizzato o impostare una variabile che lo definirebbe automaticamente.
Le Intestazioni HTTP aggiuntive sono richieste da determinati server HTTP (specialmente per i servizi REST).
Nota
L'azione Richiesta HTTP utilizza già una chiave di sottoscrizione incorporata, quindi non è necessario inserire il valore Ocp-Apim-Subscription-Key in Intestazioni HTTP aggiuntive.
È necessario fornire il valore Ocp-Apim-Subscription-Key se si effettua una chiamata all'API Cloud da una non-NiceLabelapplicazione.
-
Intestazioni aggiuntive: intestazioni hardcoded o intestazioni ottenute da valori variabili. Per accedere alle variabili, fare clic sul piccolo pulsante freccia sul lato destro dell'area di testo. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel 10.
Alcuni server HTTP (specialmente per i servizi REST) richiedono l'inclusione nel messaggio di intestazioni HTTP personalizzate. Questa sezione consente di specificare l'intestazione HTTP necessaria.
Le intestazioni HTTP vanno immesse usando la sintassi seguente:
header field name: header field value
Ad esempio, per usare i nomi di campo di intestazione
Accept
,User-Agent
eContent-Type
, si potrebbe usare quanto segue:Accept: application/json; charset=utf-8 User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.63 Safari/537.36 Content-Type: application/json; charset=UTF-8
È possibile impostare come hardcoded i nomi di campo dell'intestazione oppure ricavarne i valori dalle variabili di trigger. È possibile usare tutti i campi di intestazione personalizzati desiderati. A tal fine, è sufficiente posizionare ciascun campo di intestazione in una nuova riga.
Nota
Le intestazioni HTTP immesse escluderanno le intestazioni già definite altrove nelle proprietà dell'azione, come Content-Type.
Servizio Web è un metodo di comunicazione tra due dispositivi elettronici o istanze di software. Servizio web è definito come uno standard di scambio di dati. Esso utilizza il formato XML per taggare i dati, il protocollo SOAP è usato per trasferire i dati e il linguaggio WSDL per descrivere i servizi disponibili.
Questa azione si collega a un servizio Web remoto ed esegue i metodi su di esso. I metodi possono essere descritti come azioni che vengono pubblicate sul servizio Web. L'azione invia valori in entrata al metodo selezionato nel servizio Web remoto, raccoglie il risultato e lo salva nelle variabili selezionate.
Dopo aver importato il WSDL e aggiunto un riferimento al servizio Web, i suoi metodi vengono elencati nella casella combinata Metodo.
Nota
È possibile trasferire i tipi semplici sul servizio Web, come stringa, numero intero, booleano, ma non i tipi complessi. Il WSDL deve contenere una singola associazione.
Si prevede di stampare etichette di prodotti. Il trigger riceverebbe solo un segmento dei dati necessari. Es.: il trigger riceve il valore per ID prodotto
e le variabili Descrizione
, ma non per Prezzo
. Le informazioni sul prezzo sono disponibili in un database a parte, accessibile tramite la chiamata al servizio Web. Servizio Web definisce la funzione usando una definizione WSDL. Ad esempio, l'input della funzione è ID prodotto
e il suo output è Prezzo
. L'azione servizio Web invia l'ID prodotto
al servizio Web. Esso viene eseguito e genera una consultazione interna nel proprio database e, di conseguenza, fornisce la corrispondenza Prezzo
. L'azione salva il risultato in una variabile, consentendo di utilizzarlo successivamente sull'etichetta.
Il gruppo Definizione Servizio Web include le seguenti impostazioni:
Nota
Questa operazione supporta il protocollo Internet versione 6 (IPv6).
-
WSDL: posizione della definizione WSDL.
Di solito la definizione WSDL viene fornita dal servizio Web stesso. Normalmente, si immette il collegamento in WSDL e si fa clic su Importa per leggere la definizione. Per qualsiasi problema di recupero della definizione WSDL dalla risorsa online, salvarla in un file e immettere il percorso con il nome file per caricare i metodi dallo stesso. rileva automaticamente se il servizio Web remoto usa un documento o la sintassi RPC e se comunica correttamente.
-
Indirizzo: indirizzo in cui viene pubblicato il servizio Web.
Inizialmente, queste informazioni vengono recuperate dal WSDL, ma possono essere aggiornate prima dell'esecuzione dell'operazione. Questa possibilità risulta utile per gli ambienti di sviluppo/test/produzione divisi, in cui viene usato lo stesso elenco di azioni, ma con nomi di server diversi sui quali vengono eseguiti i servizi Web.
È consentito contenuto fisso, una miscela di contenuto fisso e variabile oppure solo contenuto variabile. Per immettere contenuto variabile, fare clic sul pulsante con la freccia a destra dell'area dei dati e inserire la variabile dall'elenco. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel 10.
-
Metodo: metodi (funzioni) che sono disponibili per un servizio Web selezionato. L'elenco viene automaticamente popolato dalla definizione WSDL.
-
Parametri: variabili di input e output per il metodo (funzione) selezionato.
I parametri in entrata prevedono un input. Per eseguire test e risolvere problemi è possibile immettere un valore fisso e visualizzare un'anteprima del risultato sullo schermo. Normalmente, si selezionerebbe una variabile per il parametro in entrata. Il valore di tale variabile sarà usato come parametro di input. Il parametro in uscita fornisce il risultato della funzione. È necessario selezionare la variabile che memorizzerà il risultato.
-
Timeout: timeout dopo il quale viene stabilita la connessione a un server.
Nota
L’azione Servizio Web viene eseguita su Web Printing Server e non su Web Printing Client.
Se si utilizza Servizio Web in NiceLabel Web Client e si desidera eseguire localmente (ignorando il Web Printing Server), aggiungere il prefisso "LOCAL_" al nome dell'azione.
Autenticazione consente l'autenticazione di base dell'utente. Questa opzione definisce le credenziali dell'utente necessarie per stabilire una chiamata in uscita a un servizio Web remoto.
-
Abilita autenticazione di base: abilita la definizione di nome utente e password che possono essere immessi manualmente o definiti da valori variabili. Selezionare Origini dati per selezionare o creare le variabili.
-
Mostra password: visualizza i caratteri mascherati relativi a nome utente e password.
I dettagli sulla sicurezza sono disponibili nella sezione Protezione dell'accesso ai trigger nella guida dell'utente di NiceLabel Automation.
Il campo Anteprima dati consente di eseguire una prova del servizio Web.
-
Il pulsante Esegui esegue una chiamata al servizio Web.
Invia i valori dei parametri in entrata al servizio Web e fornisce il risultato del parametro in uscita. Usare questa funzionalità per testare l'esecuzione di un servizio Web. È possibile immettere i valori per i parametri in entrata e visualizzare il risultato sullo schermo. Quando si è soddisfatti dell'esecuzione, sostituire il valore fisso immesso per il parametro in entrata con una variabile dall'elenco.
Questa azione salva in un file selezionato il valore della variabile o altri flussi di dati (come i dati binari). Il servizio NiceLabel Automation deve avere accesso in scrittura alla cartella definita.
Il gruppo File definisce il file da aprire.
-
Nome del file: posizione del file da aprire all'interno di questa azione.
Percorso e nome file possono essere hardcoded e ogni volta verrà usato lo stesso file. Se è definito solo un nome file senza percorso, viene usata la cartella con il file di configurazione (.MISX) NiceLabel Automation. È possibile usare il riferimento relativo al nome del file, nel quale la cartella con il file .MISX viene usata come cartella principale.
Origine dati: attiva il nome di file di variabile. Selezionare una variabile contenente il percorso e/o il nome di file oppure combinare più variabili che creano il nome di file. Per ulteriori informazioni, vedere la sezione Uso di valori composti nella guida dell'utente di NiceLabel Automation.
Il gruppo Se il file esiste gestisce le opzioni nel caso in cui il file esista già.
-
Sovrascrivi il file: sovrascrive i dati esistenti con i nuovi dati. Il vecchio contenuto va perduto.
-
Aggiungi dati al file: aggiunge i valori variabili ai file di dati esistenti.
Il gruppo Contenuto definisce quali dati verranno scritti nel file specificato.
-
Utilizza dati ricevuti dal trigger: i dati originali ricevuti dal trigger verranno salvati nel file. In pratica, questa opzione crea una copia dei dati in entrata.
-
Personalizzato: salva il contenuto disponibile nell'area del testo. Sono consentiti valori fissi, valori variabili e caratteri speciali. Per immettere variabili e caratteri speciali, fare clic sul pulsante freccia a destra dell'area di testo. Per ulteriori informazioni, vedere la sezione Combinazione di valori in un oggetto nella guida dell'utente di NiceLabel Automation.
-
Codifica: tipo di codifica per i dati inviati. Automatico definisce automaticamente la codifica. Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
Questa azione legge il contenuto del nome file specificato e lo salva in una variabile. Può essere letto il contenuto di qualsiasi tipo di file, compresi i dati binari.
Di solito, il modulo Automation Builder riceve i dati per la stampa di etichette con un trigger. Es.: se si usa un trigger di file, il suo contenuto viene letto automaticamente e può essere analizzato dai filtri. Tuttavia, potrebbe essere opportuno escludere i filtri per ottenere dei dati esterni. Dopo aver eseguito questa azione e aver memorizzato i dati in una variabile, è possibile usare una qualsiasi delle azioni disponibili per usare i dati.
Questa azione è utile:
-
se si devono combinare i dati ricevuti dal trigger con i dati memorizzati in un file.
Avvertimento
Se si caricano i dati dai file binari (come immagine bitmap o file di stampa), assicurarsi che la variabile per memorizzare il contenuto letto sia definita come variabile binaria.
-
Quando si desidera scambiare i dati tra i trigger. Un trigger prepara i dati e li salva sul file (usando l'azione Salva dati su file), mentre l'altro trigger legge i dati.
Il gruppo File definisce il file dal quale leggere il contenuto.
-
Nome del file: posizione del file da leggere all'interno di questa azione.
Percorso e nome file possono essere hardcoded e ogni volta verrà usato lo stesso file. Se è definito solo un nome file senza percorso, viene usata la cartella con il file di configurazione (.MISX) NiceLabel Automation. È possibile usare il riferimento relativo al nome del file, nel quale la cartella con il file .MISX viene usata come cartella principale.
Origine dati: attiva il nome di file di variabile. Selezionare una variabile contenente il percorso e/o il nome di file oppure combinare più variabili che creano il nome di file. Per ulteriori informazioni, vedere la sezione Uso di valori composti nella guida dell'utente di NiceLabel Automation.
Nota
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Il gruppo Contenuto imposta i dettagli relativi al contenuto del file.
-
Variabile: variabile che memorizza il contenuto del file. È necessario definire almeno una variabile (esistente o appena creata).
-
Codifica: tipo di codifica per i dati inviati. Automatico definisce automaticamente la codifica. Se necessario, selezionare il tipo di codifica preferito dall'elenco a discesa.
Nota
La codifica non può essere selezionata se i dati vengono letti da una variabile binaria. In questo caso, la variabile contiene i dati così come sono.
Il gruppo Riprova in caso di errore definisce come deve continuare l'azione di esecuzione se il file specificato diventa inaccessibile.
Suggerimento
Il modulo Automation Builder potrebbe non essere più in grado di accedere al file, in quanto esso è bloccato da un'altra applicazione. Se un'applicazione scrive ancora i dati sul file selezionato e li tiene bloccati in modalità esclusiva, nessun'altra applicazione può aprirli contemporaneamente, nemmeno per la lettura. Altre cause possibili di nuovi tentativi di azione: il file non esiste (ancora), la cartella non esiste (ancora) oppure l'utente del servizio non dispone dei privilegi di accesso al file.
-
Tentativi di prova: definisce il numero di tentativi di accesso al file. Se il valore è impostato su 0, non viene effettuato nessun nuovo tentativo.
-
Intervallo tentativi: l'intervallo di tempo tra i singoli tentativi, in millisecondi.
Questa azione elimina un file selezionato da un'unità disco.
Il modulo NiceLabel Automation viene eseguito come servizio sotto un account utente Windows definito. Assicurarsi che l'account disponga delle autorizzazioni per eliminare il file in una cartella specificata.
Il gruppo File imposta i dettagli relativi al file.
-
Nome del file: il nome del file da eliminare. Nome del file può essere hardcoded. Origine dati definisce dinamicamente il valore Nome file usando una variabile esistente o appena creata.
Percorso e nome file possono essere hardcoded e ogni volta verrà usato lo stesso file. Se è definito solo un nome file senza percorso, viene usata la cartella con il file di configurazione (.MISX) NiceLabel Automation. È possibile usare il riferimento relativo al nome del file, nel quale la cartella con il file .MISX viene usata come cartella principale.
L'opzione Origine dati attiva il nome di file di variabile. Selezionare un'unica variabile contenente il percorso e/o il nome di file oppure combinare più variabili che creano il nome di file. Per ulteriori informazioni, vedere la sezione Uso di valori composti nella guida dell'utente di NiceLabel Automation.
Nota
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Questa azione apre il browser di sistema per la finestra di dialogo di file o cartelle.
Il gruppo Finestra di dialogo imposta le preferenze di navigazione.
-
Cerca: consente di scegliere tra la ricerca di un file o di una cartella.
-
Filtro: consente di impostare il tipo di file da individuare. Immettere manualmente il tipo di file, definire i filtri usando la finestra di dialogo Definisci filtri file o selezionare Origine dati per determinare dinamicamente il filtro usando un valore di variabile. La finestra di dialogo Definisci filtri file consente all'utente di:
-
Elencare i filtri. Ciascun filtro è identificato con un tipo Nome filtro e Filtro.
-
Gestire i filtri esistenti usando i pulsanti Aggiungi, Elimina, Sposta su e Sposta giù.
Nota
Se si rimuovono tutti i filtri, l'elenco a discesa per la selezione del tipo di file non sarà visualizzato all'apertura della finestra di dialogo.
-
-
Cartella iniziale: imposta la cartella iniziale da aprire con l'azione.
-
Titolo finestra di dialogo: titolo della finestra del visualizzatore file che si apre con l'azione.
-
Consenti file inesistente: consente di cercare un file che non esiste nella cartella specificata. Questa opzione consente di memorizzare il percorso su un file inesistente in una variabile e di utilizzarlo in una serie di azioni. Il file può essere creato in un secondo momento utilizzando altre azioni, come Salva dati su file.
Il gruppo Origine dati output seleziona una variabile per la memorizzazione del percorso di file/cartelle.
-
Salva percorso su: variabile esistente o nuova per il percorso di file/cartelle i cui salvare.
Questa azione esegue più volte tutte le azioni subordinate (nidificate). Tutte le azioni nidificate vengono eseguite in un ciclo per il numero di volte definito dalla differenza tra il valore iniziale e quello finale.
Nota
L'azione Per ciclo avvia la modalità di stampa della sessione: una modalità di ottimizzazione della stampa che stampa tutte le etichette di un ciclo utilizzando un singolo file di processo di stampa. Per ulteriori informazioni, vedere la sezione Stampa della sessione nella Guida dell'utente di NiceLabel Automation.
Il gruppo Impostazioni ciclo include le seguenti opzioni:
-
Valore iniziale: riferimento del punto iniziale dei ciclo. Selezionare Origine dati per definire dinamicamente il valore iniziale mediante un valore di variabile. Selezionare o creare una variabile contenente come inizio un valore numerico.
-
Valore finale: riferimento al punto finale. Selezionare Origine dati per definire dinamicamente il valore iniziale mediante un valore di variabile. Selezionare o creare una variabile contenente come inizio un valore numerico.
Suggerimento
I valori negativi sono consentiti per Valore iniziale e Valore finale.
-
Salva valore ciclo su una variabile: salva il valore del ciclo corrente in una variabile esistente o appena creata. Il valore del ciclo può contenere qualsiasi valore tra il valore iniziale e finale. Salvare il valore per riutilizzarlo in un'altra azione e per identificare l'iterazione corrente.
Questa azione esegue più volte azioni nidificate subordinate. Tutte le azioni nidificate vengono eseguite in un ciclo il numero di volte quanti sono i record presenti nella tabella del modulo con un database connesso.
È possibile utilizzare tutti i record o i record selezionati per eseguire azioni nidificate subordinate.
Il gruppo Impostazioni seleziona i record.
-
Tabella modulo: tabella modulo contenente i record per i quali dovrebbe essere ripetuta un'azione.
-
Usa tutti i record: ripete un'azione per tutti i record di una tabella definita.
-
Usa record selezionati: ripete un'azione solo per i record selezionati.
Se si utilizza l'azione Esegui istruzione SQL con l'opzione abilitata Itera per ogni record, NiceLabel inserisce automaticamente l’azione Per ogni record. Viene visualizzata una nota sulla mappatura automatica delle variabili.
Le variabili prompt sull'etichetta si collegano automaticamente ai campi del database con gli stessi nomi. Consultare le istruzioni su come creare le proprie soluzioni:
Importante
Quando si crea la soluzione con una connessione al database, usare le variabili prompt sulle etichette invece dei campi del database.
Utilizzare gli stessi nomi per le variabili prompt definite per i campi del database, per esempio:
Campo del database: food_products_1c.ProdCode
Variabile prompt sull’etichetta: ProdCode
NiceLabel quindi mappa automaticamente le variabili corrispondenti con i campi del database.
Esempio 121. Esempio
La soluzione è collegata al database. Se si desidera stampare i record selezionati sulle etichette.
Utilizzare l’azione Per ogni record e nidificare le azioni per stampare le etichette. Selezionare l’opzione Utilizza record selezionati.
Selezionare i record nella tabella del database sul modulo di stampa, quindi stampare le etichette.
Questa azione consente di:
-
monitorare gli errori mentre vengono eseguite le azioni
-
eseguire una serie di azioni alternative, se si verifica un errore
L'azione di prova crea i segnaposto Fare e Su errore per le azioni. Tutte le azioni che dovrebbero essere eseguite qualora un trigger si attivi vanno inserite all'interno del segnaposto Fare. Se non viene rilevato nessun errore al momento dell'esecuzione delle azioni dal segnaposto Fare, queste sono le uniche azioni ad essere eseguite. Tuttavia, se si verifica un errore, l'esecuzione di azioni dal segnaposto Fare si interrompe e l'esecuzione passa alle azioni dal segnaposto Su errore.
Esempio 123. Esempio
Se qualsiasi azione nel segnaposto Fare non riesce, l'esecuzione dell'azione si interrompe e riprende con le azioni nel segnaposto Su errore. Se Prova venisse posizionato da solo, l'esecuzione del trigger verrebbe interrotta. Nel nostro caso, Prova è nidificato sotto l'azione Per ciclo. Normalmente, qualsiasi errore nel segnaposto Fare interromperebbe anche l'esecuzione dell'azione Per ciclo, anche se vi sono ulteriori passi da eseguire fino al completamento di Per ciclo. In questo caso, non verrà eseguita nemmeno l'azione Salva dati su file. Per impostazione predefinita, ciascun errore interrompe l'intera elaborazione del trigger. Tuttavia, è anche possibile continuare con l'esecuzione della prossima iterazione nell'azione Per ciclo. Affinché ciò avvenga, abilitare l'opzione di errore Ignora nell'azione Prova. Se i dati del passo corrente in Per ciclo provocano un errore nel segnaposto Fare, vengono eseguite le azioni di Su errore. Dopodiché, viene eseguita l'azione Salva dati su file nel livello 2 e quindi l'azione Per ciclo continua a essere eseguita nell'iterazione successiva.
Questa azione assicura un agevole rilevamento ed esecuzione degli errori delle azioni di "feedback" o "reporting". Ad esempio, se si verifica un errore durante l'elaborazione del trigger, è possibile inviare l'avvertenza. Per ulteriori informazioni, vedere la sezione Feedback sullo stato del processo di stampa nella guida dell'utente di NiceLabel Automation.
Nota
Importante! L'azione Prova fornisce i risultati previsti con azioni asincrone. Se il ciclo Prova include l'azione Stampa etichetta che non riesce, l'esecuzione dell'azione completa comunque il ciclo Prova e non passa alle azioni Su errore, come previsto. Il risultato del mancato passaggio alle azioni Su errore è l'azione Stampa etichetta che, per impostazione predefinita, viene eseguita in modalità sincrona. Per evitare che ciò avvenga, assicurarsi che la stampa supervisionata sia attivata. Passare alle impostazioni dei trigger > Altro > Feedback dal motore di stampa e attivare Stampa supervisionata.
Nota
Ulteriori informazioni sulla stampa supervisionata sono disponibili nella sezione Modalità di stampa sincrona.
Questa azione configura più azioni all'interno dello stesso contenitore. Tutte le azioni posizionate al di sotto dell'azione Gruppo appartengono allo stesso gruppo e saranno eseguite insieme.
Questa azione fornisce i seguenti vantaggi:
-
Migliore organizzazione e visualizzazione del flusso di azioni. È possibile espandere o ridurre l'azione Gruppo e visualizzare le azioni nidificate solo quando è necessario. Ciò aiuta a tenere più pulita l'area di configurazione.
-
Definizione dell'esecuzione condizionale. È possibile definire una sola volta una condizione nell'azione Gruppo, non singolarmente per ciascuna azione. Se la condizione è soddisfatta, vengono eseguite tutte le azioni all'interno del gruppo. Questo può consentire di risparmiare molto tempo e di ridurre il numero di errori di configurazione. L'azione Gruppo fornisce un buon metodo per definire le regole di esecuzione IF..THEN per più azioni.
Questa azione restituisce le informazioni strutturali sul file di etichetta associato. Essa fornisce le informazioni sulle dimensioni dell'etichetta e il driver della stampante ed elenca tutte le variabili di etichette e le loro proprietà principali.
L'azione Ottieni informazioni sull'etichetta restituisce le informazioni originali così come esse vengono salvate nel file di etichetta. Inoltre, fornisce informazioni dopo che è stato simulato il processo di stampa. La simulazione fa sì che tutte le variabili di etichetta ottengano il valore come avrebbero fatto durante una stampa normale. Inoltre, le informazioni sull'altezza dell'etichetta forniscono le dimensioni corrette nel caso in cui l'etichetta sia stata definita come etichetta ad altezza variabile (in questo caso, le dimensioni dell'etichetta dipendono dalla quantità di dati da stampare). L'azione restituisce le dimensioni per le dimensioni di un'etichetta, non per un formato pagina.
L'azione salva le informazioni sulla struttura dell'etichetta in una variabile selezionata. Dopodiché, è possibile reinviare i dati al sistema usando l'azione Richiesta HTTP (o un'azione di connettività ai dati in uscita simile) oppure rimandarli nella risposta del trigger, se il trigger è bidirezionale.
Nota
L'azione deve essere nidificata sotto l'azione Apri etichetta.
Il gruppo Variabile seleziona o crea una variabile che memorizza le informazioni strutturali su un'etichetta.
-
Nome: specifica il nome della variabile. Selezionare o creare una variabile che memorizza le informazioni sull'etichetta in formato XML.
-
Se si desidera usare le informazioni XML all'interno di questo trigger, è possibile definirle ed eseguirle con l'azione Usa filtro dati (solo Automation Builder).
-
Se si desidera restituire i dati XML in risposta al trigger HTTP o Servizio Web, usare questa variabile direttamente nel campo Dati di risposta della pagina di configurazione del trigger.
-
Se si desidera salvare i dati XML su un file, usare l'azione Salva dati su file.
-
Il gruppo Impostazioni aggiuntive consente di attivare l'uso di valori provvisori.
-
Usa valori temporanei: sostituisce i valori dell'origine dati mancanti con valori provvisori.
Suggerimento
Per una descrizione dettagliata dei valori provvisori, vedere la sezione Variabile nella guida dell'utente di NiceLabel 10.
XML delle informazioni sull'etichetta di esempio
L'esempio seguente illustra la vista strutturale degli elementi dell'etichetta e i relativi attributi, quando questi vengono restituiti.
<?xml version="1.0" encoding="UTF-8"?> <Label> <Original> <Width>25000</Width> <Height>179670</Height> <PrinterName>QLS 3001 Xe</Printer> </Original> <Current> <Width>25000</Width> <Height>15120</Height> <PrinterName>QLS 3001 Xe</Printer> </Current> <Variables> <Variable> <Name>barcode</Name> <Description></Description> <DefaultValue></DefaultValue> <Format>All</Format> <CurrentValue></CurrentValue> <IncrementType>None</IncrementType> <IncrementStep>0</IncrementStep> <IncrementCount>0</IncrementCount> <Length>100</Length> </Variable> </Variables> </Format>
Specifica XML delle informazioni sull'etichetta
Questa sezione contiene una descrizione della struttura di file XML restituita dall'azione Ottieni informazioni sull'etichetta.
Nota
Tutti i valori di misurazione sono espressi in unità 1/1000 mm. Ad esempio, la larghezza di 25000 è pari a 25 mm.
-
<Label>: questo è un elemento principale.
-
<Original>: specifica le dimensioni dell'etichetta e il nome della stampante memorizzati nel file di etichetta.
-
Width: questo elemento contiene la larghezza dell'etichetta originale.
-
Height: questo elemento contiene l'altezza dell'etichetta originale.
-
PrinterName: questo elemento contiene il nome della stampante per il quale l'etichetta è stata creata.
-
-
Current: specifica le dimensioni dell'etichetta e il nome della stampante dopo il completamento della stampa simulata.
-
Width: questo elemento contiene la larghezza effettiva dell'etichetta.
-
Height: questo elemento contiene l'altezza effettiva dell'etichetta. Se un'etichetta è definita come etichetta ad altezza variabile, può crescere insieme agli oggetti etichetta. Ad esempio, le dimensioni degli oggetti Casella di testo e RTF possono aumentare in direzione verticale e determinare anche l'espansione dell'etichetta.
-
PrinterName: questo elemento contiene il nome della stampante che verrà usata per la stampa.
Esempio 126. Esempio
Verrà usata una stampante diversa da quella originale qualora il driver stampante originale non sia installato in questo computer, oppure se la stampante è stata cambiata mediante l'azione Imposta stampante.
-
-
<Variables> e <Variable>: l'elemento
Variables
contiene l'elenco di tutte le variabili dell'etichetta di richiesta, definite in un elementoVariable
separato. Le variabili di richiesta sono quelle elencate nella finestra di dialogo Stampa al momento della stampa dell'etichetta da NiceLabel 10. Se nell'etichetta non sono definite variabili di richiesta, l'elementoVariables
è vuoto.-
Name: contiene il nome della variabile.
-
Description: contiene la descrizione della variabile.
-
DefaultValue: contiene il valore predefinito definito per la variabile durante il processo di progettazione dell'etichetta.
-
Format: contiene il tipo accettabile di contenuto della variabile (caratteri).
-
IsPrompted: contiene le informazioni sul fatto che la variabile sia richiesta o meno al momento della stampa.
-
PromptText: contiene testo che richiede all'utente l'immissione di un valore.
-
CurrentValue: contiene il valore effettivamente utilizzato per la stampa.
-
IncrementType: contiene informazioni in merito al fatto che la variabile sia definita o meno come contatore. Se è identificato come contatore, indica di che tipo di contatore si tratta.
-
IncrementStep: contiene le informazioni sul passo del contatore. Il valore del contatore aumenta/diminuisce per questo valore nell'etichetta successiva.
-
IncrementCount: contiene informazioni sul punto in cui valore del contatore aumenta/diminuisce. Di solito, il contatore cambia valore su ciascuna etichetta, ma, esso può essere modificato.
-
Length: contiene il numero massimo di caratteri memorizzati in una variabile.
-
IsPickListEnabled: contiene informazioni in merito al fatto che l'utente selezioni o meno i valori variabili da una lista prelievi.
-
PickListValues: contiene i valori effettivi (selezionabili) della lista prelievi.
-
Definizione dello schema XML (XSD) per l'XML della specifica dell'etichetta
<?xml version="1.0" encoding="utf-8"?> <xs:schema id="Format" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="Label"> <xs:complexType> <xs:all> <xs:element name="Original"> <xs:complexType> <xs:sequence> <xs:element name="Width" type="xs:decimal" minOccurs="1" /> <xs:element name="Height" type="xs:decimal" minOccurs="1" /> <xs:element name="PrinterName" type="xs:string" minOccurs="1" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Current"> <xs:complexType> <xs:sequence> <xs:element name="Width" type="xs:decimal" minOccurs="1" /> <xs:element name="Height" type="xs:decimal" minOccurs="1" /> <xs:element name="PrinterName" type="xs:string" minOccurs="1" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Variables"> <xs:complexType> <xs:sequence> <xs:element name="Variable" minOccurs="0" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="Name" type="xs:string" minOccurs="1" /> <xs:element name="Description" type="xs:string" minOccurs="1" /> <xs:element name="DefaultValue" type="xs:string" minOccurs="1" /> <xs:element name="Format" type="xs:string" minOccurs="1" /> <xs:element name="CurrentValue" type="xs:string" minOccurs="1" /> <xs:element name="IncrementType" type="xs:string" minOccurs="1" /> <xs:element name="IncrementStep" type="xs:integer" minOccurs="1" /> <xs:element name="IncrementCount" type="xs:integer" minOccurs="1" /> <xs:element name="Length" type="xs:string" minOccurs="1" /> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:all> </xs:complexType> </xs:element> </xs:schema>
Questa azione esegue i comandi inclusi in un file di comando selezionato. Tutte le opzioni Tipo file forniscono comandi che NiceLabel 10 vengono eseguiti nell'ordine dall'alto verso il basso.
Di solito i file di comando forniscono i dati per un'unica etichetta, ma è possibile definire file di qualsiasi livello di complessità. Per ulteriori informazioni, vedere la sezione Tipi di file di comando.
Il gruppo File definisce il tipo e il nome del file di comando che verrà eseguito (JOB, XML o CSV).
-
Tipo file. Specifica il tipo di file di comando da eseguire.
-
Nome del file. Specifica il nome del file di comando.
Nome file può essere hardcoded e ogni volta verrà eseguito lo stesso file di comando. L'opzione Variabile consente di usare un nome di file di variabile. Selezionare o creare una variabile contenente il percorso e/o nome di file se viene eseguito un trigger o si verifica un evento. Di solito, il valore rispetto alla variabile viene assegnato da un filtro.
Usare la sintassi UNC per le risorse di rete. Per ulteriori informazioni, vedere la sezione Accesso alle risorse di rete condivise nella guida dell'utente di NiceLabel Automation.
Questa azione esegue i comandi personalizzati NiceLabel immessi.
Nidificare sempre questa azione sotto l'azione Apri etichetta. Consente di fare riferimento all'etichetta alla quale si applicano i comandi. Per ulteriori informazioni, vedere la sezione Uso di Comandi personalizzati nella guida dell'utente di NiceLabel Automation.
Nota
La maggior parte dei comandi personalizzati è disponibile con azioni individuali, quindi nella maggior parte dei casi i comandi personalizzati non sono necessari.
Nota
L'azione Invia comandi personalizzati può essere utilizzata per terminare la modalità di stampa della sessione. Questa modalità funge da modalità di ottimizzazione della stampa che stampa tutte le etichette di un ciclo utilizzando un singolo file di processo di stampa. Per terminare la stampa della sessione, nidificare l'azione Invia comandi personalizzati sotto l'azione Per ciclo e utilizzare il comando SESSIONEND. Per ulteriori dettagli, vedere le sezioni Stampa di sessioni e Uso di comandi personalizzati nella Guida dell'utente diNiceLabel Automation.
L'editor Script dispone delle seguenti funzionalità:
-
Inserisci origine dati: inserisce nello script una variabile esistente o appena creata.
-
Editor di script: apre l'editor, che rende la creazione di script più facile ed efficiente.
Questa azione legge la licenza attivata ed esegue le azioni nidificate al di sotto di questa azione solo se viene usato un determinato tipo di licenza.
Suggerimento
L'azione Verifica licenza protegge la configurazione del trigger evitando che venga eseguito su sistemi non autorizzati.
Nota
La chiave di licenza che attiva il software può inoltre codificare l'ID di soluzione. Si tratta del numero univoco che identifica il provider di soluzioni che ha venduto la licenza NiceLabel 10.
Se l'ID della soluzione configurato corrisponde all'ID della soluzione codificato nella licenza, il sistema di destinazione può eseguire le azioni nidificate, limitando l'esecuzione alle licenze vendute dal provider di soluzioni.
I trigger possono essere crittografati e bloccati, in modo tale che solo agli utenti autorizzati sia consentito aprire la configurazione. Per ulteriori informazioni, vedere la sezione Protezione della configurazione dei trigger nella guida dell'utente di NiceLabel Automation.
Il gruppo Informazioni sulla licenza consente di selezionare l'ID della licenza.
-
ID licenza: definisce il numero di ID delle licenze consentite per eseguire le azioni nidificate.
-
Se il valore immesso non è l'ID della licenza codificato nella licenza, le azioni nidificate non vengono eseguite.
-
Se il valore immesso è impostato su 0, se viene trovata una licenza valida, le azioni vengono eseguite.
-
Nota
L'UID di partner digitale può essere usato anche come ID di licenza. Questa opzione è disponibile per i membri del programma digitale per i partner NiceLabel.
Questa azione registra un evento su NiceLabel Control Center ai fini della cronologia e della soluzione dei problemi.
Nota
Per rendere attiva l'azione Registra evento, assicurarsi che la registrazione del processo di stampa su NiceLabel Control Center sia attivata.
Il gruppo Dati evento fornisce informazioni sull'evento registrato.
-
Informazioni: descrizione di base dell'evento che sarà inclusa nel registro eventi di NiceLabel Control Center. In quest'area sono consentiti fino a 255 caratteri.
-
Dettagli: descrizione dettagliata dell'evento da registrare in NiceLabel Control Center. In quest'area sono consentiti fino a 2000 caratteri.
Suggerimento
Le descrizioni immesse nei campi Informazioni e Dettagli consentono di filtrare gli eventi in Cronologia di tutte le attività, in Control Center. Quando si lavora con Control Center, passare a Cronologia > Tutte le attività > Definire filtro. Per ulteriori dettagli, leggere la Guida dell'utente di Control Center.
Questa azione esegue il processo di stampa e fornisce un'anteprima dell'immagine dell'etichetta. Per impostazione predefinita, l'anteprima viene salvata su disco come immagine JPEG, ma è possibile scegliere un altro formato di immagine. È anche possibile controllare le dimensioni dell'immagine di anteprima creata. L'azione genera l'anteprima per una singola etichetta.
Dopo aver creato l'anteprima dell'etichetta in un file, è possibile inviare il file a un'applicazione di terza parte usando una delle azioni in uscita, come Invia dati su HTTP, Invia dati alla porta seriale, Invia dati alla porta TCP/IP, oppure usarlo come messaggio di risposta dai trigger bidirezionali, come Trigger servizio Web. L'applicazione della terza parte può prendere l'immagine e mostrarla all'utente come anteprima di etichetta.
Il gruppo Anteprima definisce il file da visualizzare in anteprima e i relativi dettagli.
-
Nome file: specifica il percorso e il nome del file. Se è hardcoded, ogni volta viene usato lo stesso file. Se si usa solo il nome del file senza il percorso, viene usata la cartella con il file di configurazione (.MISX). È possibile usare il riferimento relativo al nome di file, nel quale la cartella con il file .MISX viene usata come cartella principale. L'opzione Origine dati attiva il nome di file di variabile. Selezionare o creare una variabile contenente il percorso e/o nome di file dopo che viene eseguito un trigger. Di solito, il valore rispetto alla variabile viene assegnato da un filtro.
-
Tipo immagine: specifica il tipo di immagine usato per salvare l'anteprima dell'etichetta.
-
Anteprima etichetta retro (etichette fronte-retro): consente di visualizzare l'anteprima del retro di un'etichetta. Questa funzionalità risulta utile quando si usano etichette fronte-retro e si desidera visualizzare l'anteprima del retro dell'etichetta.
Esempio 132. Esempio
Ad esempio, se il modello di etichetta definisce la dimensione come 4" × 3" e risoluzione della stampante di etichette è impostata su 200 DPI, l'anteprima dell'immagine risultante ha dimensioni pari a 800 × 600 pixel. La larghezza è pari a 4 pollici per 200 DPI, per un totale di 800 pixel. L'altezza è pari a 3 pollici per 200 DPI, per un totale di 600 pixel.
Il gruppo Impostazioni aggiuntive consente di attivare l'uso di valori provvisori.
-
Usa valori temporanei: sostituisce i valori dell'origine dati mancanti con valori provvisori e li visualizza nell'anteprima dell'etichetta.
Suggerimento
Valore provvisorio definisce un valore di variabile segnaposto in un oggetto durante la progettazione di etichette o moduli. In un oggetto etichette, il valore provvisorio viene sostituito dal valore reale della variabile al momento della stampa.
Questa azione consente di creare una variante pronta per la revisione di un'etichetta esistente. Gli oggetti etichetta di tali varianti hanno valori di origine dati bloccati. Il loro contenuto è definito dal valore corrente dell'origine dati applicabile.
Lo scopo della creazione di una variante pronta per la revisione di un'etichetta con origini dati “bloccate” è rendere l'etichetta idonea per il processo di approvazione in cui i dati e il modello devono essere approvati insieme. Invece di visualizzare un'etichetta senza contenuto definito per i relativi oggetti, l'approvatore rivede una variante con i valori definiti. Questo gli consente di vedere e approvare rapidamente il layout finale dell'etichetta con i valori reali che saranno usati per la stampa.
Suggerimento
Il processo di approvazione dell'etichetta è applicabile alle etichette memorizzate in Documento di archiviazione di Control Center. È possibile applicare vari tipi di workflow per le etichette e le varianti di etichetta memorizzate. La scelta del workflow di approvazione dipende dai requisiti dell'ambiente del business. Per ulteriori dettagli, vedere la guida dell'utente di NiceLabel 10 Control Center.
Il gruppo Impostazioni definisce il file di etichetta da convertire e il file di output (variante dell’etichetta).
-
Nome etichetta: il nome del file di etichetta da convertire in una variante pronta per la revisione con valori di origine dati bloccati. Origine dati definisce dinamicamente il valore Nome etichetta usando una variabile esistente o appena creata.
-
Origini dati ora stampa: questa opzione consente di definire le origini dati i cui valori saranno forniti al momento della stampa effettiva. Se in questo campo è elencata un'origine dati, il suo valore non viene bloccato e può essere fornito al momento della stampa. Gli esempi tipici sono origini dati per valori di produzione come numero LOT, data di scadenza, ecc.
Suggerimento
Inserire solo i nomi delle origini dati, senza parentesi quadre, separati da virgole o elencati in una colonna usando il tasto Invio.
-
Nome file di output: il nome del file di variante di etichetta che sarà pronto per la revisione. Origine dati definisce dinamicamente il valore Nome etichetta usando una variabile esistente o appena creata.
Esistono diverse regole che si applicano alla variante di etichetta pronta per la revisione:
-
Per impostazione predefinita, i valori dell'origine dati sono bloccati. Per escludere le origini dati evitando che vengano bloccati, elencarli nel campo Origini dati ora stampa per tenerli attivi nell'etichetta pronta per la revisione. È possibile definirne i valori al momento della stampa.
-
Variabili di contatore, funzioni, campi di database e variabili globali vengono convertiti in variabili non richieste.
-
La grafica è incorporata.
-
La variante dell'etichetta di destinazione memorizzata in Documento di archiviazione di NiceLabel Control Center viene automaticamente sottoposta al check-in. Le azioni Nome etichetta e Origini dati ora stampa vengono utilizzate come commento di check-in.
-
Le varianti di etichetta possono essere aperte in NiceLabel 10 Designer nello stato di blocco.
-
I file di etichetta generati con questa azione non possono essere importati.
-
Se le varianti di etichetta sono memorizzate nella memoria della stampante, il comando di richiamo può fornire solo i valori per le origini dati al momento della stampa.
-
Se si usa NiceLabel Control Center, l'anteprima di etichetta in Documento di archiviazione consente di modificare le origini dati al momento di stampa.
-
Le variabili dell'ora e della data corrente non possono essere impostate come origini dati dell'ora di stampa nella variante di etichetta pronta per la revisione.
Alcuni oggetti accettano più valori come contenuto. Tale contenuto può essere una combinazione di valori fissi, variabili e caratteri speciali (codici di controllo). Gli oggetti che accettano valori combinati sono identificati da un piccolo pulsante freccia destra sul lato destro dell'oggetto. Fare clic sul pulsante freccia per immettere una variabile o un carattere speciale.
-
Uso di valori fissi. Immettere un valore fisso per la variabile.
-
Uso di valori fissi e dati delle variabili. I valori combinati possono contenere valori variabili e fissi. I nomi di variabili devono essere racchiusi tra parentesi quadre
[]
. Immettere le variabili manualmente o inserirle facendo clic sul pulsante freccia a destra. Durante l'elaborazione, i valori delle variabili vengono uniti insieme con dati fissi e usati come contenuto dell'oggetto.Nell'esempio seguente, il contenuto viene unito da tre variabili e da elementi di dati fissi.
-
Uso di caratteri speciali. I caratteri speciali sono supportati con valori combinati. È possibile immettere manualmente i caratteri speciali oppure inserirli mediante un elenco a discesa. In questo caso, il valore di
variable1
viene unito con dati fissi e un carattere binario di avanzamento modulo. L'elenco di caratteri speciali è disponibile qui.
Questo argomento descrive i passi per usare in modo ottimale le risorse di rete condivise.
Il componente di esecuzione di Desktop Designerviene eseguito nella modalità di servizio sotto l'account utente specificato, ereditando i privilegi di accesso di tale account.
Per poter aprire i file di etichetta e usare i driver della stampante in Desktop Designer, è necessario concedere privilegi sufficienti al relativo account utente.
Quando si accede al file su un'unità di rete, usare la sintassi UNC e non le lettere dell'unità mappata. UNC è una convenzione di denominazione per specificare e mappare le unità di rete. Desktop Designer tenterà di sostituire automaticamente la sintassi della lettera dell'unità con la sintassi UNC.
Esempio 137. Esempio
Se il file è accessibile come G:\Labels\label.nlbl
, farvi riferimento nella notazione UNC come \\server\share\Labels\label.nlbl
(dove l'unità G: è mappata su \\server\share
).
Quando si apre un file in un archivio di documenti all'interno di Control Center, usare la notazione HTTP come http://servername:8080/label.lbl
oppure la notazione WebDAV come \\servername@8080\DavWWWRoot\label.lbl
.
Nota
Prima di tutto è necessario aggiungere e configurare gli utenti che lavorano con i file archiviati in Documento di archiviazione nel Control Center. Ulteriori informazioni sulla gestione degli utenti sono disponibili nella Guida dell'utente di Control Center.
Per stampare etichette mediante una stampante di rete condivisa, rendere disponibile il driver della stampante sul server in cui è installato Desktop Designer.
Assicurarsi che l'account utente sotto il quale è in esecuzione Desktop Designer abbia accesso al driver della stampante. Se la stampante di rete era stata appena installata sulla macchina, Desktop Designer potrebbe non vederla fino al riavvio del servizio.
Suggerimento
Per consentire la notifica automatica dei nuovi driver della stampante di rete è necessario attivare la regola in entrata appropriata nel firewall Windows. Per ulteriori informazioni, consultare la knowledge base, articolo KB 265.
Se Desktop Designer tenta di caricare un'etichetta o un file immagine e questo file non viene trovato immediatamente, non annulla l'elaborazione né segnala un errore. Tenta di individuare il file richiesto in posizioni alternative.
Desktop Designer controlla le posizioni dei file nell'ordine seguente:
-
Controllare se il file si trova nella posizione definita nell'azione.
-
Controllare se il file è presente nella stessa cartella del file della soluzione o dell'etichetta.
-
Controllare se il file di etichetta è presente nella cartella
.\Labels
(per i file grafici, controllare la cartella.\Graphics
). -
Controllare se il file di etichetta è presente nella cartella
..\Labels
(per i file grafici, controllare la cartella..\Graphics
). -
Controllare se il file è presente nella cartella Labels globale (cartella Graphics per i file grafici).
Se il file non è presente in nessuna delle posizioni sopraelencate, l'azione non riesce. Si è verificato un errore.
ID stato spooler (in esadecimali) |
Descrizione stato spooler |
0 |
Nessuno stato. |
1 |
La stampante è in pausa. |
2 |
La stampante sta stampando. |
4 |
La stampante è in uno stato di errore. |
8 |
La stampante non è disponibile. |
10 |
Manca carta nella stampante. |
20 |
È necessaria l'alimentazione manuale. |
40 |
La stampante ha un problema con la carta. |
80 |
La stampante è offline. |
100 |
Stato input/output attivo. |
200 |
La stampante è occupata. |
400 |
Carta inceppata. |
800 |
Il vassoio di uscita è pieno. |
2000 |
La stampante è in attesa. |
4000 |
La stampante sta elaborando. |
10000 |
La stampante si sta riscaldando. |
20000 |
Il livello di toner/inchiostro è basso. |
40000 |
Nella stampante non è rimasto toner. |
80000 |
Impossibile stampare la pagina corrente. |
100000 |
È necessario l'intervento dell'utente. |
200000 |
Memoria della stampante esaurita. |
400000 |
Lo sportello è aperto. |
800000 |
Errore sconosciuto. |
1000000 |
La stampante è in modalità risparmio energetico. |