1. NiceLabel Help Center
  2. Automation
  3. Actions

Général

Ouvrir une étiquette

L'action Ouvrir une étiquette spécifie le fichier de l'étiquette qui va être imprimée. Quand l'action est exécutée, le masque d'étiquette spécifié s'ouvre en mémoire cache. L'étiquette reste en cache tant que les déclencheurs et les événements l'utilisent.

Le nombre d'étiquettes pouvant être ouvertes en même temps n'est pas limité. Quand une étiquette déjà chargée est à nouveau demandée, NiceLabel Automation va d'abord déterminer si une version plus récente est disponible et approuvée pour l'impression, et ouvrira ensuite l'étiquette.

Dans cet exemple, NiceLabel 10 charge l'étiquette label.nlbl du dossier C:\ProjectA\Labels.

C:\ProjectA\Labels\label.nlbl
UUID-85982b89-4df6-ce75-0252-37f1933af2f2.png

S'il ne trouve pas l'étiquette spécifiée, NiceLabel 10 essaye de la trouver à un autre endroit. Pour plus d'informations, consulter l'article Ordre de recherche des fichiers requis dans le guide utilisateur de NiceLabel Designer.

À propos : Ce groupe identifie l'action sélectionnée.

  • Nom : Permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.

  • Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.

  • Type d'action : Information en lecture seule sur le type d'action sélectionné.

Utilisation de chemins relatifs

