Dati e connettività

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 di 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.

Aspettare la terminazione: specifica che l'esecuzione dell'azione deve attendere il completamento di questa azione, prima di continuare con l'azione pianificata successiva.

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 di 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.

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.

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.

se si devono combinare i dati ricevuti dal trigger con i dati memorizzati in un file.

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.

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 di 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.

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.

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.

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 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 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.

Ottenere dati aggiuntivi da un database: nel modulo Automation Builder un trigger riceve i dati per la stampa di etichette, ma non tutti i valori necessari. Ad esempio, un trigger riceve i valori per ID prodotti e Descrizione, ma non per Prezzo. Il valore per Prezzo va cercato nel database SQL.

Esempio di codice 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 nel database: dopo che un'etichetta è stata stampata, aggiornare il record di database e inviare un segnale al sistema in cui si informa che quel record particolare è già stato elaborato.

Esempio di codice SQL:

Impostare il valore del campo di tabella AlreadyPrinted su True 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.

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.

Se si usano le variabili di trigger 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.

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 tempi di elaborazione più lunghi.

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.

Salva risultato su variabile: seleziona o crea una variabile per memorizzare il risultato dell'istruzione SQL. Questa opzione dipende dalla Modalità di esecuzione selezionata.

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.

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.

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.

I prerequisiti per l'impostazione Rispondi al mittente sono:

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.

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.

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.

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.

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.

Dati: contenuto da inviare in uscita

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.

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.

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.

Posizione di avvio: posizione iniziale per l'estrazione dei dati.

Posizione finale: posizione finale per l'estrazione dei dati.

Salva dati su variabile: selezionare o creare una variabile per memorizzare i dati ricevuti.

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.

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.

Destinazione: indirizzo, porta e destinazione (percorso) del server Web.

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.

Salva risposta dati in una variabile: variabile per memorizzare i dati ricevuti dal server.

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.

Mostra password: disabilita il mascheramento dei caratteri della password.

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.

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.

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 e Content-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.

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. NiceLabel 10 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.

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 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.