Guide de l’utilisateur de Studio

Dernière mise à jour 20 déc. 2023

À propos des sélecteurs

Pour automatiser des actions spécifiques dans l’interface utilisateur, vous devez interagir avec différents fenêtres, boutons, listes déroulantes et bien d’autres. Les éléments d’IU peuvent être identifiés notamment en utilisant leur position sur l’écran, mais cela peut être peu fiable.

Dans Studio UiPath, ce problème est résolu grâce à l'emploi de sélecteurs dont le rôle est de stocker les attributs d'un élément d'interface utilisateur graphique et de ses parents sous la forme d'un fragment XML.

Les sélecteurs sont généralement générés par Studio de façon automatique, sans que vous ayez besoin de fournir d'autres données. C'est d'autant plus vrai si votre projet d'automatisation porte sur une interface utilisateur statique.

Certains logiciels (par exemple des applications Web) sont cependant caractérisés par une mises en page changeante et des nœuds d'attribut liés à des valeurs volatiles. Ces changements ne peuvent pas être anticipés par Studio UiPath et il est donc possible que vous ayez besoin de créer certains sélecteurs manuellement.

Voici la structure d'un sélecteur :

<node_1/><node_2/>...<node_N/>

Le dernier nœud représente l'élément de l'interface utilisateur graphique que l'on souhaite automatiser, tandis tous les nœuds précédents représentent les parents de cet élément. <node_1> est généralement connu sous le nom de nœud racine : il représente la fenêtre supérieure de l'application.

Chaque nœud possède un ou plusieurs attributs pour permettre d'identifier sans hésitation un niveau donné de l'application sélectionnée.

Chaque nœud suit le format suivant :

<ui_system attr_name_1='attr_value_1' ... attr_name_N='attr_value_N'/>

Une valeur est associée à chaque attribut. Il est important de choisir des attributs avec des valeurs constantes, car le sélecteur ne pourra pas reconnaître l'élément si les valeurs des attributs changent à chaque démarrage de l'application.

Les sélecteurs sont accessibles dans le module d'activités Propriétés (Properties), sous Saisie > Cible > Sélecteur (Input > Target > Selector). Toutes les activités liées aux éléments graphiques possèdent cette propriété.

La fenêtre Éditeur de sélecteur (Selector Editor) permet d'afficher et de modifier le sélecteur automatique, ainsi que ses attributs. Pour accéder à cette fenêtre, rendez-vous dans le module Concepteur de flux de travail (Workflow Designer) et cliquez sur le bouton des Options dans le corps d'une activité, puis sélectionnez l'option Modification du sélecteur (Edit Selector).

Cela peut également être accompli à l'aide du bouton Ellipsis à côté du champ Sélecteur (Selector), dans le module Propriétés (Properties).

Option	Description
Valider	Le bouton indique l'état du sélecteur en vérifiant la validité de la définition de sélecteur et la visibilité de l'élément cible à l'écran. Le bouton Valider a trois états : Sélecteur en cours de validation Sélecteur valide Sélecteur non valide Sélecteur modifié, revalider Le bouton est relié aux états de validation d'UI Explorer.
Indiquer l'élément (Indicate Element)	Indiquez un nouvel élément d'IU pour remplacer le précédent.
Réparer (Repair)	Permet d'indiquer à nouveau le même élément d'IU cible et de réparer le sélecteur. Cette opération ne remplace pas complètement le sélecteur précédent. Le bouton est uniquement disponible lorsque le sélecteur n'est pas valide.
Mettre en surbrillance (Highlight)	Met l'élément cible au premier plan. Il reste surligné jusqu'à ce que l'option soit désactivée par clic. Le bouton est uniquement activé si le sélecteur est valide.
Modifier les attributs	Contient tous les composants de l'application nécessaires à l'identification de l'application cible (une fenêtre, un bouton, etc.). Cette section est modifiable.
Modifier le sélecteur	Contient le sélecteur réel. Cette section est modifiable.
Ouvrir dans UI Explorer	Lance UI Explorer. L'option est uniquement activée pour les sélecteurs valides.

Remarque : dans certaines situations, lorsque Studio et l'application ciblée sont ouverts avec des privilèges élevés différents, le sélecteur peut ne pas fonctionner. Nous vous recommandons de toujours ouvrir les deux applications avec les mêmes privilèges.

Balises et attributs pris en charge

Les tableaux suivants présentent la compatibilité entre les balises et les attributs utilisés pour créer des sélecteurs et la capacité du sélecteur:

Remarque : les sélecteurs générés pour les applications Java qui contiennent plusieurs balises WND ne peuvent pas être utilisés avec la surveillance des événements.

WND

Attribut	Fuzzy	RegEx	Sensible à la casse
app
cls
title
aaname
ctrlname (WinForms)
ctrlid (WinForms)
idx
tid
pid
isremoteapp
aastate
sapClient (SAP)
sapLanguage (SAP)
sapProgram (SAP)
sapScreen (SAP)
sapSession (SAP)
sapSysName (SAP)
NuméroSysSap (SAP)
sapSysSessionId (SAP)
sapTransaction (SAP)
sapUser (SAP)

HTML

Attribut	Fuzzy	RegEx	Sensible à la casse
url
htmlwindowname
title
app
idx
pid
tid
excludehwnd
bsid (Browser Session ID)
isremoteapp

WEBCTRL

Les attributs tag et idx utilisent des valeurs de chaîne. Tous les autres attributs WEBCTRL ont des valeurs dynamiques.`

Attribut	Fuzzy	RegEx	Sensible à la casse
tag
idx
aaname
name
id
parentid
class
css-selector
innertext
isleaf
parentclass
parentname
title
src
href
tableCol
tableRow
colName
rowName

Ctrl

Attribut	Fuzzy	RegEx	Sensible à la casse
Rôle
name
automationid
labeledby
aastate
virtualname
text
rowName
idx

UIA

Attribut	Fuzzy	RegEx	Sensible à la casse
accelkey (Accelerator Key)
acskey (Access Key)
automationid
cls
helpText
legacyAccHelp (Legacy Accessible Help)
enabled
kbfocus (Is Keyboard Focusable)
ispwd (Is Password)
itemstatus
itemtype
rtid (Runtime ID)
Rôle
name
pid
tableRow
tableCol
rowName
colName
idx

Java

Attribut	Fuzzy	RegEx	Sensible à la casse
Rôle
name
virtualname
javastate
tableRow
tableCol
rowName
colName
idx

SAP

Attribut	Fuzzy	RegEx	Sensible à la casse
id
leafid Cet attribut n'est pas exposé dans le panneau Attribut car il est mutuellement exclusif avec l'attribut id . Il peut être ajouté manuellement.
tableRow
tableCol
colName
relpath
itemId