Déclencheur client TCP/IP

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

Le déclencheur client TCP/IP transforme votre Automation en un client d'écoute qui se connecte aux serveurs TCP/IP. Plusieurs appareils et systèmes endossent le rôle d'un serveur TCP/IP : systèmes d'inspection visuelle, imprimantes, automates programmables industriels (PLC), lecteurs, balances, etc. Automation peut s'y connecter et attendre les données entrantes. Après avoir reçu un certain nombre de caractères, une séquence de caractères ou un délai d'expiration, le déclencheur client TCP/IP s'active et commence à exécuter vos actions. Si la connexion échoue, le déclencheur vous permet de vous reconnecter automatiquement.

Utilisation typique : Vous imprimez automatiquement plusieurs types d'étiquettes d'emballages en utilisant une imprimante réseau. Il est crucial que vous sachiez à quel moment votre imprimante a terminé d'imprimer un type d'étiquette avant de commencer à en imprimer un autre. Le déclencheur client TCP/IP vous permet de définir la vérification automatisée permanente de la disponibilité de l'imprimante. Pendant que vous imprimez le premier type d'étiquette, le déclencheur client TCP/IP vérifie le statut de l'impression, et lorsque l'imprimante a terminé, il envoie un message à Automation pour envoyer l'autre type d'étiquette en impression.

Général

Serveur de destination : Saisir l'emplacement (adresse IP ou nom de l'hôte) du serveur TCP/IP auquel vous voulez vous connecter.
Port : Spécifie le numéro de port hôte à partir duquel vous allez recevoir les données entrantes. Assurez-vous que les ports de votre pare-feu sont ouverts côté serveur.
Intervalle de reconnexion au serveur : Définit le temps en millisecondes au bout duquel votre Automation tente de se reconnecter à votre serveur TCP/IP.
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, le serveur 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.
Si 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

Message d'initialisation : Message texte qui arrive sur le serveur dès qu'Automation établit la connexion.
Message de réponse : Spécifie le texte du message qui est renvoyé au serveur à l'activation du déclencheur (avant que les actions ne commencent à être exécutées).
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 23. 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 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.

Note

Note

Note