Utilizar Aplicación/Navegador

UiPath.UIAutomationNext.Activities.NApplicationCard

Descripción

Abre una aplicación de escritorio o una página del navegador web para usar en la automatización de IU.

Después de arrastrar y soltar la actividad en el flujo de trabajo e indicar la aplicación o página web que se va a usar, añade las actividades que se deben realizar dentro de la actividad Usar aplicación / navegador . Si la aplicación aún no está abierta, se abre cuando se ejecuta el proyecto.

Esta actividad es compatible con el repositorio de objetos.

Para aprender a utilizar esta actividad, consulta el Tutorial: trabajar con la automatización de la interfaz de usuario.

Nota:

• A partir de UI Automation v20.10.x, se pueden anidar entre sí múltiples actividades de Uso de aplicación / navegador . Esto le permite automatizar varias aplicaciones simultáneamente.
• A partir de la versión 21.10.3de UI Automation, la actividad Usar aplicación / navegador puede abrir aplicaciones en entornos remotos.
• A partir de la versión 22.10.1de Automatización de IU, la actividad también puede abrir navegadores en entornos remotos.

Compatibilidad de proyectos

Windows: heredado | Windows | Multiplataforma

Windows (heredado), configuración de Windows

Panel del Diseñador

• Haga clic en Indicar aplicación para identificar la aplicación moviendo el ratón a su ventana y haciendo clic en ella. Si el destino es una página web del navegador, navegue hasta la página antes de indicar la aplicación.
• Después de indicar el destino, gestiona el destino haciendo clic en Menú y seleccionando las siguientes opciones:
  • Indicar destino en pantalla : vuelve a indicar la aplicación.
  • Destino destacado : ve la aplicación indicada en la pantalla rodeada en un cuadro.
  • Mostrar captura de pantalla informativa : muestra una captura de pantalla de la aplicación o página web de destino.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Motor de OCR : selecciona una de estas dos opciones.
    • Motor de OCR integrado : utiliza el motor de OCR integrado en el modelo de IA de Computer Vision, concretamente UiPath Screen OCR.
    • Motor de OCR personalizado : usa un motor de OCR personalizado. Cuando se selecciona esta opción, se agrega un panel en la tarjeta de actividad donde puede colocar una actividad del motor de OCR diferente a la de UiPath Screen OCR.
  • Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde pueda reutilizarse en todo el proceso de automatización.

• Puedes iniciar una nueva instancia de la aplicación o una nueva sesión del navegador, conservando la configuración actual, utilizando el botón junto al campo Ruta de la aplicación (en caso de una aplicación) o URL del explorador (en caso de un navegador). Al abrir un Explorador a través de este botón, se aplican todas las configuraciones realizadas en la sección Opciones: Navegador, lo que permite probar el comportamiento de la actividad en tiempo de diseño, mitigando posibles fallos en tiempo de ejecución.

• Configure los ajustes de inicio de la aplicación:
  • Si la aplicación es un navegador web, puedes hacer clic en Más a la derecha del campo URL del navegador y, a continuación, utiliza una de las opciones del menú para editar la URL de la página web que deseas abrir.
  • Si la aplicación no es un explorador web, puedes:
    • Especifica los parámetros que se van a pasar a la aplicación de destino en el inicio desde el campo Argumentos de la aplicación . Por ejemplo, si la aplicación de destino es Acrobat Reader, puedes abrir un archivo PDF específico proporcionando la ruta completa al archivo. Para abrir el archivo C:\Sample.pdf, haz clic en Más > Texto y, a continuación, introduce C:\Sample.pdf en el Generador de texto. Ciertos tipos de aplicaciones se identifican automáticamente y rellenan automáticamente la propiedad Argumentos, como las aplicaciones Java, las aplicaciones de Office Suite, Adobe Acrobat o el Explorador de archivos de Windows.
    • Haga clic en Más a la derecha del campo Ruta de la aplicación y, a continuación, utiliza una de las opciones del menú para editar la ruta completa del archivo ejecutable que se va a abrir. Para las aplicaciones instaladas en modo de usuario, la automatización no guarda la ruta real que incluye el nombre de usuario, se utiliza una ruta relativa y se muestra en el campo como User Folder.
      Nota: cuando la ruta definida en el campo Ruta de la aplicación es dinámica, hacer clic en Indicar destino en pantalla en las actividades secundarias genera un error si la aplicación de destino no está abierta.
    • Marca o desmarca la casilla de verificación Coincidir con título exactitud. Esta opción solo aparece cuando indicas toda la ventana de una aplicación y no solo un elemento dentro de la aplicación. Además, esta opción no aparece al indicar un navegador web. Cuando está marcada, solo se utilizan en la automatización las aplicaciones que coinciden exactamente con el título de la aplicación actual. Si no se marca (predeterminado), en la automatización se utiliza la ventana con el título más parecido.

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á en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

