Obtener texto

UiPath.UIAutomationNext.Activities.NGetText

Descripción

Extrae y copia el texto de un elemento de la interfaz de usuario.

Esta actividad debe añadirse dentro de una actividad Usar aplicación/navegador.

Para utilizar esta actividad fuera de una actividad Usar aplicación/navegador , debes proporcionar un Elemento de entrada.

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 : elige la pestaña del navegador que representa la aplicación web para automatizar.
• Indicar objetivo en pantalla
  • Indique el elemento de la IU que se utilizará como destino. Después de indicar el destino, selecciona el botón más para acceder a las siguientes opciones:
  • Indicate target on screen - Indicate the target again.
  • Editar destino : abre el modo de selección para configurar el destino.

Panel de propiedades

Entrada/Salida

• Valor de texto : te permite almacenar el texto del elemento de la IU especificado en una variable. Las variables creadas en este campo son del tipo 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.
• 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.

Opciones

• Método de extracción : describe el método de extracción que quieres utilizar. Las siguientes opciones están disponibles:
  • Predeterminado : pasa por los posibles métodos de extracción (atributo de texto, Texto completo, en ese orden) y se detiene en el primer método que devuelve datos. La única razón para cambiar el método predeterminado es si devuelve un texto, pero no el correcto. Si el método predeterminado no devuelve nada, lo mismo se aplica a los otros métodos de extracción.
  • Atributo de texto : extrae el valor del atributo de texto para el elemento de la IU especificado.
  • Texto completo : extrae el texto completo del elemento de la IU, incluidos sus elementos secundarios. Este método es útil cuando quieres extraer el texto completo de un elemento contenedor que contiene varios elementos secundarios.
  • OCR : extrae el texto utilizando el motor OCR.
• Opciones de extracción:
  • Formato de texto
  • Ignorar el texto oculto
  • Coordenadas de Word
• 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.
  • Deshabilitado : desactiva Healing Agent para esta actividad.
  • Heredar la configuración del trabajo : aplica la configuración definida en Gobernanza o en Orchestrator en el nivel de proceso o trabajo.
  • 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.
  • Igual que la aplicación/navegador : hereda la configuración de la actividad principal Usar aplicación/navegador .
• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleanos (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.

Destino

• Expandir propiedades de destino : muestra las propiedades de destino y anclaje. Esto ocultará las otras propiedades de la actividad y mostrará solo las relacionadas con el destino.

• Contraer propiedades de destino : oculta las propiedades de destino y anclaje. Esto ocultará las propiedades relacionadas con el destino y mostrará las propiedades de la actividad.

• 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 : el selector estricto generado para el elemento de IU de destino.
  • Selector difuso : los parámetros del selector difuso.
  • 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.
    • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
    • Texto de CV : indica el texto identificado mediante Computer Vision.
    • Ocurrencia de texto CV : indica una ocurrencia específica que se utilizará cuando se encuentran varias coincidencias.
    • Precisión del texto CV : indica el nivel de precisión para la coincidencia de texto OCR.
  • 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.
  • Imagen (solo Windows)
    • Precisión de imagen : indica el nivel de precisión para la coincidencia de imágenes.
    • Repetición de imagen : indica una repetición específica que se utilizará cuando se encuentran varias coincidencias.
  • Texto nativo (solo Windows)
    • Texto nativo : el texto que se buscará para identificar el elemento de la IU.
    • Ocurrencia de texto nativo : indica una ocurrencia específica que se utilizará cuando se encuentran varias coincidencias.

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

• 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. Las opciones son:

  • 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 : cuando se habilita, la actividad también 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 - Zona de recorte

• 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. De forma predeterminada, se selecciona Centro .
• Desplazamiento X : desplazamiento horizontal de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32.
• Desplazamiento Y : desplazamiento vertical de la posición del cursor 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.

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.

Windows - Configuración heredada

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

Después de indicar el destino, selecciona el menú para acceder a las siguientes opciones:

• 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.
• Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde puede reutilizarse en todo tu proceso de automatización.
• Vista previa de extracción : abre el asistente Obtener texto - Vista previa de extracción , que te permite ver qué texto se recupera del destino en tiempo real.

• Guardar en : te permite almacenar el texto del elemento de la IU especificado en una variable. Las variables creadas en este campo son del tipo String .

Vista previa de extracción

El asistente Obtener texto - Vista previa de extracción te permite elegir qué método de extracción quieres utilizar y también muestra en tiempo real el texto que se muestra utilizando el método elegido. El texto extraído se muestra en el cuadro de texto Vista previa de la extracción y se puede copiar utilizando el botón Copiar al portapapeles .

Si no se utiliza el asistente, se prueban todos los métodos de extracción de forma predeterminada y se elige automáticamente el mejor. La elección de un método de extracción en la ventana de vista previa de extracción anula este mecanismo y hace que ese método sea el único que se utiliza.

Están disponibles los siguientes métodos:

• Predeterminado
• Atributo de texto
• 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.

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. También puedes elegir un valor predeterminado en el menú desplegable: 10 (s), 20 (s) o 30 (s).

• Predeterminado : pasa por los posibles métodos de extracción (atributo de texto, Texto completo, en ese orden) y se detiene en el primer método que devuelve datos. La única razón para cambiar el método predeterminado es si devuelve un texto, pero no el correcto. Si el método predeterminado no devuelve nada, lo mismo se aplica a los otros métodos de extracción.

• Atributo de texto : extrae el valor del atributo de texto para el elemento de la IU especificado.

• Texto completo : extrae el texto completo del elemento de la IU, incluidos sus elementos secundarios. Este método es útil cuando quieres extraer el texto completo de un elemento contenedor que contiene varios elementos secundarios.

• Nativo : extrae el texto visible para el elemento de la IU especificado.

Nota:

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.

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

• Texto : consulta Guardar en en el panel Diseñador.

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