List package

Le package Liste comprend des actions qui vous permettent d'effectuer diverses opérations sur une variable du type de données Liste.

Utilisation des variables de type de données Liste

Une liste est un ensemble de valeurs ordonnées. Les valeurs peuvent être du sous-type de données Booléen, Chiffre ou Chaîne. Lorsque vous initialisez une variable de liste, vous pouvez sélectionner le sous-type de données N'importe lequel afin de maintenir l'un des trois sous-types de données. Vous pouvez saisir des valeurs manuellement en créant une nouvelle variable ou en sélectionnant une variable existante dans le menu Variables, puis en cliquant sur Ajouter.

Les utilisations courantes des variables de liste incluent :
  • l'envoi d'un e-mail à plusieurs destinataires ;
  • la recherche de plusieurs adresses Web.
Remarque :
  • Le tri des valeurs de liste n'est actuellement pas pris en charge.
  • Il n'est pas possible d'affecter directement des valeurs de l'enregistrement à une liste. Vous pouvez néanmoins utiliser l'action Boucle pour parcourir en boucle tous les éléments de l'enregistrement et les ajouter à la liste de variables.

Actions dans le package Liste

Si vous utilisez une action Liste dans une action Boucle, vous devez utiliser l'itérateur Pour chaque élément de la liste.

Les actions suivantes sont disponibles dans le package Liste :

Action Description
Ajouter un élément Reportez-vous à la rubrique action Ajouter un élément dans List.
Ajouter Reportez-vous à la rubrique action Ajouter dans List.
Attribuer Reportez-vous à la rubrique action Attribuer dans List.
Effacer Reportez-vous à la rubrique action Effacer dans List.
Obtenir un élément Reportez-vous à la rubrique action Obtenir l'élément dans List.
Joindre des éléments Reportez-vous à la rubrique action Joindre des éléments dans List.
Supprimer l'élément Reportez-vous à la rubrique action Supprimer un élément dans List.
Définir un élément Reportez-vous à la rubrique action Définir un élément dans List.
Taille Reportez-vous à la rubrique action Taille dans List.

Exemple

Créez un bot pour ajouter des éléments à une liste et récupérer des données d'une liste. Pour utiliser cette fonctionnalité, procédez comme suit :
  1. Créez un bot.
    1. Dans le panneau de gauche, cliquez sur Automatisation.

      La liste des bots et des formulaires disponibles s'affiche.

    2. Cliquez sur Créer un robot.
    3. Saisissez le nom du bot : ListBot
    4. Cliquez sur Créer et modifier.
  2. Créez les variables suivantes.
    • Variable : StringList
      • Type : Liste
      • Sous-type : Chaîne
      • Nom : StringList
      • Valeur par défaut à 0 : Automation
      • Valeur par défaut à 1 : Anywhere
    • Variable : SampleString
      • Nom : SampleString
      • Valeur par défaut : PvtLtd
    • Variable : ListOutput
      • Type : N'importe lequel
      • Nom : ListOutput
  3. Pour insérer un élément dans une variable de liste, dans le volet Actions, double-cliquez sur l'action Liste > Ajouter un élément ou faites-la glisser.
    1. Dans le champ Variable de liste, sélectionnez StringList.
    2. Dans le champ Éléments à ajouter, sélectionnez SampleString.
    3. Pour insérer l'élément à la fin de la liste, sélectionnez l'option À la fin de la liste.
  4. Pour récupérer une valeur à une position spécifiée dans une liste, dans le volet Actions, double-cliquez sur l'action Liste > Obtenir un élément ou faites-la glisser.
    1. Dans le champ Variable de liste, sélectionnez StringList.
    2. Dans le champ Numéro d'index, saisissez 0. Ce champ permet de spécifier la position dans la liste à partir de laquelle vous souhaitez récupérer une valeur.
    3. Pour stocker la sortie de l'action Attribuer la sortie à la variable de liste, sélectionnez ListOutput.
  5. Pour imprimer la valeur de l'index 0, double-cliquez sur l'action Zone de message ou faites-la glisser. Cliquez sur Enregistrer et sur Exécuter.

    Le bot affiche les données de l'index zéro de la variable de liste, c'est-à-dire Automatisation.