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

UUID-e7689da1-7fbe-e698-af8e-884c627bf335.png

À 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 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 100. 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. Loftware utilise la syntaxe .NET Framework pour les expressions clasiques. Pour plus d'informations, voir .NET Framework Syntax for Regular Expressions.

  • 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. Loftware utilise une notation pour encoder de tels caractères sous forme lisible, comme <CR> pour Retour Chariot et <LF> pour Passage à la Ligne. Cette option convertit les caractères spéciaux de la syntaxe Loftware en caractères binaires réels.

    Exemple 101. Exemple:

    Quand il reçoit les données "<CR><LF>", Desktop 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.

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.