• Nombre paramostrar : el nombre que se muestra para la actividad en el panel Diseñador. Se genera automáticamente un nombre para mostrar cuando indica un destino.

  Importante:

  El nombre para mostrar de la actividad Usar aplicación / navegador también se usa como referencia que apunta a la aplicación o el navegador objetivo. Después de indicar el destino, a menos que se establezca manualmente, el nombre para mostrar se cambia automáticamente al siguiente formato:

  • Para aplicaciones: Use Application: [title] - [app name]
  • Para navegadores: Use Browser [browser type] : [title]

  En el caso de las tarjetas de aplicación anidadas, cada actividad dentro de una tarjeta muestra un menú desplegable en su cuerpo que te permite elegir la tarjeta de aplicación con la que deseas utilizarla.

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

  Nota: cuando se indica una ventana en un entorno de escritorio remoto, el tiempo de espera predeterminado se establece en 60 segundos.

Entrada

• Aplicación de destino unificada : expande esta categoría para configurar los siguientes ajustes:

  • Argumentos : si la aplicación no es un navegador web, puedes especificar parámetros para pasar a la aplicación de destino al inicio. Puede usar esta propiedad para abrir un archivo específico con la aplicación. Por ejemplo, si la aplicación de destino es Acrobat Reader, puede abrir un libro específico proporcionando la ruta completa del archivo. Para abrir el archivo C: \ Muestra.pdf, introduzca "C:\Sample.pdf". Ciertos tipos de aplicaciones se identifican automáticamente y completan automáticamente la propiedad Argumentos, como las aplicaciones Java, las aplicaciones de Office Suite, Adobe Acrobat o el Explorador de archivos de Windows.

  • Ruta delarchivo : si la aplicación no es un navegador web, especifica la ruta completa del archivo ejecutable que se va a abrir. Si se especifica una ruta de archivo, se borra la propiedad de la URL .

    Nota: Cuando la ruta definida en el campo Ruta de archivo es dinámica, al hacer clic en Indicar destino en una pantalla en actividades secundarias se genera un error si la aplicación de destino aún no está abierta.
• Selector : un fragmento XML que almacena los atributos de un elemento de la interfaz de usuario.
• URL : si la aplicación es un navegador web, especifica la URL de la página web que se va a abrir. Si se especifica una URL, se borra la propiedad Ruta del archivo .

Elemento de entrada/salida

• Elemento de entrada : el elemento de destino que quieres utilizar con esta aplicación, almacenado en un objeto UIElement . Este objeto se puede recuperar de la propiedad Elemento de salida de otra actividad de automatización de IU. Puedes utilizar este campo de propiedad para pasar el elemento de destino de una actividad anterior a esta sin tener que volver a indicarlo. Este campo solo admite variables UIElement .
• Elemento de salida : genera el elemento de destino indicado en esta actividad en una variable UIElement que luego puede reutilizarse en otras actividades. Este campo solo admite variables UIElement .

Otros

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

Opciones

• Cerrar : selecciona cuándo cerrar la aplicación de destino después de que la automatización ejecute todas las actividades añadidas dentro de esta actividad:
  • Nunca : nunca cierre la aplicación.
  • Navegador IfOpenedByApp : se cierra solo si la aplicación fue abierta por la automatización. Este es el valor predeterminado.
  • Siempre : cierra la aplicación cada vez.

