Filtrer la table de données (Filter Data Table)

UiPath.Core.Activities.FilterDataTable

Permet de filtrer une variable DataTable en spécifiant les conditions dans l'Assistant de filtre (Filter Wizard). L'activité peut conserver ou supprimer des lignes ou des colonnes en fonction des conditions logiques spécifiées dans l'assistant. Le corps de l'activité contient un bouton Assistant de filtre (Filter Wizard) afin que vous puissiez accéder à l'assistant et personnaliser vos paramètres à tout moment.

Remarque : En raison de changements internes, plusieurs activités ne sont plus visibles dans la liste des favoris lors de la mise à niveau vers la version v20.4 ou une version ultérieure, si elles avaient été ajoutées à la liste des favoris dans la version v19.4 ou une version antérieure de UiPath.System.Activities.

Compatibilité du projet

Windows - Héritage | Multiplateforme

Configuration multiplateforme

Propriétés

• TableDonnées (DataTable) - la variable DataTable que vous souhaitez trier. Ce champ prend uniquement en charge les variables DataTable.
• Conditions defiltre : les conditions utilisées pour filtrer la table de données.

Options avancées

• Action - Spécifie si la table doit être filtrée en conservant ou en supprimant les lignes cible.
• Table de données filtrées - La table de données filtrées résultante.

• Premiere ligne - La première ligne de la table de données qui correspond aux filtres configurés

  
  

  

  
  

Windows - Héritage, configuration Windows

Propriétés

Commun

• DisplayName : le nom complet de l'activité. Ce champ ne prend en charge que les chaînes ou les variables String .

Entrée

• TableDonnées (DataTable) - la variable DataTable que vous souhaitez trier. Ce champ prend uniquement en charge les variables DataTable.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• Mode filtrage de lignes (FilterRowsMode)- Spécifie si la table doit être filtrée en conservant ou en supprimant les lignes cible. Sélectionner une ou deux options dans le menu déroulant :Conserver (Keep) ou Supprimer (Remove). La valeur par défaut est Conserver (Keep).
• Mode sélection de colonnes (SelectColumnsMode) - Spécifie si la table doit être filtrée en conservant ou en supprimant les colonnes cible. Sélectionner une ou deux options dans le menu déroulant :Conserver (Keep) ou Supprimer (Remove). La valeur par défaut est Conserver (Keep).

Sortie

• Table de données (DataTable) : variable DataTable filtrée obtenue. Placer la même variable que celle dans le champ Entrée (Input) modifie la variable initiale tandis que l'ajout d'une nouvelle variable laisse la variable initiale inchangée. Ce champ prend uniquement en charge les variables DataTable.
  Remarque :

  • Si vous copiez et collez une activité Filtrer la table de données (Filter Data Table) personnalisée à l'intérieur du panneau Concepteur (Designer), elle ne conserve pas (not) sa configuration.
  • Les plages Excel ne sont pas prises en charge comme entrée pour cette activité.

Assistant de filtre

Cet assistant permet de créer les options de filtrage pour une variable DataTable. Vous pouvez l'ouvrir en utilisant le bouton Assistant de filtre (Filter Wizard) dans le corps de l'activité du panneau Concepteur (Designer). Vous pouvez sélectionner le DataTable à modifier ainsi que celui dans lequel vous voulez enregistrer les modifications, à partir des champs suivants :

• Table de données d'entrée (Input Data Table) - Variable DataTable que vous souhaitez filtrer. Ce champ prend uniquement en charge les variables DataTable.
• Table de données de sortie (Output Data Table) - Variable de sortie DataTable. Si la même variable que celle présente dans le champ Entrée (Input) est utilisée, elle est remplacée par les modifications. L'indication d'une variable différente ne modifie pas la variable d'entrée.

Vous pouvez choisir de filtrer par Ligne (Row) ou par Colonne (Column) en fonction de l'onglet sélectionné. Il existe deux onglets, comme suit :

Descriptions des champs de l'onglet Filtrer les lignes (Filter Rows)

L'onglet Filtrer les lignes (Filter Rows) permet de filtrer une variable DataTable par Lignes (Rows). Pour ce faire, vous disposez des options suivantes :

1. Conserver ou supprimer les lignes correspondantes : spécifie s'il faut filtrer les lignes en les conservant ou en les supprimant. Il suffit pour ce faire de sélectionner les cases d'option Conserver ou Supprimer. Si vous sélectionnez Conserver, seules les lignes qui remplissent la condition spécifiée seront conservées ; si vous sélectionnez Supprimer, les lignes qui correspondent à la condition spécifiée seront supprimées.
2. Et/Ou (And/Or) : spécifie les conjonctions logiques à utiliser entre les conditions. Ce bouton ne s'affiche que si vous avez plusieurs conditions. Par défaut, lorsque vous ajoutez une condition, le bouton s'affiche sous Et (And). Cliquez sur le bouton pour passer sa valeur à Ou (Or).
3. Colonne (Column) - Nom ou index de la colonne devant remplir la condition.
4. Opération (Operation) - Condition logique à respecter entre la Colonne (Column) et la Valeur (Value).
5. Valeur (Value) - Valeur à vérifier avec l'Opération (Operation) et la Colonne (Column).
6. Ajouter/Supprimer une condition (Add/Remove Condition) - Cliquer sur le bouton + ajoute une autre phrase à la condition, tandis que le fait de cliquer sur le bouton x supprime une phrase.
   Remarque : Lorsque vous indiquez une variable dans la zone de texte Colonne (Column), vous pouvez utiliser une variable Int32 pour spécifier l'index de colonne (column index) ou une variable String pour spécifier le nom de colonne (column name).

Sortie

L'onglet Colonnes de sortie vous permet de filtrer une DataTable par Colonnes. Pour ce faire, vous disposez des options suivantes :

1. Mode de sélection des colonnes : spécifie s'il faut filtrer les colonnes en les conservant ou en les supprimant. Il suffit pour ce faire de sélectionner les cases d'option Conserver ou Supprimer. La sélection de l'option Conserver (Keep) ne conserve que les colonnes indiquées ci-dessous, tandis que la sélection de l'option Supprimer (Remove) supprime les lignes spécifiées ci-dessous de l'entrée DataTable.
2. Colonne (Colonne) - Colonnes que vous souhaitez conserver ou supprimer de DataTable.
   Remarque :Lorsque vous indiquez une variable dans la zone de texte Colonne (Column), vous pouvez utiliser une variable Int32 pour spécifier l'index de colonne (column index) ou une variable String pour spécifier le nom de colonne (column name).
3. Ajouter/Supprimer des colonnes (Add/Remove Columns) - Cliquer sur le bouton + permet d'ajouter une autre colonne, tandis qu'appuyer sur le bouton x supprime la colonne.
   Remarque :L'ordre dans lequel vous ajoutez des colonnes dans l'assistant est l'ordre dans lequel les colonnes sont disposées dans la table de sortie.

Exemple d'utilisation de l'activité Filter Data Table

Ici, vous pouvez voir comment l'activité Filtrer la table de données (Filter Data Table) est utilisée dans un exemple qui intègre plusieurs activités.