Variables

Définir une variable

Cette action assigne une nouvelle valeur à la variable sélectionnée.

Généralement, les variable récupèrent leur valeur par l'action Utiliser du filtre de données (dans Automation Builder) qui extrait des champs dans les données reçues et les relie aux variables. Il est parfois nécessaire de définir personnellement les valeurs de variables, souvent en cas de dépannage. Dans Automation Builder, les valeurs de variables ne sont pas mémorisées d'un déclencheur à l'autre, mais sont conservées durant l'utilisation du déclencheur.

Le groupe Variables définit le nom de la variable et sa valeur.

Nom : nom de la variable dont la valeur doit changer.
Valeur : Assigne une nouvelle valeur à la variable sélectionnée.. Elle peut être soit codée en dur, soit fournie 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 49. 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.

Enregistrer les données variables

Cette action enregistre les valeurs d'une ou plusieurs variables dans le fichier associé.

Dans le module NiceLabel Automation cette action permet d'échanger des données entre les déclencheurs. Pour relire les données dans le déclencheur, utiliser l'action Charger les Données Variables.

Astuce

Les valeurs sont enregistrées au format CSV, avec le nom des variables sur la première ligne. Si les variables contiennent des valeurs mufti lignes, les caractères de la nouvelle ligne (CR/LF) sont encodés ainsi : \n\r.

Le groupe Paramètres définit le nom du fichier.

Nom de fichier : nom du fichier dans lequel il faut enregistrer les données variables. Il peut être codé en dur, et les valeurs seront enregistrées chaque fois dans le même fichier.

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.

Le groupe Si le fichier existe gère les options en cas de fichier existant.

Ecraser le fichier : écrase les données existantes avec les nouvelles données variables. L'ancien contenu est perdu.
Joindre les données au fichier : joint les valeurs de la variable au fichier de données existantes.

Le groupe Structure du fichier texte spécifie les paramètres du fichier CSV :

Séparateur : spécifie le type de séparateur (tabulation, point virgule, virgule ou caractère personnalisé). Le séparateur est un caractère qui sépare les valeurs.
Délimiteur de texte : spécifie le caractère qui délimite le contenu du texte.
Encodage du fichier : Spécifie le mode d'encodage utilisé dans le fichier de données. Auto définit automatiquement l'encodage. Si nécessaire, sélectionner le type d'encodage préféré dans le menu déroulant.

Astuce

UTF-8 est une bonne sélection par défaut.
Ajouter les noms des variables dans la première ligne : place le nom de la variable dans la première ligne du fichier.

Le groupe Variables définit les variables dont les valeurs doivent être lues dans le fichier de données. Les valeurs des variables existantes seront remplacées par les valeurs du fichier.

Toutes les variables : spécifie que toutes les variables définies dans le fichier de données devront être lues.
Variables sélectionnées : Spécifie que seules les variables sélectionnées seront lues dans le fichier de données.

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

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 50. Exemple

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.

Charger les données variables

Cette action charge les valeurs d'une ou plusieurs variables enregistrées dans le fichier associé par l'action Enregistrer les données variables . Cette action permet d'échanger des données entre les déclencheurs. Il est possible de charger une variable particulière ou toutes les variables qui existent dans le fichier.

Le groupe Paramètres définit le nom du fichier.

Nom de fichier : Spécifie le fichier duquel il faut charger les données variables. Il peut être codé en dur, et les valeurs seront chargées chaque fois du même fichier.

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.

Les paramètres du groupe Structure du fichier doivent refléter la structure du fichier enregistré par l'action Enregistrer les données variables.

Séparateur : Spécifie le type de séparateur (tabulation, point virgule, virgule ou caractère personnalisé). Le séparateur est un caractère qui sépare les valeurs.
Délimiteur de texte : Spécifie le caractère qui délimite le contenu du texte.
Encodage du fichier : Spécifie le mode d'encodage utilisé dans le fichier de données. Auto définit automatiquement l'encodage. Si nécessaire, sélectionner le type d'encodage préféré dans le menu déroulant.

Astuce

UTF-8 est une bonne sélection par défaut.

Le groupe Variables définit les variables dont les valeurs doivent être chargées.

