Prendre une capture d'écran (Take Screenshot)

UiPath.UIAutomationNext.Activities.NTakeScreenshot

Description

Prend une capture d'écran d'un élément d'interface utilisateur ou d'une application spécifié 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é Utiliser l'application/le navigateur (Use Application/Browser).

Si elle est ajoutée dans une activité Utiliser l’application/le navigateur (Use Application/Browser ), seule l’application ciblée est capturée. S'il est ajouté en dehors d'une carte d'application, puisqu'il n'y a pas de cible spécifiée, l'ensemble du bureau est capturé.

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

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Windows - Héritage, configuration Windows

Module Designer

• Cliquez sur Indiquer dans l'application/le navigateur (Indicate in App/Browser) 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.

• Sortie vers (Output to ) : utilisez les boutons radio pour choisir le type de sortie :

  • Fichier (File) : enregistre la capture d'écran dans un fichier à un emplacement spécifié. L’option par défaut.
  • Image - Enregistre la capture d'écran dans l'image indiquée.
  • Presse-papiers (Presse-papiers ) - Enregistre la capture d'écran en tant qu'image dans le presse-papiers pour une utilisation ultérieure.
• Nom dufichier (File Name ) - Nom du fichier dans lequel la capture d'écran de l'élément d'IU spécifié est enregistrée. Cliquez sur Rechercher un fichier ( Browse for File), puis naviguez jusqu'au dossier où enregistrer la capture d'écran et spécifiez le nom et l'extension du fichier à utiliser.

• Incrémentation automatique (Auto increment ) - Sélectionnez ce qu'il faut ajouter au nom de fichier lors de l'enregistrement de la capture d'écran en cas de conflit de noms de fichiers. Par exemple, si un fichier portant le même nom que celui que vous enregistrez existe déjà, choisir Index conserve le nom du fichier, créant un nouveau fichier pour chaque capture d'écran et ajoutant un numéro d'index à chacune, consécutivement.

  • Aucun (écrasement) : si un fichier portant le même nom existe déjà, remplacez-le.
  • Index (Index) : ajoutez un numéro au nom du fichier, par exemple screenshot (1).png.
  • AAAA.MM.JJ à HH.MM.SS : ajoutez la date et l'heure de la capture d'écran au nom de fichier, par exemple screenshot 2020.06.22 at 10:22:32.

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.

Entrée

• Incrémentation automatique - Voir Incrémentation automatique dans le panneau Concepteur.
• Nom dufichier : voir Nom du fichier dans le panneau Concepteur.
• Cible (Target) - L'élément cible. L’élément cible doit être défini. Avant d'être indiqué à 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é sont affichées.
  • 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.

  • 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/de sortie

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

Divers

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

Sortie

• Chemin dufichier enregistré (Saved file path ) - Chemin d'accès complet au fichier dans lequel enregistrer la capture d'écran, y compris le suffixe ajouté, le cas échéant. Cela détermine également l'emplacement où la propriété Incrémentation automatique ( Auto increment ) enregistre les fichiers de capture d'écran indexés.
• Image enregistrée : la capture d'écran enregistrée en tant que Image; utilisé lorsque la sortie est définie sur image.

Configuration multiplateforme

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

• Conteneur de captures d'écran : choisissez entre Page entière et Élément pour prendre une capture d'écran de la page entière ou d'un seul élément. L'option par défaut est Page entière ( Entire page).

Options supplémentaires

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.

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

Options

• Nom de fichier (File name ) : le nom du fichier dans lequel la capture d'écran de l'élément d'IU spécifié est enregistrée.
• Incrément automatique : définit ce qu'il faut ajouter au nom de fichier en cas de conflits de noms de fichiers. Choisissez une option dans le menu déroulant :
  • YYYY.MM.DD à HH.MM.SS : si un fichier portant 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 portant 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 Index, résultant en un fichier appelé Filename YYYY.MM.DD at HH.MM.SS (1).
  • Index : si un ou plusieurs fichiers correspondant au modèle Filename (XX) existent déjà, un fichier est créé avec le nom Filename (N+1), où N est l’index maximal des fichiers existants.
  • Aucun (écraser) - Le nom de fichier sera exactement tel que spécifié, et dans le cas où un autre fichier portant le même nom existe déjà, il sera écrasé. Il s'agit de l'option par défaut.

Entrée/sortie

• Capture d'écran du fichier : la capture d'écran enregistrée en tant que fichier .png .
• É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.