- Información general
- Automatización de IU
- Aplicaciones y tecnologías automatizadas con UI Automation
- Compatibilidad de proyectos
- UI-ANA-016: Introducir URL para abrir el navegador
- UI-ANA-017: ContinueOnError verdadero
- UI-ANA-018: enumerar actividades de OCR / imagen
- UI-DBP-006: uso del contenedor
- UI-DBP-013: uso incorrecto de la automatización de Excel
- UI-DBP-030: uso de variables prohibidas en selectores
- UI-PRR-001: Simular clic
- UI-PRR-002: Simular tipo
- UI-PRR-003: uso incorrecto de aplicación abierta
- UI-PRR-004: retrasos codificados
- UI-REL-001: Idx grande en selectores
- UI-SEC-004: datos de correo electrónico del selector
- UI-SEC-010: Restricciones de aplicaciones / URL
- UI-USG-011: atributos no permitidos
- UX-SEC-010: restricciones de aplicaciones / URL
- UX-DBP-029: uso no seguro de contraseña
- UI-PST-001: nivel de registro de auditoría en la configuración del proyecto
- Herramienta de migración del navegador de UiPath
- Recorte de región
- Grabadora de Computer Vision
- Activar
- Base de anclaje
- Asociar navegador
- Asociar ventana
- Bloquear entrada de usuario
- Aviso
- Comprobar
- Clic
- Clic en imagen
- Desencadenador de clic de imagen
- Clic en texto OCR
- Clic en el texto
- Desencadenador de clic
- Cerrar aplicación
- Cerrar pestaña
- Cerrar ventana
- Anclaje consciente de contexto
- Copiar texto seleccionado
- Desencadenador de cambio del atributo del elemento
- Elemento existente
- Ámbito del elemento
- Desencadenador de cambio de estado de elemento
- Exportar el árbol de la IU
- Extraer datos estructurados
- Buscar elementos secundarios
- Buscar elemento
- Buscar imagen
- Buscar coincidencias de imágenes
- Buscar texto OCR
- Buscar elemento relativo
- Buscar posición de texto
- Obtener ventana activa
- Obtener antecesor
- Obtener atributo
- Obtener información de atributo
- Obtener a partir del portapapeles
- Obtener texto completo
- Obtener texto OCR
- Obtener contraseña
- Obtener posición
- Obtener elemento de origen
- Obtener texto
- Obtener texto visible
- Volver
- Avanzar
- Ir a inicio
- Google Cloud Vision OCR
- Ocultar ventana
- Resaltar
- Desencadenador de tecla de acceso rápido
- Mantener el puntero
- Mantener el puntero en imagen
- Mantener el puntero sobre texto OCR
- Mantener el puntero en el texto
- Imagen existente
- Indicar en pantalla
- Insertar código .NET
- Inject Js Script
- Invocar método de ActiveX
- Desencadenador de pulsación de tecla
- Cargar imagen
- Maximizar ventana
- Microsoft Azure Computer Vision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Minimizar ventana
- Supervisar eventos
- Desencadenador del ratón
- Mover ventana
- Ir a
- Texto OCR existente
- Apariencia en elemento
- Fuga en elemento
- Apariencia en imagen
- Fuga en imagen
- Abrir aplicación
- Abrir navegador
- Actualizar navegador
- Reproducir evento de usuario
- Restaurar ventana
- Guardar imagen
- Seleccionar elemento
- Seleccionar varios elementos
- Enviar tecla de acceso rápido
- Establecer región de recorte
- Establecer foco
- Establecer texto
- Establecer en portapapeles
- Establecer atributo web
- Mostrar ventana
- Iniciar proceso
- Desencadenador del sistema
- Realizar captura
- Tesseract OCR
- Texto existente
- Información sobre herramientas
- Escribir en
- Escribir Texto Seguro
- Utilizar primer plano
- Esperar a atributo
- Esperar a fuga de elemento
- Esperar a fuga de imagen
- Desencadenador de eventos de aplicación
- Marcar/Desmarcar
- Comprobar estado de aplicación
- Comprobar elemento
- Clic
- Clic desencadenador de eventos
- Arrastrar y soltar
- Extraer datos de tabla
- Para cada elemento de interfaz de usuario
- Obtener atributo
- Obtener datos del navegador
- Obtener texto
- Obtener URL
- Ir a URL
- Resaltar
- Mantener el puntero
- Inject Js Script
- Atajos del teclado
- Desencadenador de eventos de pulsación de tecla
- Desplazamiento del ratón
- Navegar por el navegador
- Seleccionar elemento
- Establecer datos del navegador
- Establecer navegador de Runtime
- Establecer texto
- Realizar captura
- Escribir en
- Utilizar Aplicación/Navegador
- Transacción de llamada
- Clic en imagen en pantalla
- Hacer clic en botón de barra de herramientas
- Expandir tabla jerárquica ALV
- Expandir árbol ALV
- Expandir árbol
- Lectura de barra de estado
- Inicio de sesión en SAP
- Inicio de sesión en SAP
- Desencadenador de cambio de atributos de sesión de SAP
- Seleccionar fechas en el calendario
- Seleccionar elemento de menú
- Ámbito de la celda de la tabla
- Transacción de llamada
- Clic en imagen en pantalla
- Hacer clic en botón de barra de herramientas
- Expandir tabla jerárquica ALV
- Expandir árbol ALV
- Expandir árbol
- Lectura de barra de estado
- Inicio de sesión en SAP
- Inicio de sesión en SAP
- Seleccionar fechas en el calendario
- Seleccionar elemento de menú
- Ámbito de la celda de la tabla
- Realizar búsquedas en el navegador y recuperar resultados mediante las API de automatización de IU
- Exploración web
- Buscar imágenes
- Hacer clic en imágenes
- Eventos de desencadenador y supervisor
- Crear y anular archivos
- Páginas HTML: extraer y manipular información
- Manipulación de ventana
- Selección de lista automatizada
- Buscar y manipular elementos de ventana
- Gestionar automatización de texto
- Cargar y procesar imágenes
- Gestionar acciones activadas por el ratón
- Automatizar tiempo de ejecución de aplicación
- Ejecución automática de una aplicación local
- Navegación de explorador
- Automatización web
- Ejemplo de ámbito de desencadenador
- Habilitar soporte de automatización de IU en DevExpress
- Computer Vision Local Server
- Automatización móvil
- Notas relacionadas
- Compatibilidad de proyectos
- Obtener tipos de registro
- Obtener registros
- Obtener origen de la página
- Obtener la orientación del dispositivo
- Obtener identificador de sesión
- Instalar aplicación
- Administrar aplicación actual
- Administrar otras aplicaciones
- Abrir enlace profundo
- Abrir URL
- Conexión de dispositivo móvil
- Deslizamiento direccional
- Patrón de dibujo
- Pase de dedo posicional
- Pulse un botón del hardware
- Establecer orientación del dispositivo
- Realizar captura
- Tomar parte de la captura de pantalla
- Elemento existente
- Ejecutar comando
- Obtener atributo
- Obtener elemento seleccionado
- Obtener texto
- Establecer elemento seleccionado
- Establecer texto
- Deslizamiento
- Pulsar
- Escribir Texto
- Terminal
- Notas relacionadas
- Acerca del paquete de actividades de Terminal
- Compatibilidad de proyectos
- Mejores prácticas
- Buscar texto
- Obtener color de la posición
- Obtener la posición del cursor
- Obtener campo
- Obtener campo en posición
- Obtener área de pantalla
- Obtener texto
- Obtener texto en posición
- Mover cursor
- Mover cursor al texto
- Enviar tecla de control
- Teclas de envío
- Teclas de envío seguras
- Establecer campo
- Configurar campo en posición
- Sesión del terminal
- Esperar texto de campo
- Esperar texto en pantalla
- Esperar texto en posición
Actividades UIAutomation
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.
uiAutomation.<APIMethod>()
. Por ejemplo, uiAutomation.Open()
.
Espacio de nombres: UiPath.UIAutomationNext.API.Contracts
Ensamblado: UiPath.UIAutomationNext.API.Contracts (en la dll UiPath.UIAutomationNext.API.Contracts)
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. |
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])
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 proporcionanFilePath
oURL
)Always
(abre otra instancia de la aplicación incluso si una ya está abierta, solo funciona si se proporcionanFilePath
oURL
)
WindowResize NWindowResize
: elige el tamaño de la ventana:Ninguno
Aumentar
Restaurar
Minimizar
UserDataFolderMode BrowserUserDataFolderMode
: elUserDataFolderMode
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 estableceUserDataFolderPath
.DefaultFolder
: usa la carpeta predeterminada del navegador, sin importar si se ejecuta en la sesión principal o PIP.CustomFolder
: utiliza la carpeta especificada enUserDataFolderPath
o una ruta generada automáticamente siUserDataFolderPath
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
: introduceTrue
si quieres abrir el navegador en modo de incógnito. De forma predeterminada está establecido enFalse
.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.
TargetAppModel
.
Attach(
TargetAppModel targetApp,
[TargetAppOptions targetAppOptions]))
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 proporcionanFilePath
oURL
)Always
(abre otra instancia de la aplicación incluso si una ya está abierta, solo funciona si se proporcionanFilePath
oURL
)
WindowResize NWindowResize
: elige el tamaño de la ventana:Ninguno
Aumentar
Restaurar
Minimizar
UserDataFolderMode BrowserUserDataFolderMode
: elUserDataFolderMode
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 estableceUserDataFolderPath
.DefaultFolder
: usa la carpeta predeterminada del navegador, sin importar si se ejecuta en la sesión principal o PIP.CustomFolder
: utiliza la carpeta especificada enUserDataFolderPath
o una ruta generada automáticamente siUserDataFolderPath
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
: introduceTrue
si quieres abrir el navegador en modo de incógnito. De forma predeterminada está establecido enFalse
.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.
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]))
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 .
Para operar WebDriverMode en una configuración sin interfaz gráfica, estos pasos pueden servir como guía.
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));
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.