Méthodes de connecteur de liste

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 élément de liste unique.

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

    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? Notes
    Élément Nom de l’élément de liste. Données dans Objet Aucun Oui

    Ajouter une liste

    Ajoute une liste d’éléments.

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

    Tableau 2. Paramètres de la méthode AddList
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Liste Liste des é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 en fonction de l’existence d’un élément de liste.

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

    Tableau 3. Contient les paramètres de la méthode
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Élément Nom de l’élément de liste que la méthode recherche. Données dans Objet Aucun Oui
    Retour Renvoie la valeur Vrai si l’élément de liste est trouvé, sinon, renvoie la valeur Faux. Données sortantes 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? Notes
    Retour Renvoie le nombre total d’éléments de liste ajoutés. Données sortantes Entier Non applicable Non applicable

    FindByProperty

    Trouve un élément de liste basé sur la clé et 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 du port.

    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? Notes
    Prop Clé de la paire clé-valeur. Données dans Chaîne Aucun Oui
    Valeur Valeur de la paire clé-valeur. 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. Données sortantes Booléen Non applicable Non applicable
    Élément si le paramètre Found a la valeur true, la méthode renvoie l’élément de liste. Données sortantes Objet Non applicable Non applicable

    Texte de recherche

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

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

    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? Notes
    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 expression régulière. Données dans Chaîne Aucun Oui
    Matchtype Option permettant d’indiquer si le type de correspondance sera :
    • Une correspondance exacte
    • Respecter la casse
    • Contenant les caractères spécifiés.
    		 Données entrantes Chaîne Aucun Oui
    Nombre Renvoie le nombre total d’occurrences de la correspondance. Données sortantes Entier Non applicable Non applicable
    Supprimer la liste Renvoie la liste des correspondances. Données sortantes Liste Non applicable Non applicable

    Obtenir un é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 du port.

    Tableau 7. Paramètres de la méthode GetItem
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Index Valeur d’index de l’élément de liste. Données dans Entier Aucun Oui
    Retour Renvoie l’élément de liste. Données sortantes 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 effectuer la configuration, procédez comme suit.
    1. Cliquez sur l’icône des paramètres de la méthode ( icône des paramètres de la méthode.).
    2. Cliquez sur l’icône Ajouter un index (icône Ajouter un index).
    3. Entrez la valeur d’index.
    4. Mettez à 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 la méthode GetList
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Retour Renvoie les éléments de liste et les listes. Données sortantes 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 du port.

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

    Tout supprimer

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

    Inverser

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

    Définir les éléments

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

    Pour effectuer la configuration, procédez comme suit.
    1. Cliquez sur l’icône des paramètres de la méthode ( icône des paramètres de la méthode.).
    2. Cliquez sur l’icône Ajouter un index (icône Ajouter un index).
    3. Entrez la valeur d’index.
    4. Mettez à 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.

      Des données dans le port sont créées avec chaque valeur d’index.

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

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

    Trier

    Trie les éléments de 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? Notes
    Retour Renvoie les éléments de liste sous la forme d’un tableau de liste. Données sortantes Liste de tableaux Non applicable Non applicable