NiceLabel 10 permet d'utiliser des chemins relatifs pour référencer les fichiers d'étiquettes. Le dossier racine est toujours le dossier où la solution (ou configuration dans le cas où l'action est utilisée dans une configuration NiceLabel Automation) est stockée.

En utilisant la syntaxe suivante, l'étiquette se chargera de façon relative depuis l'emplacement du fichier de configuration. Automation Buildercherchera l'étiquette dans le dossier ProjectA, à deux niveaux plus haut que le dossier actuel, et ensuite dans le dossier Labels.

..\..\ProjectA\Labels\label.nlbl

Le groupe Paramètres définit le fichier de l'étiquette.

  • Nom : Spécifie le nom de l'étiquette. Il peut être codé en dur, et la même étiquette sera imprimée à chaque fois. L'option Source de données permet de définir le nom du fichier dynamiquement. Sélectionner ou créer une variable qui contient le chemin et/ou le nom du fichier, si un déclencheur s'exécute ou un événement survient.

    Astuce

    En général, la valeur est assignée à la variable par un filtre.

    Note

    Utiliser la syntaxe UNC pour les ressources réseau.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

  • Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.

  • Condition : Définit une expression dont le résultat est une valeur bouléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

  • Ignorer l'échec : Spécifie si une erreur doit être ignorée ou non. Quand Ignorer l'échec est activé, l'exécution des actions continue même si l'action en cours a échoué.

    Note

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple 30. Exemple

À la fin de l'impression, vous pouvez envoyer la mise à jour du résultat à une application externe en utilisant l'action Requête HTTP. Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.


  • Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.

Imprimer l'étiquette

Cette action exécute l'impression de l'étiquette. Elle doit toujours être indentée sous l'action Ouvrir l'étiquette. L'indentation permet d'avoir la référence de l'étiquette à imprimer. Ceci permet d'avoir plusieurs étiquettes ouvertes en même temps, et de spécifier l'étiquette à imprimer.

Avec cette commande, l'étiquette s'imprime en utilisant les pilotes définis dans le masque d'étiquette. Si ce pilote d'imprimante n'existe pas sur le système, l'étiquette s'imprime en utilisant le pilote d'impression par défaut. Il est possible de remplacer le pilote d'imprimante en utilisant la commande Définir l'imprimante.

Pour atteindre une haute performance d'impression d'étiquettes, NiceLabel 10 active deux paramètres par défaut :

  • Traitement parallèle. De multiples processus d'impression sont effectués simultanément. Le nombre de tâches d'impression fonctionnant en arrière-plan dépend du matériel, et plus précisément du type de processeur. Chaque noyau de processeur peut contenir une seule thread d'impression. Cette valeur par défaut est modifiable. Pour plus d'informations, consulter l'article Traitement parallèle dans le guide utilisateur de NiceLabel Automation.

  • Mode asynchrone. Dès que le pré-traitement du déclencheur se termine et que les instructions pour le moteur d'impression sont disponibles, la thread d'impression démarre en arrière-plan. Le contrôle est rendu au déclencheur pour qu'il puisse accepter le flux de données entrantes suivant dès que possible. Quand le mode synchrone est activé, le contrôle n'est pas rendu au déclencheur tant que le processus d'impression n'est pas terminé. Cela peut prendre un certain temps, mais le déclencheur a l'avantage d'envoyer un retour d'informations à l'application fournissant les données. Pour plus d'informations, consulter l'article Mode synchrone dans le guide utilisateur de NiceLabel Automation.

    Note

    L'utilisation de l'option Enregistrer l'erreur dans une variable, dans Exécution d'action et Traitement d'Erreurs ne va pas produire de résultats en mode asynchrone, car le déclencheur ne recevra pas de retour du processus d'impression. Pour récupérer des informations du processus d'impression, il faut activer le mode synchrone.

Note

Si l'action Imprimer l'étiquette est indentée sous l'action Boucler, Automation l'exécute dans un mode de session d'impression. C'est un mode d'optimisation de l'impression qui imprime toutes les étiquettes d'une boucle dans un seul fichier d'impression. Pour plus d'informations, consulter l'article Impression en session dans le guide utilisateur de NiceLabel Automation.

À propos : Ce groupe identifie l'action sélectionnée.

  • Nom : Permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.

  • Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.

  • Type d'action : Information en lecture seule sur le type d'action sélectionné.

Quantité : Ce groupe définit le nombre d'étiquettes à imprimer avec le formulaire actif.

  • Étiquettes : Détermine le nombre d'étiquettes imprimées. Source de données spécifie ou ajoute une variable qui définit dynamiquement la quantité d'étiquettes à imprimer.

    Note

    La valeur de variable est généralement assignée par l'action Utiliser un Filtre de Données et doit être un nombre entier.

Toutes (quantité illimitée) : Imprime une quantité d'étiquettes en fonction du masque créé.

Détails d'impression Quantité illimitée

Cette option est utilisée dans deux scénarios.

  1. Commander à l'imprimante d'imprimer la même étiquette continuellement jusqu'à ce qu'elle soit éteinte, ou qu'elle reçoive l'ordre d'effacer sa mémoire tampon.

    Avertissement

    Ce scénario requiert l'installation et l'utilisation du pilote d'imprimante Loftware pour l'impression d'étiquettes.

    Lors de l'impression d'une étiquette fixe, une seule tâche d'impression est envoyée à l'imprimante, avec la quantité définie sur « illimitée ». Les imprimantes d'étiquettes ont un paramètre de commande d'impression pour indiquer l'impression « illimitée ».

    Quand l'étiquette n'est pas fixe mais qu'elle comporte des objets qui changent durant l'impression, comme des compteurs, alors la quantité imprimée sera définie par la quantité maximale supportée par l'imprimante. Le pilote d'imprimante Loftware connaît la quantité limite et imprime toutes les étiquettes possibles.

    Exemple 31. Exemple

    La quantité maximale supportée par l'imprimante est de 32 000. C'est la quantité d'étiquettes qui est imprimée quand l'option Toutes (quantité illimitée) est sélectionnée.


  2. Le déclencheur ne fournit aucune donnée, mais il signale seulement que « l'événement s'est effectué ». La logique pour collecter les données nécessaires se trouve sur l'étiquette. Généralement, une connexion vers une base de données est configurée avec l'étiquette et, à chaque déclenchement, l'étiquette doit se connecter à la base de données et récupérer tous les enregistrements. Dans ce cas, l'option Toutes (quantité illimitée) se comprend comme « imprimer tous les enregistrements de la base de données ».

  • Quantité variable (définie à partir d'une variable d'étiquette) : Spécifie une variable de l'étiquette qui va définir la quantité d'étiquettes à imprimer.

    Le déclencheur ne reçoit pas le nombre d'étiquettes à imprimer, donc il transmet la décision au masque de l'étiquette. L'étiquette peut contenir une connexion à la base de données, qui fournira la quantité d'étiquettes, ou il y a une autre source d'information de quantité. Une variable d'étiquette doit être définie comme « variable de quantité ».

Le groupe Avancé définit les détails de l'impression d'étiquettes. Cliquer sur Afficher les options avancées de l'imprimante pour définir les options d'impression Avancées :

Cette section spécifie les paramètres de quantité liés aux quantités d'étiquettes moins fréquemment utilisés.

  • Nombre d'étiquettes sautées : Définit le nombre d'étiquettes à sauter sur la première page des étiquettes. La feuille d'étiquettes peut avoir déjà été imprimée, mais pas entièrement. Cette feuille peut être utilisée en déplaçant la position de départ. Cette option est applicable pour imprimer les étiquettes sur des feuilles, pas sur des rouleaux d'étiquettes, c'est donc applicable aux imprimantes de bureau mais pas aux imprimantes d'étiquettes.

  • Copies d'étiquettes identiques : Spécifie le nombre de copies d'étiquettes à imprimer pour chaque étiquette unique. Pour des étiquettes fixes, cette option donne le même résultat que l'option principale Nombre d'étiquettes. Avec des étiquettes variables, telles que les étiquettes utilisant des compteurs, ce sera le nombre réel de copies.

  • Nombre de jeux d'étiquettes spécifie combien de fois la totalité de l'impression d'étiquettes doit se répéter.

    Exemple 32. Exemple

    Le déclencheur, ou l'événement, reçoit un contenu de 3 lignes de données formatées en CSV, donc on attend l'impression de 3 étiquettes (1, 2, 3). En mettant cette option à 3, l'impression se fera dans l'ordre suivant : 1, 2, 3, 1, 2, 3, 1, 2, 3.


  • Métadonnées : avec chaque travail d’impression, écrit vos commentaires d’impression au Control Center. Vos métadonnées figurant dans Historique > Impression > colonne Imprimer les métadonnées. Vous pouvez utiliser les métadonnées pour le triage et le filtrage, ainsi que pour d’autres fonctions dans le Control Center. Les métadonnées n’ont aucune incidence sur vos impressions ni sur les flux d’impression. Vous utilisez les métadonnées pour enregistrer vos informations supplémentaires concernant vos travaux d’impression dans le Control Center. Les métadonnées peuvent comprendre le numéro de LOT ou d’autres variables d’étiquette, les noms d’imprimantes et les valeurs générées par l’utilisateur/le système.

    Pro_Enterprise.png

Astuce

Toutes les valeurs du groupe Avancé peuvent être soit codées en dur, soit fournies dynamiquement par une variable nouvelle ou existante.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

  • Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.

  • Condition : Définit une expression dont le résultat est une valeur bouléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

  • Ignorer l'échec : Spécifie si une erreur doit être ignorée ou non. Quand Ignorer l'échec est activé, l'exécution des actions continue même si l'action en cours a échoué.

    Note

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple 33. Exemple

À la fin de l'impression, vous pouvez envoyer la mise à jour du résultat à une application externe en utilisant l'action Requête HTTP. Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.


  • Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.

Exécuter le fichier de commande Oracle XML

Enterprise.png

Exécute l'impression avec les données d'un fichier au format Oracle XML.

NiceLabel Automation est directement compatible avec les fichiers XML ayant la structure Oracle XML, qui sont définis par le logiciel Oracle Warehouse Management.

Cette action est un raccourci. Elle permet d'exécuter directement des fichiers Oracle XML sans avoir besoin de les analyser avec un filtre et de mapper les valeurs aux variables.

Pour pouvoir utiliser cette action, le fichier XML doit être conforme au spécifications Oracle XML. Pour plus d'informations, consulter la section Spécifications d'Oracle XML dans le guide utilisateur de NiceLabel Automation.

Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter la section Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

Info Niveau De Produit

Nécessite Automation Builder.

Comment recevoir un fichier de commande dans un déclencheur et l'exécuter

Quand le déclencheur reçoit le fichier de commande et qu'il faut l'exécuter, effectuer les opérations suivantes :

  1. Dans le module Automation Builder, dans l'onglet Variables , cliquer sur le bouton Variable Internesur le ruban.

  2. Dans le menu déroulant, activer la variable interne DataFileName. Cette variable interne fournit le chemin et le nom du fichier qui contient les données reçues par le déclencheur. Dans ce cas, le contenu est le fichier de commande. Pour plus d'informations, consulter l'article Variables internes dans le guide utilisateur de NiceLabel Automation.

  3. Dans l'onglet Actions, ajouter l'action pour exécuter le fichier de commande, telle qu'Exécuter un Fichier de Commande, Exécuter un Fichier de Commande Oracle XML, ou Exécuter un Fichier de Commande SAP AII XML.

    Pour l'action Lancer le Fichier de Commande, sélectionner le type de fichier de commande dans Type de Fichier.

  4. Activer l'option Variable.

  5. Sélectionner la variable DataFileName dans la liste de variables disponibles.

À propos : Ce groupe identifie l'action sélectionnée.

  • Nom : Permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.

  • Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.

  • Type d'action : Information en lecture seule sur le type d'action sélectionné.

Le groupe Fichier définit le fichier de commande Oracle XML à utiliser.

  • Nom du fichier : Sélectionne le fichier de commande Oracle XML. Il peut être soit codé en dur, soit fourni dynamiquement par une variable nouvelle ou existante.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

  • Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.

  • Condition : Définit une expression dont le résultat est une valeur bouléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

  • Ignorer l'échec : Spécifie si une erreur doit être ignorée ou non. Quand Ignorer l'échec est activé, l'exécution des actions continue même si l'action en cours a échoué.

    Note

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple 34. Exemple

À la fin de l'impression, vous pouvez envoyer la mise à jour du résultat à une application externe en utilisant l'action Requête HTTP. Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.


  • Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.

Exécuter le fichier de commande SAP AII XML

Pro_Enterprise.png

Cette action exécute l'impression avec les données d'un fichier au format SAP AII XML.

NiceLabel Automation est directement compatible avec les fichiers XML ayant la structure "SAP AII XML", qui sont définis par le logiciel SAP.

Cette action est un raccourci. Elle permet d’exécuter directement des fichiers SAP AII XML sans avoir besoin de les analyser avec un filtre. Pour pouvoir utiliser cette action, le fichier XML doit être conforme aux spécifications SAP AII XML. Pour plus d'informations, consulter le chapitre Spécifications SAP AII XML dans le guide utilisateur de NiceLabel Automation.

Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter la section Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

Info Niveau De Produit

Nécessite Automation Builder.

Comment recevoir un fichier de commande dans un déclencheur et l'exécuter

Quand le déclencheur reçoit le fichier de commande et qu'il faut l'exécuter, effectuer les opérations suivantes :

  1. Dans le module Automation Builder, dans l'onglet Variables , cliquer sur le bouton Variable Internesur le ruban.

  2. Dans le menu déroulant, activer la variable interne DataFileName. Cette variable interne fournit le chemin et le nom du fichier qui contient les données reçues par le déclencheur. Dans ce cas, le contenu est le fichier de commande. Pour plus d'informations, consulter l'article Variables internes dans le guide utilisateur de NiceLabel Automation.

  3. Dans l'onglet Actions, ajouter l'action pour exécuter le fichier de commande, telle qu'Exécuter un Fichier de Commande, Exécuter un Fichier de Commande Oracle XML, ou Exécuter un Fichier de Commande SAP AII XML.

    Pour l'action Lancer le Fichier de Commande, sélectionner le type de fichier de commande dans Type de Fichier.

  4. Activer l'option Variable.

  5. Sélectionner la variable DataFileName dans la liste de variables disponibles.

À propos : Ce groupe identifie l'action sélectionnée.

  • Nom : Permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.

  • Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.

  • Type d'action : Information en lecture seule sur le type d'action sélectionné.

Le groupe Fichier définit le fichier de commande SAP AII XML à utiliser.

  • Nom du fichier : sélectionne le fichier de commande SAP AII XML. Il peut être soit codé en dur, soit fourni dynamiquement par une variable nouvelle ou existante.

Le groupeParamètres facultatifs permet de définir le nom de l'étiquettes s'il n'est pas inclus dans le fichier XML.

  • Nom de l'étiquette : Le fichier de l'étiquette sélectionnée pour être utilisée dans le fichier de commande. Il peut être soit codé en dur, soit fourni dynamiquement par une variable nouvelle ou existante.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

  • Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.

  • Condition : Définit une expression dont le résultat est une valeur bouléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

  • Ignorer l'échec : Spécifie si une erreur doit être ignorée ou non. Quand Ignorer l'échec est activé, l'exécution des actions continue même si l'action en cours a échoué.

    Note

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple 35. Exemple

À la fin de l'impression, vous pouvez envoyer la mise à jour du résultat à une application externe en utilisant l'action Requête HTTP. Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.


  • Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.

Exécuter le fichier de commande

Cette action exécute les commandes du fichier de commande sélectionné. Toutes les options de Type de fichier comportent les commandes qu'NiceLabel 10 exécutera de haut en bas.

Les fichiers de commande fournissent généralement des données pour une seule étiquette. Il est possible de définir des fichiers plus complexes. Pour plus d'informations, consulter le chapitre Types de fichiers de commande.

À propos : Ce groupe identifie l'action sélectionnée.

  • Nom : Permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.

  • Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.

  • Type d'action : Information en lecture seule sur le type d'action sélectionné.

Le groupe Fichier définit le type et le nom du fichier de commande à exécuter (JOB, XML or CSV).

  • Type de fichier. Spécifie le type de fichier de commande à exécuter.

  • Nom du fichier. Spécifie le nom du fichier de commande.

    Le Nom du fichier peut être codé en dur, et le même fichier de commande sera utilisé à chaque fois. L'option Variable active le nom de fichier variable. Sélectionner ou créer une variable qui contient le chemin et/ou le nom du fichier, si un déclencheur s'exécute ou un événement survient. En général, la valeur est assignée à la variable par un filtre.

    Utiliser la syntaxe UNC pour les ressources réseau. Pour plus d'informations, consulter la section Accès aux Ressources de Réseau Partagées dans le guide utilisateur de NiceLabel Automation.

Info Niveau De Produit

Nécessite Automation Builder.

Comment recevoir un fichier de commande dans un déclencheur et l'exécuter

Quand le déclencheur reçoit le fichier de commande et qu'il faut l'exécuter, effectuer les opérations suivantes :

  1. Dans le module Automation Builder, dans l'onglet Variables , cliquer sur le bouton Variable Internesur le ruban.

  2. Dans le menu déroulant, activer la variable interne DataFileName. Cette variable interne fournit le chemin et le nom du fichier qui contient les données reçues par le déclencheur. Dans ce cas, le contenu est le fichier de commande. Pour plus d'informations, consulter l'article Variables internes dans le guide utilisateur de NiceLabel Automation.

  3. Dans l'onglet Actions, ajouter l'action pour exécuter le fichier de commande, telle qu'Exécuter un Fichier de Commande, Exécuter un Fichier de Commande Oracle XML, ou Exécuter un Fichier de Commande SAP AII XML.

    Pour l'action Lancer le Fichier de Commande, sélectionner le type de fichier de commande dans Type de Fichier.

  4. Activer l'option Variable.

  5. Sélectionner la variable DataFileName dans la liste de variables disponibles.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

  • Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.

  • Condition : Définit une expression dont le résultat est une valeur bouléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

  • Ignorer l'échec : Spécifie si une erreur doit être ignorée ou non. Quand Ignorer l'échec est activé, l'exécution des actions continue même si l'action en cours a échoué.

    Note

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple 36. Exemple

À la fin de l'impression, vous pouvez envoyer la mise à jour du résultat à une application externe en utilisant l'action Requête HTTP. Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.


  • Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.

Envoyer des commandes personnalisées

Cette action exécute les commandes personnalisées saisies dans NiceLabel.

Cette action doit toujours être indentée dans l'action Ouvrir l'étiquette. Elle comporte toutes les références de l'étiquette à laquelle les commandes s'appliquent. Pour plus d'informations, consulter l'article Utilisation des commandes personnalisées dans le guide utilisateur de NiceLabel Automation.

Note

La majorité des commandes personnalisées sont disponibles avec des actions individuelles, donc dans la plupart des cas, il n'y a pas besoin de commandes personnalisées.

Note

L'action Envoyer des commandes personnalisées est utilisable pour terminer une impression en session. C'est un mode d'optimisation de l'impression qui imprime toutes les étiquettes d'une boucle dans un seul fichier d'impression. Pour terminer une impression en session, indenter l'action Envoyer une commande personnalisée sous l'action Boucler et utiliser la commande SESSIONEND. Pour plus d'informations, consulter les articles Impression en session et Utiliser des commandes personnalisées dans le guide utilisateur de NiceLabel Automation.

À propos : Ce groupe identifie l'action sélectionnée.

  • Nom : Permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.

  • Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.

  • Type d'action : Information en lecture seule sur le type d'action sélectionné.

L'éditeur de Script propose les fonctionnalités suivantes :

  • Insérer une source de données : Permet d'insérer une variable, nouvelle ou existante, dans un script.

  • Éditeur de script : Ouvre l'éditeur qui rend l'écriture du script plus facile et plus efficace.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

  • Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.

  • Condition : Définit une expression dont le résultat est une valeur bouléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

  • Ignorer l'échec : Spécifie si une erreur doit être ignorée ou non. Quand Ignorer l'échec est activé, l'exécution des actions continue même si l'action en cours a échoué.

    Note

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple 37. Exemple

À la fin de l'impression, vous pouvez envoyer la mise à jour du résultat à une application externe en utilisant l'action Requête HTTP. Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.


  • Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.