Méthodes du connecteur de table

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 17 minutes de lecture

    • Le connecteur Table fournit plusieurs méthodes qui effectuent diverses actions sur les données tabulaires dans le cadre d’une automatisation Workflow dans le Studio de conception de bureau de RPA. Par exemple, des tâches telles que l’obtention d’une table, l’obtention de données de ligne et la suppression de lignes vides.

    Réglable

    Insère une table dans le workflow. La méthode SetTable doit être utilisée avant d’effectuer toute autre opération sur une table de données. Vous devez fournir l’objet de table qui doit être défini.
    Tableau 1. Paramètres définissables
    Nom de paramètre Description Type de port de données Type de données
    Table Nom de la table que vous souhaitez ajouter ou modifier.
    Exemple
    Table de données
    		 Données dans Table de données

    Ajouter une colonne

    Ajoute une colonne à une table. La position de la colonne est déterminée par la valeur de l’index de colonne que vous spécifiez. Vous devez fournir le nom de la nouvelle colonne et l’index de colonne auquel la nouvelle colonne doit être ajoutée.
    Tableau 2. Paramètres AddColumn
    Nom de paramètre Description Type de données
    Nom Nom de la nouvelle colonne que vous souhaitez ajouter.
    Exemple
    Données client
    		 Chaîne
    Index de colonne Index de la colonne dans laquelle la nouvelle colonne doit être ajoutée. Par défaut, -1 est la valeur d’index que vous pouvez mettre à jour. Par exemple, 0, 1, 2 peut indiquer la position des colonnes de gauche à droite. Entier

    Ajouter des colonnes

    Ajoute plusieurs colonnes à une table en acceptant les noms de colonnes d’une autre méthode ou d’un autre composant. Pour afficher les colonnes ajoutées, utilisez la méthode GetTable. Vous devez fournir une liste de noms de nouvelles colonnes qui doivent être ajoutées dans la table de données.
    Tableau 3. Paramètres AddColumns
    Nom de paramètre Description Type de données
    Prénoms Accepte les noms de colonnes sous la forme d’un tableau, d’une liste de tableaux ou d’une liste.
    Exemple
    { « OrderID », « CustomerName », « OrderDate », « Status"} ;
    		 IEnumerable

    Ajouter une ligne

    Ajoute une ligne et son contenu à l’index spécifié. Vous devez fournir l’index de ligne auquel la ligne doit être ajoutée.

    Pour définir les valeurs d’index dans lesquelles vous ajoutez le contenu de la ligne, procédez comme suit :

    1. Cliquez sur l’icône Paramètres du composant ( Icône Paramètres du composant.).
    2. Cliquez sur l’icône Ajouter un index ( icône Ajouter un index.).
    3. Entrez l’index.
    4. Répétez les étapes pour ajouter plusieurs index.
    5. Cliquez sur OK.
      Remarque :
      Un port d’entrée de données est ajouté à chaque ligne que vous ajoutez.
    Tableau 4. Paramètres AddRow
    Nom de paramètre Description Type de port de données Type de données
    Index de ligne Index de la ligne à laquelle la nouvelle ligne doit être ajoutée. Données dans Entier

    GetTable

    Renvoie la table que vous avez créée avec les méthodes AddColumn, AddColumns et AddRow.
    Remarque :
    Vous devez exécuter cette méthode après avoir exécuté les méthodes AddColumn, AddColumns et AddRow.
    Tableau 5. Paramètres GetTable
    Nom de paramètre Description Type de port de données Type de données
    Table de données Renvoie le type DataTable représentant l’objet DataTable sous-jacent. Sortie de données Table de données

    Effacer les colonnes

    Efface toutes les valeurs de colonne d’une table.

    Lignes claires

    Efface toutes les valeurs de ligne d’une table.

    Supprimer ColumnByIndex

    Supprime une colonne en fonction de la valeur d’index que vous spécifiez. Vous devez fournir l’index de la colonne à supprimer au paramètre Index.
    Tableau 6. Paramètres DeleteColumnByIndex
    Nom de paramètre Description Type de port de données Type de données
    index Valeur d’index de la colonne qui doit être supprimée. Données dans Entier

    Supprimer ColumnByName

    Supprime une colonne en fonction du nom que vous spécifiez. Vous devez fournir le nom de la colonne à supprimer.
    Tableau 7. Paramètres DeleteColumnByName
    Nom de paramètre Description Type de port de données Type de données
    Nom Nom de la colonne qui doit être supprimée. Données dans Chaîne

    Supprimer la ligne

    Supprime une ligne en fonction de la valeur d’index fournie. Avant d’exécuter cette méthode, vous devez affecter des valeurs d’index personnalisées aux lignes. Vous devez fournir l’index de la ligne qui doit être supprimée.
    Tableau 8. Paramètres DeleteRow
    Nom de paramètre Description Type de port de données Type de données
    index Index de la ligne qui doit être supprimée. Données dans Entier

    FiltreAndTri

    Filtre et trie la table en fonction d’une expression que vous spécifiez. Vous devez fournir l’expression pour calculer la valeur d’une colonne, le nom de colonne à trier dans SortColumnName et Order. Elle renvoie le nombre de lignes disponibles en fonction de l’ensemble de critères et renvoie également la table de données complète.
    Tableau 9. Paramètres FilterAndSort
    Nom de paramètre Description Type de port de données Type de données
    Expression Expression permettant de calculer la valeur d’une colonne.
    Exemple
    « État = 'En attente' » : en fonction de cette expression de requête, les données sont filtrées.
    		 Données dans Chaîne
    Nom de la colonne de tri Nom de colonne utilisé par la méthode pour trier les données.
    Exemple
    Date : la méthode trie les données en fonction de la colonne Date.
    		 Données dans Chaîne
    Commande Ordre du nom de colonne Données dans Chaîne
    Table de données Renvoie la table de données contenant les données filtrées de l’objet DataTable sous-jacent. Sortie de données Table de données
    Nombre Renvoie le nombre de lignes après le tri. Sortie de données Entier

    FiltreParRegEx

    Filtre les données de la table en fonction d’une expression régulière ou RegEx que vous spécifiez. Vous devez fournir l’index de colonne au paramètre ColumnIndex et l’expression régulière au paramètre RegExpression, qui sont utilisés pour le filtrage. Cette méthode renvoie le nombre de lignes et la table de données.
    Tableau 10. Paramètres FilterByRegEx
    Nom de paramètre Description Type de port de données Type de données
    Index de colonne Index de colonne sur laquelle la logique de filtrage doit être appliquée. La valeur d’index par défaut est -1 pour la première colonne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier
    Expression de regExpression Expression régulière qui est utilisée comme logique de filtrage. Données dans Chaîne
    Retour Renvoie une table de données contenant des données filtrées à partir de l’objet DataTable sous-jacent. Sortie de données Table de données
    Nombre de lignes Renvoie le nombre de lignes disponibles en fonction du filtre à l’aide de RegExpression. Sortie de données Entier

    FindText

    Recherche le texte dans la table que vous spécifiez en fonction d’un ou de plusieurs critères et renvoie la valeur de la cellule. Vous devez fournir le texte à rechercher dans le paramètre SearchText, la position à partir de laquelle la recherche doit commencer dans StartPosition et le type de correspondance requis.
    Tableau 11. Paramètres FindText
    Nom de paramètre Description Type de port de données Type de données
    SearchText Texte à rechercher dans la table.
    Exemple
    « John Doe »
    		 Données dans Chaîne
    Position de départ Position de la colonne à partir de laquelle la recherche doit commencer. Données dans Entier
    Type de correspondance Type de correspondance du texte :
    • ExactMatch : le texte spécifié et le texte recherché doivent correspondre exactement. Il s’agit d’une valeur par défaut.
    • MatchCase : la casse de texte spécifiée doit correspondre à la casse du texte recherché.
    • Contient : Le texte spécifié doit contenir un ou plusieurs caractères du texte recherché.
    		 Données dans Type de correspondance
    Valeur de cellule Renvoie la valeur de la cellule en fonction de la recherche. Sortie de données Objet
    ColIndex Renvoie l’index de la colonne contenant le texte recherché. Sortie de données Entier
    Index de ligne Renvoie l’index de la ligne qui contient le texte recherché. Sortie de données Entier

    GetCellValue

    Renvoie la valeur d’une cellule en fonction des valeurs d’index de ligne et de colonne que vous spécifiez. Vous devez fournir le numéro de ligne et le numéro de colonne de la cellule à partir de laquelle la valeur doit être récupérée.
    Tableau 12. Paramètres GetCellValue
    Nom de paramètre Description Type de port de données Type de données
    Ligne Numéro de ligne de la cellule requise. Données dans Entier
    Colonne Numéro de colonne de la cellule requise. Données dans Entier
    Retour Renvoie le type d’objet représentant la valeur de cellule de l’objet DataTable sous-jacent. Sortie de données Objet

    GetCellValueIfRowHas

    Renvoie la valeur True si la méthode trouve le texte que vous spécifiez et les valeurs des lignes en fonction des valeurs d’index que vous spécifiez. Vous devez fournir le texte à rechercher. Effectuez la recherche sur une colonne particulière fournie par SearchColumnIndex et commencez à rechercher le texte à partir d’une ligne particulière fournie à StartRowIndex. La valeur par défaut est 1, ce qui signifie la 1ère ligne du tableau.

    Pour spécifier les valeurs des lignes, vous devez configurer la méthode.

    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 de ligne ( Ajouter un index de ligne.).
    3. Mettez à jour le type de données de la valeur d’index de ligne.
    4. Saisissez la valeur de l’index de ligne.
    5. Cliquez sur OK.
    Tableau 13. Paramètres GetCellValueIfRowHas
    Nom de paramètre Description Type de port de données Type de données
    SearchText Texte à rechercher dans la ligne.
    Exemple
    « John Doe »
    		 Données dans Chaîne
    Index de colonne de recherche Index de colonne dans laquelle le texte doit être recherché. Données dans Entier
    Index StartRowIndex Ligne de début à partir de laquelle la recherche doit être effectuée. Données dans Entier
    Trouvé Renvoie la valeur true si le texte correspond. Sortie de données Booléen

    GetCellValues

    Renvoie les valeurs des cellules multiples en fonction des valeurs d’index que vous spécifiez. Vous devez fournir l’index de ligne de la cellule dont la valeur doit être récupérée. Des index de lignes supplémentaires peuvent également être ajoutés pour obtenir ces valeurs de cellule à l’aide de la fenêtre de configuration.

    Pour configurer, effectuez les actions suivantes :

    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 de ligne ( Ajouter un index de ligne.).
    3. Mettez à jour le type de données de la valeur d’index de ligne.
    4. Saisissez la valeur de l’index de ligne.
    5. Cliquez sur OK.
    Tableau 14. Paramètres GetCellValue
    Nom de paramètre Description Type de port de données Type de données
    Index de ligne Index de la ligne dont la valeur de cellule est requise. Données dans Entier

    GetCount

    Renvoie le nombre total de lignes et de colonnes d’une table de données.

    Tableau 15. Paramètres GetCount
    Nom de paramètre Description Type de port de données Type de données
    Ligne Renvoie le nombre total de lignes créées. Sortie de données Entier
    Colonne Renvoie le nombre total de colonnes créées. Sortie de données Entier

    GetRowData

    Renvoie les données de la ligne en fonction de la valeur d’index que vous spécifiez. Vous devez fournir la valeur d’index de la ligne à partir de laquelle les données doivent être récupérées.
    Tableau 16. Paramètres GetRowData
    Nom de paramètre Description Type de port de données Type de données
    Index de ligne Valeur d’index de la ligne à partir de laquelle les données doivent être récupérées. Données dans Entier
    Retour Renvoie la liste de type d’objet représentant les données de ligne de l’objet DataTable sous-jacent. Le type de données IEnumerable accepte les données de la valeur de ligne sous forme de tableau, de liste ou de liste de tableau et les renvoie en tant qu’objet. Sortie de données IEnumerable

    GetTableAsCSV

    Enregistre les données de table au format CSV sur le lecteur local. Vous devez fournir le chemin d’accès dans lequel le fichier CSV doit être écrit et également fournir le séparateur entre les deux enregistrements.
    Tableau 17. Paramètres GetTableAsCSV
    Nom de paramètre Description Type de port de données Type de données
    Chemin d’accès au fichier Chemin d’accès du dossier dans le lecteur local où la méthode enregistre les données de table au format CSV. Dans le chemin d’accès au fichier, vous devez inclure le nom du fichier.
    Exemple
    D :\Projects\Customer data.csv
    		 Données dans Chaîne
    Délimiteur Délimiteur qui sépare les données de la table.
    Exemple
    Virgule (« , »)
    		 Données dans Chaîne

    GetTableAsHTML

    Renvoie les données de la table dans un format de fichier HTML. Avant d’exécuter cette méthode, vous devez créer des colonnes, des lignes et des données, puis les exécuter avec la méthode GetTable.
    Tableau 18. Paramètres GetTableAsHTML
    Nom de paramètre Description Type de port de données Type de données
    Retour Renvoie les données tabulaires au format HTML. Données dans Chaîne

    GetTableAsJson

    Renvoie les données de la table au format de fichier JSON. Avant d’exécuter cette méthode, vous devez créer des colonnes, des lignes et des données, puis les exécuter avec la méthode GetTable.
    Tableau 19. Paramètres GetTableAsJson
    Nom de paramètre Description Type de port de données Type de données
    Retour Renvoie les données tabulaires sous forme d’objet JSON. Données dans Chaîne

    LoadFromExcel

    Importe la feuille ou les données du fichier Excel spécifié dans la table de données. Vous devez fournir le chemin du fichier Excel à partir duquel les données doivent être chargées. Donnez le nom de la feuille ou fournissez une requête au paramètre SheetOrQuery. Si une requête est fournie, définissez le booléen IsQuery sur Vrai, et si un nom de feuille est fourni, définissez le booléen IsQuery sur Faux. Vous pouvez tester si les données ont été importées correctement avec la méthode GetTable.
    Tableau 20. Paramètres LoadFromExcel
    Nom de paramètre Description Type de port de données Type de données
    FilePath Chemin d’accès au fichier Excel à partir duquel les données sont importées.
    D :\Projects\Sales\Sales data.xlsx
    		 Données dans Chaîne
    FeuilleOuRequête Indique si les données sont importées à partir d’une feuille dans le fichier Excel ou via une requête dans le fichier. Données dans Chaîne
    Requête IsQuery Valeur booléenne indiquant si les données sont chargées via une requête. Données dans Booléen

    Colonne de correspondance

    Associe les colonnes d’une autre table de données à la colonne de la table actuelle en fonction de l’index de colonne. Vous devez fournir la table de données dont les colonnes doivent être mises en correspondance fournie dans dtTable avec l’index de colonne dans la table actuelle dans le paramètre ColumnIndex. Avant d’exécuter cette méthode, vous devez exécuter la méthode GetTable.
    Tableau 21. Paramètres MatchColumn
    Nom de paramètre Description Type de port de données Type de données
    dtTable Table de données dont les colonnes doivent être mises en correspondance. Données dans Table de données
    Index de colonne Index de la colonne avec laquelle il doit être associé. Données dans Entier
    Retour Renvoie une valeur vrai ou faux indiquant si la colonne spécifiée est mise en correspondance. Sortie de données Booléen

    RemoveEmptyColumns

    Supprime toutes les colonnes vides de la table et renvoie la table de données après l’opération.
    Tableau 22. Paramètres RemoveEmptyColumns
    Nom de paramètre Description Type de port de données Type de données
    Retour Renvoie la table de données après avoir supprimé les colonnes vides. Sortie de données Table de données

    RemoveEmptyRows

    Supprime toutes les lignes vides de la table et renvoie la table de données après l’opération.
    Tableau 23. Paramètres RemoveEmptyRows
    Nom de paramètre Description Type de port de données Type de données
    Retour Renvoie la table de données après avoir supprimé les lignes vides. Sortie de données Table de données

    Valeur SetCellValue

    Ajoute des données à une cellule en fonction des valeurs d’index de colonne et de ligne. Vous devez fournir le numéro de ligne, le numéro de colonne et la valeur dans le paramètre Valeur qui doit être défini.

    Avant d’exécuter cette méthode, vous devez créer des colonnes, des lignes et des données, puis les exécuter avec la méthode GetTable.

    Tableau 24. Paramètres SetCellValue
    Nom de paramètre Description Type de port de données Type de données
    Ligne Numéro d’index de la ligne que la méthode utilisera pour remplir les données. Données dans Entier
    Colonne Numéro d’index de la colonne que la méthode utilisera pour remplir les données. Données dans Entier
    Valeur Valeur qui doit être définie dans la cellule. Données dans Objet

    SetCellValueIfRowHas

    Définit la ou les valeurs de cellule d’une ligne particulière si la ligne contient du texte spécifié. Vous devez fournir l’index de ligne dans la boîte de dialogue de configuration de l’index de ligne. Le nom du paramètre d’index de ligne ajouté est pris en compte pour définir la valeur et la valeur fournie à ce paramètre est la valeur réelle qui sera définie sur la ligne de la table.
    Tableau 25. Paramètres SetCellValueIfRowHas
    Nom de paramètre Description Type de port de données Type de données
    SearchText Texte à rechercher dans la ligne. Données dans Chaîne
    Index de colonne de recherche Index de la colonne dans laquelle le texte doit faire l’objet d’une recherche. Données dans Entier
    Index StartRowIndex Ligne de départ à partir de laquelle le texte doit faire l’objet d’une recherche. Données dans Entier
    Trouvé Renvoie la valeur vrai si le texte correspond. Sortie de données Booléen

    SetColumnName

    Met à jour un nom de colonne en fonction de l’index et du nom de colonne que vous spécifiez. Vous devez d’abord créer ou importer une table à l’aide de la méthode SetTable.
    Tableau 26. Paramètres SetColumnName
    Nom de paramètre Description Type de port de données Type de données
    Index de colonne Index de la colonne qui doit être nommée. Données dans Entier
    Nom Nouveau nom de la colonne. Données dans Chaîne

    SetJson

    Convertit un objet JSON en table de données. Fournissez les données JSON qui doivent être converties en table de données.
    Conseil :
    Pour créer un objet JSON, utilisez la méthode GetTableAsJson, puis transmettez les valeurs à la méthode SetJson.
    Tableau 27. Paramètres SetJson
    Nom de paramètre Description Type de port de données Type de données
    JSON L’objet JSON doit être converti en DataTable. Données dans Chaîne

    Liste d’ensemble

    Convertit une liste en table de données. Fournissez la liste de données qui doit être convertie en table.
    Tableau 28. Paramètres SetList
    Nom de paramètre Description Type de port de données Type de données
    Données Données de type liste qui doivent être converties en table. Le type de données d’entrée IEnumerable accepte les données sous forme de tableau, de liste ou de liste de tableau.
    { « OrderID » : 102, « CustomerName » : « John Doe », « OrderDate » : « 2024-02-02 », « Status » : « Expédié » } ;
    		 Données dans IEnumerable

    SetRowData

    Insère les données de ligne spécifiées dans une table de données. Vous devez fournir le numéro d’index de la ligne au paramètre RowIndex et les données qui doivent être ajoutées à la ligne au paramètre Data.
    Tableau 29. Paramètres SetRowData
    Nom de paramètre Description Type de port de données Type de données
    Index de ligne Numéro d’index de la ligne qui doit être modifiée. Données dans Entier
    Données Données d’une ligne insérée dans une table de données. Le type de données d’entrée IEnumerable accepte les données sous forme de tableau, de liste ou de liste de tableau.
    { « OrderID » : 102, « CustomerName » : « John Doe », « OrderDate » : « 2024-02-02 », « Status » : « Expédié » } ;
    		 Données dans IEnumerable

    Liste de destinations

    Convertit la table spécifiée en liste.
    Tableau 30. Paramètres ToList
    Nom de paramètre Description Type de port de données Type de données
    Retour Renvoie un IEnumerable représentant un objet DataTable converti en liste. Le type de données IEnumerable accepte les données sous forme de tableau, de liste ou de liste de tableau et renvoie la liste. Sortie de données IEnumerable

    VLookUp

    Obtient la ou les valeurs de cellule d’une ligne particulière si la ligne contient du texte spécifié.

    Pour entrer les valeurs, effectuez les actions suivantes :
    1. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres du composant.).
    2. Cliquez sur l’icône Ajouter une valeur..
    3. Entrez les valeurs.
    4. Cliquez sur OK.
    Tableau 31. Paramètres VLookUp
    Nom de paramètre Description Type de port de données Type de données
    Nom du port Nom du port du composant. Données dans Chaîne
    SearchText Texte que la méthode recherchera dans les lignes et les colonnes. Données dans Chaîne
    DataColumnIndex Valeur entière qui indique l’ordre de la colonne à partir de la gauche. La valeur d’index par défaut est -1 pour la première colonne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier
    Index de colonne de recherche Valeur entière qui indique l’ordre de la colonne à partir de la gauche. La valeur d’index par défaut est -1 pour la première colonne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier
    Index StartRowIndex Valeur entière qui indique l’ordre de la colonne à partir de la gauche. La valeur d’index par défaut est -1 pour la première ligne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier

    VLookUpSet

    Définit la ou les valeurs de cellule d’une ligne particulière si la ligne contient du texte spécifié.

    Pour entrer les valeurs, effectuez les actions suivantes :
    1. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres du composant.).
    2. Cliquez sur l’icône Ajouter une valeur..
    3. Entrez les valeurs.
    4. Cliquez sur OK.
    Tableau 32. Paramètres VLookUpSet
    Nom de paramètre Description Type de port de données Type de données
    Nom du port Nom du port du composant. Données dans Chaîne
    SearchText Texte que la méthode recherchera dans les lignes et les colonnes. Données dans Chaîne
    DataColumnIndex Valeur entière qui indique l’ordre de la colonne à partir de la gauche. La valeur d’index par défaut est -1 pour la première colonne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier
    Index de colonne de recherche Valeur entière qui indique l’ordre de la colonne à partir de la gauche. La valeur d’index par défaut est -1 pour la première colonne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier
    Index StartRowIndex Valeur entière qui indique l’ordre de la colonne à partir de la gauche. La valeur d’index par défaut est -1 pour la première ligne. Il est facultatif de fournir une valeur d’index personnalisée. Si le champ ne reçoit aucune valeur d’index personnalisée, la méthode définit automatiquement l’ordre des colonnes. Données dans Entier