

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Tableaux de données
<a name="actions-data-tables"></a>

Les actions relatives aux tableaux de données vous permettent de travailler avec des données structurées sous forme de tableau. Ces actions vous permettent de créer, de transformer et de générer des données tabulaires dans vos automatisations.

## Trier le tableau
<a name="sort-table"></a>

Trie un tableau par colonne. Utilisé pour organiser vos données par ordre croissant ou décroissant.

**Propriétés :**
+ **Table de données** (obligatoire) : variable de table à trier (par exemple,`my_table`)
+ **Nom de la colonne à trier** (obligatoire) : nom de la colonne à trier (par exemple, « Montant total »)
+ **Ordre de tri** (liste déroulante) : Choisissez « Croissant » (le plus petit en premier) ou « Décroissant » (le plus grand en premier) - par défaut : Décroissant
+ **Table triée** (sortie) : nom de variable pour la nouvelle table triée

## Tableau des filtres
<a name="filter-table"></a>

Conserve les lignes correspondant à un critère. Utilisé pour extraire les lignes pertinentes d'un ensemble de données plus important.

**Propriétés :**
+ **Table de données** (obligatoire) : variable de table à filtrer (par exemple,`my_table`)
+ **Expression de filtre** (obligatoire) : expression booléenne utilisant des noms de colonnes et des opérateurs (==, >, <, \$1 =). Combinez les conditions avec & (AND) ou \$1 (OR). Utilisez des guillemets simples pour les noms de colonnes contenant des espaces et des valeurs de texte (par exemple, « 'Équipe' == 'Ventes' et 'Montant total' > 100 »)
+ **Table filtrée** (sortie) : nom de variable pour la table filtrée

Exemples de filtres :

```
# Column 'amount' is greater than 25
"amount > 25"

# Column 'team' equals text 'Sales'
"team == 'Sales'"

# Multiple conditions
"amount > 25 & status == 'active'"

# Grouped conditions
"(amount > 25 & team == 'Sales') | (amount > 50 & team == 'Marketing')"

# Column 'title' contains text 'Director'
"title.str.contains('Director')"

# Column 'Customer No' equals a variable customer_id
"`Customer No` == " + str(customer_id)

# Column 'ProfitCenter' equals variable profitCenter
"`ProfitCenter` == '" + str(profitCenter) + "'"
```

## Valeur de recherche
<a name="lookup-value"></a>

