Répertorier les méthodes de connecteur

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture

    • Les méthodes du 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 dans les 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

    AjouterListe

    Ajoute une liste d’éléments.

    Pour fournir des entrées dans les 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 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 selon qu’un élément de liste existe ou non.

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

    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?
    É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 (en anglais seulement)

    Trouve 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 dans les paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 5. Paramètres de méthode FindByProperty
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Appui 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. Sortie de données Booléen Non applicable Non applicable
    Élément si le paramètre Found est True, la méthode retourne l’élément de liste. Sortie de données Objet Non applicable Non applicable

    Texte de recherche

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

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

    Tableau 6. Paramètres de 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
    • Faire correspondre la casse
    • 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
    Outlister Renvoie la liste des correspondances. Sortie de données 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 dans les 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 le configurer, procédez comme suit.
    1. Cliquez sur l’icône des paramètres de méthode (icône des 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. 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 de l’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 dans les 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 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.

    Éléments définis

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

    Pour le configurer, procédez comme suit.
    1. Cliquez sur l’icône des paramètres de méthode (icône des 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. 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.

      Une entrée de données est créée avec chaque valeur d’index.

    Pour fournir des entrées dans les 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 liste. Données dans Objet Aucun Oui

    Trier

    Trie les éléments de liste.

    ToArray (Tableau de données)

    Renvoie les éléments de la liste sous la forme d’un tableau. Vous devez ajouter plus d’un élément 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 la liste sous la forme d’une liste de tableaux. Sortie de données Liste de tableaux Non applicable Non applicable