Trigger client TCP/IP

Per ulteriori informazioni sui trigger in generale, vedere la sezione I trigger.

Il trigger client TCP/IP trasforma Automation in un cliente di ascolto che si connette ai server TCP/IP. Esistono diversi dispositivi e sistemi che assumono il ruolo di un server TCP/IP: sistemi di ispezione della visione, stampanti, PLC, scanner, bilance, ecc. Automation può connettersi ad essi e attendere i dati in entrata. Dopo aver ricevuto un certo numero di caratteri, una sequenza di caratteri o un timeout, il trigger client TCP/IP si attiva e inizia a eseguire le operazioni. Se la connessione non riesce, il trigger consente di riconnettersi automaticamente.

Uso tipico: si stampano automaticamente più tipi di etichette di imballaggio usando una stampante di rete. È fondamentale che l'utente sappia quando la stampante ha finito di stampare un tipo di etichetta prima di iniziare a stampare il secondo tipo di etichetta. Il trigger client TCP/IP consente di impostare il controllo permanente automatico della disponibilità della stampante. Durante la stampa del primo tipo di etichetta, il trigger client TCP/IP controlla lo stato della stampa e, al termine della stampa, invia un messaggio a Automation per inviare il secondo tipo di etichetta da stampare.

Generale

Server di destinazione: digitare la posizione (indirizzo IP o nome host) del server TCP/IP al quale connettersi.
Porta: specifica il numero di porta host dal quale si riceveranno i dati in entrata. Assicurarsi che le porte del firewall siano aperte lato server.
Riconnetti a intervallo server: definire il tempo, in millisecondi, trascorso il quale Automation tenta di riconnettersi al server TCP/IP.
Quando viene ricevuto il numero di caratteri: specifica che il trigger si attiva quando viene ricevuto il numero di caratteri necessari. In questo caso, il server può tenere aperta una connessione e inviare i dati in continuazione. Ciascuna porzione di dati deve avere le stesse dimensioni.
Quando viene ricevuta una sequenza di caratteri: specifica che il trigger si attiva ogni volta che viene ricevuta la sequenza di caratteri necessaria. Questa opzione viene usata se si sa che la "fine dei dati" è sempre identificata da un set di caratteri univoco. È possibile inserire caratteri speciali (binari) mediante il pulsante accanto al campo di modifica.
- Includi nei dati del trigger: la sequenza di caratteri che determina l’evento di trigger non viene rimossa dai dati, ma resta inclusa in essi. Il trigger riceve il flusso completo di dati ricevuti.
Quando niente di nuovo è ricevuto nell'intervallo di tempo specifico: specifica che il trigger si attiva dopo che è trascorso l’intervallo di tempo necessario dall’ultimo carattere ricevuto.

Esecuzione

Messaggio di inizializzazione: messaggio di testo che giunge al server ogni volta che Automation stabilisce una connessione.
Messaggio di risposta: specifica il messaggio di testo che viene restituito al server dopo l'attivazione del trigger (prima che abbia inizio l'esecuzione delle azioni).
Codifica messaggio: Specifica lo schema di codifica dei dati, in modo tale che i caratteri speciali possano essere elaborati correttamente. NiceLabel Automation può rilevare automaticamente la codifica dei dati, in base all'intestazione BOM (file di testo) o all'attributo di codifica (file XML).

Altro

Le opzioni nella sezione Feedback dal motore di stampa specificano i parametri di comunicazione che consentono di ricevere feedback dal motore di stampa.

Stampa supervisionata: attiva la modalità di stampa sincrona. Usarla ogni volta che si desidera reinviare lo stato del processo di stampa all'applicazione di terzi. Per ulteriori informazioni, vedere la sezione Modalità di stampa sincrona.

Le opzioni nella sezione Elaborazione dati specificano se si desidera tagliare i dati in modo tale che si inseriscano in una variabile, oppure ignorare le variabili di etichetta mancanti. Per impostazione predefinita, segnala gli errori e interrompe il processo di stampa se si tenta di conservare valori troppo a lungo nelle variabili di etichetta oppure di impostare valori per variabili di etichetta inesistenti.

