Prendre une capture d'écran (Take Screenshot)

UiPath.UIAutomationNext.Activities.NTakeScreenshot

Description

Prend une capture d'écran d'un élément d'IU, d'une application ou du bureau entier et l'enregistre en tant que fichier image.

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

Si ajouté dans une activité Utiliser l'application/le navigateur , seule l'application ciblée est capturée. S'il est ajouté en dehors d'une carte d'application et qu'aucune cible n'est spécifiée, l'ensemble du bureau est capturé.

Remarque :

À partir de UIAutomation v25.10.32, une option de bureau dédiée a été ajoutée à la liste déroulante du conteneur Capture d’écran , permettant la capture en mode plein écran même lorsque l’activité est utilisée dans une carte d’application.

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 : sélectionnez l’onglet du navigateur ou la fenêtre d’application qui héberge l’application à automatiser, lorsque l’activité est placée dans les activités Utiliser l’application/le navigateur imbriquées.

• Conteneur de capture d'écran : spécifie l'étendue de l'interface utilisateur pour la capture d'écran. Sélectionnez l’une des options suivantes:

  • Fenêtre principale : capture une capture d’écran de la fenêtre active principale de l’application jointe.
  • Élément - Capture une capture d'écran de l'élément indiqué.
  • Poste de travail - Capture une capture d'écran de l'ensemble du bureau.

  La valeur par défaut est Fenêtre principale.

• Indiquer la cible à l'écran : indiquez l'élément d'IU à utiliser comme cible. Ce bouton n'est disponible que lorsque l'option Élément est sélectionnée comme conteneur de capture d'écran. Après avoir indiqué la cible, cliquez sur les trois lignes situées à côté de la capture d'écran informative pour accéder aux options suivantes :

  • Indiquer la cible : indiquez à nouveau la cible. Si le descripteur est défini dans le référentiel d’objets, vous devez d’abord le dissocier du référentiel d’objets si vous souhaitez spécifier un descripteur uniquement pour l’activité actuelle.
  • 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.
  • Modifier la capture d’écran d’information : modifie 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 au référentiel d’objets, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation. Cette option s'affiche uniquement lorsque l'objet n'a pas encore été ajouté au référentiel d'objets.
  • Afficher dans le référentiel d’objets : ouvre le panneau Référentiel d’objets avec le descripteur sélectionné. Cette option s'affiche uniquement lorsque l'objet a été ajouté au référentiel d'objets.
  • Dissocier du référentiel d’objets : dissocie le descripteur du référentiel d’objets. Cette option s'affiche uniquement lorsque l'objet a été ajouté au référentiel d'objets.

• Sortie vers : utilisez les cases d'option pour choisir le type de sortie :

  • Fichier - Enregistre la capture d'écran dans un fichier à un emplacement spécifié. L'option par défaut.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.

• Nom du fichier - Nom du fichier dans lequel la capture d'écran de l'élément de l'interface utilisateur spécifié est enregistrée. Cette propriété est uniquement disponible lorsque l'option Fichier est sélectionnée comme sortie vers.

• Incrémentation auto - Définit ce qu'il faut ajouter au nom du fichier en cas de conflit de noms de fichier. Cette propriété est uniquement disponible lorsque l'option Fichier est sélectionnée comme sortie vers. Choisissez une option dans le menu déroulant:

  • Aucun (écrasement) : le nom de fichier sera exactement tel que spécifié, et dans le cas où un autre fichier avec le même nom existe déjà, il sera écrasé. Il s'agit de l'option par défaut.
  • Index : si un ou plusieurs fichiers qui correspondent au modèle Filename (XX) existent déjà, un nouveau fichier est créé avec le nom Filename (N+1), où N est l'index maximal des fichiers existants.
  • YYYY.MM.DD à HH.MM.SS - Si un fichier avec le nom spécifié existe déjà, un nouveau fichier est créé avec le nom Filename YYYY.MM.DD at HH.MM.SS. Si un fichier avec le nom de fichier Filename YYYY.MM.DD at HH.MM.SS existe déjà et qu'un index est ajouté, comme dans le cas de l'index, ce qui entraîne un fichier appelé Filename YYYY.MM.DD at HH.MM.SS (1).

Panneau propriétés

Cible

Cette section est uniquement disponible lorsque l'option Élément est sélectionnée comme conteneur Capture d'écran.

• Bouton Développer les propriétés cibles/Réduire les propriétés cibles : affiche/masque le conteneur cible et ses propriétés d'ancre.

• 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 et au moins une méthode de ciblage doit être sélectionnée :

  • Sélecteur strict

  • Sélecteur de correspondances approximatives

  • Image (uniquement disponible pour les projets Windows)

  • Texte natif (uniquement disponible pour les projets Windows)

  • Computer Vision

  • Sélecteur sémantique

    Remarque :

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

• Sélecteur strict : le sélecteur strict généré pour l’élément d’IU. S’affiche uniquement si la méthode de ciblage du Sélecteur strict a été sélectionnée.

• Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives. S'affiche uniquement si la méthode de ciblage du Sélecteur de correspondances approximatives a été sélectionnée.

• Image : ces propriétés sont disponibles uniquement lorsque la méthode de ciblage Image est sélectionnée.

  • Précision de l'image : spécifie le seuil de confiance utilisé pour la correspondance d'images. La valeur par défaut est 0,8.
  • Occurrence d’image : spécifie la correspondance à utiliser lorsque plusieurs images correspondantes sont trouvées.

• Natif : ces propriétés sont disponibles uniquement lorsque la méthode de ciblage Native est sélectionnée.

  • Texte natif : spécifie le texte utilisé pour identifier l’élément de l’interface utilisateur.
  • Occurrence de texte natif : spécifie l’occurrence à utiliser lorsque plusieurs correspondances sont trouvées.
  • Sensible à la casse du texte natif : indique si la correspondance de texte est sensible à la casse.

