Filtrer (Filter)

UiPath.Excel.Activities.Business.FilterX

Crée un filtre dans une plage, une table ou une feuille en fonction des valeurs d'une seule colonne. Peut également être utilisé pour effacer les filtres existants. Pour filtrer plusieurs colonnes sur une seule plage/feuille/tableau, vous devez utiliser plusieurs activités Filter ciblant la même plage source. L’activité peut être utilisée avec un fichier Excel sélectionné pour une activité parente Utiliser fichier Excel (Use Excel File ) ou avec le bloc-notes du projet.

Lorsque vous utilisez cette activité pour créer un filtre et qu'un filtre existe déjà :

• Si le filtre existant est appliqué à la plage sourcedéfinie , le filtre existant n'est pas effacé (les deux filtres sont appliqués).

• Si le filtre existant est appliqué en dehors de la plage sourcedéfinie :

  • Si la plage source définie est une feuille ou une plage de cellules, le filtre existant est effacé et le nouveau filtre est appliqué.
  • Si la plage source définie est une table, le filtre existant n'est pas effacé.

Lorsque vous utilisez cette activité pour effacer des filtres existants :

• Si une colonne est définie dans Nom de la colonne, seul le filtre de la colonne spécifiée est effacé. La plage source définie doit correspondre à la plage filtrée par la colonne.

• Si le nom de la colonne est vide :

  • Si la plage source définie est une feuille ou une plage de cellules, tous les filtres de la feuille entière sont supprimés.
  • Si la plage source définie est une table, tous les filtres de cette table sont supprimés uniquement.

Pour apprendre à utiliser cette activité, consultez Tutorial: Filtering Data in Excel.

Configurer l'activité

Dans le corps de l’activité

• Plage source : cliquez sur l'icône Plus à droite du champ, sélectionnez le fichier, puis une plage, table ou feuille désignée à filtrer, ou sélectionnez Indiquer dans Excel (Indicate in Excel) pour ouvrir le fichier et sélectionner une plage directement à partir du fichier. Pour saisir une plage, un table ou une feuille manuellement, sélectionnez Entrée personnalisée.

  Vous pouvez également sélectionner Ouvrir dans l'éditeur avancé (Open in Advanced Editor) et saisir une expression VB.

• Nom de la colonne : cliquez sur l'icône Plus à droite du champ, sélectionnez Plage, puis sélectionnez l'en-tête de la colonne sur laquelle appliquer le filtre. Vous pouvez également sélectionner Texte pour saisir la valeur dans l'en-tête de colonne dans le générateur de texte, ou sélectionner Ouvrir dans l'éditeur avancé et saisir une expression VB.
• Configurer le filtre (Configure Filter ) : cliquez sur ce bouton pour configurer le filtre des valeurs de la colonne. Vous pouvez utiliser un filtre de base pour entrer une ou plusieurs valeurs sur lesquelles filtrer, ou un filtre avancé pour spécifier des conditions à l'aide d'opérateurs de comparaison de la même manière que vous configurez un filtre automatique personnalisé dans Excel.
• Effacer tous les filtres existants : sélectionnez cette option si vous souhaitez effacer les filtres existants au lieu d'en créer un. L'effacement des filtres ne supprime pas les configurations de filtre de l'activité, si elles ont été définies.

Panneau propriétés

Commun

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur.

Entrée

• Voir les options dans le corps de l'activité.

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

• Effacer tout filtre existant : voir Effacer tout filtre existant dans le corps de l’activité.