studio
2024.10
true
Guide de l’utilisateur de Studio
Last updated 4 nov. 2024

À 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/><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'/><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 :

  • docs image Sélecteur en cours de validation
  • docs image Sélecteur valide
  • docs image Sélecteur non valide
  • docs image 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

available

available

available

cls

available

available

available

title

available

available

available

aaname

available

available

available

ctrlname (WinForms)

available

available

available

ctrlid (WinForms)

available

available

available

idx

Non disponible

Non disponible

Non disponible

tid

Non disponible

Non disponible

Non disponible

pid

Non disponible

Non disponible

Non disponible

isremoteapp

Non disponible

Non disponible

Non disponible

aastate

available

available

available

sapClient (SAP)

available

available

available

sapLanguage (SAP)

available

available

available

sapProgram (SAP)

available

available

available

sapScreen (SAP)

Non disponible

Non disponible

Non disponible

sapSession (SAP)

Non disponible

Non disponible

Non disponible

sapSysName (SAP)

available

available

available

NuméroSysSap (SAP)

Non disponible

Non disponible

Non disponible

sapSysSessionId (SAP)

available

available

available

sapTransaction (SAP)

available

available

available

sapUser (SAP)

available

available

available

HTML

Attribut

Fuzzy

RegEx

Sensible à la casse

url

available

available

available

htmlwindowname

available

available

available

title

available

available

available

class

available

available

available

app

Non disponible

Non disponible

Non disponible

idx

Non disponible

Non disponible

Non disponible

pid

Non disponible

Non disponible

Non disponible

tid

Non disponible

Non disponible

Non disponible

excludehwnd

Non disponible

Non disponible

Non disponible

bsid (Browser Session ID)

Non disponible

Non disponible

Non disponible

isremoteapp

Non disponible

Non disponible

Non disponible

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

available

available

available

idx

available

available

available

aaname

available

available

available

name

available

available

available

id

available

available

available

parentid

available

available

available

class

available

available

available

css-selector

Non disponible

Non disponible

Non disponible

innertext

available

available

available

visibleinnertext

available

available

available

isleaf

available

available

available

parentclass

available

available

available

parentname

available

available

available

src

available

available

available

href

available

available

available

tableCol

available

available

available

tableRow

available

available

available

colName

available

available

available

rowName

available

available

available

aria-label

available

available

available

aria-labelledby

available

available

available

Ctrl

Attribut

Fuzzy

RegEx

Sensible à la casse

Rôle

available

available

available

name

available

available

available

automationid

available

available

available

labeledby

available

available

available

aastate

available

available

available

virtualname

available

available

available

text

available

available

available

rowName

available

available

available

idx

Non disponible

Non disponible

Non disponible

UIA

Attribut

Fuzzy

RegEx

Sensible à la casse

accelkey (Accelerator Key)

available

available

available

acskey (Access Key)

available

available

available

automationid

available

available

available

cls

available

available

available

helpText

available

available

available

legacyAccHelp (Legacy Accessible Help)

available

available

available

enabled

available

available

available

kbfocus (Is Keyboard Focusable)

available

available

available

ispwd (Is Password)

available

available

available

itemstatus

available

available

available

itemtype

available

available

available

rtid (Runtime ID)

available

available

available

Rôle

available

available

available

name

available

available

available

pid

available

available

available

tableRow

Non disponible

Non disponible

Non disponible

tableCol

Non disponible

Non disponible

Non disponible

rowName

available

available

available

colName

available

available

available

idx

Non disponible

Non disponible

Non disponible

Java

Attribut

Fuzzy

RegEx

Sensible à la casse

Rôle

available

available

available

name

available

available

available

virtualname

available

available

available

javastate

available

available

available

tableRow

Non disponible

Non disponible

Non disponible

tableCol

Non disponible

Non disponible

Non disponible

rowName

available

available

available

colName

available

available

available

idx

Non disponible

Non disponible

Non disponible

SAP

Attribut

Fuzzy

RegEx

Sensible à la casse

id

available

available

available

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.

available

available

available

tableRow

Non disponible

Non disponible

Non disponible

tableCol

Non disponible

Non disponible

Non disponible

colName

available

available

available

relpath

available

available

available

itemId

available

available

available

Silverlight

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

  • Balises et attributs pris en charge
  • WND
  • HTML
  • WEBCTRL
  • Ctrl
  • UIA
  • Java
  • SAP
  • Silverlight

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.