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.

Nota:

Las URL internas no se pueden abrir utilizando esta actividad cuando el explorador no las acepta directamente como argumentos de línea de comandos. No puedes abrir las páginas internas de Chrome (chrome://) o Edge (edge://). Sin embargo, puedes abrir, las páginas internas de Firefox (about:).

Después de arrastrar y soltar la actividad en el flujo de trabajo e indicar la aplicación o página web a utilizar, añade las actividades a realizar dentro de la actividad Utilizar 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.

Nota:

• A partir de la versión 20.10.x de Automatización de IU, se pueden anidar varias actividades Usar aplicación/navegador entre sí. Esto te permite automatizar varias aplicaciones simultáneamente.
• A partir de la versión 21.10.3 de Automatización de IU, la actividad Usar aplicación/navegador puede abrir aplicaciones en entornos remotos.
• A partir de la versión 22.10.1 de Automatización de IU, la actividad también puede abrir navegadores en entornos remotos.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Configuración de Windows y multiplataforma

• Selecciona Indicar el objetivo en pantalla para identificar la aplicación moviendo el ratón a su ventana y seleccionándola.Si el destino es una página web del navegador, navega a la página antes de indicar la aplicación.
• Después de indicar el destino, gestiona el destino seleccionando el botón de opciones del menú y eligiendo una de las siguientes opciones:
  • Indicar destino en pantalla : vuelve a indicar la aplicación. En caso de que el Descriptor esté definido en el Repositorio de objetos, deberás desvincularlo del Repositorio de objetos si quieres indicar un Descriptor solo para la actividad actual.
  • Mostrar en el repositorio de objetos : abre el panel Repositorio de objetos con el Descriptor seleccionado.
  • Desvincular del repositorio de objetos : desvincula el descriptor del repositorio de objetos.
  • 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.
• Trabajo en ámbito : elige la pestaña del navegador que representa la aplicación web para automatizar. Si indicaste una aplicación Java, aparece en el menú desplegable entre las pestañas del navegador. La opción está oculta cuando solo hay una pestaña disponible.
• Generar : abre la grabadora Autopilot de Automatización de IU, donde puedes generar secuencias de flujo de trabajo de automatización de IU. También puedes seleccionar el icono Generar las actividades de automatización de IU utilizando Autopilot en la esquina superior derecha del cuadro de captura de pantalla informativo. Para obtener más información, consulta la página Grabadora de Autopilot de automatización de IU .
• URL : la URL de la aplicación web. El valor se rellena automáticamente después de elegir la pestaña. También puedes elegir Abrir URL en una nueva pestaña yendo al menú más opciones. Si la URL ya está abierta, puedes enfocarla o abrirla de nuevo en una nueva pestaña.
• ¿Requiere autenticación? : habilita la autenticación multifactor. Para obtener más información, consulta la página Conexión del navegador de automatización de IU .

Panel de propiedades

Gestión de diálogos

• Descartar alertas : habilita el descarte automático de los diálogos de alerta de JavaScript.
• Descartar confirmaciones : habilita el descarte automático de los diálogos de confirmación de JavaScript.
• Confirmar respuesta de diálogo : respuesta a los diálogos de confirmación de JavaScript: Cancelar o Aceptar. Solo está disponible cuando Descartar confirmaciones se establece en Verdadero.
• Descartar solicitudes : habilita el descarte automático de los cuadros de diálogo de solicitud de JavaScript.
• Respuesta de diálogo de solicitud : respuesta a los diálogos de solicitud de JavaScript: Cancelar o Aceptar. Solo está disponible cuando Descartar solicitudes se establece en Verdadero.
• Texto de respuesta de la solicitud : respuesta de texto para los diálogos de solicitud de JavaScript. Solo está disponible cuando Descartar solicitudes se establece en Verdadero.

Entrada/Salida

• 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

• Abrir : define si se abre 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 abres la ventana del navegador.

• Cerrar : define si se cierra 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 : cerrar solo si la ventana del navegador fue abierta por la actividad Usar navegador . Este es el valor predeterminado.
  • Nunca : nunca cerrar la ventana del navegador.

• Modo de entrada : el método utilizado para generar entradas de teclado y ratón.

  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus.
  • Simular : simula la acción utilizando las API de accesibilidad. Funciona para navegadores. Envía todo el texto en una sola acción. Funciona en segundo plano (incluso si la aplicación de destino no está enfocada).

• Ventana de incógnito/privado : 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 : activa automáticamente el modo Imagen en imagen (PiP) con una carpeta de datos de usuario independiente de la predeterminada. Si la Ruta de la carpeta de datos del usuario no está configurada, se generará una carpeta automáticamente. Esto puede ser útil cuando buscas aislar el 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 predeterminada 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 separada o aislada para las tareas de automatización.
  • Carpeta personalizada : utiliza la carpeta especificada en Ruta de la carpeta de datos del usuario. Si la ruta de la carpeta de datos del usuario no está configurada, 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 del usuario. La configuración de la carpeta de datos del usuario del navegador solo está disponible para 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 se establece.

• Resize window - Defines whether the application/browser is resized when initialized.

  • Ninguno : no se aplica ningún cambio de tamaño a la aplicación/navegador.
  • Maximizar : la aplicación/navegador se maximiza cuando se inicializa.
  • Restaurar al tamaño en tiempo de diseño : 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.

• Window attach mode - Defines where inner activities search for their target elements.

  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.

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

• WebDriver mode - Indicates how the WebDriver is used when opening a new browser session. The following options are available:

  • Deshabilitado : deshabilita el uso de WebDriver.
  • Con GUI : se muestra la GUI del navegador.
  • Headless : el navegador se inicia de forma silenciosa, sin GUI. Para obtener más información, consulta Acerca del protocolo WebDriver.

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

Destino

• URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.
• File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.
  Nota:

  Cuando la ruta definida en el campo Ruta del archivo es dinámica, seleccionar Indicar destino en pantalla en actividades secundarias genera un error si la aplicación de destino no está abierta.

• Selector : lista de atributos utilizados para encontrar una ventana del navegador en particular.
• Argumentos : parámetros que se pasan a la aplicación de destino al inicio.
• Directorio de trabajo : la ruta al directorio de trabajo actual. Este campo solo acepta variables de cadena o valores de cadena, que deben colocarse entre comillas.

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.

Windows - Configuración heredada

• Selecciona Indicar aplicación para identificar la aplicación moviendo el ratón a su ventana y seleccionándola. Si el destino es una página web del navegador, navega a la página antes de indicar la aplicación.

• Después de indicar el destino, gestiona el destino seleccionando el botón de opciones del menú y eligiendo una de las siguientes opciones:

  • Indicate target on screen - Indicate the application again.
  • Highlight Target - View the indicated application on your screen surrounded in a box.
  • Show informative screenshot - View a screenshot of the target application or web page.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Motor OCR : selecciona una de las dos opciones:
    • Motor OCR integrado : utiliza el motor OCR integrado en el modelo de IA de Computer Vision, es decir, UiPath Screen OCR.
    • Motor OCR personalizado : utiliza un motor OCR personalizado. Cuando se selecciona esta opción, se añade un panel en la tarjeta de actividad donde puedes soltar una actividad del motor OCR diferente a UiPath Screen OCR.
  • 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.

• Puede iniciar una nueva instancia de la aplicación o una nueva sesión del navegador, conservando los ajustes de configuración actuales, utilizando el junto al campo Ruta de la aplicación (en el caso de una aplicación) o URL del navegador (en el caso de un navegador). Si abres un navegador a través de este botón, se aplican todas las configuraciones realizadas en la sección Opciones - Propiedad del navegador , lo que te 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, selecciona 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 parámetros para pasar a la aplicación de destino al 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, selecciona Más > Texto y, a continuación, introduce C:\Sample.pdf en el Creador 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.

    • Selecciona 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, seleccionar Indicar destino en pantalla en 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á 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.

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

  Importante:

  El nombre para mostrar de la actividad Usar aplicación/navegador también se utiliza como referencia que apunta a la aplicación o navegador al que se dirige. 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 una en su cuerpo que te permite elegir la tarjeta de aplicación con la que quieres 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:

  Al indicar una ventana en un entorno de Escritorio remoto, la configuración predeterminada del tiempo de espera se establece en 60 segundos.

• Unified Target Application - Expand this category to configure the following settings:

  • Arguments - If the application is not a web browser, you can specify parameters to pass to the target application at startup. You can use this property to open a specific file with the application. For example, if the target application is Acrobat Reader, you can open a specific workbook by providing the full path to the file. To open the file C:\Sample.pdf, enter "C:\Sample.pdf". Certain application types are automatically identified and autofill the Arguments property, such as Java apps, Office Suite apps, Adobe Acrobat, or Windows File Explorer.
  • File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.
    Nota:

    Cuando la ruta definida en el campo Ruta del archivo es dinámica, seleccionar Indicar destino en pantalla en actividades secundarias genera un error si la aplicación de destino no está abierta.

  • Selector - An XML fragment that stores the attributes of a user interface element.
  • URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.
  • DirectorioDeTrabajo : la ruta al directorio de trabajo actual. Este campo solo acepta variables de cadena o valores de cadena, que deben colocarse entre comillas.

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

• Output Element - Outputs the target element indicated in this activity to an UIElement variable which can then be reused in other activities. This field supports only UIElement variables.

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

• 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 cerrar la aplicación.
  • Si lo abre la aplicación/navegador : cerrar solo si la aplicación fue abierta por la automatización. Este es el valor predeterminado.
  • Siempre : cierra la aplicación siempre.

• Input mode - Select which method the Robot should use to interact with the target application:

  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • Simular : simula el uso de las 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 acción. Funciona incluso si la aplicación de destino no está enfocada. Compruebe si el elemento de IU de su aplicación de destino lo admite.
  • API de Chromium : realiza acciones utilizando 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. Para obtener más información, consulta esta página.
  • Mensajes de ventana : simula el uso de 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 acción. Funciona incluso si la aplicación de destino no está enfocada. Compruebe si el elemento de IU de su aplicación de destino lo admite.
  • Segundo plano : ejecuta acciones en segundo plano. Intenta utilizar Simular o la API de 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 uso del 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 abras la aplicación.
  • Si no está abierto : se abre 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 incluso si ya hay una abierta. Solo funciona si se rellenan los campos Ruta del archivo o URL .

• Resize window - Defines whether the application/browser is resized when initialized.

  • Ninguno : no se aplica ningún cambio de tamaño a la aplicación/navegador.
  • Maximizar : la aplicación/navegador se maximiza cuando se inicializa.
  • Restaurar al tamaño en tiempo de diseño : 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.

• Window attach mode - Defines where inner activities search for their target elements.

  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.

Opciones: navegador

• Gestión de diálogos : una vez que selecciones el valor DialogHandling en lugar de (null), podrás configurar las siguientes opciones:

  • Descartar alertas : habilita el descarte automático de los diálogos de alerta de JavaScript.
  • Descartar confirmaciones : habilita el descarte automático de los diálogos de confirmación de JavaScript.
  • Confirmar respuesta de diálogo : respuesta a los diálogos de confirmación de JavaScript: Cancelar o Aceptar.
  • Descartar solicitudes : habilita el descarte automático de los cuadros de diálogo de solicitud de JavaScript.
  • Respuesta de diálogo de solicitud : respuesta a los diálogos de solicitud de JavaScript: Cancelar o Aceptar.
  • Texto de respuesta de la solicitud : respuesta de texto para los diálogos de solicitud de JavaScript.

• Incognito/private window - If selected, opens the new browser session in incognito/private mode. By default, this check box is cleared.

• 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 : activa automáticamente el modo Imagen en imagen (PiP) con una carpeta de datos de usuario independiente de la predeterminada. Si la Ruta de la carpeta de datos del usuario no está configurada, se generará una carpeta automáticamente. Esto puede ser útil cuando buscas aislar el navegador durante las tareas de automatización y mantener los datos separados de la sesión de navegación principal.
  • CarpetaPredeterminada : utiliza la carpeta predeterminada 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 separada o aislada para las tareas de automatización.
  • CarpetaPersonalizada : utiliza la carpeta especificada en Ruta de la carpeta de datos del usuario. Si la ruta de la carpeta de datos del usuario no está configurada, 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 del usuario. La configuración de la carpeta de datos del usuario del navegador solo está disponible para 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 se establece. Puedes encontrar más detalles sobre el modo de carpeta de datos de usuario y la ruta de carpeta de datos de usuario aquí.

• WebDriver mode - Indicates how the WebDriver is used when opening a new browser session. The following options are available:

  • Deshabilitado : deshabilita el uso de WebDriver.
  • ConGUI : se muestra la GUI del navegador.
  • Headless : el navegador se inicia de forma silenciosa, sin GUI.Puedes encontrar más detalles sobre WebDriver aquí.