Toutes les variables : Spécifie que toutes les variables définies dans le fichier de données devront être lues.
Variables sélectionnées : Spécifie que seules les variables sélectionnées seront lues dans le fichier de données.

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

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 51. Exemple

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.

Manipulation de chaîne de caractères

Cette action définit le formatage des données variables sélectionnées.

Les actions les plus utilisées sont : effacer les espaces de début et de fin, rechercher et remplacer des caractères, et effacer les guillemets d'ouverture et de fermeture.

Cette fonctionnalité sert souvent quand un déclencheur reçoit un fichier de données non structuré ou des données anciennes. Dans ce cas, les données doivent être analysées par le filtre de Données non structurées. Cette action permet d'affiner la valeur des données.

Note

Parfois, cette action n'est pas assez puissante pour manipuler une chaîne de caractères. Utiliser alors l'action Exécuter le Script et un script Visual Basic ou Python pour manipuler les données.

Le groupe Variables définit les variables dont les valeurs doivent être formatées.

Toutes le variables : Spécifie toutes les variables définies dans le fichier de données qui devront être formatées.
Variables sélectionnées : Spécifie que seules les variables sélectionnées dans le fichier de données seront formatées.

Le groupe Formater le texte définit les fonctions de manipulation de chaîne de caractères qui seront appliquées aux variables ou champs sélectionnés. Plusieurs fonctions sont utilisables. Les fonctions s'appliqueront dans l'ordre sélectionné dans l'interface utilisateur, de haut en bas.

Supprimer les espaces au début : Enlève tous les caractères d'espacement (code décimal ASCII 32) du début de la chaîne de caractères.
Supprimer les espaces à la fin : Enlève tous les caractères d'espacement (code décimal ASCII 32) à la fin de la chaîne de caractères.
Effacer le caractère d'ouverture fermeture : Efface la première occurrence du caractère d'ouverture et de fermeture trouvé dans la chaîne de caractères.

Exemple 52. Exemple

Si on utilise "{" comme caractère d'ouverture et "}" comme caractère de fermeture, la chaîne d'entrée {{selection}} est convertie en {selection}.

Rechercher et remplacer : Exécute une recherche classique et remplace la fonction selon la valeur fournie pour rechercher et remplacer par. Les expressions régulières sont utilisables.

Note

Il y a plusieurs implémentations des expressions classiques utilisées. NiceLabel 10 utilise la syntaxe .NET Framework pour les expressions clasiques. Pour plus d'informations, consulter la Base de Connaissances article.

Remplacer les caractères non imprimables par des espaces : remplace tous les caractères de contrôle de la chaîne par un espace (code décimal ASCII 32). Les caractères non imprimables sont des caractères avec des valeurs décimales ASCII entre 0–31 et 127–159.
Supprimer les caractères non imprimables : Enlève tous les caractères de contrôle de la chaîne. Les caractères non imprimables sont des caractères avec des valeurs décimales ASCII entre 0–31 et 127–159.
Décoder les caractères spéciaux : Décode les caractères (ou codes de contrôle) qui sont indisponibles sur le clavier, comme le retour chariot ou le passage à la ligne. NiceLabel 10 utilise une notation pour encoder de tels caractères sous forme lisible, tels que <CR> pour Retour Chariot et <LF> pour Passage à la Ligne. Cette option convertit les caractères spéciaux de la syntaxe NiceLabel en caractères binaires réels.

Exemple 53. Exemple

Quand il reçoit les données "<CR><LF>", Designer les utilise comme une chaîne complète de 8 caractères. Il faut activer cette nouvelle option pour interpréter et utiliser les données comme deux caractères binaires CR (Retour Chariot – code ASCII 13) et LF (Passage à la ligne – code ASCII 10).

Rechercher et supprimer tout avant : Recherche la chaîne et enlève les caractères situés avant la chaîne définie. La chaîne de caractères trouvée peut aussi être effacée.
Rechercher et supprimer tout après : Recherche la chaîne et enlève les caractères situés après la chaîne définie. La chaîne de caractères trouvée peut aussi être effacée.
Changement de casse : Modifie tous les caractères dans vos chaînes en lettres capitales ou minuscules.

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

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 54. Exemple

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.