Générateur d\'expressions

Utilisez le générateur d\'expressions pour créer des expressions simples ou complexes de manière simplifiée.

Lorsque vous créez une automatisation, dans le panneau des propriétés de l\'Action, pour certains actions qui permettent l\'accès aux variables, vous pouvez soit entrer une valeur, soit cliquer sur Insérer une valeur dans le champ de propriété pour construire le type d\'expression que vous souhaitez créer.

Avantages

  • L\'assistant de création d\'expressions facile à utiliser vous aide à construire des expressions complexes plus rapidement et avec plus de précision, vous faisant ainsi gagner un temps précieux.
  • Le processus de création d\'expressions devient plus intuitif et explicite. Vous pouvez facilement définir ou modifier la valeur d\'une variable à l\'aide de la liste de référence intégrée des méthodes correspondantes à choisir.
  • Vous pouvez prévisualiser l\'expression, et si l\'expression que vous avez construite est invalide, une icône d\'erreur s\'affichera dans la prévisualisation. Cela vous aide à valider et vérifier la syntaxe de votre expression pour vous assurer qu\'elle s\'exécutera sans erreur.

Fonctionnalités

Le générateur d\'expressions fournit les fonctionnalités suivantes :
  • Fournit un support plus approfondi pour les propriétés (par nom, index ou méthode) : Lorsque vous utilisez une variable telle qu\'une liste, un dictionnaire ou un enregistrement, vous pouvez accéder à la valeur soit par nom, soit par un numéro d\'index spécifique, ou en utilisant des méthodes applicables (par exemple, la méthode listGet pour les listes, la méthode DictionaryToString pour les dictionnaires) pour déterminer l\'index de manière dynamique.
    • Nom : Une clé utilisée comme identifiant unique associé à une valeur.
    • Index : Un index fait référence à des données qui pointent vers un emplacement spécifique dans la table, l\'enregistrement, la liste, etc.
    • Méthode : Les méthodes sont des fonctions qui sont appelées sur des objets. Ils jouent un rôle crucial dans la modification ou l\'accès aux propriétés de l\'objet.

    Exemple : $Inventaire_Stock_2025[4]{"\"Date de fabrication\""}$

    Propriétés prises en charge

  • Prise en charge de l\'ajout d\'expressions avec des arguments : Lorsque vous sélectionnez une méthode en fonction du type de variable, vous pouvez entrer des paramètres/arguments pour la méthode. Un argument est la valeur réelle qui est passée à la méthode lorsqu\'elle est appelée.

    Exemple, Variable = $Données_Employé_2025$

    Méthode : Chaîne majuscule-Majuscule (Convertir la chaîne à l\'index 0 en majuscule).

    Nouvelle expression : $Employee_Data_2025[0].String:uppercase$

    Dans ce cas, String:uppercase est une méthode de l\'objet chaîne qui renvoie la version en majuscules de la chaîne.

    Ajouter des expressions avec des arguments

  • Capacité à construire des expressions imbriquées: Vous pouvez créer une expression pour un nom, un index ou une méthode qui contient d\'autres expressions en son sein. Créer des expressions imbriquées rend les expressions complexes plus faciles à lire, à modifier et à déboguer.

    Exemple: $listOfDates[0].Datetime.get[0].Number:toString$

    Capacité à construire des expressions imbriquées

  • Reprise à partir de l\'expression surlignée : En sélectionnant l\'expression entière dans la zone de texte de la propriété et en cliquant sur (x), vous ouvrez le générateur d\'expressions. Ici, l\'expression entière est séparée selon la variable, la méthode et l\'argument, vous donnant un contrôle total pour construire une expression supplémentaire ou mettre à jour les valeurs existantes selon vos besoins.

    Exemple : Vous sélectionnez l\'expression $Dictionary_Var(name)$ et cliquez sur (x) dans la fenêtre de création d\'expression. Il vous montre l\'expression que vous avez sélectionnée. Sélectionnez Méthode et choisissez String trim-Trim pour supprimer les espaces de la chaîne. La nouvelle expression que vous construirez sera $Dictionary_Var{name}.String:trim$.

    Reprise à partir de l\'expression surlignée

Expressions de construction

Le tableau suivant explique les différentes manières de construire des expressions.
Option Description
Saisir l\'expression manuellement Lorsque vous créez une automatisation dans le Éditeur de Bot, vous pouvez saisir manuellement une expression dans le champ des propriétés de l\'action, ce qui permet d\'utiliser des variables en entrée.

Lorsque vous saisissez une variable, le système propose une liste de variables système et définies par l\'utilisateur. Cette liste est filtrée en fonction du texte que vous tapez, vous guidant dans la création de votre automatisation.

Après avoir saisi ou sélectionné une variable, vous pouvez choisir les méthodes correspondantes en entrant un point (.) après le nom de la variable. Cette fonctionnalité vous permet d\'entrer une combinaison de texte statique et de variables, améliorant ainsi la flexibilité de la création de votre automatisation.

Lorsque vous saisissez une expression, et si l\'expression n\'est pas valide, l\'erreur est mise en évidence avec le message d\'erreur pertinent, ce qui vous aide à identifier et corriger rapidement toute erreur.

Utilisation du générateur d\'expressions

Une alternative à la méthode ci-dessus, en tant que développeur, est de créer une expression à l\'aide du générateur d\'expressions. Appuyez sur F2 ou cliquez sur l\'icône (x) pour insérer une valeur dans la zone de texte de la propriété.

Lorsque vous ouvrez le générateur d\'expressions, il vous propose une gamme de composants parmi lesquels choisir, y compris des variables (à la fois système et définies par l\'utilisateur) et des valeurs globales. Cette flexibilité vous permet de créer des expressions qui répondent à vos besoins spécifiques.

Lors de la sélection d\'une variable, le système vous fournit une liste de méthodes et d\'arguments correspondants. Cette orientation vous permet de faire des choix éclairés lors de la construction de votre expression, améliorant ainsi la qualité de votre travail.

Après avoir sélectionné les variables et les méthodes, vous pouvez prévisualiser l\'expression que vous avez construite, et une icône d\'erreur s\'affiche si l\'expression n\'est pas valide. De plus, vous pouvez sélectionner des variables et des méthodes de manière itérative pour construire une expression. Cette fonctionnalité vous donne un contrôle total sur la construction de votre expression, vous permettant de l\'affiner jusqu\'à ce qu\'elle réponde à vos exigences spécifiques.