Realizar captura

UiPath.UIAutomationNext.Activities.NTakeScreenshot

Descripción

Realiza una captura de pantalla de un elemento de IU, una aplicación o un escritorio completo especificados y la guarda como un archivo de imagen.

Esta actividad puede utilizarse tanto dentro como fuera de una actividad Usar aplicación/navegador .

Si se añade dentro de una actividad Usar aplicación/navegador , solo se captura la aplicación de destino. Si se añade fuera de una tarjeta de aplicación y no se ha especificado ningún destino, se captura todo el escritorio.

Nota:

A partir de UIAutomation v25.10.32, se añadió una opción de Escritorio dedicada al menú desplegable del contenedor Captura de pantalla , que permite la captura de pantalla completa incluso cuando la actividad se utiliza dentro de una Tarjeta de aplicación.

Esta actividad es compatible con el repositorio de objetos.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Configuración de Windows y multiplataforma

• Trabajo en ámbito : selecciona la pestaña del navegador o la ventana de la aplicación que aloja la aplicación para automatizar, cuando la actividad se coloca dentro de las actividades anidadas de Usar aplicación/navegador .

• Contenedor de capturas de pantalla : especifica el ámbito de la IU para la captura de pantalla. Selecciona una de las siguientes opciones:

  • Ventana principal : captura una captura de pantalla de la ventana activa principal de la aplicación adjunta.
  • Elemento : captura una captura de pantalla del elemento indicado.
  • Escritorio : captura una captura de pantalla de todo el escritorio.

  El valor predeterminado es Ventana principal.

• Indicar destino en pantalla : indica el elemento de IU que se utilizará como destino. Este botón solo está disponible cuando se selecciona la opción Elemento como contenedor de Captura de pantalla. Después de indicar el destino, haz clic en el menú de hamburguesa junto a la captura de pantalla informativa para acceder a las siguientes opciones:

  • Indicar destino : vuelve a indicar el destino. Si el Descriptor está definido en el Repositorio de objetos, primero debes desvincularlo del Repositorio de objetos si quieres especificar un Descriptor solo para la actividad actual.
  • Editar destino : abre el modo de selección para configurar el destino.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Cambiar captura de pantalla informativa : cambia la captura de pantalla de la aplicación o página web de destino.
  • Añadir al repositorio de objetos : añade el elemento de IU actual al repositorio de objetos, desde donde se puede reutilizar a lo largo de tu proceso de automatización. Esta opción solo se muestra cuando el objeto aún no se ha añadido al Repositorio de objetos.
  • Mostrar en el repositorio de objetos : abre el panel Repositorio de objetos con el Descriptor seleccionado. Esta opción solo se muestra cuando el objeto se ha añadido al Repositorio de objetos.
  • Desvincular del repositorio de objetos : desvincula el descriptor del repositorio de objetos. Esta opción solo se muestra cuando el objeto se ha añadido al Repositorio de objetos.

• Salida a (solo disponible para proyectos de Windows): utiliza los botones de radio para elegir el tipo de salida:

  • Archivo : guarda la captura de pantalla en un archivo en una ubicación especificada. La opción predeterminada.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.

• Nombre del archivo : el nombre del archivo donde se guarda la captura de pantalla del elemento de la IU especificado. Esta propiedad solo está disponible cuando la opción Archivo está seleccionada como Salida a.

• Incremento automático : define qué anexar al nombre de archivo en caso de conflictos de nombre de archivo. Esta propiedad solo está disponible cuando la opción Archivo está seleccionada como Salida a. Elige una opción del menú desplegable:

  • Ninguno (sobrescribir) : el nombre del archivo será exactamente el especificado y, en caso de que ya exista otro archivo con el mismo nombre, se sobrescribirá. Esta es la opción predeterminada.
  • Índice : si ya existen uno o varios archivos que coinciden con el patrón Filename (XX) , se crea un nuevo archivo con el nombre Filename (N+1), donde N es el índice máximo de los archivos existentes.
  • AAAA.MM.DD a las HH.MM.SS : si ya existe un archivo con el nombre especificado, se crea un nuevo archivo con el nombre Filename YYYY.MM.DD at HH.MM.SS. Si ya existe un archivo con el nombre de archivo Filename YYYY.MM.DD at HH.MM.SS , y se añade el índice, similar al caso del Índice, resultando en un archivo llamado Filename YYYY.MM.DD at HH.MM.SS (1).

