À 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, ce problème est résolu grâce à l’emploi de sélecteurs. Leur 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 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 affichés dans le panneau 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 Options de sélection (Selection Options) permet de sélectionner et de modifier une cible. Pour accéder à cette fenêtre, dans le panneau Concepteur de workflow (Workflow Designer), cliquez sur le bouton Options dans le corps d'une activité et sélectionnez Indiquer la cible à l'écran (Indicate target on screen) ou Modifier la cible (Edit target).

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, utilisez le bouton Ellipse à côté du champ Sélecteur (Selector), dans le panneau 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	Description	Fuzzy	RegEx	Sensible à la casse
app	Le nom de fichier de l’application contenant l’élément d’IU.
cls	Le nom de classe de la fenêtre contenant l’élément d’IU.
title	Le titre de la fenêtre de l’élément d’IU.
aaname	Nom ’Active Accessibility’ de l’élément d’IU.
ctrlname (WinForms)	Nom WinForms de l’élément d’IU.
ctrlid (WinForms)	ID de contrôle Win32 de la fenêtre contenant l’élément d’IU.
idx	Le numéro d’instance de l’élément d’IU.
tid	ID du thread qui a créé l’élément d’IU.
pid	ID de processus de l’application contenant l’élément d’IU.
isremoteapp
aastate	État ’Active Accessibility’ de l’élément d’IU.
sapClient (SAP)	Client SAP sélectionné sur l’écran de connexion.
sapLanguage (SAP)	Langue SAP spécifiée sur l’écran de connexion.
sapProgram (SAP)	Programme source SAP en cours d’exécution.
sapScreen (SAP)	Numéro d’écran SAP actuellement affiché.
sapSession (SAP)	Numéro de session SAP, également affiché dans la barre d’état de l’interface utilisateur graphique SAP.
sapSysName (SAP)	Nom du système SAP.
NuméroSysSap (SAP)	Serveur d’applications SAP.
sapSysSessionId (SAP)	Toutes les sessions de l’interface utilisateur graphique SAP de la même connexion sont représentées sur le serveur avec le même SysSessionId.
sapTransaction (SAP)	Transaction SAP en cours d’exécution.
sapUser (SAP)	Utilisateur SAP connecté au système.

HTML

Attribut	Description	Fuzzy	RegEx	Sensible à la casse
url	L’URL de la page Web contenant l’élément actuel.
htmlwindowname
title	Le titre de la fenêtre de l’élément.
class	Le nom de classe du contexte accessible de l’élément.
app	Le nom de fichier de l'application contenant l'élément d'IU
idx	Le numéro d’instance de l’élément d’IU.
pid	ID de processus de l’application contenant l’élément d’IU.
tid	ID du thread qui a créé l’élément d’IU.
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	Description	Fuzzy	RegEx	Sensible à la casse
tag	Balise HTML de l’élément.
idx	Le numéro d’instance de l’élément d’IU.
aaname	Nom ’Active Accessibility’ de l’élément d’IU.
name	Propriété Name de l’élément d’IU.
id	L’identificateur unique de l’élément d’IU.
parentid	L’attribut de l’ID HTML du premier élément ancêtre qui contient l’ID.
class
css-selector
innertext	La propriété innerText d’un élément HTML.
visibleinnertext
isleaf
parentclass	L’attribut de classe HTML du premier élément ancêtre qui contient la classe.
parentname	L’attribut de nom HTML du premier élément d’IU ancêtre qui contient un nom.
src	Spécifie l’emplacement ou la source de l’élément.
href	L’URL de la page Web à laquelle le lien accède.
tableCol	Le numéro de colonne de table qui contient l’élément d’IU.
tableRow	Le numéro de ligne de table qui contient l’élément d’IU.
colName	Le nom de la colonne de table qui contient l’élément d’IU.
rowName	Le nom de la ligne de table qui contient l’élément d’IU.
aria-label	Attribut aria-label de l’élément.
aria-labelledby

Ctrl

Attribut	Description	Fuzzy	RegEx	Sensible à la casse
Rôle	La propriété du rôle ’Accessibilité active’ de l’élément d’IU.
name	Propriété Name de l’élément d’IU.
automationid	L’ID ’UI Automation’ de l’élément d’IU.
labeledby	L’objet ’UI Automation’ libellé par l’attribut de l’élément d’IU.
aastate	État ’Active Accessibility’ de l’élément d’IU.
virtualname	Le nom de l’élément donné par la technologie d’accessibilité sous-jacente.
text	Le texte de l’élément d’IU, tel qu’il s’affiche à l’écran.
rowName	Le nom de la ligne de table qui contient l’élément d’IU.
idx	Le numéro d’instance de l’élément d’IU.

UIA

Attribut	Description	Fuzzy	RegEx	Sensible à la casse
accelkey (Accelerator Key)
acskey (Access Key)
automationid	L’ID ’UI Automation’ de l’élément d’IU.
cls	Le nom de classe de la fenêtre contenant l’élément d’IU.
helpText	Chaîne d’aide de l’élément d’IU.
legacyAccHelp (Legacy Accessible Help)
enabled
kbfocus (Is Keyboard Focusable)
ispwd (Is Password)
itemstatus
itemtype
rtid (Runtime ID)
Rôle	La propriété du rôle ’Accessibilité active’ de l’élément d’IU.
name	Propriété Name de l’élément d’IU.
pid	ID de processus de l’application contenant l’élément d’IU.
tableRow	Le numéro de ligne de table qui contient l’élément d’IU.
tableCol	Le numéro de colonne de table qui contient l’élément d’IU.
rowName	Le nom de la ligne de table qui contient l’élément d’IU.
colName	Le nom de la colonne de table qui contient l’élément d’IU.
idx	Le numéro d’instance de l’élément d’IU.

Java

Attribut	Description	Fuzzy	RegEx	Sensible à la casse
Rôle	La propriété du rôle ’Accessibilité active’ de l’élément d’IU.
name	Propriété Name de l’élément d’IU.
virtualname	Le nom de l’élément donné par la technologie d’accessibilité sous-jacente.
javastate	L’état de l’élément d’IU, tel que fourni par le ’pont d’accessibilité Java’.
tableRow	Le numéro de ligne de table qui contient l’élément d’IU.
tableCol	Le numéro de colonne de table qui contient l’élément d’IU.
rowName	Le nom de la ligne de table qui contient l’élément d’IU.
colName	Le nom de la colonne de table qui contient l’élément d’IU.
idx	Le numéro d’instance de l’élément d’IU.

SAP

Attribut	Description	Fuzzy	RegEx	Sensible à la casse
id	L’identificateur unique de l’élément d’IU.
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	Le numéro de ligne de table qui contient l’élément d’IU.
tableCol	Le numéro de colonne de table qui contient l’élément d’IU.
colName	Le nom de la colonne de table qui contient l’élément d’IU.
relpath
itemId

Silverlight

Veuillez noter que la balise Silverlight ne prend pas en charge les capacités Fuzzy, RegEx et Case-Sensitive.