Export UI Tree

UiPath.Core.Activities.ExportUiTree

Exporte tous les éléments d'IU et leurs attributs et valeurs respectifs trouvés dans l'élément indiqué sous forme de fichier XML ou JSON. Cette activité vous aide à comprendre pourquoi un sélecteur a échoué lors de son exécution en inspectant la sortie de l'activité et en la comparant à la configuration du sélecteur.

Propriétés

Commun

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à l'objet UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.
• Élément cible (Target.Element) - Utiliser la variable UiElement renvoyée par une autre activité. Cette propriété ne peut pas être utilisée avec la propriété Selector. Ce champ prend en charge les variables UiElement uniquement.
• Sélecteur de cible (Target.Selector) - Propriété de texte utilisée pour trouver un élément donné de l'interface utilisateur lors de l'exécution de l'activité. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément d'interface graphique utilisateur que vous recherchez et de certains de ses parents.
• Expiration cible ms (Target.TimeoutMS) - Spécifie le délai d'attente (en millisecondes) avant l'exécution de l'activité au-delà duquel un message d'erreur SelectorNotFoundException est généré . La valeur par défaut est 30 000 millisecondes (30 secondes).
• Attente cible prête (Target.WaitForReady) - Avant d'exécuter 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/Terminé - Attend que tous les éléments d'IU de l'application cible soient créés avant d'exécuter 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 (Desktop applications) - Un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. Si elles existent, l'activité est exécutée.
  • Applications Web (Web Applications)
  1. Internet Explorer - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
  2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
  • 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.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• FormatExportation : une liste déroulante qui spécifie le format dans lequel vous souhaitez que les éléments d'IU soient exportés. Vous pouvez choisir entre XML et JSON. Par défaut, XML est sélectionné.
• CheminExportation : le chemin où vous souhaitez créer le fichier contenant l'arborescence d'IU extraite. Si ce champ est laissé vide, le fichier est exporté en tant qu'argument de sortie ExportedString. Ce champ ne prend en charge que les chaînes et les variables String.
• Filtre : un filtre qui vous permet d'exporter uniquement certains types de sélecteurs. L'arborescence d'IU exportée contient uniquement des éléments d'IU selon les types de sélecteurs spécifiés dans ce champ.
• InclureInstantanés : si cette option est sélectionnée, elle enregistre des captures d'écran de l'arborescence de l'interface utilisateur avec le fichier contenant les sélecteurs. Par défaut, cette case est décochée.
• DélaiOpération (millisecondes) : spécifie la durée (en millisecondes) à attendre pour que l'activité génère le fichier contenant l'arborescence d'IU exportée.
• Remplacer : si cette option est sélectionnée, l'activité écrase tous les fichiers existants dans le chemin spécifié dans le champ de propriété CheminExportation. Par défaut, cette case est décochée.
• InfrastructureIU : un menu déroulant qui spécifie l'infrastructure d'IU utilisée pour détecter les éléments d'IU de niveau supérieur. Trois choix sont possibles : Par défaut, Active Accessibility et UiAutomation. Par défaut, Par défaut est sélectionné. Ce champ de propriété est utilisé uniquement lors de l'exportation du contenu de l'ensemble du bureau.

Dans le corps de l’activité

Le corps de l'activité vous permet de configurer plusieurs paramètres de l'activité sans interagir avec le panneau Propriétés, tels que :

Le bouton Indiquer à l'écran permet de sélectionner l'application cible dont vous souhaitez exporter l'arborescence d'IU.

Le menu déroulant Format d'exportation (Export Format) vous permet de choisir entre les formats XML ou JSON qui peuvent être utilisés pour le fichier exporté.

Le champ Fichier de destination vous permet de spécifier le chemin d'enregistrement du fichier ou de rechercher le dossier.

La case à cocher Inclure les captures d'écran spécifie si les captures d'écran des éléments d'IU réels doivent être enregistrées avec le fichier contenant l'arborescence d'IU ou non. Par défaut, la case est décochée.