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é Utiliser l'application/le navigateur (Use Application/Browser), vous devez fournir un élément d’entrée.

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

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Configuration Windows et multiplate-forme

• Étendue du travail (Work in scope ) - Choisissez l'onglet du navigateur générant le rendu de l'application Web à automatiser.

• Indiquer la cible à l’écran : indiquez 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 :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.

Panneau propriétés

Entrée/sortie

• Valeur du texte (Text value ) : 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 .
• Infos sur les mots (Words info ) - Les informations supplémentaires du texte récupéré, telles que les coordonnées de l'écran, sont enregistrées dans la variable fournie dans ce champ. Ce champ ne prend en charge que NWordInfo variables.
• Élément d'entrée (Input element ) : 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 . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.

Options

• Méthode d'extraction (Scraping method ) : décrit la méthode d'extraction à utiliser. Les options suivantes sont disponibles :
  • Par défaut (Default) : parcourt les méthodes d'extraction possibles (attribut Text, Fulltext, dans cet ordre) et s'arrête à la première méthode qui renvoie des données. La seule raison de changer la méthode par défaut est si elle renvoie un texte, mais pas la bonne. Si la méthode par défaut ne renvoie rien, il en va de même pour les 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 intégral (Fulltext ) - Extrait le texte complet de l'élément de l'interface utilisateur, 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 à utiliser pour identifier l'élément. Cette propriété peut recevoir 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 decontrôle CV (CV Control type ) : indique le type de contrôle identifié à l'aide de Computer Vision.
    • Texte 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 le fait que l'application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles qui existent dans le DOM mais qui sont masqués.
  • Entièrement visible : vérifie si l'élément d'IU est visible ou non.
• Sites Web réactifs - Activez la mise en page des sites Web réactifs.

Cible - Zone de détourage

• Point d'ancrage - Décrit le point de départ du curseur auquel les décalages des propriétés Décalage X et Décalage Y sont ajoutés. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRightet 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

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de 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 :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : 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 (Preview extraction ) - Ouvre l'assistant Obtenir le texte (Get Text) - Aperçu de l'extraction , qui permet de voir quel texte est récupéré à partir de la cible en temps réel.
• Enregistrer dans (Save to ) : 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 le texte - Aperçu de l'extraction ( Get Text - Extraction preview ) vous permet de choisir la méthode d'extraction à utiliser et affiche également en temps réel le texte qui s'affiche en utilisant la méthode choisie. Le texte extrait est affiché dans la zone de texte Aperçu de l'extraction ( Extraction preview ) et peut être copié à l'aide du bouton Copier dans le presse-papiers ( Copy to Clipboard ).

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
• Texte intégral (Fulltext ) - Cette méthode offre la possibilité d' Ignorer le texte caché, qui peut être activée en cochant sa case respective.
• Native (Native) - Cette méthode vous permet d'Autoriser le formatage (Allow formatting) et de récupérer les coordonnées d'écran des mots en cochant les cases de chacune de ces fonctionnalités.
  
  

  

  
  

Après avoir sélectionné la méthode que vous souhaitez utiliser pour l'extraction, appuyez sur Enregistrer et fermer pour fermer l'assistant et propager les modifications que vous avez apportées dans le panneau Propriétés de l'activité.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : spécifie 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 (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.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• 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 la durée (en secondes) d'attente de 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 (Default) : parcourt les méthodes d'extraction possibles (attribut Text, Fulltext, dans cet ordre) et s'arrête à la première méthode qui renvoie des données. La seule raison de changer la méthode par défaut est si elle renvoie un texte, mais pas la bonne. Si la méthode par défaut ne renvoie rien, il en va de même pour les 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 intégral (Fulltext ) - Extrait le texte complet de l'élément de l'interface utilisateur, 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.
  • Natif : extrait le texte visible de l'élément de l'interface utilisateur spécifié.
• Remarque : si une case cochée est ciblée par cette activité, le texte renvoyé est checked. Si une image est ciblée par cette activité, le texte alt de l'image est renvoyé.
  • Type decontrôle CV (CV Control type ) : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte CV - Indique le texte identifié à l’aide de Computer Vision.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs - Activez la mise en page des sites Web réactifs.
  • 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 à utiliser pour identifier l'élément. Cette propriété peut recevoir 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.
  • Contrôle de visibilité (Visibility check ) - Vérifie si l'élément d'IU est visible ou non. Vous pouvez choisir l’une des trois options suivantes 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 le fait que l'application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles qui existent dans le DOM mais qui 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 les Actions, attendez que l'application soit prête à accepter les entrées. Vous pouvez choisir l’une des trois options suivantes 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 (Instance d'application) : 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 (Application instance).

• Élément d'entrée (Input element ) : 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 . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.

• 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). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

• Texte : voir Enregistrer vers dans le panneau Concepteur.
• Infos sur les mots (Words info ) - Les informations supplémentaires du texte récupéré, telles que les coordonnées de l'écran, sont enregistrées dans la variable fournie dans ce champ. Ce champ ne prend en charge que NWordInfo variables.