Répertorier les méthodes de connecteur

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 5 minutes de lecture

    • Les méthodes de connecteur de liste effectuent diverses actions sur les éléments de liste dans le cadre d’un workflow d’automatisation. Vous devez d’abord exposer les méthodes avant de les utiliser.

    Ajouter

    Ajoute un seul élément de liste.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 1. Ajouter des paramètres de méthode
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Élément Nom de l’élément de liste. Données dans Objet Aucun Oui

    Liste d’ajouts

    Ajoute une liste d’éléments.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 2. Paramètres de méthode AddList
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ? Notes
    Liste Liste d’éléments. Données dans Objet Aucun Oui Vous pouvez transmettre les éléments de liste à partir d’une variable ou d’un composant approprié.

    Contient

    Renvoie la valeur booléenne selon qu’un élément de liste existe ou non.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 3. Contient les paramètres de méthode
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Élément Nom de l’élément de liste recherché par la méthode. Données dans Objet Aucun Oui
    Retour Renvoie la valeur Vrai si l’élément de liste est trouvé, sinon renvoie la valeur Faux. Sortie de données Booléen Non applicable Non applicable

    Nombre

    Renvoie le nombre total d’éléments de liste ajoutés.

    Tableau 4. Paramètres de la méthode de comptage
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie le nombre total d’éléments de liste ajoutés. Sortie de données Entier Non applicable Non applicable

    FindByProperty

    Recherche un élément de liste en fonction de la clé et de la valeur spécifiées. Vous devez créer au moins un élément de liste de paires clé-valeur avant d’exécuter cette méthode.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 5. Paramètres de la méthode FindByProperty
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Appui Clé dans la paire de valeurs clés. Données dans Chaîne Aucun Oui
    Valeur Valeur de la paire de valeurs clés. Données dans Chaîne Aucun Oui
    Trouvé Renvoie la valeur Vrai si l’élément de liste est trouvé, sinon renvoie la valeur Faux. Sortie de données Booléen Non applicable Non applicable
    Élément si le paramètre Trouvé est Vrai, la méthode renvoie l’élément de liste. Sortie de données Objet Non applicable Non applicable

    FindText

    Recherche du texte ou des regex dans les éléments de liste en fonction du filtre spécifié et renvoie le nombre total d’occurrences du texte et du texte lui-même.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 6. Paramètres de la méthode FindByProperty
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    SearchText Texte que la méthode recherche dans les éléments de liste. Données dans Chaîne Aucun Oui
    Rechercher par Option permettant d’indiquer si la méthode recherche un texte ou une regex. Données dans Chaîne Aucun Oui
    Type de correspondance Option permettant d’indiquer si le type de correspondance sera :
    • Une correspondance exacte
    • Ticket de correspondance
    • Contenant les caractères spécifiés.
    		 Données dans Chaîne Aucun Oui
    Nombre Renvoie le nombre total d’occurrences de la correspondance. Sortie de données Entier Non applicable Non applicable
    Retirer la liste Renvoie la liste des correspondances. Sortie de données Liste Non applicable Non applicable

    Obtenir l’élément

    Renvoie un élément de liste en fonction de sa valeur d’index.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 7. Paramètres de méthode GetItem
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Index Valeur d’index de l’élément de liste. Données dans Entier Aucun Oui
    Retour Renvoie l’élément de liste. Sortie de données Objet Non applicable Non applicable

    Obtenir des éléments

    Renvoie les éléments de liste en fonction de leurs valeurs d’index. Vous devez d’abord configurer les valeurs d’index.

    Pour configurer, procédez comme suit.
    1. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres de méthode.).
    2. Cliquez sur l’icône Ajouter un index ( icône Ajouter un index.).
    3. Entrez la valeur d’index.
    4. Mettre à jour le type de données de la valeur d’index.
    5. Répétez les étapes pour ajouter d’autres valeurs d’index.
    6. Cliquez sur OK.

      Un port de sortie de données est créé avec chaque valeur d’index. Le port de sortie de données renvoie l’élément de liste correspondant à la valeur d’index.

    Obtenir une liste

    Renvoie tous les éléments de liste et les listes créées.

    Tableau 8. Paramètres de méthode GetList
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie les éléments de liste et les listes. Sortie de données Tableau Aucun Non applicable

    Supprimer

    Supprime l’élément de liste spécifié.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 9. Paramètres de méthode GetList
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Élément Élément de liste supprimé par la méthode. Données dans Objet Aucun Oui

    Supprimer tout

    Supprime tous les éléments de liste ajoutés.

    Inverser

    Inverse l’ordre des valeurs d’index des éléments de liste.

    Éléments d’ensemble

    Met à jour les valeurs des éléments de liste. Pour utiliser la méthode, vous devez d’abord la configurer.

    Pour configurer, procédez comme suit.
    1. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres de méthode.).
    2. Cliquez sur l’icône Ajouter un index ( icône Ajouter un index.).
    3. Entrez la valeur d’index.
    4. Mettre à jour le type de données de la valeur d’index.
    5. Répétez les étapes pour ajouter d’autres valeurs d’index.
    6. Cliquez sur OK.

      Un port de données est créé avec chaque valeur d’index.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 10. Paramètres de méthode SetItems
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Élément Accepte la valeur des éléments de la liste. Données dans Objet Aucun Oui

    Trier

    Trie les éléments de la liste.

    ToArray

    Renvoie les éléments de liste sous la forme d’un tableau. Vous devez ajouter plusieurs éléments de liste avant d’exécuter cette méthode.

    Tableau 11. Paramètres de la méthode ToArray
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie les éléments de liste sous la forme d’une liste de tableau. Sortie de données Liste de tableaux Non applicable Non applicable