Check App State

UiPath.UIAutomationNext.Activities.NCheckState

Description

Vérifie l'état d'une application ou d'un navigateur Web en vérifiant si un élément apparaît ou disparaît de l'interface utilisateur, et peut exécuter un ensemble d'activités si l'élément est trouvé et un autre ensemble d'activités si l'élément est introuvable.

Il peut surveiller les modifications d’une application entière, et pas seulement d’un seul élément d’IU.

Cette activité peut être utilisée à la fois à l’intérieur et à l’extérieur d’une activité Use Application/Browser .

Cela peut également être utilisé comme condition de l'activité Étendue de nouvelle tentative (Retry Scope).

Cette activité est compatible avec le référentiel d’objets.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Configuration Windows et multiplate-forme

• Travaux de l’étendue (Work in scope) : choisissez l’onglet du navigateur affichant l’application Web à automatiser.
• Indiquer la cible à l'écran
  • Indiquer l’élément d’IU à utiliser comme cible. Après avoir indiqué la cible, sélectionnez le bouton « plus » pour accéder aux options suivantes :
  • Indicate target on screen - Indicate the target again.
  • Modifier la cible : ouvrez le mode de sélection pour configurer la cible.
• Wait for (appear/disappear) - Select which event to use for determining the state of the application or browser:
  • Element to appear - Wait for the element to appear in the user interface. If you select this option:
    • Ajoutez les activités à exécuter si l'élément apparaît dans le bloc IfExists .
    • Ajoutez les activités à exécuter si l'élément n'apparaît pas dans le bloc IfNotExists .
  • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
    • Ajoutez les activités à exécuter si l'élément disparaît dans le bloc IfExists .
    • Ajoutez les activités à exécuter si l'élément ne disparaît pas dans le bloc IfNotExists .
• Délai d'attente (secondes) : délai d'attente pour que l'élément apparaisse ou disparaisse avant d'exécuter l'un des deux blocs d'activités. La valeur par défaut est 5 secondes.

Panneau propriétés

Entrée/sortie

• État : une valeur vraie ou fausse indiquant l'état détecté de la cible.
• Élément d’entrée : l’élément d’IU sur lequel l’activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Output Element d'autres activités UI Automation.
• Output Element : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut être ensuite utilisé pour cibler le même élément avec d'autres activités.

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.
  • Désactivé : désactive Healing Agent pour cette activité.
  • Inherit job settings : applique les paramètres définis dans Gouvernance ou dans Orchestrator au niveau du processus ou de la tâche.
  • 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.
  • Identique à l’application/au navigateur : hérite de la configuration de l’activité parente Use Application/Browser .

Cible

• Développer les propriétés de la cible : affiche les propriétés de la cible et de l'ancre. Cela masquera les autres propriétés de l'activité et n'affichera que celles liées à la cible.

• Réduire les propriétés de la cible : masque les propriétés de la cible et de l'ancre. Cela masquera les propriétés liées à la cible et affichera les propriétés de l'activité.

• Méthodes de ciblage : les types de sélecteurs que vous souhaitez utiliser pour identifier l’élément. Cette propriété peut être définie sur n’importe quelle combinaison à partir du menu déroulant :

  • Aucun (None)
  • Sélecteur strict : le sélecteur strict généré pour l’élément d’IU cible.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • Computer Vision : pour utiliser Computer Vision comme méthode de ciblage, vous devez accéder à Paramètres du projet > Computer Vision et veiller à définir le bon point de terminaison du serveur. Vous pouvez laisser ce champ tel quel et utiliser UiPath Cloud, qui est rempli par défaut, ou bien saisir une autre valeur en sélectionnant l'un des autres points de terminaison publics spécifiques à une région de serveur ou à votre propre serveur local. Vous pouvez également utiliser Computer Vision comme méthode de ciblage en définissant Utiliser un serveur local sur True. Cela implique que le package UiPath.ComputerVision.LocalServer soit installé dans votre projet. Lorsque le serveur local est activé, la valeur du serveur est écrasée. Le serveur local n'est cependant pas disponible avec les projets multiplate-forme.
    • Type de contrôle CV : indique le type de contrôle identifié à l'aide de Computer Vision.
    • Texte du CV : indique le texte identifié à l'aide de Computer Vision.
    • Occurrence de texte CV : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.
    • Précision du texte CV : indique le niveau de précision de la correspondance de texte OCR.
  • Sélecteur sémantique : exploite des modèles LLM pour générer des descriptions fonctionnelles et humaines des éléments d’IU. Ces descriptions sont très fiables. Elles peuvent donc évoluer en fonction des modifications de l’interface utilisateur et améliorent considérablement la résilience de l’automatisation lorsque les sélecteurs traditionnels échouent.
  • Image (Windows uniquement)
    • Précision de l'image : indique le niveau de précision de la correspondance de l'image.
    • Occurrence d'image : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.
  • Texte natif
    • Texte natif : le texte à trouver pour identifier l’élément d’IU.
    • Occurrence de texte natif : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.