• Modo de entrada : selecciona qué método debe utilizar el robot para interactuar con la aplicación de destino:

  • Eventos de hardware : utiliza el controlador de hardware para realizar la acción. Este es el método más lento, no funciona en segundo plano, pero es compatible con todas las aplicaciones de escritorio.

  • Simular : simula mediante API de accesibilidad. Recomendado para navegadores, aplicaciones basadas en Java, SAP. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.

  • API de Chromium : realiza acciones utilizando las API del depurador. Solo funciona para elementos de Chromium. Envía todo el texto de una vez. Funciona incluso si la aplicación de destino no está enfocada. Para obtener más información, consulta esta página.

  • Mensajes de ventana : simula usando mensajes Win32. Recomendado para aplicaciones de escritorio. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.

  • En segundo plano : ejecuta acciones en segundo plano. Intenta utilizar la API de Simulación o Chromium siempre que sea posible, mientras que las actividades complejas (imagen, texto nativo) se ejecutan como de costumbre, en primer plano. Se recomienda encarecidamente utilizar este método con la característica Verificar ejecución .

    Nota: no se admite el modo de entrada en segundo plano con aplicaciones de la Plataforma universal de Windows, lo que significa que las aplicaciones de este tipo no se pueden automatizar en segundo plano.
• Abrir : selecciona cuándo abrir la aplicación de destino para la ejecución de la automatización:
  • Nunca : nunca abra la aplicación.
  • IfNotOpen : abrir solo si la aplicación está cerrada. Este es el valor predeterminado. Solo funciona si se rellenan los campos Ruta del archivo o URL .
  • Siempre : abre otra instancia de la aplicación aunque una ya esté abierta. Solo funciona si se rellenan los campos Ruta del archivo o URL .

• Cambiar tamaño de la ventana : define si la aplicación / navegador cambia de tamaño cuando se inicializa.

  • Ninguno: no se aplica ningún cambio de tamaño a la aplicación/navegador.
  • Maximizar: la aplicación/navegador se maximiza cuando al inicializarse.
  • Restaurar al tamaño actual : la aplicación / navegador se redimensiona y se mueve a la posición y el tamaño que tenía cuando se indica, si es posible.
  • Minimizar: la aplicación/navegador se minimiza cuando se inicializa.
• Modo de agregación de ventana : define dónde buscan las actividades internas sus elementos de destino.
  • Instancia de aplicación: las actividades internas buscan la instancia de aplicación indicada, incluidas todas las ventanas principales y secundarias (alertas, ventanas emergentes, etc.). Se excluyen otras instancias de la aplicación.
  • Ventana única : las actividades internas buscan solo en la ventana indicada.

Opciones: navegador

• Ventana de incógnito / privada : si se selecciona, se abre la nueva sesión del navegador en modo de incógnito / privado. De forma predeterminada, esta casilla de verificación está desactivada.

• Modo de carpeta de datos del usuario: el modo de carpeta de datos del usuario que quieres establecer. Se utiliza para iniciar el navegador con una carpeta de datos de usuario específica.

  • Automático: desencadena automáticamente el modo Picture-in-Picture (PiP) con una carpeta de datos de usuario independiente de la predeterminada. Si la ruta de carpeta de datos del usuario no está establecida, se genera automáticamente una carpeta. Esto puede ser útil cuando buscas aislamiento del navegador durante las tareas de automatización y mantener los datos separados de la sesión de navegación principal.
  • Carpeta predeterminada: utiliza la carpeta por defecto del navegador, independientemente de si se ejecuta en la sesión de navegación principal o en una sesión PiP. Esta opción es útil si quieres que el robot utilice la carpeta de datos de usuario existente y no necesitas una sesión independiente o aislada para las tareas de automatización.
  • Personalizar: utiliza la carpeta especificada en Ruta de carpeta de datos del usuario. Si la ruta de carpeta de datos del usuario no está establecida, se utiliza una ruta generada automáticamente. Esta opción te ofrece más flexibilidad y control para gestionar tus carpetas para diferentes tareas de automatización estableciendo una ruta personalizada para la carpeta de datos de usuario.

  La configuración de la carpeta de datos de usuario del navegador solo está disponible en Chrome, Edge Chromium y Firefox.