• Computer Vision : ces propriétés sont disponibles uniquement lorsque la méthode de ciblage Computer Vision est sélectionnée.

  • Type de contrôle CV : spécifie le type de contrôle identifié à l'aide de Computer Vision.
  • Texte du CV : spécifie le texte identifié à l'aide de Computer Vision.
  • Précision du texte CV : spécifie le seuil de confiance utilisé pour la correspondance du texte OCR. La valeur par défaut est 0,7.
  • Occurrence de texte CV : spécifie l’occurrence à utiliser lorsque plusieurs correspondances sont trouvées.

• Sélecteur sémantique : une description sémantique qui définit la cible. Cette propriété est disponible uniquement lorsque la méthode de ciblage Sémantique a été sélectionnée.

  Les modèles LLM (Large Language Model) sont utilisés pour générer des descriptions fonctionnelles par défaut et lisibles par un humain des éléments d’IU. Ces descriptions sont très résilientes aux modifications de l’interface utilisateur et contribuent à améliorer la fiabilité de l’automatisation lorsque les sélecteurs traditionnels sont insuffisants ou échouent.

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

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

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

• Cible - Zone de détourage : spécifie une zone de détourage qui peut être configurée davantage. Il peut être utilisé pour établir une zone plus petite/grande de l’élément d’IU trouvé au moment de l’exécution à l’aide du Sélecteur de la cible ou fournie directement via la propriété Élément d’entrée de la cible.

  • 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 (sélectionnés par défaut).
  • Décalage X - Déplacement horizontal de la région 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 région 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.

Cible - Ancre (n)

• 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 et au moins une méthode de ciblage doit être sélectionnée :
  • Sélecteur strict
  • Sélecteur de correspondances approximatives
  • Image (uniquement disponible pour les projets Windows)
  • Texte natif (uniquement disponible pour les projets Windows)
  • Computer Vision
• Sélecteur strict : le sélecteur strict généré pour l’élément d’IU. S’affiche uniquement si la méthode de ciblage du Sélecteur strict a été sélectionnée.
• Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives. S'affiche uniquement si la méthode de ciblage du Sélecteur de correspondances approximatives a été sélectionnée.
• Image : ces propriétés sont disponibles uniquement lorsque la méthode de ciblage Image est sélectionnée.
  • Précision de l'image : spécifie le seuil de confiance utilisé pour la correspondance d'images. La valeur par défaut est 0,8.
  • Occurrence d’image : spécifie la correspondance à utiliser lorsque plusieurs images correspondantes sont trouvées.
• Natif : ces propriétés sont disponibles uniquement lorsque la méthode de ciblage Native est sélectionnée.
  • Texte natif : spécifie le texte utilisé pour identifier l’élément de l’interface utilisateur.
  • Occurrence de texte natif : spécifie l’occurrence à utiliser lorsque plusieurs correspondances sont trouvées.
  • Sensible à la casse du texte natif : indique si la correspondance de texte est sensible à la casse.
• Computer Vision : ces propriétés sont disponibles uniquement lorsque la méthode de ciblage Computer Vision est sélectionnée.
  • Type de contrôle CV : spécifie le type de contrôle identifié à l'aide de Computer Vision.
  • Texte du CV : spécifie le texte identifié à l'aide de Computer Vision.
  • Précision du texte CV : spécifie le seuil de confiance utilisé pour la correspondance du texte OCR. La valeur par défaut est 0,7.
  • Occurrence de texte CV : spécifie l’occurrence à utiliser lorsque plusieurs correspondances sont trouvées.

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.

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

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.

Entrée/sortie

• Fichier de capture d'écran : la capture d'écran enregistrée en tant que fichier .png .
• Élément de sortie - Émet un élément d'IU cible et le stocke dans un objet ÉlémentIU , qui peut être ensuite utilisé pour cibler le même élément avec d'autres activités.
• Élément d'entrée : l'élément d'IU sur lequel l'activité est exécutée, stocké dans un objet ÉlémentIU . 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.

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

• Sortie vers : utilisez les cases d'option pour choisir le type de sortie :
  • Fichier - Enregistre la capture d'écran dans un fichier à un emplacement spécifié. L'option par défaut.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.
• Nom du fichier - Nom du fichier dans lequel la capture d'écran de l'élément d'IU spécifié est enregistrée. Cliquez sur Rechercher des fichiers, puis naviguez jusqu'au dossier où vous souhaitez enregistrer la capture d'écran, et spécifiez le nom de fichier et l' extension à utiliser.
• Auto increment - Select what to append to the filename when saving the screenshot in case of filename conflicts. For example, if a file with the same name as the one you save already exists, choosing Index keeps the file name, creating a new file for each screenshot and adding an index number to each, consecutively.
  • None (overwrite) - If a file with the same name already exists, replace it.
  • Index - Add a number to the filename, for example screenshot (1).png.
  • YYYY.MM.DD at HH.MM.SS - Add the date and time when the screenshot is taken to the filename, for example screenshot 2020.06.22 at 10:22:32.

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.

• Incrémentation automatique : voir Incrémentation automatique dans le panneau Concepteur.

• NomFichier : voir NomFichier dans le panneau Concepteur.

• Cible : l'élément cible. L'élément cible doit être défini. Avant d'indiquer à l'écran, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l’élément qui a été indiqué s’affichent.

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

• Saved file path - The full path to the file where to save the screenshot, including the appended suffix, if applicable. This also dictates where the Auto increment property saves the indexed screenshot files.

• Image enregistrée : la capture d'écran enregistrée en tant qu'image; utilisé lorsque « Output » est défini sur image.