• Sélecteur de fenêtre : sélecteur de la fenêtre d'application. Uniquement applicable lorsque le mode d’attachement de fenêtre est défini sur instance d’application.

• Attendre le chargement de la page : avant d’effectuer l’action, attendez que l’application soit prête à accepter la saisie. Les options sont les suivantes :

  • None : n’attend pas que la cible soit prête.
  • Interactif : attend qu'une partie de l'application soit prête.
  • Complète  : attend que l'application entière soit prête.

• Vérification de visibilité : lorsqu’elle est activée, l’activité vérifie également si l’élément d’IU est visible ou non. Choisissez l’une des trois options dans le menu déroulant :

  • Aucun : ne vérifie pas la visibilité.
  • Interactif (pour le sélecteur de correspondances approximatives) : option par défaut. Vérifie si l’élément est potentiellement visible en ignorant le défilement de la page et les obstructions par d’autres applications, ou bien si l’application est réduite. Cette vérification est utile lorsque vous voulez vous assurer que vous ne ciblez pas des éléments invisibles, qui existent dans le DOM mais sont masqués.
  • Entièrement visible : vérifie si l'élément d'IU est visible ou non.

• Sites Web réactifs : permet d'activer la mise en page réactive des sites Web.

Horaires

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Vérifier la visibilité : lorsqu’elle est activée, l’activité vérifie également si l’élément d’IU est visible ou non.

Configuration Windows - Héritage

• Sélectionnez Indiquer dans l’application/le navigateur pour indiquer l’élément d’IU à utiliser comme cible.

Après avoir indiqué la cible, sélectionnez le menu pour accéder aux options suivantes :

• Indicate target on screen - Indicate the target again.
• Modifier la cible : ouvrez le mode de sélection pour configurer la cible.
• Indiquer dans n’importe quelle application : lorsqu’elle est utilisée dans une activité Use Application/Browser , vous pouvez sélectionner cette option pour vérifier les états de l’application par rapport à des fenêtres ou des éléments non associés à l’instance d’application actuelle sans avoir à ajouter une nouvelle carte d’application.
• Supprimer la capture d'écran d'information : supprime la capture d’écran de l’application cible ou de la page Web.
• Ajouter au référentiel d’objets : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Wait for - Select which event to use for determining the state of the application or browser:
  • Element to appear - Wait for the element to appear in the user interface. If you select this option:
    • Add the activities to execute if the element appears in the Target appears block.
    • Add the activities to execute if the element does not appear in the Target does not appear block.
  • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
    • Add the activities to execute if the element disappears in the Target disappears block.
    • Add the activities to execute if the element does not disappear in the Target does not disappear block.
• Secondes : durée d’attente pour que l’élément apparaisse ou disparaisse avant d’exécuter l’un des deux blocs d’activités. Vous pouvez choisir une valeur prédéterminée dans le menu déroulant. La valeur par défaut est 5 secondes.
• Cliquez sur Activer/Désactiver les branches dans le corps de l'activité pour configurer la visibilité des éléments Cible apparaît et Cible n'apparaît pas les conteneurs dans lesquels vous pouvez ajouter des activités à exécuter, selon l'état. Vous pouvez travailler avec les deux conteneurs, l'un d'eux ou aucun. Par défaut, les deux blocs sont visibles.