• Ruta de la carpeta de datos del usuario : la carpeta de datos del usuario que utiliza el navegador. El valor predeterminado es %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si no está configurado.

  Puedes encontrar más detalles sobre ModoDeCarpetaDeDatosDelUsuario y RutaDeLaCarpetaDeDatosDelUsuario aquí.

• Modo WebDriver: indica cómo se utiliza WebDriver al abrir una sesión nueva del navegador. Las siguientes opciones están disponibles:

  • Deshabilitado : deshabilita el uso de WebDriver.
  • WithGUI : se muestra la GUI del navegador.
  • Sin interfaz: el navegador se inicia de forma silenciosa, sin GUI.

  Puedes encontrar más detalles sobre WebDriver aquí.

Configuración multiplataforma

El nombre de la actividad en proyectos multiplataforma es Usar navegador y solo se puede utilizar para automatizar navegadores web.

• Trabajar en el ámbito : elija la pestaña del navegador que representa la aplicación web que se va a automatizar.
• URL : la URL de la aplicación web. El valor se completa automáticamente después de elegir la pestaña.
• ¿Requiere autenticación? - Autenticación multifactor habilitada. Para obtener más información, consulta la página Conexión del navegador de automatización de IU .

Opciones adicionales

Plazos

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

• 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á en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Opciones

• Abrir : define si se debe abrir la aplicación de destino antes de ejecutar las actividades en ella.
  • Siempre : abre la ventana del navegador cada vez.
  • Si no está abierto : abre una nueva ventana del navegador si ninguna coincide con el selector y la URL. Este es el valor predeterminado.
  • Nunca : nunca abra la ventana del navegador.
• Cerrar : define si se debe cerrar la aplicación de destino antes de ejecutar las actividades en ella.
  • Siempre : cierra la ventana del navegador cada vez.
  • Si se abre con Usar navegador : se cierra solo si la ventana del navegador se abrió con la actividad Usar navegador . Este es el valor predeterminado.
  • Nunca : nunca cierre la ventana del navegador.
• Modo de entrada : el método utilizado para generar la entrada de teclado o de ratón.
  • API Chromium: realiza acciones mediante las API de depuración. Solo funciona para elementos de Chromium. Envía todo el texto de una vez. Funciona incluso si la aplicación de destino no está enfocada.
  • Simular : simula las Actions mediante las API de accesibilidad. Funciona para navegadores. Envía todo el texto en una sola Actions. Funciona en segundo plano (incluso si la aplicación de destino no está enfocada).
• Ventana de incógnito / privada : si se selecciona, abre la nueva sesión del navegador en modo de incógnito / privado. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso.

• Modo de carpeta de datos de usuario : el modo de carpeta de datos de usuario que quieres establecer. Se utiliza para iniciar el navegador con una carpeta de datos de usuario específica.

  • Automático: desencadena automáticamente el modo Picture-in-Picture (PiP) con una carpeta de datos de usuario independiente de la predeterminada. Si la ruta de carpeta de datos del usuario no está establecida, se genera automáticamente una carpeta. Esto puede ser útil cuando buscas aislamiento del navegador durante las tareas de automatización y mantener los datos separados de la sesión de navegación principal.
  • Carpeta predeterminada: utiliza la carpeta por defecto del navegador, independientemente de si se ejecuta en la sesión de navegación principal o en una sesión PiP. Esta opción es útil si quieres que el robot utilice la carpeta de datos de usuario existente y no necesitas una sesión independiente o aislada para las tareas de automatización.
  • Carpeta personalizada: utiliza la carpeta especificada en Ruta de carpeta de datos del usuario. Si la ruta de carpeta de datos del usuario no está establecida, se utiliza una ruta generada automáticamente. Esta opción te ofrece más flexibilidad y control para gestionar tus carpetas para diferentes tareas de automatización estableciendo una ruta personalizada para la carpeta de datos de usuario.

  La configuración de la carpeta de datos de usuario del navegador solo está disponible en Chrome, Edge Chromium y Firefox.

• Ruta de la carpeta de datos del usuario : la carpeta de datos del usuario que utiliza el navegador. El valor predeterminado es %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si no está configurado.

Destino

• Selector : lista de atributos utilizados para buscar una ventana del navegador determinada.

Entrada/Salida

• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.