Abrir

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

Esta API se utiliza llamando al servicio UiAutomation, según el siguiente formato: uiAutomation.API(). Por ejemplo, uiAutomation.Open().

Definición

Espacio de nombres: UiPath.UIAutomationNext.API.Contracts

Ensamblado: UiPath.UIAutomationNext.API.Contracts (en la dll UiPath.UIAutomationNext.API.Contracts)

Sobrecargas

Sobrecarga	Descripción
Open(String, TargetAppOptions, String, String)	Abre una aplicación de escritorio o página web específica para utilizar en la automatización de la interfaz de usuario, identificada por el nombre de pantalla del repositorio de objetos.
Open(TargetAppModel, TargetAppOptions)	Abre una aplicación de escritorio o página web específica para usar en la automatización de la interfaz de usuario, identificada por el objeto TargetAppModel .
Open(String, String, String, NAppOpenMode, NWindowResize, NInteractionMode)	Abre una aplicación de escritorio o página web específica para utilizar en la automatización de la interfaz de usuario, identificada por el nombre de pantalla del repositorio de objetos, junto con otras personalizaciones de la aplicación o página web.

Open(String, TargetAppOptions, String, String)

Abre una aplicación de escritorio o página web específica para utilizar en la automatización de la interfaz de usuario, identificada por el nombre de pantalla del repositorio de objetos.

Open(
    string screenName,  
    TargetAppOptions targetAppOptions, 
    [string appName],
    [string appVersion])

screeName Cadena

El nombre de la pantalla en la que desea centrarse, como una cadena registrada dentro del Repositorio de objetos.

targetAppOptions

Opciones y ajustes adicionales para adjuntar a la aplicación o página web:

• Timeout Double : especifica los segundos durante los que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos. Cuando se indica una ventana en un entorno de escritorio remoto, la configuración predeterminada de Tiempo de espera se establece en 60 segundos.
• InteractionMode NInteractionMode:
  • HardwareEvents : utiliza el controlador de hardware para realizar las Actions. Esta es la API más lenta, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
  • Simulate : simula las Actions mediante las API de accesibilidad. Recomendado en automatización de navegadores, aplicaciones Java o SAP. 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.
  • DebuggerApi : realiza Actions mediante las API del depurador. Solo funciona para elementos 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.
  • WindowMessages : envía la entrada del ratón y del teclado a través 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 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.
  • Background : ejecuta Actions en segundo plano. Intenta utilizar la API de Simulate o Chromium siempre que sea posible, mientras que las API complejas (imagen, texto nativo) se ejecutan como de costumbre, en primer plano. Se recomienda encarecidamente utilizar esta API con la característica Verificar ejecución .
• OpenMode NAppOpenMode : elige cuándo abrir la aplicación:
  • Never (nunca abra la aplicación)
  • IfNotOpen (se abre solo si la aplicación está cerrada, esta es la selección predeterminada, solo funciona si se proporcionan FilePath o URL )
  • Always (abre otra instancia de la aplicación incluso si una ya está abierta, solo funciona si se proporcionan FilePath o URL )
• WindowResize NWindowResize : elige el tamaño de la ventana:
  • Ninguno
  • Aumentar
  • Restaurar
  • Minimizar
• UserDataFolderMode BrowserUserDataFolderMode : el UserDataFolderMode que quieres establecer. Se utiliza para iniciar el navegador con una carpeta de datos de usuario específica.
  • Automatic : el modo Imagen en imagen usa una carpeta distinta al modo predeterminado, que se genera automáticamente si no se establece UserDataFolderPath .
  • DefaultFolder : usa la carpeta predeterminada del navegador, sin importar si se ejecuta en la sesión principal o PIP.
  • CustomFolder : utiliza la carpeta especificada en UserDataFolderPath o una ruta generada automáticamente si UserDataFolderPath no está configurado.
• UserDataFolderPath String : la carpeta de datos del usuario que utiliza el navegador. El valor predeterminado es %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si no está configurado.
• IsIncognito Boolean : introduce True si quieres abrir el navegador en modo de incógnito. De forma predeterminada está establecido en False.
• WebDriverMode NWebDriverMode : indica cómo se usa WebDriver al abrir una nueva sesión del navegador. Están disponibles las siguientes opciones:
  • Disabled : deshabilita el uso de WebDriver.
  • WithGUI : se muestra la GUI del navegador.
  • Headless : el navegador se inicia de forma silenciosa, sin GUI.

appName Cadena

El nombre de la aplicación a la que adjuntar. Este parámetro es aplicable para aplicaciones de escritorio.

appVersion Cadena

La versión de la aplicación a la que adjuntar. Este parámetro es aplicable para aplicaciones de escritorio.

Open(TargetAppModel, TargetAppOptions)

Abre una aplicación de escritorio o página web específica para usar en la automatización de la interfaz de usuario, identificada por el objeto TargetAppModel .

Open(
    TargetAppModel targetApp,
    [TargetAppOptions targetAppOptions])

targetApp ModeloDeAppDeDestino

La aplicación de destino o página web a la que adjuntar. Es un objeto de tipo TargetAppModel que proporciona información sobre la aplicación:

• Selector : un fragmento XML que almacena los atributos de un elemento de la interfaz de usuario.
• FilePath : si la aplicación no es un navegador web, especifica la ruta completa del archivo ejecutable que se va a abrir.
• Arguments : si la aplicación no es un navegador web, puedes especificar parámetros para pasar a la aplicación de destino al inicio.
• Url : si la aplicación es un navegador web, especifica la URL de la página web que se va a abrir.
• Title : el título de la aplicación o el navegador.

targetAppOptions

Opciones y ajustes adicionales para adjuntar a la aplicación o página web:

• Timeout Double : especifica los segundos durante los que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos. Cuando se indica una ventana en un entorno de escritorio remoto, la configuración predeterminada de Tiempo de espera se establece en 60 segundos.
• InteractionMode NInteractionMode:
  • HardwareEvents : utiliza el controlador de hardware para realizar las Actions. Esta es la API más lenta, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
  • Simulate : simula las Actions mediante las API de accesibilidad. Recomendado en automatización de navegadores, aplicaciones Java o SAP. 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.
  • DebuggerApi : realiza Actions mediante las API del depurador. Solo funciona para elementos 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.
  • WindowMessages : envía la entrada del ratón y del teclado a través 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 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.
  • Background : ejecuta Actions en segundo plano. Intenta utilizar la API de Simulate o Chromium siempre que sea posible, mientras que las API complejas (imagen, texto nativo) se ejecutan como de costumbre, en primer plano. Se recomienda encarecidamente utilizar esta API con la característica Verificar ejecución .
• OpenMode NAppOpenMode : elige cuándo abrir la aplicación:
  • Never (nunca abra la aplicación)
  • IfNotOpen (se abre solo si la aplicación está cerrada, esta es la selección predeterminada, solo funciona si se proporcionan FilePath o URL )
  • Always (abre otra instancia de la aplicación incluso si una ya está abierta, solo funciona si se proporcionan FilePath o URL )
• WindowResize NWindowResize : elige el tamaño de la ventana:
  • Ninguno
  • Aumentar
  • Restaurar
  • Minimizar
• UserDataFolderMode BrowserUserDataFolderMode : el UserDataFolderMode que quieres establecer. Se utiliza para iniciar el navegador con una carpeta de datos de usuario específica.
  • Automatic : el modo Imagen en imagen usa una carpeta distinta al modo predeterminado, que se genera automáticamente si no se establece UserDataFolderPath .
  • DefaultFolder : usa la carpeta predeterminada del navegador, sin importar si se ejecuta en la sesión principal o PIP.
  • CustomFolder : utiliza la carpeta especificada en UserDataFolderPath o una ruta generada automáticamente si UserDataFolderPath no está configurado.
• UserDataFolderPath String : la carpeta de datos del usuario que utiliza el navegador. El valor predeterminado es %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si no está configurado.
• IsIncognito Boolean : introduce True si quieres abrir el navegador en modo de incógnito. De forma predeterminada está establecido en False.
• WebDriverMode NWebDriverMode : indica cómo se usa WebDriver al abrir una nueva sesión del navegador. Están disponibles las siguientes opciones:
  • Disabled : deshabilita el uso de WebDriver.
  • WithGUI : se muestra la GUI del navegador.
  • Headless : el navegador se inicia de forma silenciosa, sin GUI.

Open(String, String, String, NAppOpenMode, NWindowResize, NInteractionMode)

Abre una aplicación de escritorio o página web específica para utilizar en la automatización de la interfaz de usuario, identificada por el nombre de pantalla del repositorio de objetos, junto con otras personalizaciones de la aplicación o página web.

Open(
    string screenName,
    [string appName],
    [string appVersion],
    [NAppOpenMode openMode],
    [NWindowResize windowResize],
    [NInteractionMode interactionMode])

screeName Cadena

El nombre de la pantalla en la que desea centrarse, como una cadena registrada dentro del Repositorio de objetos.

appName Cadena

El nombre de la aplicación a la que adjuntar. Este parámetro es aplicable para aplicaciones de escritorio.

appVersion Cadena

La versión de la aplicación a la que adjuntar. Este parámetro es aplicable para aplicaciones de escritorio.

openMode NAppOpenMode

Seleccione cuándo abrir la aplicación de destino para la ejecución de la automatización:

• Never (nunca abra la aplicación)
• IfNotOpen (se abre solo si la aplicación está cerrada, esta es la selección predeterminada, solo funciona si el parámetro Url está configurado)
• Always : (abre otra instancia de la aplicación incluso si una ya está abierta, solo funciona si el parámetro Url está configurado).

NWindowResize

Elija el tamaño de la ventana:

• Ninguno
• Aumentar
• Restaurar
• Minimizar

NInteractionMode

Elija qué API debe usar el robot para interactuar con la aplicación de destino:

• HardwareEvents : utiliza el controlador de hardware para realizar las Actions. Esta es la API más lenta, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
• Simulate : simula las Actions mediante las API de accesibilidad. Recomendado en automatización de navegadores, aplicaciones Java o SAP. 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.
• DebuggerApi : realiza Actions mediante las API del depurador. Solo funciona para elementos 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.
• WindowMessages : envía la entrada del ratón y del teclado a través 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 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.
• Background : ejecuta Actions en segundo plano. Intenta utilizar la API de Simulate o Chromium siempre que sea posible, mientras que las API complejas (imagen, texto nativo) se ejecutan como de costumbre, en primer plano. Se recomienda encarecidamente utilizar esta API con la característica Verificar ejecución .

Ejecutar WebDriverMode como Headless

Para operar WebDriverMode en una configuración sin interfaz gráfica, estos pasos pueden servir como guía.

Comienza definiendo una variable para tu pantalla. Utiliza la función uiAutomation.Open para abrir una nueva aplicación en el navegador de tu elección: en esta instancia, Edge.Después de eso, utiliza la clase Options en la sobrecarga para especificar ciertas opciones del navegador.Entre estas opciones, establece webDriverMode en NWebDriverMode.Headless.

El código correspondiente se ve así:

var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));

Este código funciona para establecer tu WebDriver en modo sin interfaz gráfica, habilitando la automatización del navegador sin que el navegador esté visiblemente abierto.