Adjuntar

Se centra en una aplicación de escritorio o una página del navegador web que ya está abierta para usar en la automatización de IU.

Esta API se utiliza llamando al servicio UIAutomation, según el siguiente formato: uiAutomation.<APIMethod>(). 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
Attach(String, TargetAppOptions, String, String)	Se centra en una aplicación de escritorio o página web específica para utilizar en la automatización de IU, identificada por el nombre de pantalla del repositorio de objetos.
Attach(TargetAppModel, TargetAppOptions)	Se centra en una aplicación de escritorio o página web específica para su uso en la automatización de IU, identificada por el objeto TargetAppModel .
Attach(String, String, String, NAppAttachMode, NWindowResize, NInteractionMode)	Se centra en una aplicación de escritorio o página web específica para utilizar en la automatización de IU, identificada por el nombre de pantalla del repositorio de objetos, junto con otras personalizaciones de la aplicación o página web.

Attach(String, TargetAppOptions, String, String)

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

Attach(
    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 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.

Attach(TargetAppModel, TargetAppOptions)

Se centra en una aplicación de escritorio o página web específica para su uso en la automatización de IU, identificada por el objeto TargetAppModel .

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

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

Attach(String, String, String, NAppAttachMode, NWindowResize, NInteractionMode)

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

Attach(string screenName,
    [string appName],
    [string appVersion],
    [NAppAttachMode appAttachMode],
    [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.

appAttachMode NAppAttachMode

• ByProcessName : otras API buscarán en todas las ventanas con el mismo nombre de proceso que la aplicación indicada.
• ByInstance : otras API buscarán en 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.
• SingleWindow : otras API buscarán solo en la ventana indicada.

windowResize NWindowResize

Elija el tamaño de la ventana:

• Ninguno
• Aumentar
• Restaurar
• Minimizar

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