Panneau propriétés

Commun

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

• • Type de contrôle CV : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte du CV : indique le texte identifié à l'aide de Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs : permet d'activer la mise en page réactive des sites Web.
  • Sélecteur strict : le sélecteur strict généré pour l’élément d’IU.
  • Méthodes de ciblage : les types de sélecteurs que vous souhaitez utiliser pour identifier l’élément. Cette propriété peut être définie sur n’importe quelle combinaison à partir du menu déroulant :
    • Aucun (None)
    • Sélecteur strict
    • Sélecteur de correspondances approximatives
    • Image
    • Texte natif
    • Computer Vision : pour utiliser Computer Vision comme méthode de ciblage, vous devez accéder à Paramètres du projet > Computer Vision et veiller à définir le bon point de terminaison du serveur. Vous pouvez laisser ce champ tel quel et utiliser UiPath Cloud, qui est rempli par défaut, ou bien saisir une autre valeur en sélectionnant l’un des autres points de terminaison publics spécifiques à une région de serveur ou à votre propre serveur local. Vous pouvez également utiliser Computer Vision comme méthode de ciblage en définissant Utiliser un serveur local sur True. Cela implique que le package UiPath.ComputerVision.LocalServer soit installé dans votre projet. Lorsque le serveur local est activé, la valeur du serveur est écrasée. Le serveur local n'est cependant pas disponible avec les projets multiplate-forme.
    • Sélecteur sémantique : exploite des modèles LLM pour générer des descriptions fonctionnelles et humaines des éléments d’IU. Ces descriptions sont très fiables. Elles peuvent donc évoluer en fonction des modifications de l’interface utilisateur et améliorent considérablement la résilience de l’automatisation lorsque les sélecteurs traditionnels échouent.
  • Vérification de visibilité : vérifie si l’élément d’IU est visible ou non. Choisissez l’une des trois options dans le menu déroulant :
    • Aucun : ne vérifie pas la visibilité.
    • Interactif (pour le sélecteur de correspondances approximatives) : option par défaut. Vérifie si l’élément est potentiellement visible en ignorant le défilement de la page et les obstructions par d’autres applications, ou bien si l’application est réduite. Cette vérification est utile lorsque vous voulez vous assurer que vous ne ciblez pas des éléments invisibles, qui existent dans le DOM mais sont masqués.
    • Entièrement visible
      • Vérifie si l’élément d’IU est visible ou non.
  • Attendre le chargement de la page : avant d’effectuer l’action, attendez que l’application soit prête à accepter la saisie. Choisissez l’une des trois options dans le menu déroulant :
    • None : n’attend pas que la cible soit prête.
    • Interactif : attend qu'une partie de l'application soit prête.
    • Complète  : attend que l'application entière soit prête.
  • Sélecteur de fenêtre : le sélecteur utilisé pour la fenêtre d'application. Uniquement applicable lorsque le mode d’attachement de fenêtre est défini sur Instance d’application.

• Élément d’entrée : l’élément d’IU sur lequel l’activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Output Element d'autres activités UI Automation.

• Output Element : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut être ensuite utilisé pour cibler le même élément avec d'autres activités.

• Privé : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé. Ce champ prend uniquement en charge les valeurs Boolean (Vrai, Faux , Faux). La valeur par défaut est False.

• Délai d'attente (secondes) : voir secondes dans le panneau Concepteur.

• Attendre (apparaître/disparaître) : voir Attendre dans le panneau Concepteur.

• Résultat : indique si l’élément existe ou non. Ce champ prend uniquement en charge les variables Boolean . Vous pouvez également enregistrer cette valeur (Vrai/Faux) pour une utilisation ultérieure, ou l'enregistrer dans une cellule d'un fichier Excel parent ou du bloc-notes du projet.