Obtenir le texte (Get Text)

UiPath.UIAutomationNext.Activities.NGetText

Description

Extrait et copie le texte d'un élément d'IU.

Cette activité doit être ajoutée dans une activité Use Application/Browser.

Pour utiliser cette activité en dehors d’une activité Use Application/Browser , vous devez fournir un élément Input.

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.

Panneau propriétés

Entrée/sortie

• Valeur du texte - Permet de stocker le texte de l'élément d'interface utilisateur spécifié dans une variable. Les variables créées dans ce champ sont de type String .
• Words info - The additional information of the retrieved text, such as screen coordinates, are saved in the variable supplied in this field. This field supports only NWordInfo variables.
• É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

• Méthode d'extraction : décrit la méthode d'extraction que vous souhaitez utiliser. Les options suivantes sont disponibles :
  • Par défaut : parcourt les méthodes d'extraction possibles (attributs de texte, Fulltext, dans cet ordre) et s'arrête à la première méthode qui renvoie des données. La seule raison de modifier la méthode par défaut est que elle renvoie un texte, mais pas la bonne. Si la méthode par défaut ne renvoie rien, la même chose s'applique aux autres méthodes d'extraction.
  • Attribut de texte - Extrait la valeur de l'attribut de texte pour l'élément d'IU spécifié.
  • Texte complet - Extrait le texte complet de l'élément d'IU, y compris ses éléments enfants. Cette méthode est utile lorsque vous souhaitez extraire le texte complet d'un élément conteneur qui contient plusieurs éléments enfants.
  • OCR : extrait le texte à l’aide du moteur OCR.
• Options d'extraction:
  • Mise en forme du texte
  • Ignorer le texte masqué
  • Coordonnées des mots
• 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 .
• Continuer en cas d'erreur (Continue on error) : 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 booléennes Vrai (True) et Faux (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 Vrai (True), l’exécution du projet se poursuit même en cas d’erreurs.

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.

Cible - Zone de détourage

• Point d'ancrage : décrit le point de départ du curseur vers lequel il se décalage des propriétés Décalage X et Décalage Y sont ajoutées. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRight  et Center. Par défaut, Center est sélectionné.
• Décalage X - Déplacement horizontal de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32.
• Décalage Y - Déplacement vertical de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32.
• Largeur du décalage : largeur de la zone de décalage.
• Hauteur de décalage : hauteur de la région de décalage.

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.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Délai d'attente : spécifiez le délai d'attente pour l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

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.
• 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.
• Aperçu de l'extraction : ouvre l'assistant Obtenir l'aperçu de l'extraction de texte , qui vous permet de voir quel texte est récupéré à partir de la cible en temps réel.

• Enregistrer dans : permet de stocker le texte de l'élément d'IU spécifié dans une variable. Les variables créées dans ce champ sont de type String .

Aperçu de l’extraction

L'assistant Obtenir l'aperçu de l'extraction de texte vous permet de choisir la méthode d'extraction que vous souhaitez utiliser et affiche également en temps réel le texte qui est affiché en utilisant la méthode choisie. Le texte extrait s’affiche dans la zone de texte Aperçu de l’extraction et peut être copié à l’aide du bouton Copier dans le Presse-papiers .

Si l'assistant n'est pas utilisé, toutes les méthodes d'extraction sont essayées par défaut et la meilleure est choisie automatiquement. Le choix d’une méthode d’extraction dans la fenêtre d’aperçu de l’extraction remplace ce mécanisme et fait de cette méthode la seule utilisée.

Les méthodes suivantes sont disponibles :

• Default
• Attribut de texte
• Fulltext - This method offers the option to Ignore hidden text, which can be activated by selecting its respective check box.
• Native - This method enables you to Allow formatting and retrieve the screen coordinates of the words by selecting the check boxes for each of these features.

After selecting the method you want to use for scraping, hitting Save & close closes the wizard and propagates the changes you have made in the Properties Panel of the activity.

Panneau propriétés

Commun

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (Vrai, Faux , Faux). 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'erreurs.

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

• 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.

• Délai d'attente : spécifiez le délai d'attente pour l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes. Vous pouvez également choisir une valeur prédéterminée dans le menu déroulant : 10 (s), 20 (s) ou 30 (s).

• Par défaut : parcourt les méthodes d'extraction possibles (attributs de texte, Fulltext, dans cet ordre) et s'arrête à la première méthode qui renvoie des données. La seule raison de la modification de la méthode par défaut est que elle renvoie un texte, mais pas le bon. Si la méthode par défaut ne renvoie rien, la même chose s'applique aux autres méthodes d'extraction.

• Attribut de texte - Extrait la valeur de l'attribut de texte pour l'élément d'IU spécifié.

• Texte complet - Extrait le texte complet de l'élément d'IU, y compris ses éléments enfants. Cette méthode est utile lorsque vous souhaitez extraire le texte complet d'un élément conteneur qui contient plusieurs éléments enfants.

• Native - Extrait le texte visible de l'élément de l'interface utilisateur spécifié.

Remarque :

If a selected check box is targeted by this activity, the returned text is checked. If an image is targeted by this activity, the alt text of the image is returned.

• 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.

• Texte : voir Enregistrer dans dans le panneau Concepteur.

• Words info - The additional information of the retrieved text, such as screen coordinates, are saved in the variable supplied in this field. This field supports only NWordInfo variables.