Zone de détourage

Une zone de détourage désigne une zone spécifique de l’écran qui est définie et utilisée pour UI Automation. Elle peut notamment être utilisée dans le cas d’automatisations basées sur des images. Par exemple, vous pouvez utiliser une activité Cliquer (Click) pour indiquer un élément d’IU et agir au niveau d’une sous-zone de l’élément, par exemple, en cliquant sur BottomRight pour la zone de détourage la plus petite/grande.

La zone de détourage par défaut est l’élément d’IU entier que vous avez indiqué. Cependant, elle peut être manipulée et réduite à une zone plus petite pour plus de rapidité et d’efficacité.

Configuration d’une zone de détourage

La propriété ZoneDétourage (Click) des activités UI Automation classiques est imbriquée sous la propriété Cible (Target) et peut être utilisée pour établir une zone plus petite/grande de l’élément d’IU trouvé au moment de l’exécution à l’aide de la propriété Sélecteur (Selector) de la cible ou fournie directement via la propriété Élément (Element) de la cible.

Pour ce faire, vous devez saisir des valeurs pour toutes les coordonnées (Gauche (Left), Haut (Top), Droite (Right), Bas (Bottom)) et manipuler directement la zone de détourage.

Limitations

Il existe quelques différences entre les commentaires de débogage visuels et les actions réelles du robot. Prenons l’activité Cliquer (Click) classique comme exemple.

Pour une zone de détourage de (-10,-10, 0, 0), si l’activité est configurée avec PositionDuCurseur (CursorPosition) défini sur BottomRight, l’action de clic est effectuée au niveau de l’origine de l’élément (0,0).

Pour une zone de détourage de (0, 0, -10, -10), le résultat est similaire au premier cas en raison d’un tri du code interne/de la modification des nombres inférieurs sur les axes X et Y.

Pour une zone de détourage de (10, 10, -10, -10), l’action de clic a lieu exactement à une distance de (10,10) de l’origine de l’élément (0,0). Le même tri des valeurs de la zone de détourage sur l’axe X et séparément sur l’axe Y donne une zone de détourage interne de (-10, -10, 10, 10).

En bref, bien que les deux premières coordonnées correspondent à X, les coordonnées Y doivent être relatives à la valeur TopLeft, tandis que les deux dernières coordonnées doivent être relatives à la valeur BottomRight de l’élément. Cependant, ce n’est pas le cas, et les quatre coordonnées sont relatives à la valeur TopLeft de l’élément.

De plus, en raison des valeurs de tri du code interne sur les axes X et Y, une configuration telle que (0, 0, -10, -10) donne le même résultat qu’une configuration (-10, -10, 0, 0).

Configuration d’une zone de détourage à l’aide d’un objet rectangle

Vous pouvez configurer une zone de détourage à l’aide de l’activité classique Définir la zone de détourage (Set Clipping Region).

Pour ce faire, vous devez définir la propriété Direction sur RECTANGLE et saisir sous la propriété Zone (Region) les coordonnées selon ce format : UiPath.Core.Region(New Rectangle(X,Y,Width,Height)).

Configuration d’une zone de détourage à l’aide de l’activité Rechercher l’élément (Find Element) ou Rechercher l’image (Find Image)

La zone de détourage peut être définie de façon à couvrir uniquement l’élément ou l’image recherché(e) à l’aide des activités Rechercher l’image (Find Image) ou Rechercher l’élément (Find Element).

La position de l’élément ou de l’image est identifiée et la zone peut ensuite être manipulée à l’aide de la propriété TRADUIRE (TRANSLATE) de l’activité Définir la zone de détourage (Set Clipping Region).