Retour d'informations sur le travail d'impression

L'application qui fournit les données d'impression à NiceLabel Automation veut parfois recevoir des informations concernant l'état des travaux d'impression. Le retour d'informations peut être simple tel que « Tout OK » dans le cas où le travail d'impression est réussi, ou plus détaillé en cas de problème. Pour des raisons de performances, par défaut NiceLabel Automation désactive les possibilités de retour d'informations. Ainsi, l'exécution de l'impression est plus rapide car le déclencheur ne s'occupe pas du processus d'exécution d'impression. Les erreurs sont enregistrées dans le journal de la base de données, mais le déclencheur ne va pas les traiter.

Cette méthode permet aussi d'envoyer des informations concernant les autres données que le déclencheur peut collecter. Par exemple, l'état des imprimantes réseau, le nombre de travaux d'impression dans le spouleur, la liste d'étiquettes dans un dossier, la liste de variables dans le fichier d'étiquette spécifié, etc.

Note

Pour activer le retour d'informations par le moteur d'impression, il faut activer le mode d'impression synchrone. Pour plus d'informations, consulter l'article Mode d'impression synchrone.

Activer le retour d'informations sur le travail d'impression en utilisant l'une des deux méthodes disponibles.

Le déclencheur renvoie les informations concernant l'état des travaux d'impression (Retour synchrone)

Certains déclencheurs ont une capacité de retour d'informations intégrée. Quand le mode d'impression synchrone est activé, le déclencheur connaît en interne l'état du travail d'impression. Le client peut envoyer les données au déclencheur, garder la connexion ouverte et attendre le retour. Pour utiliser cette méthode de retour d'informations, sélectionner utiliser un type de déclencheur qui supporte le retour d'informations.

Si une erreur survient dans une des actions, la variable interne LastActionErrorDesc contient le message d'erreur détaillé. La valeur de ce message peut être utilisée telle quelle ou personnalisée.

Pour plus d'informations, consulter les détails des déclencheurs respectifs.

Déclencheur Web Service : Par défaut, ce déclencheur supporte le retour d'informations. Le document WSDL (Web Service Description Language) décrit les détails concernant l'interface Service Web et indique comment activer le retour d'informations. Utiliser la réponse par défaut qui envoie la description d'erreur en cas de défaillance de l'action d'impression. Ou personnaliser la réponse et renvoyer le contenu d'une variable. La variable peut contenir des données diverses, y compris un aperçu de l'étiquette ou le travail d'impression (données binaires).
Déclencheur serveur HTTP : Par défaut, ce déclencheur supporte le retour d'informations. NiceLabel Automation va utiliser le code de réponse HTTP standard pour indiquer l'état du travail d'impression. La réponse HTTP peut être personnalisée pour renvoyer le contenu d'une variable. La variable peut contenir des données diverses, y compris un aperçu de l'étiquette ou le travail d'impression (données binaires).
Déclencheur serveur TCP/IP : Ce déclencheur supporte le retour d'informations, mais pas automatiquement. Pour qu'il renvoie des informations, il faut configurer le client qui fournit les données pour ne pas interrompre la connexion après l'envoi des données. Après la fin du processus d'impression, l'action suivante dans la liste peut être Envoyer les données au port TCP/IP avec le paramètre Répondre à l'expéditeur activé. Les informations peuvent être renvoyées sur la connexion restée ouverte.

L'action fournit le renvoi d'informations d'état du travail d'impression (retour asynchrone)

Pour les déclencheurs qui ne supportent pas le retour d'informations en interne ou pour envoyer des messages d'information durant le traitement du déclencheur, il est possible de définir une action qui renverra les informations à une destination donnée. Dans ce cas, l'application fournissant les données peut fermer la connexion dès que les données pour le déclencheur ont été fournies.

Exemple 92. Exemple

Le déclencheur TCP/IP est utilisé pour collecter les données. Le client a terminé la connexion immédiatement après l'envoi des données, donc nous ne pouvons pas répondre sur la même connexion. Dans ce cas, les informations sont renvoyées sur un autre canal. Vous pouvez configurer une des actions de connexion sortante, telle que Exécuter l'instruction SQL, Ouvrir Document/Programme, Requête HTTP, Envoyer les données au port TCP/IP et autres. Il faut alors placer cette action dans l'action Imprimer l'étiquette.

Pour renvoyer des informations sur un statut spécifique, tel que « erreur survenue », utiliser l'une des méthodes suivantes.

Utiliser la condition de l'action : L'état du travail d'impression est exposé dans deux variables internes (LastActionErrorID et LastActionErrorDesc). La première contient l'ID de l'erreur ou la valeur 0 en l'absence d'erreur. La seconde contient un message d'erreur détaillé. Les valeurs de ces variables sont utilisables dans les conditions des actions à exécuter en cas d'erreur. Par exemple, vous pouvez utiliser l'action Requête HTTP à la fin de l'impression. L'action renverrait un retour d'informations en cas d'erreur. Pour activer ce retour, effectuer les opérations suivantes :
1. Ouvrir les propriétés du déclencheur.
2. Dans le groupe de ruban Variable, cliquer sur Variables internes et activer la variable ActionLastErrorID.
3. Aller sur l'onglet Actions.
4. Ajouter l'action Envoyer les données à HTTP.
5. Dans les propriétés de l'action, étendre Afficher les options d'exécution et de traitement d'erreurs.
6. Pour Condition, saisir ce qui suit. L'action ayant cette condition s'exécute seulement si l'erreur survient et si LastErrorActionID contient l'ID de l'erreur (toute valeur plus grande que 0). Par défaut, les conditions s'exécutent en utilisant la syntaxe VB Script.
  
  ActionLastErrorID > 0
7. Vous devez aussi activer l'option Ignorer l'échec sur chaque action qui va échouer. Cela prévient Automation de ne pas arrêter complètement l'exécution des actions, mais de continuer par l'action suivante au même niveau hiérarchique.
  
  Note
  
  Pour plus d'informations, consulter l'article Traitement d'erreur.
Utiliser l'action Essayer : L'action Essayer élimine le besoin de coder les conditions. L'action fournit deux espaces réservés. L'espace réservé Do (faire) contient les actions à exécuter. Si une erreur survient, l'exécution s'interrompt et les actions dans l'espace réservé Pour erreur sont exécutées. Les actions de connectivité du trafic en sortie de cet espace réservé sont utilisées pour renvoyer les informations sur le statut du travail d'impression. Pour plus d'informations, consulter l'article Essayer.