Méthodes de connecteur de table

SetTable

Insère une table dans le workflow. La méthode SetTable doit être utilisée avant toute autre opération sur une table de données. Vous devez fournir l’objet de table à définir.

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 d’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 sur les clients	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 les positions 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
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"} ;	Numérique

Ajouter une ligne

Ajoute une ligne et son contenu à l’index spécifié. Vous devez fournir le RowIndex 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 :

Cliquez sur l’icône Paramètres du composant ( ).
Cliquez sur l’icône Ajouter un index (icône
Entrez l’index.
Répétez les étapes pour ajouter plusieurs index.
Cliquez sur OK.
Remarque :
Un port d’entrée de données est ajouté avec 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 (Table à obtenir)

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	Retourne 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.

DeleteColumnByIndex (en anglais seulement)

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

DeleteColumnByName

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 à supprimer.

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

Filtrer et trier

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 pour 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 selon lequel la méthode triera les données. Exemple Date : la méthode trie les données en fonction de la colonne Date.	Données dans	Chaîne
Ordre	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 tri.	Sortie de données	Entier

FiltreParRegEx

Filtre les données de la table en fonction d’une expression régulière ou d’une 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. Fournir une valeur d’index personnalisée est facultatif. 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 régulière	Expression régulière 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 (en anglais seulement)

Recherche le texte dans la table que vous spécifiez en fonction d’un ou 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 du 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
Index Col	Renvoie l’index de la colonne qui contient 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 Vrai 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 de la table.

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

Cliquez sur l’icône Paramètres de méthode ( ).
Cliquez sur l’icône Ajouter un index de ligne ( ).
Mettez à jour le type de données de la valeur d’index de ligne.
Saisissez la valeur de l’index de ligne.
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
SearchColumnIndex (en anglais seulement)	Index de colonne dans laquelle le texte doit être recherché.	Données dans	Entier
Index de ligne de démarrage	Ligne de début à partir de laquelle la recherche doit être effectuée.	Données dans	Entier
Trouvé	Renvoie la valeur vrai si le texte correspond.	Sortie de données	Booléen

GetCellValues

Renvoie les valeurs des multiples cellules 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, procédez comme suit :

Cliquez sur l’icône Paramètres de méthode ( ).
Cliquez sur l’icône Ajouter un index de ligne ( ).
Mettez à jour le type de données de la valeur d’index de ligne.
Saisissez la valeur de l’index de ligne.
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 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 valeur de ligne sous forme de tableau, de liste ou de liste de tableaux et les renvoie en tant qu’objet.	Sortie de données	Numérique

GetTableAsCSV

Enregistre les données de table au format CSV sur le lecteur local. Vous devez indiquer 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 dans lequel la méthode enregistre les données de table au format CSV. Dans le chemin d’accès du 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 au 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 dans un 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 en tant qu’objet JSON.	Données dans	Chaîne

LoadFromExcel (en anglais seulement)

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 True, et si un nom de feuille est fourni, définissez le booléen IsQuery sur False. 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
Chemin d’accès au fichier	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
Feuille ou requête	Indique si les données sont importées à partir d’une feuille du fichier Excel ou via une requête dans le fichier.	Données dans	Chaîne
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 la suppression des 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 la suppression des 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
SearchColumnIndex (en anglais seulement)	Index de la colonne dans laquelle le texte doit être recherché.	Données dans	Entier
Index de ligne de démarrage	Ligne de début à 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 (en anglais seulement)

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

Convertit un objet JSON en table de données. Fournissez des 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 table de données.	Données dans	Chaîne

Liste d’ensemble

Convertit une liste en table de données. Indiquez 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	Numérique

SetRowData (en anglais seulement)

Insère les données de la ligne spécifiée dans une table de données. Vous devez indiquer le numéro d’index de la ligne au paramètre RowIndex et les données à ajouter à 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 à modifier.	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	Numérique

Liste d’inclusion

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 tableaux et renvoie la liste.	Sortie de données	Numérique

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, procédez comme suit :

Cliquez sur l’icône Paramètres de méthode ( ).
Cliquez sur .
Saisissez les valeurs.
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
Index de la colonne de données	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. Fournir une valeur d’index personnalisée est facultatif. 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
SearchColumnIndex (en anglais seulement)	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. Fournir une valeur d’index personnalisée est facultatif. 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 ligne de démarrage	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. Fournir une valeur d’index personnalisée est facultatif. 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, procédez comme suit :

Cliquez sur l’icône Paramètres de méthode ( ).
Cliquez sur .
Saisissez les valeurs.
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
Index de la colonne de données	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. Fournir une valeur d’index personnalisée est facultatif. 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
SearchColumnIndex (en anglais seulement)	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. Fournir une valeur d’index personnalisée est facultatif. 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 ligne de démarrage	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. Fournir une valeur d’index personnalisée est facultatif. 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