Lire les données du fichier

Cette action lit le contenu du fichier fourni et l'enregistre dans la variable. Elle peut lire le contenu de tout type de fichiers, y compris les données binaires.

En principe, le module Automation Builder reçoit les données pour l'impression de l'étiquette avec le déclencheur. Par exemple : Avec le déclencheur fichier, le contenu du fichier déclencheur est automatiquement lu et analysé par des filtres. Mais il faut parfois contourner les filtres pour obtenir des données externes. Après exécution de cette action et sauvegarde des données dans une variable, ces données sont de nouveau utilisables avec une des actions.

Cette action est utile :

  • Pour combiner les données reçues par le déclencheur avec les données sauvegardées dans un fichier.

    • Avertissement :

    Pour charger des données de fichiers binaires (comme des fichiers image bitmap ou d'impression), vérifier que la variable dans laquelle les données lues sont enregistrées est définie comme variable binaire.

  • Pour échanger des données entre les déclencheurs. Un déclencheur prépare les données et les enregistre dans le fichier (en utilisant l'action Enregistrer les données dans le fichier), l'autre déclencheur lit les données.

Fichier: Nom du fichier dans lequel il faut lire les données.

  • Nom de fichier: Emplacement du fichier ou du programme dans lequel cette action va lire les données.

    Le nom et le chemin du fichier peuvent être codés en dur, et le même fichier sera utilisé à chaque fois. Si le nom du fichier est défini sans le chemin, le dossier comportant le fichier de configuration d'Loftware Automation (.MISX) sera utilisé. En utilisant une référence relative au nom de fichier, le dossier avec le fichier .MISX est utilisé comme dossier racine.

    Source de données active le nom de fichier variable. Sélectionner une variable qui contient le chemin et/ou le nom du fichier, ou combiner plusieurs variables pour créer le nom du fichier. Pour plus d'informations, consulter l'article Utilisation des valeurs composées dans le guide utilisateur de Loftware Automation.

    Note

    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 Loftware Automation.

Le groupe Contenu détermine les détails relatifs au contenu du fichier.

  • Variable: Variable qui comporte le contenu du fichier. Il faut définir au moins une variable.

  • Encodage: Spécifie l'encodage des données envoyées. Auto définit automatiquement l'encodage. Si nécessaire, sélectionner le type d'encodage préféré dans le menu déroulant.

    Note

    Il est impossible d'encoder des données si elles proviennent d'une variable binaire. Dans ce cas, la variable contiendra les données telles qu'elles.

Le groupe Ressayer après échec définit comment l'action peut continuer si le fichier spécifié devient inaccessible.

Conseil

Quand Automation Builder ne peut pas accéder au fichier, c'est peut être parce qu'il est verrouillé par une autre application. Si une application écrit encore des données dans le fichier et l'a bloqué en mode exclusif, aucune autre application ne peut l'ouvrir en même temps, même pas en lecture. Les causes de nouvelles tentatives sont les suivantes : le fichier n'existe pas (encore), le dossier n'existe pas (encore), l'utilisateur du service ne dispose pas des droits d'accès au fichier.

  • Nouvelles tentatives: Spécifie le nombre de tentatives pour accéder au fichier. Si la valeur est 0, il n'y aura aucune tentative.

  • Intervalle entre les tentatives: Spécifie l'intervalle de temps entre les essais défini en millisecondes.

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 de programmation d'une ligne qui doit fournir une valeur boolé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. Si elle est activée, l'exécution des actions continue même si l'action en cours a échoué.

    Remarque

    Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées en cas d'échec. 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

    À la fin de l'impression, il est possible d'envoyer la mise à jour du statut à 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.