Guide de l’utilisateur de Studio

Dernière mise à jour 17 déc. 2024

Propriétés des activités de l'interface utilisateur

Plusieurs activités peuvent être utilisées dans le cadre de l'automatisation d'une application ou d'une application Web. Elles sont disponibles dans la catégorie UI Automation du module Activités (Activities).

Toutes ces activités possèdent plusieurs propriétés communes :

Poursuite sur erreur (ContinueOnError) permet d'indiquer si le processus d'automatisation doit être maintenu ou interrompu en cas d'erreur. Ce champ accepte uniquement des valeurs booléennes (Vrai, Faux). La valeur par défaut dans ce champ est Faux (False). Par conséquent, si ce champ est laissé vide et qu'une erreur survient, l'exécution du projet est interrompue. Si le champ indique au contraire Vrai (True), l'exécution du projet se poursuit même en cas d'erreur.

Remarque : si le champ Poursuite sur erreur (ContinueOnError) indique Vrai (True) pour une activité contenue dans un bloc Try Catch, les erreurs potentielles ne seront pas détectées lors de l'exécution du projet.
Retard après (DelayAfter) permet d'ajouter une pause après l'activité (valeur indiquée en millisecondes).
Retard avant (DelayBefore) permet d'ajouter une pause avant l'activité (valeur indiquée en millisecondes).
TimeoutMS permet d'indiquer pour un élément donné un délai d'attente de réponse (en millisecondes) au-delà duquel une erreur sera émise. La valeur par défaut de ce champ est de 30000 millisecondes (30 secondes).
Attendre que la fonctionnalité soit prête (WaitForReady) - Avant d'effectuer les actions, attendez que la cible soit prête. Les options suivantes sont disponibles :
- None (Aucun) - Attend uniquement la création de l'élément de l'interface utilisateur cible avant d'exécuter l'action. Vous pouvez, par exemple, utiliser cette option si vous souhaitez récupérer uniquement du texte à partir d'une page Web ou cliquer sur un bouton spécifique sans être obligé d'attendre que tous les éléments de l'interface utilisateur soient chargés. Il est à noter que ceci peut avoir des conséquences indésirables si le bouton est basé sur des éléments qui ne sont pas encore chargés, comme par exemple des scripts.
- Interactif (Interactive) : attend que l'application cible indique qu'elle est prête, bien que certains actifs puissent toujours être en cours de chargement.
- Terminé - attend le chargement de tous les éléments d'IU dans l'application cible avant l'exécution effective de l'action.
  
  Pour évaluer si une application est à l'état Interactif (Interactive) ou Terminé (Complete), les balises suivantes sont vérifiées :
  
  Applications de bureau : un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. S'ils existent, l'activité est exécutée.
  
  Applications Web (Web Applications)
  - Internet Explorer : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé. En outre, l'état Occupé doit être défini sur « False ».
  - Autres : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé.
  Applications SAP (SAP applications) : une fois la présence de la balise <wnd> vérifiée, une API SAP spécifique est utilisée pour détecter si la session est occupée ou non.

Cible (Target): identifie l'élément d'interface utilisateur avec lequel l'activité fonctionne.

La cible permet d'identifier un l'élément d'interface utilisateur grâce à plusieurs composants, notamment le conteneur, le sélecteur et la région de découpage.

En offrant une vision plus précise du contexte dans lequel un bouton ou un champ donné existe, un conteneur permet de différencier les différentes fenêtres ou zones au sein de la même application. Les conteneurs sont générés automatiquement, mais peuvent être modifiés à partir du module Propriétés (Properties).

Les éléments suivants sont des conteneurs :