Déclencheur serveur TCP/IP

Pour en savoir plus sur les déclencheurs en général, consulter l'article Comprendre les déclencheurs.

L'événement de déclencheur serveur TCP/IP survient quand les données sont reçues sur le socket surveillé (numéro d'adresse IP et de port).

Utilisation typique : Un système existant exécute une transaction, qui en fait envoie les données au serveur NiceLabel Automation sur un socket spécifique. Le contenu des données peut être structuré en format CSV, XML etc., ou il peut être structuré dans un ancien format. Dans chaque cas, NiceLabel Automation va lire les données, analyser les valeurs en utilisant des filtres et les imprimer sur les étiquettes. Pour plus d'informations concernant l'analyse et l'extraction de données, consulter l'article Comprendre les filtres.

Général

Note

Ce déclencheur est compatible avec le protocole Internet version 6 (IPv6).

Cette section permet de configurer les principaux paramètres de ce déclencheur.

Port : Spécifie le numéro de port sur lequel les données entrantes seront acceptées. Utiliser un numéro de port qui n'est pas utilisé par une autre application. Si le port sélectionné est utilisé, il sera impossible de démarrer le déclencheur dans Automation Manager. Pour plus d'informations concernant les problèmes de sécurité, voir l'article Sécuriser l'accès aux déclencheurs.

Note

S'il y a un hébergement multiple activé sur le serveur (plusieurs adresses IP sur une ou plusieurs cartes réseau), NiceLabel Automation répondra au port défini pour toutes les adresses IP.

Nombre maximum de connexions simultanées : Spécifie le nombre maximum de connexions acceptées. Autant de clients peuvent envoyer des données au déclencheur simultanément.

Les options de la section Exécution spécifient quand le déclencheur doit activer et démarrer l'exécution des actions.

À la déconnexion du client : Spécifie que le déclencheur s'active lorsque le client aura envoyé les données et terminé la connexion. C'est un paramètre par défaut.

Note

Ne pas utiliser cette option s'il faut envoyer un rapport d'informations sur l'état du travail d'impression à l'application tierce. Si la connexion reste ouverte, l'envoi d'un rapport peut être fait en utilisant l'action Envoyer les données au port TCP/IP avec le paramètre Répondre à l'expéditeur.

Sur le nombre de caractères reçus : Spécifie que le déclencheur s'active dès qu'il reçoit le nombre de caractères requis. Dans ce cas, l'application tierce peut garder la connexion ouverte et envoyer continuellement des données. Chaque segment de données doit avoir la même taille.
Selon la séquence de caractères reçue : Spécifie que le déclencheur s'active chaque fois qu'il reçoit le nombre de caractères requis. Utiliser cette option quand la 'fin de données' est toujours identifiée par une chaîne de caractères unique. Cette chaîne peut comporter des caractères spéciaux (binaires) en utilisant le bouton à côté du champ d'édition.
- Inclure dans les données du déclencheur : La séquence de caractères qui détermine l'événement de déclenchement n'est pas coupée des données, mais sera incluse dans les données. Le déclencheur reçoit le flux de données complet.
Lorsque rien de nouveau n'a été reçu dans l'intervalle de temps spécifié : Spécifie que le déclencheur s'active après un temps donné passé depuis le dernier caractère reçu.

Exécution

Autoriser les connexions des hôtes suivants : Spécifie la liste d'adresses IP ou les noms d'hôte des ordinateurs pouvant se connecter au déclencheur. Mettre chaque entrée sur une nouvelle ligne.
Refuser les connexions pour les hôtes suivants : Spécifie la liste d'adresses IP ou les noms d'hôte des ordinateurs qui ne peuvent pas se connecter au déclencheur. Mettre chaque entrée sur une nouvelle ligne.
Message de bienvenue : Spécifie le texte du message qui est renvoyé au client chaque fois qu'il se connecte au déclencheur TCP/IP.
Message de réponse : Spécifie le texte du message qui est renvoyé au client chaque fois que l'action est exécutée. Utiliser cette option quand le client ne se déconnecte pas après la transmission de données et attend la réponse de fin d'exécution de l'action. Si le message de la réponse est codé en dur, il est toujours le même.
Encodage du message : Spécifie le modèle d'encodage des données, de façon à ce que les caractères spéciaux puissent être traités correctement. NiceLabel Automation peut détecter automatiquement l'encodage des données, en fonction de l'entête BOM (fichiers texte), ou de l'attribut d'encodage (fichiers XML).

Autre

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 22. 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, Automation ne peut pas détecter d'erreurs lors de l'exécution. Pour plus d'informations, consulter l'article Mode d'impression synchrone.

Note

Automation 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 DataFileName pointe vers ce fichier. Pour plus d'informations, consulter l'article Variables internes.

Envoi de signaux keepalive (conservation de connexion active)

Votre système de routage réseau peut silencieusement interrompre votre connexion en cas d’absence de trafic TCP/IP pendant quelques minutes. Afin d’éviter d’être déconnecté, vous pouvez choisir d’envoyer périodiquement des signaux keepalive dans NiceLabel Automation.

Activez l’envoi de signaux keepalive dans votre fichier product.config :

Rechercher le dossier système.

%PROGRAMDATA%\NiceLabel\NiceLabel 10
Faire une copie de sauvegarde du fichier product.config.
Ouvrir product.config dans un éditeur de texte. Le fichier a une structure XML.
Ajouter les lignes suivantes :
```
<configuration>
   <IntegrationService>
     <KeepAliveTime>60000</KeepAliveTime>
     <KeepAliveInterval>10000</KeepAliveInterval>
   </IntegrationService>
</configuration>
```
Note

KeepAliveTime (durée en millisecondes) : Spécifie combien de temps la socket TCP doit rester inactive avant qu’Automation envoie un signal keepalive et attende que les paquets acquittés soient retournés.

KeepAliveInterval (intervalle en millisecondes) : Spécifie à quels intervalles envoyer un autre paquet keepalive lorsque l’hôte ne retourne pas de paquets acquittés.

Lorsque le déclencheur TCP/IP reçoit le paquet keepalive et retourne le paquet acquitté, la minuterie KeepAliveTime redémarre.

Les deux valeurs (KeepAliveTime and KeepAliveInterval) sont obligatoires pour permettre l’envoi de signaux keepalive et doivent être supérieures à 0.
Enregistrez le fichier product.config.
Redémarrez votre Automation service.

Les signaux keepalive activés conservent désormais votre connexion active.