Recherche une valeur dans une table. Utilisé pour rechercher une valeur dans une colonne et obtenir la valeur correspondante dans une autre colonne de la même ligne.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau dans lequel effectuer la recherche (par exemple,`my_table`)
+ **Nom de colonne à rechercher** (obligatoire) : colonne contenant la valeur de recherche (par exemple, « ID d'employé »)
+ **Valeur à rechercher** (obligatoire) : valeur à rechercher (par exemple, « 12345 »)
+ **Nom de colonne à afficher** (obligatoire) : colonne à partir de laquelle récupérer le résultat (par exemple, « Date d'embauche »)
+ **Valeur de cellule** (sortie) : variable stockant la valeur trouvée. Renvoie la première correspondance ou un champ vide s'il n'est pas trouvé.

## Ajouter des colonnes
<a name="add-columns"></a>

Crée de nouvelles colonnes dans un tableau. Les colonnes récemment ajoutées sont ajoutées à la fin du tableau existant.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à modifier (par exemple,`my_table`)
+ **Noms de colonnes à ajouter** (obligatoire) : tableau de nouveaux noms de colonnes (par exemple, ["Nom », « Adresse"])
+ **Valeur par défaut** (facultatif) : valeur initiale pour toutes les cellules des nouvelles colonnes (par exemple, « N/A »)
+ **Table mise à jour** (sortie) : nom de variable pour la table modifiée

## Supprimer des colonnes
<a name="remove-columns"></a>

Supprime les colonnes d'un tableau. Affiche un tableau avec toutes les colonnes restantes.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à modifier (par exemple,`my_table`)
+ **Colonnes à supprimer** (obligatoire) : tableau de noms de colonnes ou de numéros d'index. Les numéros d'index commencent à 0 et peuvent être des nombres spécifiques (par exemple, [0,1,2]) ou des plages (par exemple, range (0,2))
+ **Table mise à jour** (sortie) : nom de variable pour la table modifiée

## Conserver les colonnes
<a name="keep-columns"></a>

Supprime des colonnes supplémentaires d'un tableau. Utilisé pour sélectionner un sous-ensemble spécifique de colonnes que vous souhaitez conserver.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à modifier (par exemple,`my_table`)
+ **Colonnes à conserver** (obligatoire) : tableau de noms de colonnes à conserver (par exemple, ["Nom », « Adresse"])
+ **Table mise à jour** (sortie) : nom de variable pour la table modifiée

## Ajouter une nouvelle ligne
<a name="add-new-row"></a>

Ajoute une nouvelle ligne à un tableau. La nouvelle ligne peut être créée avec des valeurs spécifiques ou sous forme de ligne vide et est ajoutée au bas du tableau.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à modifier (par exemple,`my_table`)
+ **Valeurs de ligne** (facultatif) : tableau de valeurs pour la nouvelle ligne, en commençant par la première colonne (par exemple, ["Q1 », « Sales », 100]). S'il est vide, ajoute une ligne vide. Les valeurs manquantes génèrent des cellules vides.
+ **Table mise à jour** (sortie) : nom de variable pour la table modifiée

## Supprimer des lignes
<a name="remove-rows"></a>

Supprime des lignes d'un tableau. Affiche un tableau avec toutes les lignes restantes.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à modifier (par exemple,`my_table`)
+ **Lignes à supprimer** (obligatoire) : tableau des positions des lignes (indexation basée sur 0). Les numéros d'index commencent à 0 et peuvent être des nombres spécifiques (par exemple, [0,1,2]) ou des plages (par exemple, range (0,2))
+ **Table mise à jour** (sortie) : nom de variable pour la table modifiée

## Supprimer les doublons
<a name="remove-duplicates"></a>

Supprime les lignes dupliquées. Utilisé pour créer un ensemble de données de lignes uniques basé sur des colonnes spécifiques.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à nettoyer (par exemple,`my_table`)
+ **Colonnes à vérifier** (facultatif) : tableau de noms de colonnes pour la détection des doublons (par exemple, ["Nom », « Adresse"]). S'il est vide, vérifie l'unicité des lignes entières. Les doublons sont identifiés par des valeurs combinées dans des colonnes spécifiées.
+ **Dupliquer la ligne à conserver** (liste déroulante) : Choisissez « Première » ou « Dernière » occurrence à conserver (par défaut : Première)
+ **Table mise à jour** (sortie) : nom de variable pour la table modifiée

## Ajouter des tables
<a name="append-tables"></a>

Combine les rangées de deux tables. Permet d'ajouter des données d'une table à une autre.

**Propriétés :**
+ **Tableau à ajouter (**obligatoire) : tableau principal recevant des lignes supplémentaires (par exemple,`main_table`)
+ **Table à ajouter** (obligatoire) : table source fournissant des lignes à ajouter (par exemple,`new_data`)
+ **Gérer les différences entre les colonnes** (liste déroulante) :
  + « Ajouter » : conserver toutes les colonnes des deux tables
  + « Ignorer » : ne conserver que les colonnes correspondant à la table principale
  + « Erreur » : nécessite des correspondances exactes entre les colonnes
+ **Table combinée** (sortie) : nom de variable pour la table fusionnée

## Créer une nouvelle table
<a name="create-new-table"></a>

Crée une table vide. Utilisé pour configurer un tableau avec les colonnes requises auxquelles ajouter des lignes lors des étapes suivantes. Le nouveau tableau ne comporte aucune ligne.

**Propriétés :**
+ **Noms de colonnes** (facultatif) : tableau de noms de colonnes pour la nouvelle table (par exemple, ["Nom », « Adresse"]). S'il est vide, crée un tableau sans colonnes.
+ **Nouvelle table** (sortie) : nom de variable pour la table nouvellement créée

## Convertir le texte en tableau
<a name="convert-text-to-table"></a>

Transforme le texte délimité en tableau structuré.

**Propriétés :**
+ **Texte à convertir** (obligatoire) : texte délimité contenant les données du tableau (par exemple, « Année, quantité 2001, 100 »)
+ **Séparateur de valeurs** (facultatif) : caractères séparant les valeurs dans les lignes (par défaut : «, »)
+ **Séparateur de nouvelles lignes** (facultatif) : lignes séparant les caractères (par défaut : "«)
+ **Dispose d'en-têtes** (case à cocher) : indique si la première ligne contient des noms de colonnes. Si True, utilise la première ligne comme en-têtes ; si False, génère des noms par défaut (Column0, Column1, etc.)
+ **Nouvelle table** (sortie) : nom de variable pour la table nouvellement créée

## Convertir un tableau en HTML
<a name="convert-table-to-html"></a>

Crée un tableau au format HTML. Utilisé pour générer votre tableau sous forme de texte formaté pour un document, un e-mail, etc.

**Propriétés :**
+ **Tableau de données** (obligatoire) : Le tableau à formater (par exemple,`my_table`)
+ **Texte de tableau formaté** (sortie) : variable stockant le texte au format HTML

## Exemples
<a name="data-tables-examples"></a>

**Parcourez les lignes d'un tableau en boucle**

Pour parcourir les lignes d'une table de données, utilisez l'action « Boucler les éléments » sous « Flux de processus ». Fournissez la variable de table de données comme entrée pour « Collection d'éléments ». Mettez à jour la « Référence d'élément » pour `row` que chaque élément représente une seule ligne du tableau.

**Utiliser ou mettre à jour les valeurs des cellules d'une ligne**

Lorsque vous parcourez les lignes d'un tableau, faites référence aux valeurs de chaque cellule en utilisant la syntaxe selon `row["column name"]` laquelle le nom de colonne est remplacé par le nom de la colonne correspondant à la cellule en question.

Pour mettre à jour la valeur d'une cellule dans une ligne, utilisez l'action « Enregistrer la valeur » sous « Général ». La « Valeur à enregistrer » est la valeur avec laquelle vous souhaitez mettre à jour la cellule. Le « Nom de la variable » est la référence à la cellule en utilisant la même syntaxe que ci-dessus`row["column name"]`.