Pour en savoir plus sur les déclencheurs en général, consulter l'article Comprendre les déclencheurs.
Le déclencheur de Cloud vous permet d'intégrer votre NiceLabel Cloud ou Control Center sur site à vos systèmes d'entreprise existants exécutés dans des Clouds privés ou des centres de données dédiés. Si un système d'entreprise existant (comme SAP S/4HANA ou Oracle NetSuite) produit une sortie, une API hébergée sur le Cloud vous permet d'envoyer des requêtes HTTP au déclencheur de Cloud.
Le déclencheur de Cloud vous permet d'imprimer des étiquettes en local, dont le contenu provient de systèmes d'informations de type Cloud. Le déclencheur de Cloud exécuté sur un serveur Automation local utilise des méthodes standard pour accéder aux services basés sur le Cloud. De ce fait, vous pouvez déployer une impression en local de manière sûre et efficace.
Le déclencheur de Cloud permet d'intégrer de manière sûre et transparente votre impression d'étiquettes en local via des applications qui communiquent par Internet ouvert.
Comparé au déclencheur serveur HTTP, le déclencheur de Cloud ne vous demande pas d'ouvrir de ports entrants sur votre pare-feu. Le déclencheur de Cloud utilise une API NiceLabel dédiée exécutée dans le Cloud. C'est pourquoi le déclencheur ne nécessite que le port de sortie 443 ou les ports 9350-9354 ouverts. Dans la plupart des cas, ces ports sont déjà ouverts.
Cette section décrit comment configurer le déclencheur de Cloud dans Automation exécuté sur votre serveur local.
Ouvrir votre Automation Builder. S'assurer que Automation Builder est associé à votre Control Center. Pour vérifier, aller dans Fichier > Options >Control Center et voir si l'adresse URL de votre Control Center est là.
Note
Automation Builder et Control Center « associés » signifient aussi que les deux applications utilisent la même clé de licence.
L'onglet Éléments de configuration s'ouvre. Cliquer sur Déclencheur de Cloud pour créer une nouvelle configuration pour le déclencheur de Cloud.
Général languette
-
Définir un Nom et une Description pour retrouver facilement votre déclencheur de Cloud parmi les autres déclencheurs.
-
Paramétrer le déclencheur Communication :
-
Définir l'identifiant unique. Après avoir déployé le déclencheur, cet identifiant unique enregistre le déclencheur sur votre Control Center. N'utiliser que des caractères alphanumériques. Les caractères spéciaux ne sont pas autorisés.
Si vous exécutez la configuration du déclencheur de Cloud sur plusieurs ordinateurs, vous devez vous assurer que chaque ordinateur utilise automatiquement son propre identifiant unique. Pour empêcher les doublons indésirables, insérer des variables internes dans l'identifiant unique. Vous pouvez utiliser deux variables internes à cette fin :
-
ComputerName : Le nom de l'ordinateur sur lequel tourne la configuration.
-
SystemUserName : Le nom de l'utilisateur actuellement connecté à Windows.
Pour insérer des variables internes dans l'identifiant unique, cliquer sur Insérer une source de données et sélectionner vos variables internes.
-
-
Attendre la fin d'exécution du déclencheur : Le protocole HTTP oblige le destinataire (dans ce cas NiceLabel Automation) à renvoyer une réponse numérique à l'expéditeur en indiquant l'état du message reçu. Par défaut, NiceLabel Automation répond avec le code 200. Cela indique que Automation a bien reçu les données, mais n'indique pas si les actions du déclencheur ont bien été effectuées.
Cette option spécifie qu'un déclencheur n'envoie pas de réponse immédiatement après avoir reçu les données, mais attende que les actions se soient toutes exécutées. Ensuite, un code de réponse est envoyé, indiquant que l'action a bien été exécutée. Avec cette option est activée, la réponse peut être personnalisée et comporter des données (par ex. : la réponse à une requête HTTP est l'aperçu de l'étiquette en format PDF).
Avec le déclencheur de Cloud, les codes de réponse intégrés standard HTTPAutomation sont :
Code de réponse HTTP
Description
200
Toutes les actions sont réussies.
400
Aucune configuration disponible.
500
Erreur au cours de l'exécution de l'action.
Note
Pour envoyer un rapport d'informations à Automation concernant le processus d'impression, activer le mode d'impression synchrone. Pour plus d'informations, consulter l'article Mode d'impression synchrone.
-
Type de réponse : Spécifie le type du message de réponse. Les types de médias Internet fréquemment utilisés (connus comme types MIME ou types Content) sont prédéfinis dans le menu déroulant. Si votre type de média n'est pas disponible dans la liste, le saisir simplement vous-même. Automation envoie les données de réponse de sortie en tant que retour d'informations, formatées dans le type de média défini. L'option Variable active le type de média variable. Dans ce cas, il faut sélectionner ou créer la variable qui contiendra le type de média.
Note
Si le type de contenu n'est pas spécifié, NiceLabel Automation utilise
application/octet-streampar défaut. -
Données de réponse : Définit le contenu de votre message de réponse. Exemples de réponse HTTP : messages d'erreur personnalisés, aperçus d'étiquettes, fichiers PDF, fichiers de flux d'impression (fichier spouleur), fichiers XML avec les détails du moteur d'impression plus l'aperçu d'étiquette (encodé en chaîne Base64).
Pour sortir seulement un contenu binaire (tel qu'un aperçu de l'étiquette ou un flux d'impression), il faut sélectionner le type de média supporté, par ex.
image/jpegouapplication/octet-stream.
-
Entêtes additionnelles : Permet de définir des entêtes MIME pour le message de réponse HTTP.
La syntaxe de l'entête de la réponse et un exemple sont disponibles dans la section Action requête HTTP.
Astuce
Dans les données de réponse et les Entêtes additionnelles, le contenu peut être fixe, un mélange de contenu fixe et variable, ou contenu variable seul. Pour insérer un contenu de variable, cliquer sur le bouton avec une flèche à droite de la zone de données et insérer votre variable de la liste. Vous pouvez aussi créer une nouvelle variable contenant les données que vous voulez utiliser. Pour plus d'informations, consulter l'article Utiliser des valeurs composées.
-
Autre languette
Les options de la section Commentaires du moteur d'impression spécifient les paramètres de communication qui vous permettent de recevoir un retour d'informations du moteur d'impression.
-
Impression supervisée : Active le mode d'impression synchrone. Utiliser cette option pour renvoyer les informations sur l'état du travail d'impression à une application tierce. Pour plus d'informations, consulter l'article Mode d'impression synchrone.
Les options de la section Traitement de données permettent de préciser s'il faut couper les données pour les ajuster à la variable, ou ignorer les variables manquantes dans l'étiquette. Par défaut, va dire qu'il y a une erreur et interrompre le processus d'impression en cas d'enregistrement de valeurs trop longues dans les variables d'étiquettes, ou de paramétrage de valeurs dans des variables inexistantes.
-
Ignorer le contenu variable excessif : tronque les valeurs des données qui dépassent la longueur de la variable telle que définie dans l'éditeur d'étiquettes pour qu'elles s'adaptent. Cette option s'applique lors du paramétrage de valeurs de variables dans les filtres des fichiers de commande et au paramétrage de valeurs de variables de déclencheurs dans les variables d'étiquette ayant le même nom.
Exemple 26. Exemple
La variable de l'étiquette accepte un maximum de 5 caractères. Avec cette option activée, toute valeur plus longue que 5 caractères est tronquée aux 5 premiers caractères. Si la valeur est 1234567, ignore les chiffres 6 et 7.
-
Ignorer les variables d'étiquettes manquantes : Lors de l'impression de fichiers de commande (tels qu'un fichier JOB), le processus d'impression ignore toutes les variables qui sont :
-
spécifiées dans le fichier de commande (en utilisant la commande SET)
-
non définies sur l'étiquette
La même chose se produit si vous définissez une zone d'assignation dans un filtre pour extraire toutes les paires nom-valeur, mais votre étiquette contient moins de variables.
Lorsque vous paramétrez des valeurs dans des variables d'étiquettes inexistantes, signale une erreur. Si cette option est activée, l'impression continue.
-
Les options dans la section Script spécifient les possibilités de script.
-
Langage de script : Sélectionne le langage de script pour le déclencheur. Toutes les actions Exécuter le script d'un même déclencheur utilisent le même langage.
Les options de la section Enregistrer les données reçues spécifient les commandes disponibles pour les données reçues par le déclencheur.
-
Enregistrer les données reçues par le déclencheur vers le fichier : Activer cette option pour enregistrer les données reçues par le déclencheur. L'option Variable active le nom de fichier variable. Sélectionner une variable qui contient le chemin et le nom du fichier.
-
En cas d'erreur, enregistrer les données reçues par le déclencheur vers le fichier : Activer cette option pour enregistrer les données dans le déclencheur si une erreur survient lors de l'action d'exécution. Activer cette option pour récupérer les données qui ont causé l'erreur et résoudre le problème.
Note
Il faut activer la prise en charge de l'impression supervisée. Autrement, ne peut pas détecter d'erreurs lors de l'exécution. Pour plus d'informations, consulter l'article Mode d'impression synchrone.
Note
enregistre les données reçues dans un fichier temporaire. Le fichier temporaire est supprimé immédiatement après la fin de l'exécution du déclencheur. La variable interne
DataFileNamepointe vers ce fichier. Pour plus d'informations, consulter l'article Variables internes.
Sécurité languette
-
Verrouiller et crypter le déclencheur : Active la protection du déclencheur. Si vous l'activez, le déclencheur est verrouillé et vous ne pouvez plus le modifier. Cela crypte les actions. Seuls les utilisateurs ayant le mot de passe peuvent déverrouiller le déclencheur et le modifier.
Gâchette de démarrage
Déployer et lancer le déclencheur dans Automation Manager. Le déclencheur de Cloud surveille maintenant les requêtes entrantes.
Note
Si votre configuration nécessite une disponibilité et une évolutivité accrues, vous pouvez déployer plusieurs déclencheurs de Cloud identiques. Pour ce faire, installer plusieurs instances de Automation et y déployer les déclencheurs de Cloud. Si les déclencheurs de Cloud déployés partagent le même identifiant unique, la répartition des charges intégrée dans NiceLabel Cloud répartit automatiquement les charges du trafic entre eux.
Note
Pour paramétrer l'accès de l'intégrateur au déclencheur de Cloud, vous devez avoir le droit de gérer l'intégration au Cloud sur le Cloud de Control Center. Voir le Guide utilisateur Control Center pour plus de détails concernant la manière dont gérer vos droits utilisateur.
-
Aller dans Intégrations > Intégrations au Cloud.
-
Cliquer sur +Ajouter. Ceci ouvre la page Ajouter un nouvel accès intégrateur.
-
Saisir le Nom de l'intégrateur que vous êtes en train d'ajouter.
-
Copier la clé.
-
Cliquer sur Enregistrer.
Note
Pour plus de détails, lire la section Déclencheurs de Cloud dans votre Guide utilisateur Control Center.
Cette étape s'assure que les sorties des systèmes d'entreprise externes exécutent correctement les déclencheurs de Cloud exécutés en local. C'est le but de l'opération CloudTrigger (déclencheur de Cloud). Dans l'URL de l'opération, spécifier le nom du déclencheur que vous appelez.
Pour appeler le déclencheur avec l'identifiant unique MyCloudTrigger, appeler cette URL :
https://<YourServerName>/epm/api/trigger/<MyCloudTriggerID>
Note
L'URL peut commencer par «http» ou «https» – selon la manière dont vous configurez votre Control Center lors de l'installation. Voir le Guide d'installation Control Center, section Définir le site Web et le stockage.
Pour chaque événement (sortie) dans le système d'entreprise, appeler l'URL comme dans l'exemple. Chaque appel exécute le déclencheur de Cloud exécuté sur le serveur Automation local.
Tous les appels doivent inclure l'entête nommée Integrator-Key (clé d'intégrateur).
Note
Vous pouvez intégrer la clé d’intégrateur dans votre Control Center. Voir la rubrique Intégrations sur le Cloud, section « Configuration des comptes sur le Portail développeur ».