Panel de propiedades

Destino

Esta sección solo está disponible cuando se selecciona la opción Elemento como contenedor de Captura de pantalla.

• Botón Expandir propiedades de destino/Contraer propiedades de destino : muestra/oculta el contenedor de destino y sus propiedades de anclaje.

• Métodos de orientación : los tipos de selector que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación, y se debe seleccionar al menos un método de orientación:

  • Selector estricto

  • Selector difuso

  • Imagen (solo disponible para proyectos de Windows)

  • Texto nativo (solo disponible para proyectos de Windows)

  • Computer Vision

  • Selector semántico

    Nota:

    Para utilizar Computer Vision como método de orientación, debes ir a Configuración del proyecto > Computer Vision y asegurarte de establecer el punto final del servidor correcto. Puedes dejar este campo tal como está y utilizar UiPath Cloud, que se rellena de forma predeterminada, o puedes introducir otro valor seleccionando cualquiera de los otros puntos finales públicos específicos de una región del servidor o tu propio servidor local.

    Otra forma de utilizar Computer Vision como método de orientación es establecer Usar servidor local en Verdadero. Esto implica que el paquete UiPath.ComputerVision.LocalServer está instalado en tu proyecto. Cuando el servidor local está habilitado, el valor del servidor se sobrescribe. Sin embargo, el servidor local no está disponible en proyectos multiplataforma.

