Per ulteriori informazioni sui trigger in generale, vedere la sezione I trigger.
Il trigger cloud consente di integrare NiceLabel Cloud o Control Center on-premise con i sistemi aziendali esistenti in esecuzione nei cloud privati o nei data center dedicati. Se un sistema aziendale esistente (es.: SAP S/4HANA o Oracle NetSuite) produce un output, un’API ospitata nel cloud consente di inviare richieste HTTP al trigger cloud.
Il trigger cloud consente di stampare localmente delle etichette il cui contenuto ha origine nei sistemi di informazioni cloud. Poiché il trigger cloud in esecuzione sul server Automation locale utilizza metodi standard per accedere ai servizi basati su cloud, è possibile distribuire la stampa locale in modo sicuro e ottimizzando i tempi.
Il trigger cloud consente di integrare in modo sicuro e trasparente la stampa di etichette locale mediante le applicazioni che comunicano tramite Internet aperta.
Rispetto al trigger server HTTP, il trigger cloud non richiede l'apertura di porte in entrata sul firewall. Il trigger cloud utilizza un'API NiceLabel dedicata in esecuzione nel cloud. Per questo motivo il trigger richiede solo che siano aperte la porta in uscita 443 o le porte 9350-9354. Nella maggior parte dei casi, queste porte sono già aperte.
Questa sezione descrive come configurare il trigger cloud in Automation in esecuzione sul server locale.
Aprire Automation Builder. Assicurarsi che Automation Builder sia associato a Control Center. Per controllare, passare a File > Opzioni >Control Centere vedere se l'indirizzo URL di Control Center è presente.
Nota
"Associato" Automation Builder e Control Center significa anche che entrambe le applicazioni usano la stessa chiave di licenza.
Si apre la scheda Elementi di configurazione. Fare clic su Trigger cloud per creare una nuova configurazione per il trigger cloud.
Generale scheda
-
Impostare Nome e Descrizione per facilitare il reperimento del trigger tra gli altri trigger.
-
Definire le impostazioni del trigger Comunicazione:
-
Definire l’Identificativo univoco. Dopo aver distribuito il trigger, questo identificativo univoco lo registra in Control Center. Usare solo caratteri alfanumerici. I caratteri speciali non sono consentiti.
Se si sta eseguendo la configurazione del trigger cloud su più computer, è necessario assicurarsi che ciascun computer utilizzi automaticamente il proprio identificativo univoco. Per evitare duplicati indesiderati, inserire le variabili interne nell'ambito dell'identificativo univoco. A tal fine è possibile usare due variabili interne:
-
ComputerName: il nome del computer sul quale è in esecuzione la configurazione.
-
SystemUserName: il nome utente Windows dell'utente connesso correntemente.
Per inserire variabili interne nell'identificativo univoco, fare clic su Inserisci origine dati e selezionare le variabili interne.
-
-
Attendi la fine dell'esecuzione del trigger: il protocollo HTTP richiede che un destinatario (in questo caso, NiceLabel Automation), invii una risposta numerica al mittente, indicando lo stato del messaggio ricevuto. Per impostazione predefinita, NiceLabel Automation risponde con il codice 200. Ciò indica che Automation ha ricevuto con successo i dati, ma non fornisce alcuna informazione sul successo delle azioni del trigger.
Questa opzione specifica che un trigger non invia immediatamente una risposta dopo aver ricevuto i dati, ma attende l’esecuzione di tutte le azioni. Dopodiché, invia il codice di risposta indicando l’esecuzione corretta di un’azione. Con questa opzione attivata, è possibile rimandare indietro un tipo di risposta e i dati personalizzati (es.: la risposta a una richiesta HTTP è l'anteprima dell'etichetta in formato PDF).
Con il trigger cloud, i codici di risposta HTTP standard di Automation incorporati sono:
Codice di risposta HTTP
Descrizione
200
Tutte le azioni eseguite con successo.
400
Nessuna configurazione disponibile.
500
Si sono verificati degli errori durante l'esecuzione dell'azione.
Nota
Per inviare feedback a Automation sul processo di stampa, attivare la modalità di stampa sincrona. Per ulteriori informazioni, vedere la sezione Modalità di stampa sincrona.
-
Tipo di risposta: Specifica il tipo di messaggio di risposta. I tipi di supporti Internet usati di frequente noti anche come tipi di MIME o di contenuto) sono predefiniti nella casella a discesa. Se il tipo di supporto non è disponibile nell'elenco, digitarlo. Automation invia di dati di risposta in uscita come feedback, formattato nel tipo di supporto definito. Variabile consente di usare i tipi di supporto variabili. Se è attivata, selezionare o creare una variabile contenente il tipo di supporto.
Nota
Se non si specifica il tipo di contenuto, NiceLabel Automation usa
application/octet-streamcome contenuto predefinito. -
Dati di risposta: definisce il contenuto del messaggio di risposta. Esempi di ciò che si può rimandare indietro come risposta HTTP: messaggi di errore personalizzati, anteprime dell'etichetta, file PDF generati, file del flusso di stampa (spooling), file XML con informazioni del motore di stampa, più l'anteprima dell'etichetta (codificata come stringa Base64).
Se si genera contenuto solo binario (come anteprima di etichetta o flusso di stampa), assicurarsi di selezionare un tipo di supporto supportato, ad esempio
image/jpegoapplication/octet-stream.
-
Intestazioni aggiuntive: Consentono di definire impostazioni MIME personalizzate per il messaggio di risposta HTTP.
La sintassi e gli esempi di intestazione di risposta sono disponibili nella sezione dell'azione Richiesta HTTP.
Suggerimento
Con i dati della risposta e le intestazione aggiuntive è possibile usare contenuto fisso, una miscela di contenuto fisso e variabile oppure solo contenuto variabile. Per inserire contenuto variabile, fare clic sul pulsante con la freccia a destra dell'area dei dati e inserire una variabile dall'elenco. È inoltre possibile creare una nuova variabile che contiene i dati che si desidera utilizzare. Per ulteriori informazioni, vedere la sezione Uso di valori composti.
-
Altro scheda
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 26. 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
DataFileNamefa riferimento al nome di tale file. Per ulteriori informazioni, vedere l'argomento Variabili interne.
Sicurezza scheda
-
Blocca e crittografa il trigger: abilita la protezione del trigger. Se lo si abilita, il trigger si blocca e non è più possibile modificarlo. In tal modo, le azioni vengono crittografate. Solo gli utenti con password possono sbloccare il trigger e modificarlo.
Trigger iniziale
Distribuire e avviare il trigger in Automation Manager. Ora il trigger cloud monitora le richieste in entrata.
Nota
Se la configurazione richiede una maggiore disponibilità e scalabilità è possibile distribuire più trigger cloud identici. A tal fine, installare più istanze di Automation e distribuire i trigger cloud su di esse. Se i trigger cloud utilizzati condividono lo stesso identificativo univoco, il bilanciatore di carico incorporato in NiceLabel Cloud distribuisce automaticamente il carico del traffico tra di essi.
Nota
Per impostare l'accesso dell'integratore al trigger cloud è necessario avere il privilegio di integrazione Gestisci cloud nel cloud Control Center. Per ulteriori informazioni sulla gestione dei privilegi dell’utente, vedere la Guida dell’utente di Control Center.
-
Passare a Integrazioni > Integrazioni cloud.
-
Fare clic su +Aggiungi. Verrà aperta la pagina Aggiungi nuovo accesso per integratore.
-
Digitare il Nome dell’integratore che si sta aggiungendo.
-
Copiare la Chiave.
-
Fare clic su Salva.
Nota
Per ulteriori informazioni, leggere la sezione Trigger cloud della Guida dell’utente di Control Center.
Questo passaggio fa sì che gli output dei sistemi aziendali esterni eseguano con successo i trigger cloud che vengono eseguiti localmente. Questa è la funzione dell’operazione CloudTrigger. Nell’URL della chiamata, specificare il nome del trigger che si sta chiamando.
Per richiamare il trigger con l’identificativo univoco MyCloudTrigger, richiamare questo URL:
https://<YourServerName>/epm/api/trigger/<MyCloudTriggerID>
Nota
L'URL potrebbe iniziare con "http" o con "https", a seconda di come si configura Control Center durante l'installazione. Per ulteriori informazioni, vedere la guida di installazione di Control Center, sezione relativa all'impostazione del sito Web e all'archiviazione.
Per ogni evento (output) nel sistema aziendale esterno, richiamare l'URL come mostrato nell'esempio. Ciascuna chiamata esegue il trigger cloud in esecuzione sul server Automation locale.
Tutte le chiamate devono includere l'intestazione denominata chiave integratore.
Nota
È possibile ottenere la chiave di integrazione nel proprio Control Center. Consultare l'argomento Integrazioni cloud, "Configurazione degli account del portale per sviluppatori".