Match function

UiPath.Excel.Activities.Business.MatchFunctionX

Recherche un élément spécifié dans une plage de cellules et renvoie la position relative de cet élément dans la plage. Cette activité peut être utilisée avec un fichier Excel sélectionné pour une activité parente Utiliser fichier Excel (Use Excel File ), un fichier Excel connecté à l' automatisationou avec le bloc-notes du projet.

Configurer l'activité

Dans le corps de l’activité

• Valeur à faire correspondre (Value to match) : cliquez sur Plus à droite du champ, puis, à partir du menu, sélectionnez une valeur en utilisant l'une des options disponibles :

  • Données du Bloc-notes du projet, d'un fichier Excel parent ou d'un compte Outlook. Par exemple, sélectionnez la cellule d'un fichier Excel ou le champ d'un e-mail Outlook contenant la valeur.
  • Utiliser la valeur enregistrée (Use Saved Value) : sélectionnez une valeur que vous avez précédemment enregistrée pour une utilisation ultérieure dans le projet.
  • Texte (Text) : saisissez la valeur dans le générateur de texte.
  • Demander quand exécuté : permet de demander une valeur lorsque le projet est exécuté.
  • Nombre : Saisissez une valeur numérique.
  • Coller à partir du Presse-papiers (Paste from clipboard) : permet de coller une valeur que vous avez précédemment copiée dans le presse-papiers du projet.
  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.
• Dans la plage (In range) : la plage dans laquelle rechercher la valeur à faire correspondre. Cliquez sur Plus à droite du champ, puis, dans le menu, sélectionnez une plage nommée, ou sélectionnez Indiquer dans Excel (Indicate in Excel) pour ouvrir le fichier et sélectionner une plage directement à partir du fichier. Vous pouvez également sélectionner Entrée personnalisée (Custom Input) pour entrer manuellement la plage, ou Ouvrir dans l’éditeur avancé (Open in Advanced Editor) et entrer une expression VB.

• Type de correspondance (Match type) : spécifiez comment la valeur doit être mise en correspondance. Choisissez parmi les options disponibles :

  • 0 (première valeur exactement égale à la valeur à faire correspondre)
  • 1 (plus grande valeur inférieure ou égale à la valeur à faire correspondre)
  • -1 (plus petite valeur supérieure ou égale à la valeur à faire correspondre)
• Enregistrer dans : enregistrez la valeur renvoyée par l'activité (la position de la valeur correspondante dans la plage). Si la valeur à faire correspondre est introuvable, -1 est renvoyé. Cliquez sur Plus à droite du champ, puis, dans le menu, sélectionnez l'une des options disponibles pour enregistrer la valeur obtenue :
  • Données du Bloc-notes du projet, d'un fichier Excel parent ou d'un compte Outlook. Par exemple, sélectionnez une cellule d'un fichier Excel ou le champ d'un e-mail Outlook où enregistrer la valeur.
  • Copier dans le presse-papiers (Copy to clipboard) : permet d'enregistrer le chemin d'accès obtenu dans le presse-papiers.
  • Enregistrer pour une utilisation ultérieure (Save for Later Use) : enregistrez les données de sortie pour les utiliser ultérieurement dans votre projet en tant qu'entrée pour une autre activité.

  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.

    Note : La valeur renvoyée par l'activité est la position de la valeur correspondante dans la plage, pas la valeur elle-même.

Panneau propriétés

Commun

• NomComplet (DisplayName) : 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).

Sortie

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