• Selector de ventana (instancia de la aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo aplicable cuando el modo de adjuntar ventana se establece en Instancia de aplicación.

• Selector estricto : el selector estricto generado para el elemento de IU. Solo se muestra si se ha seleccionado el método de orientación Selector estricto .

• Selector difuso : los parámetros para el selector difuso. Solo se muestra si se ha seleccionado el método de orientación del selector difuso .

• Imagen : estas propiedades solo están disponibles cuando se selecciona el método de orientación de imagen .

  • Precisión de la imagen : especifica el umbral de confianza utilizado para la coincidencia de imágenes. El valor predeterminado es 0,8.
  • Ocurrencia de imagen : especifica qué coincidencia utilizar cuando se encuentran varias imágenes coincidentes.

• Nativo : estas propiedades solo están disponibles cuando se selecciona el método de destino Nativo .

  • Texto nativo : especifica el texto utilizado para identificar el elemento de IU.
  • Ocurrencia de texto nativo : especifica qué ocurrencia utilizar cuando se encuentran varias coincidencias.
  • Texto nativo que distingue entre mayúsculas y minúsculas : especifica si la coincidencia de texto distingue entre mayúsculas y minúsculas.

• Computer Vision : estas propiedades solo están disponibles cuando se selecciona el método de selección de Computer Vision .

  • Tipo de control CV : especifica el tipo de control identificado mediante Computer Vision.
  • Texto de CV : especifica el texto identificado mediante Computer Vision.
  • Precisión del texto CV : especifica el umbral de confianza utilizado para la coincidencia de texto OCR. El valor predeterminado es 0,7.
  • Ocurrencia de texto CV : especifica qué ocurrencia utilizar cuando se encuentran varias coincidencias.

• Selector semántico : una descripción semántica que define el destino. Esta propiedad solo está disponible cuando se ha seleccionado el método de orientación semántica .

  Los modelos lingüísticos de gran tamaño (LLM) se utilizan para generar descripciones funcionales predeterminadas y legibles por humanos de los elementos de la interfaz de usuario. Estas descripciones son muy resilientes a los cambios de la IU y ayudan a mejorar la fiabilidad de la automatización cuando los selectores tradicionales son insuficientes o fallan.

• Esperar a que se cargue la página : antes de realizar la acción, espera a que la aplicación esté lista para aceptar la entrada. Puedes elegir una de las tres opciones del menú desplegable:

  • Ninguno: No espera a que el objetivo esté listo.
  • Interactivo: espera hasta que se cargue solo una parte de la aplicación.
  • Completo: espera a que se cargue la aplicación completa.

• Comprobación de visibilidad : comprueba si el elemento de la IU es visible o no. Puedes elegir una de las tres opciones del menú desplegable:

  • Ninguno : no comprueba la visibilidad.
  • Interactivo (para Selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de la página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando se intenta garantizar que no se está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
  • Totalmente visible : comprueba si el elemento de la IU es visible o no.

• Sitios web adaptables : habilita el diseño de sitios web adaptables.

• Destino - Región de recorte : especifica una región de recorte, que puede configurarse aún más. Se puede utilizar para establecer una región más pequeña/grande del elemento de IU encontrado en tiempo de ejecución utilizando el Selector de destino o proporcionarse directamente a través de la propiedad Elemento de entrada de destino.

  • Punto de anclaje : describe el punto de partida del cursor al que se añaden las propiedades Desplazamiento X y Desplazamiento Y. Las siguientes opciones están disponibles: ArribaIzquierda, ArribaDerecha, AbajoIzquierda, AbajoDerecha y Centro (seleccionado de forma predeterminada).
  • Desplazamiento X : desplazamiento horizontal de la región según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32 .
  • Desplazamiento Y : desplazamiento vertical de la región según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32 .
  • Ancho de desplazamiento : ancho de la región de desplazamiento.
  • Altura de desplazamiento : altura de la región de desplazamiento.

Destino - Anclaje (n)

• Métodos de orientación : los tipos de selector que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación, y se debe seleccionar al menos un método de orientación:
  • Selector estricto
  • Selector difuso
  • Imagen (solo disponible para proyectos de Windows)
  • Texto nativo (solo disponible para proyectos de Windows)
  • Computer Vision
• Selector estricto : el selector estricto generado para el elemento de IU. Solo se muestra si se ha seleccionado el método de orientación Selector estricto .
• Selector difuso : los parámetros para el selector difuso. Solo se muestra si se ha seleccionado el método de orientación del selector difuso .
• Imagen : estas propiedades solo están disponibles cuando se selecciona el método de orientación de imagen .
  • Precisión de la imagen : especifica el umbral de confianza utilizado para la coincidencia de imágenes. El valor predeterminado es 0,8.
  • Ocurrencia de imagen : especifica qué coincidencia utilizar cuando se encuentran varias imágenes coincidentes.
• Nativo : estas propiedades solo están disponibles cuando se selecciona el método de destino Nativo .
  • Texto nativo : especifica el texto utilizado para identificar el elemento de IU.
  • Ocurrencia de texto nativo : especifica qué ocurrencia utilizar cuando se encuentran varias coincidencias.
  • Texto nativo que distingue entre mayúsculas y minúsculas : especifica si la coincidencia de texto distingue entre mayúsculas y minúsculas.
• Computer Vision : estas propiedades solo están disponibles cuando se selecciona el método de selección de Computer Vision .
  • Tipo de control CV : especifica el tipo de control identificado mediante Computer Vision.
  • Texto de CV : especifica el texto identificado mediante Computer Vision.
  • Precisión del texto CV : especifica el umbral de confianza utilizado para la coincidencia de texto OCR. El valor predeterminado es 0,7.
  • Ocurrencia de texto CV : especifica qué ocurrencia utilizar cuando se encuentran varias coincidencias.

Opciones

• Modo Healing Agent : configura el comportamiento del Healing Agent para esta actividad, en función de la configuración de Gobernanza u Orchestrator en el nivel de proceso o trabajo.

  • Igual que la aplicación/navegador : hereda la configuración de la actividad principal Usar aplicación/navegador .
  • Heredar la configuración del trabajo : aplica la configuración definida en Gobernanza o en Orchestrator en el nivel de proceso o trabajo.
  • Deshabilitado : desactiva Healing Agent para esta actividad.
  • Solo recomendación : permite que Healing Agent proporcione recomendaciones sobre cómo solucionar problemas de automatización de IU en trabajos en ejecución, pero solo si lo permite la configuración de Gobernanza u Orchestrator.

• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Plazos

• 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.
• Tiempo de espera : especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

Entrada/Salida

• Archivo de captura de pantalla : la captura de pantalla guardada como archivo .png .
• Elemento de salida : genera un elemento de IU de destino y lo almacena en un objeto ElementoDeIU , que puede utilizarse posteriormente para apuntar al mismo elemento con otras actividades.
• Elemento de entrada : el elemento de la IU en el que se ejecuta la actividad, almacenado en un objeto ElementoDeIU . Este campo solo admite objetos ElementoDeIU . Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de Automatización de IU.

Windows - Configuración heredada

• Selecciona Indicar en aplicación/navegador para indicar el elemento de IU que se utilizará como destino.

After you indicate the target, select the Menu button to access the following options:

• Indicate target on screen - Indicate the target again.

• Editar destino : abre el modo de selección para configurar el destino.

• Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.

• Salida a : utiliza los botones de radio para elegir el tipo de salida:
  • Archivo : guarda la captura de pantalla en un archivo en una ubicación especificada. La opción predeterminada.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.
• Nombre del archivo : el nombre del archivo donde se guarda la captura de pantalla del elemento de la IU especificado. Haz clic en Buscar archivo y, a continuación, busca la carpeta donde guardar la captura de pantalla y especifica el nombre de archivo y la extensión a utilizar.
• 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.

Panel de propiedades

Común

• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

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

• Nombre para mostrar : el nombre que se muestra para la actividad en el panel Diseñador. Al indicar un destino, se genera automáticamente un nombre para mostrar.

• Tiempo de espera : especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

• Incremento automático : consulta Incremento automático en el panel Diseñador.

• Nombre de archivo : consulta Nombre de archivo en el panel Diseñador.

• Destino : el elemento de destino. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo está establecido en (null). Una vez indicado el destino, se muestran todas las propiedades relativas al elemento indicado.

  • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
  • Texto de CV : indica el texto identificado mediante Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texto nativo : el texto que se utiliza para identificar el elemento de IU.
  • Sitios web adaptables : habilita el diseño de sitios web adaptables.
  • Selector estricto : el selector estricto generado para el elemento de IU.
  • Métodos de orientación : los tipos de selector que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación desde el menú desplegable:
    • Ninguno
    • Selector estricto
    • Selector difuso
    • Imagen
    • Texto nativo
    • Computer Vision : para utilizar Computer Vision como método de orientación, debes ir a Configuración del proyecto > Computer Vision y asegurarte de establecer el punto final del servidor correcto. Puedes dejar este campo como está y utilizar UiPath Cloud, que se rellena de forma predeterminada, o puedes introducir otro valor seleccionando cualquiera de los otros puntos finales públicos específicos de una región del servidor o tu propio servidor local. Otra forma de utilizar Computer Vision como método de orientación es establecer Usar servidor local en Verdadero. Esto implica que el paquete UiPath.ComputerVision.LocalServer está instalado en tu proyecto. Cuando el servidor local está habilitado, el valor del servidor se sobrescribe. Sin embargo, el servidor local no está disponible en proyectos multiplataforma.
    • Selector semántico : aprovecha los modelos lingüísticos de gran tamaño (LLM) para generar descripciones funcionales y similares a las humanas de los elementos de la interfaz de usuario. Estas descripciones son muy fiables, lo que las hace adaptables a los cambios de la interfaz de usuario y mejora significativamente la resistencia de la automatización cuando fallan los selectores tradicionales.
  • Comprobación de visibilidad : comprueba si el elemento de la IU es visible o no. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno : no comprueba la visibilidad.
    • Interactivo (para Selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de la página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando se intenta garantizar que no se está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
    • Totalmente visible
      • Comprueba si el elemento de la IU es visible o no.
  • Esperar a que se cargue la página : antes de realizar la acción, espera a que la aplicación esté lista para aceptar la entrada. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno: No espera a que el objetivo esté listo.
    • Interactivo: espera hasta que se cargue solo una parte de la aplicación.
    • Completo: espera a que se cargue la aplicación completa.
  • Selector de ventana (instancia de la aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo aplicable cuando el modo de adjuntar ventana se establece en Instancia de aplicación.

• Elemento de entrada : el elemento de la IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite objetos UIElement . Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de Automatización de IU.

• Elemento de salida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede utilizarse posteriormente para apuntar al mismo elemento con otras actividades.

• Privado : si se selecciona, los valores de las variables y los argumentos ya no se registran en el nivel Detallado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

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

• Imagen guardada : la captura de pantalla guardada como Imagen; se utiliza cuando la Salida se establece en image.