Ignora contenuti di variabili eccessivi: tronca i valori dei dati che superano la lunghezza della variabile come definito nel progettista di etichette per renderli idonei. Questa opzione è attiva se i valori delle variabili vengono impostati nei filtri, dai file di comando e quando vengono impostati i valori delle variabili di trigger sulle variabili di etichetta con lo stesso nome.

Esempio 23. Esempio

La variabile di etichetta accetta al massimo 5 caratteri. Con questa opzione attivata, qualsiasi valore superiore a 5 caratteri viene troncato ai primi 5 caratteri. Se il valore è 1234567 ignora le cifre 6 e 7.
Ignora le variabili dell'etichetta mancanti: quando si stampa con i file di comando (come il file JOB), il processo di stampa ignora tutte le variabili che sono:
- specificati nel file di comando (usando il comando SET)
- non definiti sull'etichetta
Lo stesso accade se si definisce l'area di assegnazione in un filtro per estrarre tutte le coppie name-value, ma l'etichetta contiene meno variabili.

Quando si impostano i valori di variabili di etichetta inesistenti, segnala un errore. Se questa opzione è attivata, la stampa continua.

Le opzioni nella sezione Scripting specificano le possibilità di esecuzione di script.

Linguaggio di script: seleziona il linguaggio di script per il trigger. Tutte le azioni Esegui script usate all'interno di un singolo trigger usano il linguaggio di script selezionato.

Le opzioni presenti nella sezione Salva dati ricevuti specificano i comandi disponibili per i dati ricevuti dal trigger.

Salva su file i dati ricevuti dal trigger: Attivare questa opzione per salvare i dati ricevuti dal trigger. L'opzione Variabile consente di usare il nome di file di variabile. Selezionare una variabile contenente il percorso e il nome del file.
Quando si verifica un errore, salva su file i dati ricevuti dal trigger: attivare questa opzione per salvare i dati nel trigger solo se si verifica un errore durante l'esecuzione dell'azione. Potrebbe essere opportuno attivare questa opzione per tenere pronti i dati alla risoluzione dei problemi.

Nota

Assicurarsi di attivare il supporto di stampa supervisionato. In caso contrario, non può rilevare errori durante l’esecuzione. Per ulteriori informazioni, vedere la sezione Modalità di stampa sincrona.

Nota

salva i dati ricevuti in un file temporaneo. Questo file temporaneo viene eliminato subito dopo il completamento dell'esecuzione del trigger. La variabile interna DataFileName fa riferimento al nome di tale file. Per ulteriori informazioni, vedere l'argomento Variabili interne.

Invio di segnali keepalive

Il sistema di routing di rete può interrompere silenziosamente la connessione quando non si registra traffico TCP/IP per alcuni minuti. Per evitare di essere disconnesso, è possibile scegliere di inviare periodicamente segnali keepalive in NiceLabel Automation.

Abilitare l'invio di segnali keepalive nel file product.config:

Spostarsi sulla cartella System.

%PROGRAMDATA%\NiceLabel\NiceLabel 10
Effettuare una copia di backup del file product.config.
Aprire product.config in un editor di testo. Il file ha una struttura XML.
Aggiungere le righe seguenti:
```
<configuration>
   <IntegrationService>
     <KeepAliveTime>60000</KeepAliveTime>
     <KeepAliveInterval>10000</KeepAliveInterval>
   </IntegrationService>
</configuration>
```
Nota

KeepAliveTime (in millisecondi): Specifica per quanto tempo la connessione socket TCP deve essere inattiva prima che Automation invii un segnale keepalive e attenda la restituzione dei pacchetti di riconoscimento.

KeepAliveInterval (in millisecondi): Specifica a quali intervalli inviare un altro pacchetto keepalive quando l'host non restituisce alcun pacchetto di riconoscimento.

Quando il trigger TCP/IP riceve il pacchetto Keep Alive e restituisce il pacchetto di riconoscimento, il timer KeepAliveTime si riavvia.

Entrambi i valori (KeepAliveTime e KeepAliveInterval) sono obbligatori per consentire l'invio di segnali keepalive e devono avere valori maggiori di 0.
Salvare il file product.config.
Riavviare il Automation service.

I segnali keepalive abilitati mantengono ora attiva la connessione.

Nota

Nota

Nota