Étendue de l'élément (Element Scope)

Activité Étendue de l'élément qui s'attache à un élément d’IU existant et l'expose comme étendue pour plusieurs activités enfants.

Important :

L’activité moderne Étendue de l’élément est uniquement disponible en aperçu.

UiPath.UIAutomationNext.Activities.NElementScope

Description

L'activité Element Scope identifie un seul élément d'IU une fois, puis l'expose sous forme d'étendue pour chaque activité placée dans son corps. Toutes les activités enfant (par exemple, Cliquer, Saisir dans, Obtenir le texte, Obtenir l'attribut) ciblent les éléments par rapport à l'élément que vous avez indiqué, au lieu de rechercher à nouveau l'écran entier.

Utilisez-le lorsque vous souhaitez exécuter plusieurs actions dans le même conteneur (une ligne de tableau, une section de formulaire, une carte ou un panneau) tout en conservant les sélecteurs courts, stables et rapides.

Le corps de l'activité est un conteneur. Les activités enfants qui doivent cibler l’élément indiqué (ou ses descendants) sont placées dans le corps. Chaque activité enfant s'exécute par rapport à l'élément capturé par l'étendue, de sorte que vous n'indiquez l'élément parent qu'une seule fois.

Remarque :

L’activité Étendue de l’élément peut être placée dans une activité Utiliser l'application/le navigateur , de sorte que l’élément soit résolu dans cette étendue d’application/de navigateur et que les activités enfants puissent hériter de ses paramètres. Il peut également être utilisé seul en indiquant directement un élément.

Compatibilité du projet

Windows | Multiplate-forme

Configuration

• Indiquer à l'écran : indiquer l'élément d'IU auquel vous souhaitez attacher. Une fois indiquée, la fiche d’activité affiche un aperçu de l’élément cible et de ses ancres.
  Après avoir indiqué la cible, gérez-la en sélectionnant le bouton des options de menu et en choisissant l’une des options suivantes :
  • Indiquer la cible : Indiquez à nouveau la cible. Si le descripteur est défini dans le référentiel d’objets, vous devez le dissocier avant de pouvoir indiquer un descripteur uniquement pour l’activité actuelle.
  • Modifier la cible : ouvrez l’assistant de sélection pour configurer l’élément cible.
  • Supprimer la capture d'écran d'information : supprime la capture d’écran de l’élément cible.
  • Modifier la capture d’écran d’information : modifie la capture d’écran de l’élément cible.
  • Afficher dans le référentiel d’objets (Show in Object Repository) : ouvre le panneau Référentiel d’objets (Object Repository) avec le descripteur sélectionné.
  • Dissocier du référentiel d’objets (Unlink from Object Repository) : dissocie le descripteur du référentiel d’objets.
  • Ajouter au référentiel d’objets : ajoute l’élément d’interface utilisateur actuel à un projet de bibliothèque, à partir duquel il peut être réutilisé tout au long de votre processus d’automatisation.

Panneau propriétés

Cible

L'élément d'IU auquel l'étendue s'attache. La cible est configurée lorsque vous indiquez l'élément à l'écran et peut être affinée à l'aide des options suivantes:

• Sélecteur de fenêtre : le sélecteur de la fenêtre d'application.
• Sélecteur strict : le sélecteur généré pour l’élément indiqué. Un sélecteur est un fragment XML qui identifie l'élément par ses attributs.

Options

• Mode Healing Agent : configure le comportement de Healing Agent pour cette activité, en fonction des paramètres de gouvernance ou d'Orchestrator au niveau du processus ou de la tâche.
  • Identique à l’application/au navigateur : hérite de la configuration de l’activité parente Use Application/Browser .
  • Inherit job settings : applique les paramètres définis dans Gouvernance ou dans Orchestrator au niveau du processus ou de la tâche.
  • Désactivé : désactive Healing Agent pour cette activité.
  • Recommandation uniquement : permet à Healing Agent de fournir des recommandations sur la façon de résoudre les problèmes d'automatisation de l'interface utilisateur lors des tâches en cours d'exécution, mais uniquement si les paramètres de gouvernance ou d'Orchestrator le permettent.
• Continuer en cas d'erreur - précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.
• Mode d'entrée : spécifie la technologie utilisée pour interagir avec l'élément cible. Les activités enfants à l’intérieur de l’étendue peuvent hériter de ce mode. Les options disponibles sont:
  • Événements matériels : agit comme un utilisateur réel, en utilisant la souris et le clavier via le système d’exploitation. Émule entièrement le comportement humain, mais certains événements peuvent être perdus et l’application cible doit être au point.
  • Simuler : simule le clic à l'aide des API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java et SAP. Habituellement plus fiable que les événements matériels, envoie tout le texte en une seule action et fonctionne même lorsque l’application cible n’est pas au point. Vérifiez que l'élément cible le prend en charge.
  • ChromiumAPI : effectue des actions grâce aux API Debugger. Fonctionne avec les éléments Chromium uniquement. Envoie tout le texte en une seule fois et fonctionne lorsque l’application cible n’est pas au point.
  • Messages de fenêtre - Utilise les messages Win32. Recommandé pour les applications de bureau. Habituellement plus fiable que les événements matériels, envoie tout le texte en même temps et fonctionne même lorsque l’application cible n’est pas au point. Vérifiez que l'élément cible le prend en charge.
  • Arrière-plan - s'exécute en arrière-plan. Utilise Simuler lorsque cela est possible; les activités complexes (image, texte natif) toujours exécutées au premier plan.

Horaires

• Délai d'attente - indique le délai d'attente (en secondes) pour qu'un élément cible soit trouvé avant qu'une erreur ne soit générée. La valeur par défaut est 30 secondes.

Remarque :

Les propriétés Délai avant et Délai après ne sont pas utilisées par l'étendue de l'élément et sont masquées dans le concepteur. Les paramètres de retard au niveau du projet ne sont intentionnellement pas appliqués à cette activité.

Entrée/sortie

• Élément d’entrée : l’élément de l’interface utilisateur sur lequel l’activité est exécutée, stocké dans un objet UiElement . Ce champ ne prend en charge que les objets UiElement . Vous pouvez obtenir cet objet à partir du champ de propriété de l'élément de sortie dans d'autres activités de UI Automation.
• Élément de sortie : l'élément de l'interface utilisateur résolu, stocké dans un objet UiElement . Vous pouvez ensuite transmettre cette variable à d'autres activités qui acceptent UiElement comme entrée.