interfaz de usuario de IA-Connect
IA-Connect es una plataforma "RPA" de Automatización de procesos robóticos que agrega funcionalidad RPA desde la nube a máquinas virtuales locales o a través de conexiones "RDS" de Citrix o Escritorio remoto de Microsoft. Este es el módulo para la automatización de la interfaz de usuario de la aplicación Windows "UIA".
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| Correo Electrónico | IAConnect@ultima.com |
| Metadatos del conector | |
|---|---|
| Publicador | Última Empresa |
| Sitio web | https://www.ultima.com/ultima-labs |
| Directiva de privacidad | https://www.ultima.com/privacy-policy |
| Categorías | Operaciones de TI; Productividad |
IA-Connect es una plataforma de Automatización de procesos robóticos (RPA) que agrega funcionalidad de RPA desde Flujos de Power Automate Cloud a máquinas virtuales locales o a través de conexiones de Citrix o Escritorio remoto de Microsoft (RDS). Los conectores de IA-Connect proporcionan más de 800 acciones, lo que le permite automatizar cada tipo de aplicación local directamente desde un flujo de nube de Power Automate. Todas las acciones de IA-Connect están disponibles directamente desde Power Automate Cloud Flow, lo que proporciona una integración sencilla entre aplicaciones locales y basadas en la nube, la capacidad de aprovechar las condiciones, bucles, contenido dinámico, expresiones y control de excepciones existentes en los procesos de RPA. La utilización de los conectores de IA-Connect también proporciona un historial de ejecución completo y una auditoría del historial de ejecución de Flow, a la vez que elimina la necesidad de tener una aplicación, consola o estudio independiente para desarrollar los procesos de RPA.
Prerrequisitos
Para usar cualquiera de los conectores de IA-Connect, debe instalar el software IA-Connect. Esto es gratuito para probar durante 30 días, después de lo cual necesitará una licencia de IA-Connect.
El software IA-Connect consta de dos componentes principales:
La IA-Connect Orchestrator, que es una aplicación web de Azure que hospedaría en su propio inquilino de Azure. Esto controla el enrutamiento y la seguridad de los flujos de RPA a una o varias máquinas virtuales locales o basadas en la nube.
El agente y el director de IA-Connect, que se instalan en las máquinas virtuales donde se puede acceder al software que desea automatizar. Además, el agente de IA-Connect puede ejecutarse dentro de una sesión de Citrix o Microsoft Remote Desktop Services (RDS), donde los comandos de RPA se pasan a un canal virtual en la sesión remota para su ejecución. El agente de IA-Connect se puede ejecutar desde un recurso compartido de red y no requiere instalación.
Conectores de IA-Connect disponibles
Los conectores de IA-Connect disponibles son:
- IA-Connect código dinámico
- IA-Connect Java
- IA-Connect JML
- sistema central de IA-Connect
- IA-Connect Microsoft Office
- IA-Connect GUI de SAP
- sesión de IA-Connect
- interfaz de usuario de IA-Connect
- explorador web de IA-Connect
Obtención de credenciales
Para recibir su licencia y comenzar su evaluación gratuita de 30 días, envíe una solicitud en nuestro sitio web (https://www.ultima.com/IA-Connect/Power-Automate).
Una vez recibida una solicitud de evaluación, nos pondrá en contacto con usted a través de la dirección de correo electrónico proporcionada para ayudar a configurar el software de IA-Connect y para proporcionarle la licencia de prueba. Esta es una prueba completa y le permitirá probar cualquiera de las 800 acciones en todos los 9 conectores IA-Connect dentro de su propio entorno durante el período de prueba.
Introducción al conector
Después de enviar una solicitud de prueba para IA-Connect, podrá descargar un archivo ZIP que contenga el software IA-Connect y la documentación que cubre la instalación y la instalación. También nos pondrá en contacto con usted para ofrecer soporte técnico e instrucciones a través del proceso de instalación según sea necesario.
Support
Durante el período de prueba, puede ponerse en contacto con Ultima Labs (IAConnect@ultima.com) para obtener soporte técnico y asistencia.
Al comprar licencias IA-Connect recibirá tokens de soporte técnico que se pueden canjear por formación o soporte técnico personalizados del Centro de Servicios Técnicos (TSC) basado en Reino Unido de Ultima.
Problemas conocidos, errores comunes y preguntas más frecuentes
Nuestra Knowledge Base contiene una serie de artículos que abarcan cualquier problema conocido, errores comunes que pueden producirse al usar los conectores de IA-Connect y las preguntas más frecuentes. Esto es accesible en https://support.ultima.com/ultimalabs y se proporciona una cuenta para acceder a estos recursos durante la prueba de IA-Connect y después de comprar una licencia de IA-Connect.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | Cierto |
| dirección de IA-Connect Orchestrator | cuerda / cadena | Especificar la dirección IA-Connect Orchestrator sin el componente HTTP(S) | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Alternar elemento UIA |
Alterna un elemento (normalmente una casilla o un cuadro de radio). Esto proporciona al elemento el estado opuesto a su estado actual (por ejemplo, se desactiva y viceversa). Si desea establecer un estado específico, use la acción "Comprobar elemento" en su lugar. |
| Buscar el primer elemento primario de UIA |
Busca en la jerarquía del árbol UIA el primer elemento primario que coincida con los criterios de búsqueda. El elemento primario se define como el elemento que está en el siguiente nivel hacia arriba el "árbol" de UIA y casi siempre es un elemento contenedor. |
| Buscar imagen de búsqueda visible en el elemento UIA |
Devuelve si una imagen de búsqueda, proporcionada como entrada para esta acción, se encuentra visiblemente dentro de un elemento UIA en pantalla. El elemento se debe traer primero al principio, ya que el Agente toma una captura de pantalla en las coordenadas del elemento y busca la imagen de búsqueda proporcionada dentro de la captura de pantalla. |
| Cambio de tamaño del elemento UIA |
Cambia el tamaño de un elemento UIA. Esta acción normalmente solo funcionará con elementos Window (que tienen el patrón de transformación). |
| Captura de pantalla de la ubicación del elemento UIA |
Toma una captura de pantalla de la ubicación de un elemento y devuelve una imagen. El elemento se debe traer primero al principio, ya que la captura de pantalla está tomando una copia de la pantalla en la ubicación de los elementos. |
| Cerrar ventana del elemento UIA |
Cierra la ventana del elemento. Normalmente solo funciona en ventanas o diálogos. |
| Clic del mouse central global en el elemento UIA |
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace clic en el botón central del mouse. |
| Clic del mouse izquierdo global en el elemento UIA |
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace clic en el botón izquierdo del mouse. |
| Clic global doble izquierdo del mouse en el elemento UIA |
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace doble clic en el botón izquierdo del mouse. |
| Comprobación de varios elementos UIA |
Establece el estado de varios elementos (normalmente una casilla o una casilla de radio) en activada o desactivada. |
| Comprobar el elemento UIA |
Establece el estado de un elemento (normalmente una casilla o una casilla de radio) en activada o desactivada. |
| Contraer elemento UIA |
Contrae un elemento (normalmente un elemento de menú o desplegable). Si el elemento ya está contraído, no ocurrirá nada. |
| Contraseña de entrada en el elemento UIA |
Acción UIA que introduce una contraseña en un elemento (normalmente un campo de entrada de contraseña), reemplazando el texto existente. |
| Contraseña de entrada global en el elemento UIA |
Mueve el mouse al centro del elemento, lo centra, hace clic con el botón izquierdo y presiona las teclas. Normalmente se usa con una entrada de contraseña que no aceptará métodos de entrada UIA nativos. |
| Dibujar rectángulo alrededor del elemento UIA |
Dibuja un rectángulo alrededor del perímetro de un elemento para ayudar a identificar que el elemento encontrado es el necesario. El rectángulo se quita automáticamente después de 5 segundos. |
| Elemento UIA de foco |
Centra un elemento que lo convierte en el elemento activo para el foco del teclado y, dependiendo de la aplicación, puede llevar la ventana de elemento al primer plano. |
| Entrada devuelta en el elemento UIA |
Introduce una línea de retorno o nueva de Windows en un elemento (normalmente un campo de entrada de texto), reemplazando el texto existente o insertando el valor devuelto en una posición específica. |
| Espera a la ventana win32 de nivel superior de UIA |
Una acción rápida de Win32 que espera un tiempo especificado para que exista una ventana win32 de nivel superior antes de devolver un identificador UIA. Una ventana de nivel superior es una que está conectada al escritorio. Puede buscar por nombre de clase o título de ventana, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. Es más común usar la acción de UIA "Esperar elemento de escritorio", que es más eficaz, pero esta acción win32 normalmente se ejecuta más rápido. |
| Esperar a la ventana principal del identificador de proceso de UIA |
Una acción Win32 sencilla y rápida que espera a que exista una ventana principal de un proceso (especificado por id. de proceso) y devuelva un identificador. La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz. |
| Esperar a la ventana principal del proceso de UIA |
Una acción Win32 sencilla y rápida que espera a que exista una ventana principal de un proceso (especificado por nombre) antes de devolver un identificador. La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz. |
| Esperar al elemento de escritorio de UIA |
Espera a que exista un elemento de escritorio (normalmente una ventana). |
| Esperar al elemento UIA |
Espera a que exista un elemento (normalmente un elemento individual dentro de una ventana, como un botón o un área de entrada de texto). |
| Esperar la imagen de búsqueda visible dentro del elemento UIA |
Espera hasta que una imagen de búsqueda, proporcionada como entrada a esta acción, se encuentra visiblemente dentro de un elemento UIA en pantalla o la cantidad de tiempo especificada. El elemento se debe traer primero al principio, ya que el Agente toma una captura de pantalla en las coordenadas del elemento y busca la imagen de búsqueda proporcionada dentro de la captura de pantalla. El elemento UIA debe existir desde el principio. La acción se completa inmediatamente una vez que se encuentra la imagen. |
| Espere a que el elemento de escritorio UIA no exista |
Espera a que un elemento de escritorio (normalmente una ventana) ya no exista. |
| Espere a que el elemento UIA no exista |
Espera a que un elemento (normalmente un elemento individual dentro de una ventana, como un botón o un área de entrada de texto) ya no exista. |
| Espere a que la imagen de búsqueda visible no exista en el elemento UIA. |
Espera hasta que una imagen de búsqueda, proporcionada como entrada a esta acción, no se puede ubicar visiblemente (o nunca se encontró) dentro de un elemento UIA en pantalla, o la cantidad de tiempo especificada ha pasado y la imagen sigue presente. El elemento se debe traer primero al principio, ya que el Agente toma una captura de pantalla en las coordenadas del elemento y busca la imagen de búsqueda proporcionada dentro de la captura de pantalla. El elemento UIA debe existir desde el principio. La acción se completa inmediatamente una vez que la imagen ya no está presente. |
| Establecer el elemento UIA en un valor de intervalo numérico |
Establece el valor del elemento que tiene un intervalo numérico, por ejemplo, una barra de desplazamiento. |
| Establecer el elemento UIA en un valor numérico |
Establece el valor del elemento que tiene una entrada numérica, por ejemplo, un campo de texto o una barra de desplazamiento. |
| Establecer el modo de búsqueda de elementos UIA |
Elija el modo de búsqueda de elementos UIA que debe usar el agente de IA-Connect al realizar acciones de UIA. Normalmente, esta acción solo se usaría si tiene un problema con el modo predeterminado (Buscar todo). |
| Establecer la ventana de UIA en normal |
Normaliza la ventana con el identificador UIA especificado (es decir, lo establece en una ventana de tamaño normal en lugar de minimizar o maximizar). |
| Establecer la ventana de UIA en primer plano |
Trae una ventana al primer plano. |
| Establecer porcentaje de desplazamiento de elementos UIA |
Establezca el porcentaje de desplazamiento horizontal o vertical del elemento especificado, si ese elemento admite el desplazamiento. Si el elemento admite el patrón "scroll", puede aplicar esta acción directamente al elemento y especificar una cantidad de desplazamiento horizontal o vertical (o ambas). Si el elemento no admite el patrón "scroll", esta acción se revertirá a los patrones "range value" o "value", pero deberá aplicarlos directamente a los controles de barra de desplazamiento, no al propio elemento. |
| Establecimiento del tiempo de espera de transacción de UIA |
Controla cuánto tiempo esperará la API de UIA a que una aplicación devuelva la información sobre un elemento. Este tiempo de espera de transacción normalmente solo se alcanzaría si la aplicación no responde. |
| Expandir el elemento UIA |
Expande un elemento (normalmente un elemento de menú o desplegable). Si el elemento ya está expandido, no ocurrirá nada. |
| Global mouse click UIA element search color region (Región de color de búsqueda de elementos UIA) |
Mueve el mouse sobre una región de píxeles dentro de un elemento UIA que cumple los criterios de color especificados y realiza un clic del mouse. El elemento se debe traer primero al principio, ya que la captura de pantalla está tomando una copia de la pantalla en la ubicación de los elementos. |
| Haga clic con el botón derecho global en el elemento UIA. |
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace clic en el botón derecho del mouse. |
| Haga clic en elemento de lista UIA por nombre. |
Hace clic en el elemento de lista con el nombre especificado. Normalmente se usa para seleccionar un elemento en un elemento desplegable o de menú. |
| Haga clic en elemento de lista UIA por índice. |
Hace clic en el elemento de lista que coincide con el índice especificado. Normalmente se usa para seleccionar un elemento en un elemento desplegable o de menú. |
| Maximizar ventana de UIA |
Maximiza la ventana con el identificador UIA especificado. |
| Minimizar la ventana de UIA |
Minimiza la ventana con el identificador UIA especificado. |
| Mover elemento UIA |
Mueve un elemento UIA a una posición especificada en la pantalla. Esta acción normalmente solo funcionará con elementos Window (que tienen el patrón de transformación). |
| Obtención de patrones de elementos UIA |
Recupere qué patrones UIA están disponibles para un elemento UIA y, por tanto, qué acciones de UIA de IA-Connect es probable que tengan un efecto en el elemento. |
| Obtención de propiedades del elemento datagrid de UIA |
Devuelve las propiedades de tabla de un elemento DataGrid. Se trata de un elemento con filas, columnas, encabezados y celdas (es decir, una tabla). |
| Obtención de varias propiedades del elemento primario de UIA |
Devuelve un árbol jerárquico de elementos primarios del elemento especificado, hasta el escritorio (nivel raíz). El elemento primario se define como el elemento que está en el siguiente nivel hacia arriba el "árbol" de UIA y casi siempre es un elemento contenedor. |
| Obtención de varios elementos UIA como tabla |
Enumera los valores de los elementos secundarios de un elemento primario especificado y devuelve en un formato de tabla. Esto se puede usar para devolver filas y columnas de datos de elementos que no son técnicamente tablas, pero que se han organizado conjuntamente en una estructura de tabla. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de esta acción, que se ejecuta como un subproceso del Agente. |
| Obtención del contenido del elemento datagrid de UIA |
Devuelve el contenido de un elemento datagrid. Se trata de un elemento con filas, columnas, encabezados y celdas (es decir, una tabla). Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de esta acción, que se ejecuta como un subproceso del Agente. |
| Obtención del identificador de elemento primario de UIA |
Devuelve un identificador para el elemento primario del elemento especificado. El elemento primario se define como el elemento que está en el siguiente nivel hacia arriba el "árbol" de UIA y casi siempre es un elemento contenedor. |
| Obtención del identificador de UIA para el elemento centrado |
Devuelve un identificador para el elemento UIA centrado actualmente. |
| Obtención del identificador de UIA para el escritorio |
Devuelve un identificador para el escritorio. Se trata de una acción obsoleta porque el identificador "-2" se puede usar para hacer referencia al elemento de escritorio, pero también porque hay muchas acciones que pueden buscar en relación con el escritorio (por ejemplo, "esperar el elemento de escritorio"). |
| Obtención del identificador de UIA para la ventana principal del elemento centrado |
Devuelve un identificador para la ventana principal del elemento UIA centrado actualmente. La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". |
| Obtención del identificador de UIA para la ventana principal del identificador de proceso |
Una acción Win32 sencilla y rápida que devuelve el identificador de cualquier ventana principal de un proceso (especificado por id. de proceso). La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz. |
| Obtención del identificador de UIA para la ventana principal del proceso |
Una acción Win32 sencilla y rápida que devuelve el identificador de cualquier ventana principal de un proceso (especificado por nombre). La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". La ventana debe existir: IA-Connect no esperará. Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz. |
| Obtención del identificador de UIA para la ventana win32 de nivel superior |
Una acción rápida de Win32 que devuelve un identificador UIA para cualquier ventana win32 de nivel superior que tenga el nombre de clase o el título de la ventana especificados, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Una ventana de nivel superior es una que está conectada al escritorio. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. La ventana debe existir, IA-Connect no esperará. Es más común usar la acción UIA 'Does UIA desktop element exist' (¿Existe el elemento de escritorio UIA?), que es más eficaz, pero esta acción win32 normalmente se ejecuta más rápido. |
| Obtención del valor de etiqueta del elemento UIA |
Devuelve el valor de la etiqueta en el elemento . |
| Obtención del valor de texto del elemento UIA |
Devuelve el valor de texto de un elemento. Normalmente, un valor de texto está asociado a una etiqueta, pero muchos elementos pueden tener esta propiedad. |
| Obtener el elemento UIA en coordenadas de pantalla |
Devuelve el elemento UIA ubicado en las coordenadas de pantalla especificadas. |
| Obtener el modo de búsqueda de elementos UIA |
Recupera el modo de búsqueda de elementos UIA que usa el agente de IA-Connect para las acciones de UIA. |
| Obtener el valor del elemento UIA |
Devuelve el valor de un elemento . Normalmente, un valor está asociado a un área de entrada de texto, pero muchos elementos pueden tener esta propiedad. |
| Obtener elementos de elemento de lista UIA |
Devuelve una lista de elementos secundarios que se encuentran en el elemento especificado (normalmente, desplegables o elementos de menú). |
| Obtener elementos de escritorio de UIA |
Devuelve una lista de todas las ventanas y diálogos del escritorio. |
| Obtener las propiedades del elemento UIA como lista |
Devuelve las propiedades de un elemento como una lista de líneas única (una sola colección de líneas o tabla de datos) en lugar de elementos individuales, lo que puede resultar útil en función de cómo quiera usar los datos. |
| Obtener propiedades del elemento UIA |
Devuelve todas las propiedades de un elemento. Esto puede ser útil si no está seguro de qué campo contiene los valores de propiedad necesarios. |
| Obtener región de color de búsqueda de elementos UIA |
Devuelve los detalles de la región de píxeles dentro de un elemento UIA que cumple los criterios de color especificados. El elemento debe traerse primero al principio, ya que el Agente localiza los colores tomando una captura de pantalla en las coordenadas del elemento. |
| Obtener varias propiedades del elemento UIA |
Devuelve las propiedades de varios elementos. Esto puede ser útil si no está seguro de qué campos contiene los valores de propiedad necesarios. |
| Obtener ventanas win32 |
Una acción rápida de Win32 que devuelve una lista de todas las ventanas win32 que, opcionalmente, tienen el nombre de clase o el título de la ventana especificados, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. Win32 Windows puede incluir elementos inesperados, como la barra de tareas, el escritorio, el menú inicio, las superposiciones transparentes, las ventanas desactivadas o ocultas, por lo que la lista devuelta puede contener más resultados de lo esperado. |
| Presione el elemento UIA. |
Presiona un elemento (normalmente un botón). |
| Restablecer todos los identificadores de elemento UIA |
Restablece todos los identificadores de elemento UIA almacenados actualmente por IA-Connect que pueden ser útiles si ha estado identificando muchos elementos y tiene un gran número de identificadores de elemento almacenados. En escenarios con un número extremadamente alto de identificadores de elemento (100 000+), esta acción también se puede usar para liberar el uso de RAM. |
| Seleccionar elemento UIA |
Selecciona un elemento (normalmente un elemento de una lista o lista desplegable). |
| Texto de entrada en el elemento UIA |
Acción UIA que introduce texto en un elemento (normalmente un campo de entrada de texto), reemplazando el texto existente o insertando el nuevo valor en una posición específica. |
| Texto de entrada en varios elementos UIA |
Acción UIA que introduce diferentes fragmentos de texto en varios elementos (normalmente campos de entrada de texto), reemplazando el texto existente o insertando el nuevo valor en una posición específica. |
| Texto de entrada global en el elemento UIA |
Mueve el mouse al centro del elemento, lo centra, hace clic con el botón izquierdo y presiona las teclas. Normalmente se usa con una entrada de texto que no aceptará métodos de entrada UIA nativos. |
| ¿El proceso tiene ventana Win32? |
Una acción Win32 sencilla y rápida que informa de si un proceso (especificado por nombre) tiene ventanas visibles. La ventana debe existir: IA-Connect no esperará. Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz. |
| ¿Está activado el elemento UIA? |
Esta acción devuelve true o false que indica si se activa un elemento (normalmente una casilla o una casilla de radio). |
| ¿Existe la ventana win32 de nivel superior? |
Una acción rápida de Win32 que indica si existe una ventana win32 de nivel superior. Una ventana de nivel superior es una que está conectada al escritorio. Puede buscar por nombre de clase o título de ventana, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. La ventana debe existir, IA-Connect no esperará. Es más común usar la acción UIA 'Does UIA desktop element exist' (¿Existe el elemento de escritorio UIA?), que es más eficaz, pero esta acción win32 normalmente se ejecuta más rápido. |
| ¿Existe un elemento de escritorio UIA? |
Informa de si existe un elemento de escritorio y proporciona algunas propiedades básicas del elemento. |
| ¿Existe un elemento UIA? |
Informa de si existe un elemento y devuelve algunas propiedades básicas del elemento. |
Alternar elemento UIA
Alterna un elemento (normalmente una casilla o un cuadro de radio). Esto proporciona al elemento el estado opuesto a su estado actual (por ejemplo, se desactiva y viceversa). Si desea establecer un estado específico, use la acción "Comprobar elemento" en su lugar.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Buscar el primer elemento primario de UIA
Busca en la jerarquía del árbol UIA el primer elemento primario que coincida con los criterios de búsqueda. El elemento primario se define como el elemento que está en el siguiente nivel hacia arriba el "árbol" de UIA y casi siempre es un elemento contenedor.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de elemento
|
ElementHandle | True | integer |
Identificador UIA del elemento de destino. |
|
Buscar el tipo de control localizado del elemento primario
|
SearchParentLocalizedControlType | string |
Tipo de control localizado del elemento UIA primario que se va a buscar. Esto se puede detectar a través de inspección. |
|
|
Buscar tipo de control de elemento primario
|
SearchParentControlType | integer |
Tipo de control de elemento UIA primario (un entero no localizado) que se va a buscar. Este es el mismo valor en distintos idiomas. |
|
|
Número máximo de elementos primarios que se van a procesar
|
MaxParentsToProcess | integer |
Número máximo de elementos primarios que se van a procesar. De forma predeterminada, se establece en 50. |
|
|
Se produce una excepción si no se encuentra el elemento primario
|
RaiseExceptionIfParentElementNotFound | boolean |
¿Debe IA-Connect generar una excepción si no se encuentra el elemento UIA de búsqueda? |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Elemento primario encontrado
|
ParentElementFound | boolean |
Devuelve true si se encontró el elemento UIA primario de búsqueda. |
|
Identificador de elemento primario
|
ParentElementHandle | integer |
Identificador UIA para el elemento primario ubicado. Esto se puede usar como entrada para realizar acciones UIA adicionales que actúan en este elemento. |
|
Nombre del elemento primario
|
ParentElementName | string |
Nombre UIA del elemento primario ubicado. |
|
Nombre de clase del elemento primario
|
ParentElementClassName | string |
Nombre de clase UIA del elemento primario ubicado. |
|
Identificador de automatización de elementos primarios
|
ParentElementAutomationId | string |
Identificador de automatización UIA del elemento primario ubicado. |
|
Tipo de control localizado del elemento primario
|
ParentElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento primario ubicado. |
Buscar imagen de búsqueda visible en el elemento UIA
Devuelve si una imagen de búsqueda, proporcionada como entrada para esta acción, se encuentra visiblemente dentro de un elemento UIA en pantalla. El elemento se debe traer primero al principio, ya que el Agente toma una captura de pantalla en las coordenadas del elemento y busca la imagen de búsqueda proporcionada dentro de la captura de pantalla.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipo de imagen de búsqueda
|
SearchImageType | string |
Define lo que representa la entrada "Imagen de búsqueda". Si se establece en "Archivo de imagen de director", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el director. Si se establece en "Archivo de imagen del agente", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el Agente. Si se establece en "Base64", la imagen de búsqueda es una representación base64 de la imagen. |
|
|
Imagen de búsqueda
|
SearchImage | string |
Imagen de búsqueda que se va a buscar en el elemento UIA especificado. Según el tipo de imagen de búsqueda especificado, esto podría contener la ruta de acceso a un archivo de imagen (en el extremo director o agente) o contener la base64 (representación de texto) de la imagen que se va a buscar. |
|
|
Tipo de imagen de búsqueda alternativa
|
AltSearchImageType | string |
Define lo que representa la entrada "Imagen de búsqueda alternativa". Si se establece en "Ninguno" o en blanco, no hay ninguna imagen de búsqueda alternativa. Si se establece en "Archivo de imagen de director", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el director. Si se establece en "Archivo de imagen del agente", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el Agente. Si se establece en "Base64", la imagen de búsqueda es una representación base64 de la imagen. |
|
|
Imagen de búsqueda alternativa
|
AltSearchImage | string |
Imagen de búsqueda alternativa opcional para buscar dentro del elemento UIA especificado. Según el tipo de imagen de búsqueda alternativo especificado, esto podría contener la ruta de acceso a un archivo de imagen (en el extremo director o agente) o contener la base64 (representación de texto) de la imagen que se va a buscar. Si especifica una imagen de búsqueda alternativa, el Agente buscará la imagen de búsqueda alternativa o la imagen de búsqueda alternativa e informará de cuál se encontraba. |
|
|
Desviación máxima del color
|
MaxColourDeviation | integer |
El máximo de colores de píxeles de un elemento puede desviarse de los colores del píxel de la imagen de búsqueda antes de que no se considere una coincidencia. 0 para ninguna desviación. La desviación se mide en valores RGB. Por ejemplo: #FF0000 es 4 diferente de #FE0102. Esto permite omitir las pequeñas diferencias de coloración. |
|
|
Diferencias máximas de píxeles
|
MaxPixelDifferences | integer |
El número máximo de píxeles que pueden diferir (por encima de la desviación máxima de color), en toda la imagen de búsqueda, antes de que se considere que una imagen no coincide. Esto permite omitir las diferencias menores entre las imágenes, pero los valores más altos pueden aumentar el tiempo necesario para localizar una imagen. Se recomienda establecer en 0 y aumentar por pequeñas cantidades si es necesario. Si se establece en un valor superior a 0, también debe establecer "Diferencias máximas de píxeles consecutivos". |
|
|
Diferencias máximas de píxeles consecutivos
|
MaxConsecutivePixelDifferences | integer |
Número máximo de píxeles consecutivos que pueden diferir (por encima de la desviación máxima de color), en cualquier fila, antes de que se considere que una imagen no coincide. Esto permite omitir las diferencias menores entre las imágenes, pero los valores más altos pueden aumentar el tiempo necesario para localizar una imagen. Se recomienda establecer en 0 y aumentar por pequeñas cantidades si es necesario. Si establece en un valor superior a 0, también debe establecer "Diferencias máximas de píxeles". |
|
|
Desplazamiento X del píxel izquierdo
|
LeftPixelXOffset | integer |
Desplazamiento X opcional para el borde izquierdo del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento X de píxel derecho
|
RightPixelXOffset | integer |
Desplazamiento X opcional para el borde derecho del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel superior
|
TopPixelYOffset | integer |
Desplazamiento Y opcional para el borde superior del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel inferior
|
BottomPixelYOffset | integer |
Desplazamiento Y opcional para el borde inferior del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Unidad de desplazamiento de Píxel X
|
PixelXOffsetsUnit | string |
Se establece en "Píxel" (valor predeterminado) si los desplazamientos X de píxel izquierdo y derecho se miden en píxeles. Establézcalo en "Porcentaje" si los desplazamientos X de píxel izquierdo y derecho se miden como un porcentaje del ancho del elemento. |
|
|
Unidad de desplazamiento de píxeles Y
|
PixelYOffsetsUnit | string |
Establézcalo en "Píxel" (valor predeterminado) si los desplazamientos Y de píxel superior e inferior se miden en píxeles. Establézcalo en "Porcentaje" si los desplazamientos Y de píxel superior e inferior se miden como un porcentaje del alto del elemento. |
|
|
Índice de imagen de búsqueda
|
SearchImageIndex | integer |
Establézcalo en 1 para buscar la primera instancia de la imagen de búsqueda (en la dirección de la búsqueda) dentro del elemento UIA. Establezca en 2 para la segunda instancia, .... , N para la instancia N. Si también está buscando una imagen alternativa, el elemento UIA se examina primero para la imagen de búsqueda y, en segundo lugar, para la imagen alternativa, buscando la instancia solicitada de esa imagen concreta (es decir, el Agente espera una o la otra, no una combinación de ambas imágenes). |
|
|
Dirección de búsqueda de imágenes
|
ImageSearchDirection | string |
Dirección de búsqueda. 'Desde la parte superior' busca por fila desde la parte superior, examinando de izquierda a derecha dentro de cada fila. 'Desde abajo' busca por fila desde la parte inferior, examinando de izquierda a derecha dentro de cada fila. 'Desde la izquierda' busca por columna de la izquierda, examinando de arriba a abajo dentro de cada columna. 'Desde la derecha' busca por columna desde la derecha, examinando de arriba abajo dentro de cada columna. Esto se puede usar junto con "Search image index" (Índice de imagen de búsqueda) para buscar la imagen Nth desde la parte superior, inferior, izquierda o derecha. Para mejorar el rendimiento, seleccione la dirección de búsqueda que cree que localizará la imagen más rápido. |
|
|
Ocultar agente
|
HideAgent | boolean |
Establézcalo en true para ocultar automáticamente el Agente (si está visible) para asegurarse de que no oculta el elemento que se analiza. |
|
|
Devolver coordenadas de pantalla como físicas
|
ReturnPhysicalCoordinates | boolean |
Establézcalo en true para que las coordenadas de la pantalla se devuelvan como coordenadas físicas. Establézcalo en false para que las coordenadas de pantalla se devuelvan como coordenadas virtuales. Si el escalado de pantalla subyacente es de 100%, las coordenadas físicas y virtuales son las mismas. Las coordenadas de elemento siempre se devuelven como coordenadas virtuales. |
|
|
Mostrar rectángulo resaltado
|
ShowHighlightRectangle | boolean |
Si se establece en true, el agente de IA-Connect resaltará la imagen ubicada en la pantalla. Esto puede ser útil durante el desarrollo, para ayudar a visualizar que se detecta la imagen correcta. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Imagen de búsqueda ubicada
|
SearchImageLocated | boolean |
Establézcalo en true si se encuentra la imagen de búsqueda. Establézcalo en false si no se encuentra la imagen de búsqueda. |
|
Qué imagen de búsqueda se encuentra
|
WhichSearchImageLocated | integer |
Establézcalo en 0, si no se encontraron imágenes de búsqueda. Establézcalo en 1 si se encuentra la imagen de búsqueda. Establézcalo en 2 si se encuentra la imagen de búsqueda alternativa. |
|
Elemento de cuadro de selección de coincidencia de imagen
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Coordenada X virtual del píxel izquierdo que coincide con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Píxel derecho del elemento rectángulo de selección de imagen
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Coordenada X virtual del píxel más derecho que coincide con la imagen especificada, en relación con el elemento virtual de arriba a la izquierda. |
|
Elemento de cuadro de límite de coincidencia de imagen
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Coordenada Y virtual del píxel superior que coincide con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Píxel inferior del elemento de cuadro de selección de coincidencia de imagen
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Coordenada Y virtual del píxel inferior que coincide con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Imagen que coincide con el elemento de cuadro de selección centro X píxel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Coordenada X virtual del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Imagen que coincide con el elemento de rectángulo delimitador Y del centro de píxeles
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Coordenada Y virtual del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Imagen que coincide con el píxel izquierdo de la pantalla del rectángulo de selección
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Coordenada X de píxel de pantalla del píxel izquierdo que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel derecho de la pantalla del cuadro de límite de coincidencia de imagen
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Coordenada X del píxel de pantalla del píxel más derecho que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel superior de la pantalla del cuadro de límite de coincidencia de imagen
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Coordenada Y de píxel de pantalla del píxel superior que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel inferior de la pantalla del cuadro de selección de coincidencia de imagen
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Coordenada Y del píxel de pantalla de la parte inferior que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Imagen que coincide con el rectángulo de selección del centro de pantalla X píxel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Coordenada X del píxel de pantalla del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Imagen que coincida con el rectángulo de selección del centro de pantalla Y píxel
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Coordenada Y del píxel de pantalla del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
Cambio de tamaño del elemento UIA
Cambia el tamaño de un elemento UIA. Esta acción normalmente solo funcionará con elementos Window (que tienen el patrón de transformación).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Cambiar el tamaño del tipo de ancho
|
ResizeWidthType | string |
Tipo de cambio de tamaño de ancho: Absoluto o relativo. |
|
|
Nuevo ancho
|
NewWidth | True | integer |
Nuevo ancho del elemento. El tipo de cambio de tamaño (por ejemplo, absoluto o relativo) se define mediante la entrada "Cambiar el tamaño del tipo de ancho". Para dejar el ancho sin cambios, elija un valor de 0 y establezca "Cambiar el tamaño del tipo de ancho" en "Relative". |
|
Cambiar el tamaño del tipo de alto
|
ResizeHeightType | string |
El tipo de cambio de tamaño de alto: Absoluto o relativo. |
|
|
Nuevo alto
|
NewHeight | True | integer |
Nuevo alto del elemento. El tipo de cambio de tamaño (por ejemplo, absoluto o relativo) se define mediante la entrada "Cambiar el tamaño del tipo de alto". Para dejar el alto sin cambios, elija un valor de 0 y establezca "Cambiar el tamaño del tipo de alto" en "Relative". |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Resultado del comando
|
UIAResizeElementResult | boolean |
Resultado del comando (correcto o erróneo). |
|
Mensaje de error
|
ErrorMessage | string |
Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió. |
Captura de pantalla de la ubicación del elemento UIA
Toma una captura de pantalla de la ubicación de un elemento y devuelve una imagen. El elemento se debe traer primero al principio, ya que la captura de pantalla está tomando una copia de la pantalla en la ubicación de los elementos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Formato de imagen
|
ImageFormat | string |
Formato de imagen que se va a usar para la captura de pantalla. Esto puede afectar a la calidad y el tamaño de los datos que se devuelven. Los formatos admitidos son PNG (el valor predeterminado), JPG, BMP y GIF. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Ocultar agente
|
HideAgent | boolean |
Establézcalo en true para ocultar automáticamente el Agente (si está visible) para asegurarse de que no oculta la captura de pantalla. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Imagen de pantalla como Base64
|
ScreenBitmapBase64 | string |
Imagen de pantalla como una cadena codificada en Base64. |
Cerrar ventana del elemento UIA
Cierra la ventana del elemento. Normalmente solo funciona en ventanas o diálogos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Clic del mouse central global en el elemento UIA
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace clic en el botón central del mouse.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Elemento Focus primero
|
FocusElementFirst | boolean |
¿Debe IA-Connect intentar centrar el elemento antes de hacer clic globalmente? |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Hacer clic en desplazamiento X
|
ClickOffsetX | integer |
Número de píxeles X para desplazar la acción de clic por. Este parámetro admite valores de desplazamiento positivo (derecho) y negativo (izquierdo). |
|
|
Haga clic en Desplazamiento Y.
|
ClickOffsetY | integer |
Número de píxeles Y por el que se va a desplazar la acción de clic. Este parámetro admite valores de desplazamiento positivo (abajo) y negativo (hacia arriba). |
|
|
Desplazamiento relativo a
|
OffsetRelativeTo | string |
Posición relativa del elemento desde el que se va a desplazar (Centro / Centro / Centro, Izquierda, Derecha, Superior, Inferior, Superior Izquierda, Superior Derecha, Inferior Izquierda, Inferior Derecha). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Clic del mouse izquierdo global en el elemento UIA
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace clic en el botón izquierdo del mouse.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Elemento Focus primero
|
FocusElementFirst | boolean |
¿Debe IA-Connect intentar centrar el elemento antes de hacer clic globalmente? |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Hacer clic en desplazamiento X
|
ClickOffsetX | integer |
Número de píxeles X para desplazar la acción de clic por. Este parámetro admite valores de desplazamiento positivo (derecho) y negativo (izquierdo). |
|
|
Haga clic en Desplazamiento Y.
|
ClickOffsetY | integer |
Número de píxeles Y por el que se va a desplazar la acción de clic. Este parámetro admite valores de desplazamiento positivo (abajo) y negativo (hacia arriba). |
|
|
Desplazamiento relativo a
|
OffsetRelativeTo | string |
Posición relativa del elemento desde el que se va a desplazar (Centro / Centro / Centro, Izquierda, Derecha, Superior, Inferior, Superior Izquierda, Superior Derecha, Inferior Izquierda, Inferior Derecha). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Clic global doble izquierdo del mouse en el elemento UIA
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace doble clic en el botón izquierdo del mouse.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Retraso en milisegundos
|
DelayInMilliseconds | integer |
Retraso (en milisegundos) entre cada uno de los clics. |
|
|
Elemento Focus primero
|
FocusElementFirst | boolean |
¿Debe IA-Connect intentar centrar el elemento antes de hacer clic globalmente? |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Hacer clic en desplazamiento X
|
ClickOffsetX | integer |
Número de píxeles X para desplazar la acción de clic por. Este parámetro admite valores de desplazamiento positivo (derecho) y negativo (izquierdo). |
|
|
Haga clic en Desplazamiento Y.
|
ClickOffsetY | integer |
Número de píxeles Y por el que se va a desplazar la acción de clic. Este parámetro admite valores de desplazamiento positivo (abajo) y negativo (hacia arriba). |
|
|
Desplazamiento relativo a
|
OffsetRelativeTo | string |
Posición relativa del elemento desde el que se va a desplazar (Centro / Centro / Centro, Izquierda, Derecha, Superior, Inferior, Superior Izquierda, Superior Derecha, Inferior Izquierda, Inferior Derecha). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Comprobación de varios elementos UIA
Establece el estado de varios elementos (normalmente una casilla o una casilla de radio) en activada o desactivada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Elementos de entrada
|
InputElementsJSON | True | string |
Matriz de elementos UIA que se van a comprobar, en formato JSON. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Comprobar el elemento UIA
Establece el estado de un elemento (normalmente una casilla o una casilla de radio) en activada o desactivada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Elemento Check
|
CheckElement | boolean |
¿Debe comprobarse el elemento (true) o desmarcarse (false)? |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Contraer elemento UIA
Contrae un elemento (normalmente un elemento de menú o desplegable). Si el elemento ya está contraído, no ocurrirá nada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Contraseña de entrada en el elemento UIA
Acción UIA que introduce una contraseña en un elemento (normalmente un campo de entrada de contraseña), reemplazando el texto existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Contraseña que se va a escribir
|
PasswordToInput | True | password |
Valor de contraseña que se va a escribir. |
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
La contraseña contiene contraseña almacenada
|
PasswordContainsStoredPassword | boolean |
Se establece en true si la contraseña contiene (o es completamente) un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. Esta contraseña almacenada podría haber sido generada por la acción "Generar contraseña", por ejemplo, o que la IA-Connect Orchestrator lo mantenga. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Probar patrón de valor
|
TryValuePattern | boolean |
Si se establece en true (valor predeterminado), el agente de IA-Connect intentará usar un patrón de valor UIA para realizar la acción de entrada de texto. Si el patrón de valor UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de valor y volverá inmediatamente a otros patrones elegidos. |
|
|
Prueba del patrón heredado
|
TryLegacyPattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón heredado de UIA para realizar la acción de entrada de texto si el patrón de valor no está disponible (ya sea porque no está presente en el elemento o porque su uso estaba deshabilitado). |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Contraseña de entrada global en el elemento UIA
Mueve el mouse al centro del elemento, lo centra, hace clic con el botón izquierdo y presiona las teclas. Normalmente se usa con una entrada de contraseña que no aceptará métodos de entrada UIA nativos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Elemento Focus primero
|
FocusElement | boolean |
¿Debe IA-Connect intentar centrar el elemento antes de hacer clic globalmente? |
|
|
Clic del mouse izquierdo global en el elemento
|
GlobalMouseClickOnElement | boolean |
¿Debe realizarse un clic global del mouse en las coordenadas del elemento (para centrar el elemento) antes de escribir texto? |
|
|
Reemplazar el valor existente con el doble clic del mouse en eliminar
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
¿Debe reemplazarse cualquier valor existente haciendo doble clic en el mouse (para resaltarlo) y, a continuación, eliminarlo? |
|
|
Reemplazar el valor existente mediante la eliminación de CTRL-A
|
ReplaceExistingValueUsingCTRLADelete | boolean |
¿Debe reemplazarse cualquier valor existente presionando Ctrl-A (para resaltar todo) y, a continuación, eliminarlo? Es posible que algunos elementos no admitan el resaltado con Ctrl-A en cuyo caso se debe probar la opción alternativa de "Reemplazar el valor existente mediante la eliminación doble del clic del mouse". |
|
|
Contraseña que se va a escribir
|
PasswordToInput | True | password |
Valor de contraseña para la entrada global mediante el teclado. |
|
Uso de eventos de clave de envío
|
SendKeyEvents | boolean |
Si se establece en true, se usarán los eventos de clave de envío (una API de nivel inferior que envía pulsaciones de teclas simuladas al sistema operativo). Si se establece en false, se usarán claves de envío (una API de nivel superior que envía pulsaciones de tecla al elemento centrado). |
|
|
Intervalo en milisegundos
|
Interval | integer |
Número de milisegundos entre cada pulsación de tecla. |
|
|
No interpretar símbolos
|
DontInterpretSymbols | boolean |
¿Deben no interpretarse los símbolos de la 'Contraseña para la entrada' como teclas especiales (por ejemplo, + para Mayús, ^ para Ctrl)? Debe establecerse en true si intenta introducir los símbolos reales. |
|
|
La contraseña contiene contraseña almacenada
|
PasswordContainsStoredPassword | boolean |
Se establece en true si la contraseña contiene (o es completamente) un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. Esta contraseña almacenada podría haber sido generada por la acción "Generar contraseña", por ejemplo, o que la IA-Connect Orchestrator lo mantenga. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Dibujar rectángulo alrededor del elemento UIA
Dibuja un rectángulo alrededor del perímetro de un elemento para ayudar a identificar que el elemento encontrado es el necesario. El rectángulo se quita automáticamente después de 5 segundos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Color de lápiz
|
PenColour | string |
Color del rectángulo que se va a dibujar (por ejemplo, rojo, verde, azul, amarillo, púrpura o naranja) o un código hexadecimal de cadena, por ejemplo, #FF0000. |
|
|
Píxeles de grosor del lápiz
|
PenThicknessPixels | integer |
Grosor (en píxeles) del borde del rectángulo resaltado. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Elemento UIA de foco
Centra un elemento que lo convierte en el elemento activo para el foco del teclado y, dependiendo de la aplicación, puede llevar la ventana de elemento al primer plano.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Entrada devuelta en el elemento UIA
Introduce una línea de retorno o nueva de Windows en un elemento (normalmente un campo de entrada de texto), reemplazando el texto existente o insertando el valor devuelto en una posición específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Reemplazar el valor existente
|
ReplaceExistingValue | boolean |
Si hay texto existente en el elemento, ¿debe reemplazarse? |
|
|
Insertar posición
|
InsertPosition | integer |
Posición (índice) para empezar a insertar texto. Si hay texto existente, la posición de inserción se puede usar para insertar en una posición específica dentro del texto existente. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Se produce una excepción si se produce un error en la validación de entrada
|
RaiseExceptionIfInputValidationFails | boolean |
Si está habilitado, el agente de IA-Connect comprobará el nuevo valor del elemento después de introducir el texto solicitado. Si el nuevo valor no coincide con el valor esperado, se generará una excepción. Si esta entrada es false (valor predeterminado), se escribirá una advertencia en el registro, pero no se generará ninguna excepción. |
|
|
Probar patrón de valor
|
TryValuePattern | boolean |
Si se establece en true (valor predeterminado), el agente de IA-Connect intentará usar un patrón de valor UIA para realizar la acción de entrada de texto. Si el patrón de valor UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de valor y volverá inmediatamente a otros patrones elegidos. |
|
|
Prueba del patrón heredado
|
TryLegacyPattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón heredado de UIA para realizar la acción de entrada de texto si el patrón de valor no está disponible (ya sea porque no está presente en el elemento o porque su uso estaba deshabilitado). |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Espera a la ventana win32 de nivel superior de UIA
Una acción rápida de Win32 que espera un tiempo especificado para que exista una ventana win32 de nivel superior antes de devolver un identificador UIA. Una ventana de nivel superior es una que está conectada al escritorio. Puede buscar por nombre de clase o título de ventana, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. Es más común usar la acción de UIA "Esperar elemento de escritorio", que es más eficaz, pero esta acción win32 normalmente se ejecuta más rápido.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de clase de búsqueda
|
SearchClassName | string |
Nombre de clase de elemento de la ventana de nivel superior que se va a buscar, por ejemplo, "Bloc de notas". |
|
|
Título de la ventana de búsqueda
|
SearchWindowTitle | string |
Título de la ventana de nivel superior que se va a buscar. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se va a esperar a que exista la ventana. |
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Identificador de proceso opcional del proceso que posee la ventana (por ejemplo, según lo proporcionado por la salida de la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o Sesión). Establézcalo en 0 para no buscar por identificador de proceso. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales en las propiedades de ventana disponibles. Ejemplo 1: [Width] < 200. Ejemplo 2: [Title] como '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varias ventanas coinciden con la búsqueda, esto le permite especificar la propiedad de ventana por la que ordenar. Se usará junto con "Match index" (Índice de coincidencia) para seleccionar la ventana necesaria. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, se devolverá la ventana coincidente más cercana a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varias ventanas coinciden con la búsqueda, debe coincidir "Índice de coincidencia" desde la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Generar excepción si no se encuentra la ventana
|
RaiseExceptionIfWindowNotFound | boolean |
¿Debería IA-Connect generar una excepción si la ventana win32 de búsqueda no existe después del período de espera? |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si la ventana existe o false si no es así. |
Esperar a la ventana principal del identificador de proceso de UIA
Una acción Win32 sencilla y rápida que espera a que exista una ventana principal de un proceso (especificado por id. de proceso) y devuelva un identificador. La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de proceso de búsqueda
|
ProcessId | True | integer |
Identificador del proceso que se va a esperar (tal como se proporciona en la acción "Ejecutar proceso" en las acciones del entorno o sesión de IA-Connect). |
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se esperará a la ventana principal del proceso. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si el elemento existe o false si no. |
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
Esperar a la ventana principal del proceso de UIA
Una acción Win32 sencilla y rápida que espera a que exista una ventana principal de un proceso (especificado por nombre) antes de devolver un identificador. La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del proceso de búsqueda
|
SearchProcessName | True | string |
Nombre del proceso que se va a buscar, por ejemplo, bloc de notas. |
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se esperará a la ventana principal del proceso. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si la ventana existe o false si no es así. |
Esperar al elemento de escritorio de UIA
Espera a que exista un elemento de escritorio (normalmente una ventana).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Si se especifica (un valor de 1 o superior), la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco (o 0). |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se va a esperar a que exista el elemento. |
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se devolverá un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Generar excepción si no se encuentra el elemento
|
RaiseExceptionIfElementNotFound | boolean |
¿Debe IA-Connect generar una excepción si el elemento UIA no existe después del período de espera? |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si el elemento existe o false si no. |
|
Identificador de elemento
|
ElementHandle | integer |
Identificador UIA del elemento. Esto se puede usar como entrada para realizar acciones UIA adicionales que actúan en este elemento. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |
Esperar al elemento UIA
Espera a que exista un elemento (normalmente un elemento individual dentro de una ventana, como un botón o un área de entrada de texto).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Si se especifica (un valor de 1 o superior), la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco (o 0). |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se va a esperar a que exista el elemento. |
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se devolverá un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Generar excepción si no se encuentra el elemento
|
RaiseExceptionIfElementNotFound | boolean |
¿Debe IA-Connect generar una excepción si el elemento UIA no existe después del período de espera? |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si el elemento existe o false si no. |
|
Identificador de elemento
|
ElementHandle | integer |
Identificador UIA del elemento. Esto se puede usar como entrada para realizar acciones UIA adicionales que actúan en este elemento. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |
Esperar la imagen de búsqueda visible dentro del elemento UIA
Espera hasta que una imagen de búsqueda, proporcionada como entrada a esta acción, se encuentra visiblemente dentro de un elemento UIA en pantalla o la cantidad de tiempo especificada. El elemento se debe traer primero al principio, ya que el Agente toma una captura de pantalla en las coordenadas del elemento y busca la imagen de búsqueda proporcionada dentro de la captura de pantalla. El elemento UIA debe existir desde el principio. La acción se completa inmediatamente una vez que se encuentra la imagen.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipo de imagen de búsqueda
|
SearchImageType | string |
Define lo que representa la entrada "Imagen de búsqueda". Si se establece en "Archivo de imagen de director", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el director. Si se establece en "Archivo de imagen del agente", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el Agente. Si se establece en "Base64", la imagen de búsqueda es una representación base64 de la imagen. |
|
|
Imagen de búsqueda
|
SearchImage | string |
Imagen de búsqueda que se va a buscar en el elemento UIA especificado. Según el tipo de imagen de búsqueda especificado, esto podría contener la ruta de acceso a un archivo de imagen (en el extremo director o agente) o contener la base64 (representación de texto) de la imagen que se va a buscar. |
|
|
Tipo de imagen de búsqueda alternativa
|
AltSearchImageType | string |
Define lo que representa la entrada "Imagen de búsqueda alternativa". Si se establece en "Ninguno" o en blanco, no hay ninguna imagen de búsqueda alternativa. Si se establece en "Archivo de imagen de director", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el director. Si se establece en "Archivo de imagen del agente", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el Agente. Si se establece en "Base64", la imagen de búsqueda es una representación base64 de la imagen. |
|
|
Imagen de búsqueda alternativa
|
AltSearchImage | string |
Imagen de búsqueda alternativa opcional para buscar dentro del elemento UIA especificado. Según el tipo de imagen de búsqueda alternativo especificado, esto podría contener la ruta de acceso a un archivo de imagen (en el extremo director o agente) o contener la base64 (representación de texto) de la imagen que se va a buscar. Si especifica una imagen de búsqueda alternativa, el Agente buscará la imagen de búsqueda alternativa o la imagen de búsqueda alternativa e informará de cuál se encontraba. |
|
|
Desviación máxima del color
|
MaxColourDeviation | integer |
El máximo de colores de píxeles de un elemento puede desviarse de los colores del píxel de la imagen de búsqueda antes de que no se considere una coincidencia. 0 para ninguna desviación. La desviación se mide en valores RGB. Por ejemplo: #FF0000 es 4 diferente de #FE0102. Esto permite omitir las pequeñas diferencias de coloración. |
|
|
Diferencias máximas de píxeles
|
MaxPixelDifferences | integer |
El número máximo de píxeles que pueden diferir (por encima de la desviación máxima de color), en toda la imagen de búsqueda, antes de que se considere que una imagen no coincide. Esto permite omitir las diferencias menores entre las imágenes, pero los valores más altos pueden aumentar el tiempo necesario para localizar una imagen. Se recomienda establecer en 0 y aumentar por pequeñas cantidades si es necesario. Si se establece en un valor superior a 0, también debe establecer "Diferencias máximas de píxeles consecutivos". |
|
|
Diferencias máximas de píxeles consecutivos
|
MaxConsecutivePixelDifferences | integer |
Número máximo de píxeles que pueden diferir (por encima de la desviación máxima de color), en cualquier fila, antes de que se considere que una imagen no coincide. Esto permite omitir las diferencias menores entre las imágenes, pero los valores más altos pueden aumentar el tiempo necesario para localizar una imagen. Se recomienda establecer en 0 y aumentar por pequeñas cantidades si es necesario. Si establece en un valor superior a 0, también debe establecer "Diferencias máximas de píxeles". |
|
|
Desplazamiento X del píxel izquierdo
|
LeftPixelXOffset | integer |
Desplazamiento X opcional para el borde izquierdo del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento X de píxel derecho
|
RightPixelXOffset | integer |
Desplazamiento X opcional para el borde derecho del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel superior
|
TopPixelYOffset | integer |
Desplazamiento Y opcional para el borde superior del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel inferior
|
BottomPixelYOffset | integer |
Desplazamiento Y opcional para el borde inferior del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Unidad de desplazamiento de Píxel X
|
PixelXOffsetsUnit | string |
Se establece en "Píxel" (valor predeterminado) si los desplazamientos X de píxel izquierdo y derecho se miden en píxeles. Establézcalo en "Porcentaje" si los desplazamientos X de píxel izquierdo y derecho se miden como un porcentaje del ancho del elemento. |
|
|
Unidad de desplazamiento de píxeles Y
|
PixelYOffsetsUnit | string |
Establézcalo en "Píxel" (valor predeterminado) si los desplazamientos Y de píxel superior e inferior se miden en píxeles. Establézcalo en "Porcentaje" si los desplazamientos Y de píxel superior e inferior se miden como un porcentaje del alto del elemento. |
|
|
Índice de imagen de búsqueda
|
SearchImageIndex | integer |
Establézcalo en 1 para buscar la primera instancia de la imagen de búsqueda (en la dirección de la búsqueda) dentro del elemento UIA. Establezca en 2 para la segunda instancia, .... , N para la instancia N. Si también está buscando una imagen alternativa, el elemento UIA se examina primero para la imagen de búsqueda y, en segundo lugar, para la imagen alternativa, buscando la instancia solicitada de esa imagen concreta (es decir, el Agente espera una o la otra, no una combinación de ambas imágenes). |
|
|
Dirección de búsqueda de imágenes
|
ImageSearchDirection | string |
Dirección de búsqueda. 'Desde la parte superior' busca por fila desde la parte superior, examinando de izquierda a derecha dentro de cada fila. 'Desde abajo' busca por fila desde la parte inferior, examinando de izquierda a derecha dentro de cada fila. 'Desde la izquierda' busca por columna de la izquierda, examinando de arriba a abajo dentro de cada columna. 'Desde la derecha' busca por columna desde la derecha, examinando de arriba abajo dentro de cada columna. Esto se puede usar junto con "Search image index" (Índice de imagen de búsqueda) para buscar la imagen Nth desde la parte superior, inferior, izquierda o derecha. Para mejorar el rendimiento, seleccione la dirección de búsqueda que cree que localizará la imagen más rápido. |
|
|
Ocultar agente
|
HideAgent | boolean |
Establézcalo en true para ocultar automáticamente el Agente (si está visible) para asegurarse de que no oculta el elemento que se analiza. |
|
|
Devolver coordenadas de pantalla como físicas
|
ReturnPhysicalCoordinates | boolean |
Establézcalo en true para que las coordenadas de la pantalla se devuelvan como coordenadas físicas. Establézcalo en false para que las coordenadas de pantalla se devuelvan como coordenadas virtuales. Si el escalado de pantalla subyacente es de 100%, las coordenadas físicas y virtuales son las mismas. Las coordenadas de elemento siempre se devuelven como coordenadas virtuales. |
|
|
Mostrar rectángulo resaltado
|
ShowHighlightRectangle | boolean |
Si se establece en true, el agente de IA-Connect resaltará la imagen ubicada en la pantalla. Esto puede ser útil durante el desarrollo, para ayudar a visualizar que se detecta la imagen correcta. |
|
|
Segundos para esperar la imagen de búsqueda
|
SecondsToWait | integer |
Número de segundos que se va a esperar a que la imagen de búsqueda se encuentre dentro del elemento UIA. Si no se encuentra la imagen, se producirá una excepción si "Raise exception if image not found" (Generar excepción si no se encuentra la imagen) está establecida en true; de lo contrario, la acción notificará que la imagen no se encuentra. |
|
|
Milisegundos entre búsquedas
|
MillisecondsBetweenSearches | integer |
Número de milisegundos que se van a esperar entre cada elemento UIA en el examen en pantalla. Dado que el reconocimiento de imágenes puede ser costoso para la CPU, un retraso puede ayudar a reducir y distribuir la utilización de la CPU. Por ejemplo: Si espera que una imagen tarde hasta 1 minuto en estar visible, agregar una pausa de 5000 milisegundos (5 segundos) entre exámenes reducirá significativamente la utilización de la CPU (reduciendo considerablemente el número de exámenes), pero solo tendrá un impacto pequeño en el tiempo de respuesta. El valor mínimo permitido es de 100 milisegundos (1/10 segundos). |
|
|
Generar excepción si no se encuentra la imagen
|
RaiseExceptionIfImageNotFound | boolean |
Establézcalo en true si IA-Connect debe generar una excepción si no se pudo encontrar la imagen después del período de espera. |
|
|
Recuperación de datos de salida para el identificador de subproceso
|
RetrieveOutputDataFromThreadId | integer |
Si ha establecido previamente "Esperar subproceso" en false (lo que hace que el Agente realice la espera en un subproceso en segundo plano), proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. De lo contrario, establezca en 0 (valor predeterminado). |
|
|
Esperar subproceso
|
WaitForThread | boolean |
Establézcalo en true para esperar a que se complete el subproceso del Agente; El agente esperará mientras se especifique "Segundos para esperar la imagen de búsqueda". Establézcalo en false para omitir la espera; El agente seguirá realizando la espera en segundo plano, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Esperar la imagen de búsqueda visible dentro del elemento UIA" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Imagen de búsqueda ubicada
|
SearchImageLocated | boolean |
Esta salida se establecerá en true, si se encuentra la imagen de búsqueda. Esta salida se establecerá en false, si no se encuentra la imagen de búsqueda. |
|
Qué imagen de búsqueda se encuentra
|
WhichSearchImageLocated | integer |
Esta salida se establecerá en 0, si no se encontraron imágenes de búsqueda. Establézcalo en 1, si se encuentra la imagen de búsqueda. Establézcalo en 2, si se encuentra la imagen de búsqueda alternativa. |
|
Elemento de cuadro de selección de coincidencia de imagen
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Coordenada X virtual del píxel izquierdo que coincide con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Píxel derecho del elemento rectángulo de selección de imagen
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Coordenada X virtual del píxel más derecho que coincide con la imagen especificada, en relación con el elemento virtual de arriba a la izquierda. |
|
Elemento de cuadro de límite de coincidencia de imagen
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Coordenada Y virtual del píxel superior que coincide con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Píxel inferior del elemento de cuadro de selección de coincidencia de imagen
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Coordenada Y virtual del píxel inferior que coincide con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Imagen que coincide con el elemento de cuadro de selección centro X píxel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Coordenada X virtual del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Imagen que coincide con el elemento de rectángulo delimitador Y del centro de píxeles
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Coordenada Y virtual del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada, en relación con el elemento virtual de la parte superior izquierda. |
|
Imagen que coincide con el píxel izquierdo de la pantalla del rectángulo de selección
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Coordenada X de píxel de pantalla del píxel izquierdo que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel derecho de la pantalla del cuadro de límite de coincidencia de imagen
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Coordenada X del píxel de pantalla del píxel más derecho que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel superior de la pantalla del cuadro de límite de coincidencia de imagen
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Coordenada Y de píxel de pantalla del píxel superior que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel inferior de la pantalla del cuadro de selección de coincidencia de imagen
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Coordenada Y del píxel de pantalla de la parte inferior que coincide con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Imagen que coincide con el rectángulo de selección del centro de pantalla X píxel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Coordenada X del píxel de pantalla del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Imagen que coincida con el rectángulo de selección del centro de pantalla Y píxel
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Coordenada Y del píxel de pantalla del centro del cuadro de límite que contiene píxeles que coinciden con la imagen especificada. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Identificador de subproceso
|
ThreadId | integer |
Si ha establecido "Esperar subproceso" en false (lo que hace que el Agente realice la espera en un subproceso en segundo plano), esta salida contendrá el identificador de subproceso del agente que se puede usar para supervisar el proceso de la acción y recuperar los resultados más adelante, cuando se haya completado el subproceso. |
Espere a que el elemento de escritorio UIA no exista
Espera a que un elemento de escritorio (normalmente una ventana) ya no exista.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Si se especifica (un valor de 1 o superior), la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco (o 0). |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se va a esperar a que el elemento no exista. |
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se devolverá un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Generar excepción si el elemento sigue existiendo
|
RaiseExceptionIfElementStillExists | boolean |
¿Debe IA-Connect generar una excepción si el elemento UIA sigue existiendo después del período de espera? |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe antes de esperar
|
ElementExistsBeforeWait | boolean |
Devuelve true si el elemento existía antes de esperar o false si no. |
|
El elemento existe después de esperar
|
ElementExistsAfterWait | boolean |
Devuelve true si el elemento existía después de esperar o false si no. |
Espere a que el elemento UIA no exista
Espera a que un elemento (normalmente un elemento individual dentro de una ventana, como un botón o un área de entrada de texto) ya no exista.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Si se especifica (un valor de 1 o superior), la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco (o 0). |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
Número máximo de segundos que se va a esperar a que el elemento no exista. |
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se devolverá un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Generar excepción si el elemento sigue existiendo
|
RaiseExceptionIfElementStillExists | boolean |
¿Debe IA-Connect generar una excepción si el elemento UIA sigue existiendo después del período de espera? |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe antes de esperar
|
ElementExistsBeforeWait | boolean |
Devuelve true si el elemento existía antes de esperar o false si no. |
|
El elemento existe después de esperar
|
ElementExistsAfterWait | boolean |
Devuelve true si el elemento existía después de esperar o false si no. |
Espere a que la imagen de búsqueda visible no exista en el elemento UIA.
Espera hasta que una imagen de búsqueda, proporcionada como entrada a esta acción, no se puede ubicar visiblemente (o nunca se encontró) dentro de un elemento UIA en pantalla, o la cantidad de tiempo especificada ha pasado y la imagen sigue presente. El elemento se debe traer primero al principio, ya que el Agente toma una captura de pantalla en las coordenadas del elemento y busca la imagen de búsqueda proporcionada dentro de la captura de pantalla. El elemento UIA debe existir desde el principio. La acción se completa inmediatamente una vez que la imagen ya no está presente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipo de imagen de búsqueda
|
SearchImageType | string |
Define lo que representa la entrada "Imagen de búsqueda". Si se establece en "Archivo de imagen de director", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el director. Si se establece en "Archivo de imagen del agente", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el Agente. Si se establece en "Base64", la imagen de búsqueda es una representación base64 de la imagen. |
|
|
Imagen de búsqueda
|
SearchImage | string |
Imagen de búsqueda que se va a buscar en el elemento UIA especificado. Según el tipo de imagen de búsqueda especificado, esto podría contener la ruta de acceso a un archivo de imagen (en el extremo director o agente) o contener la base64 (representación de texto) de la imagen que se va a buscar. |
|
|
Tipo de imagen de búsqueda alternativa
|
AltSearchImageType | string |
Define lo que representa la entrada "Imagen de búsqueda alternativa". Si se establece en "Ninguno" o en blanco, no hay ninguna imagen de búsqueda alternativa. Si se establece en "Archivo de imagen de director", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el director. Si se establece en "Archivo de imagen del agente", la imagen de búsqueda es una ruta de acceso a un archivo accesible para el Agente. Si se establece en "Base64", la imagen de búsqueda es una representación base64 de la imagen. |
|
|
Imagen de búsqueda alternativa
|
AltSearchImage | string |
Imagen de búsqueda alternativa opcional para buscar dentro del elemento UIA especificado. Según el tipo de imagen de búsqueda alternativo especificado, esto podría contener la ruta de acceso a un archivo de imagen (en el extremo director o agente) o contener la base64 (representación de texto) de la imagen que se va a buscar. Si especifica una imagen de búsqueda alternativa, el Agente buscará la imagen de búsqueda alternativa o la imagen de búsqueda alternativa e informará de cuál se encontraba. |
|
|
Desviación máxima del color
|
MaxColourDeviation | integer |
El máximo de colores de píxeles de un elemento puede desviarse de los colores del píxel de la imagen de búsqueda antes de que no se considere una coincidencia. 0 para ninguna desviación. La desviación se mide en valores RGB. Por ejemplo: #FF0000 es 4 diferente de #FE0102. Esto permite omitir las pequeñas diferencias de coloración. |
|
|
Diferencias máximas de píxeles
|
MaxPixelDifferences | integer |
El número máximo de píxeles que pueden diferir (por encima de la desviación máxima de color), en toda la imagen de búsqueda, antes de que se considere que una imagen no coincide. Esto permite omitir las diferencias menores entre las imágenes, pero los valores más altos pueden aumentar el tiempo necesario para localizar una imagen. Se recomienda establecer en 0 y aumentar por pequeñas cantidades si es necesario. Si se establece en un valor superior a 0, también debe establecer "Diferencias máximas de píxeles consecutivos". |
|
|
Diferencias máximas de píxeles consecutivos
|
MaxConsecutivePixelDifferences | integer |
Número máximo de píxeles que pueden diferir (por encima de la desviación máxima de color), en cualquier fila, antes de que se considere que una imagen no coincide. Esto permite omitir las diferencias menores entre las imágenes, pero los valores más altos pueden aumentar el tiempo necesario para localizar una imagen. Se recomienda establecer en 0 y aumentar por pequeñas cantidades si es necesario. Si establece en un valor superior a 0, también debe establecer "Diferencias máximas de píxeles". |
|
|
Desplazamiento X del píxel izquierdo
|
LeftPixelXOffset | integer |
Desplazamiento X opcional para el borde izquierdo del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento X de píxel derecho
|
RightPixelXOffset | integer |
Desplazamiento X opcional para el borde derecho del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel superior
|
TopPixelYOffset | integer |
Desplazamiento Y opcional para el borde superior del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel inferior
|
BottomPixelYOffset | integer |
Desplazamiento Y opcional para el borde inferior del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Unidad de desplazamiento de Píxel X
|
PixelXOffsetsUnit | string |
Se establece en "Píxel" (valor predeterminado) si los desplazamientos X de píxel izquierdo y derecho se miden en píxeles. Establézcalo en "Porcentaje" si los desplazamientos X de píxel izquierdo y derecho se miden como un porcentaje del ancho del elemento. |
|
|
Unidad de desplazamiento de píxeles Y
|
PixelYOffsetsUnit | string |
Establézcalo en "Píxel" (valor predeterminado) si los desplazamientos Y de píxel superior e inferior se miden en píxeles. Establézcalo en "Porcentaje" si los desplazamientos Y de píxel superior e inferior se miden como un porcentaje del alto del elemento. |
|
|
Índice de imagen de búsqueda
|
SearchImageIndex | integer |
Establézcalo en 1 para buscar la primera instancia de la imagen de búsqueda (en la dirección de la búsqueda) dentro del elemento UIA. Establezca en 2 para la segunda instancia, .... , N para la instancia N. Si también está buscando una imagen alternativa, el elemento UIA se examina primero para la imagen de búsqueda y, en segundo lugar, para la imagen alternativa, buscando la instancia solicitada de esa imagen concreta (es decir, el Agente espera una o la otra, no una combinación de ambas imágenes). |
|
|
Dirección de búsqueda de imágenes
|
ImageSearchDirection | string |
Dirección de búsqueda. 'Desde la parte superior' busca por fila desde la parte superior, examinando de izquierda a derecha dentro de cada fila. 'Desde abajo' busca por fila desde la parte inferior, examinando de izquierda a derecha dentro de cada fila. 'Desde la izquierda' busca por columna de la izquierda, examinando de arriba a abajo dentro de cada columna. 'Desde la derecha' busca por columna desde la derecha, examinando de arriba abajo dentro de cada columna. Esto se puede usar junto con "Search image index" (Índice de imagen de búsqueda) para buscar la imagen Nth desde la parte superior, inferior, izquierda o derecha. Para mejorar el rendimiento, seleccione la dirección de búsqueda que cree que localizará la imagen más rápido. |
|
|
Ocultar agente
|
HideAgent | boolean |
Establézcalo en true para ocultar automáticamente el Agente (si está visible) para asegurarse de que no oculta el elemento que se analiza. |
|
|
Mostrar rectángulo resaltado
|
ShowHighlightRectangle | boolean |
Si se establece en true, el agente de IA-Connect resaltará la imagen ubicada en la pantalla. Esto puede ser útil durante el desarrollo, para ayudar a visualizar que se detecta la imagen correcta. |
|
|
Segundos para esperar a que la imagen de búsqueda no exista
|
SecondsToWait | integer |
Número de segundos que se espera a que la imagen de búsqueda no se encuentre visiblemente dentro del elemento UIA. Si la imagen sigue presente después de este tiempo, se producirá una excepción si "Raise exception if image is still present" (Generar excepción si la imagen sigue presente) está establecida en true; de lo contrario, la acción notificará que la imagen sigue presente. |
|
|
Milisegundos entre búsquedas
|
MillisecondsBetweenSearches | integer |
Número de milisegundos que se van a esperar entre cada elemento UIA en el examen en pantalla. Dado que el reconocimiento de imágenes puede ser costoso para la CPU, un retraso puede ayudar a reducir y distribuir la utilización de la CPU. Por ejemplo: Si espera que una imagen tarde hasta 1 minuto en estar visible, agregar una pausa de 5000 milisegundos (5 segundos) entre exámenes reducirá significativamente la utilización de la CPU (reduciendo considerablemente el número de exámenes), pero solo tendrá un impacto pequeño en el tiempo de respuesta. El valor mínimo permitido es de 100 milisegundos (1/10 segundos). |
|
|
Generar excepción si la imagen sigue presente
|
RaiseExceptionIfImageStillPresent | boolean |
Establézcalo en true si IA-Connect debe generar una excepción si la imagen sigue presente después del período de espera. |
|
|
Recuperación de datos de salida para el identificador de subproceso
|
RetrieveOutputDataFromThreadId | integer |
Si ha establecido previamente "Esperar subproceso" en false (lo que hace que el Agente realice la espera en un subproceso en segundo plano), proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. De lo contrario, establezca en 0 (valor predeterminado). |
|
|
Esperar subproceso
|
WaitForThread | boolean |
Establézcalo en true para esperar a que se complete el subproceso del Agente; El agente esperará siempre que se especifique en "Seconds to wait for search image to not exist" (Segundos para esperar a que la imagen de búsqueda no exista). Establézcalo en false para omitir la espera; El Agente seguirá realizando la espera en un subproceso en segundo plano, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Esperar a que la imagen de búsqueda visible no exista dentro del elemento UIA" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Imagen de búsqueda presente antes de esperar
|
SearchImagePresentBeforeWait | boolean |
Esta salida se establecerá en true, si la imagen de búsqueda estaba presente al principio del período de espera. Esta salida se establecerá en false, si la imagen de búsqueda no estaba presente desde el principio. |
|
La imagen de búsqueda sigue presente después de la espera
|
SearchImageStillPresentAfterWait | boolean |
Esta salida se establecerá en true, si la imagen de búsqueda sigue presente, después del período de espera. Esta salida se establecerá en false, si la imagen de búsqueda ya no está presente, durante el período de espera (la acción se completa inmediatamente una vez que la imagen ya no está presente). |
|
Qué imagen de búsqueda sigue presente
|
WhichSearchImageStillPresent | integer |
Esta salida se establecerá en 0, si aún no hay imágenes de búsqueda presentes, después del período de espera. Establézcalo en 1, si la imagen de búsqueda todavía estaba presente, después del período de espera. Establézcalo en 2, si la imagen de búsqueda alternativa todavía estaba presente, después del período de espera. |
|
Identificador de subproceso
|
ThreadId | integer |
Si ha establecido "Esperar subproceso" en false (lo que hace que el Agente realice la espera en un subproceso en segundo plano), esta salida contendrá el identificador de subproceso del agente que se puede usar para supervisar el proceso de la acción y recuperar los resultados más adelante, cuando se haya completado el subproceso. |
Establecer el elemento UIA en un valor de intervalo numérico
Establece el valor del elemento que tiene un intervalo numérico, por ejemplo, una barra de desplazamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Nuevo valor
|
NewValue | True | double |
Valor de intervalo numérico en el que se va a establecer el elemento. |
|
El nuevo valor es porcentaje
|
NewValueIsPercentage | boolean |
¿El nuevo valor es un porcentaje? |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Establecer el elemento UIA en un valor numérico
Establece el valor del elemento que tiene una entrada numérica, por ejemplo, un campo de texto o una barra de desplazamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Nuevo valor
|
NewValue | True | integer |
Valor numérico en el que se va a establecer el elemento. |
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Se produce una excepción si se produce un error en la validación de entrada
|
RaiseExceptionIfInputValidationFails | boolean |
Si está habilitado, el agente de IA-Connect comprobará el nuevo valor del elemento después de introducir el texto solicitado. Si el nuevo valor no coincide con el valor esperado, se generará una excepción. Si esta entrada es false (valor predeterminado), se escribirá una advertencia en el registro, pero no se generará ninguna excepción. |
|
|
Probar patrón de valor
|
TryValuePattern | boolean |
Si se establece en true (valor predeterminado), el agente de IA-Connect intentará usar un patrón de valor UIA para realizar la acción de entrada de texto. Si el patrón de valor UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de valor y volverá inmediatamente a otros patrones elegidos. |
|
|
Prueba del patrón heredado
|
TryLegacyPattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón heredado de UIA para realizar la acción de entrada de texto si el patrón de valor no está disponible (ya sea porque no está presente en el elemento o porque su uso estaba deshabilitado). |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Establecer el modo de búsqueda de elementos UIA
Elija el modo de búsqueda de elementos UIA que debe usar el agente de IA-Connect al realizar acciones de UIA. Normalmente, esta acción solo se usaría si tiene un problema con el modo predeterminado (Buscar todo).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Modo de búsqueda de elementos UIA
|
UIAElementSearchMode | True | string |
Modo de búsqueda de elementos UIA que se va a usar. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Resultado del comando
|
SetUIAElementSearchModeResult | boolean |
Resultado del comando (correcto o erróneo). |
|
Mensaje de error
|
ErrorMessage | string |
Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió. |
Establecer la ventana de UIA en normal
Normaliza la ventana con el identificador UIA especificado (es decir, lo establece en una ventana de tamaño normal en lugar de minimizar o maximizar).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | True | integer |
Identificador UIA para la ventana que se va a normalizar. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Establecer la ventana de UIA en primer plano
Trae una ventana al primer plano.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | True | integer |
Identificador UIA de la ventana que se debe establecer como la ventana de primer plano. |
|
Ventana de alternancia
|
ToggleWindow | boolean |
¿Debe alternarse la ventana intentando centrarse o hacer clic en ella? Esto ayuda a garantizar que la ventana se lleve de forma confiable al primer plano. |
|
|
Alternancia usa el agente de clic del mouse izquierdo global
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
Si elige alternar la ventana, especifica si se deben usar clics globales del mouse para centrar primero el agente de IA-Connect. |
|
|
Alternar retraso en segundos
|
ToggleDelay | double |
Si elige alternar la ventana, especifica la pausa después de alternar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Establecer porcentaje de desplazamiento de elementos UIA
Establezca el porcentaje de desplazamiento horizontal o vertical del elemento especificado, si ese elemento admite el desplazamiento. Si el elemento admite el patrón "scroll", puede aplicar esta acción directamente al elemento y especificar una cantidad de desplazamiento horizontal o vertical (o ambas). Si el elemento no admite el patrón "scroll", esta acción se revertirá a los patrones "range value" o "value", pero deberá aplicarlos directamente a los controles de barra de desplazamiento, no al propio elemento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Porcentaje de desplazamiento horizontal
|
HorizontalScrollPercentage | double |
Posición para desplazar horizontalmente el elemento (de 0 a 100 inclusive, decimales admitidos) o -1 para dejar la posición de desplazamiento horizontal sin cambios. |
|
|
Porcentaje de desplazamiento vertical
|
VerticalScrollPercentage | double |
Posición para desplazar verticalmente el elemento (de 0 a 100 inclusive, decimales admitidos) o -1 dejar la posición de desplazamiento vertical sin cambios. |
|
|
Prueba del patrón de desplazamiento
|
TryScrollPattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón de desplazamiento UIA para realizar la acción de desplazamiento. Si el patrón de desplazamiento UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones elegidos (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de desplazamiento y volverá inmediatamente a otros patrones elegidos. El orden de los patrones intentados (si está habilitado a través de entradas para esta acción) son el desplazamiento, el valor de intervalo y el valor. |
|
|
Probar el patrón de valor de rango
|
TryRangeValuePattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón de valor de intervalo UIA para realizar la acción de desplazamiento. Si el patrón de valor del intervalo UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones elegidos (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de valor de intervalo y volverá inmediatamente a otros patrones elegidos. El orden de los patrones intentados (si está habilitado a través de entradas para esta acción) son el desplazamiento, el valor de intervalo y el valor. |
|
|
Probar patrón de valor
|
TryValuePattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón de valor UIA para realizar la acción de desplazamiento. Si el patrón de valor UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones elegidos (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de valor y volverá inmediatamente a otros patrones elegidos. El orden de los patrones intentados (si está habilitado a través de entradas para esta acción) son el desplazamiento, el valor de intervalo y el valor. Advertencia: El uso de un patrón de valor en un elemento de edición simplemente escribirá el valor en el elemento de edición. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Resultado del comando
|
UIASetElementScrollPercentageResult | boolean |
Resultado del comando (correcto o erróneo). |
|
Mensaje de error
|
ErrorMessage | string |
Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió. |
Establecimiento del tiempo de espera de transacción de UIA
Controla cuánto tiempo esperará la API de UIA a que una aplicación devuelva la información sobre un elemento. Este tiempo de espera de transacción normalmente solo se alcanzaría si la aplicación no responde.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tiempo de espera en segundos
|
TimeoutInSeconds | True | double |
El período máximo de tiempo que la API de UIA esperará a que una aplicación devuelva la información sobre un elemento. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Expandir el elemento UIA
Expande un elemento (normalmente un elemento de menú o desplegable). Si el elemento ya está expandido, no ocurrirá nada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Global mouse click UIA element search color region (Región de color de búsqueda de elementos UIA)
Mueve el mouse sobre una región de píxeles dentro de un elemento UIA que cumple los criterios de color especificados y realiza un clic del mouse. El elemento se debe traer primero al principio, ya que la captura de pantalla está tomando una copia de la pantalla en la ubicación de los elementos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Color de búsqueda
|
SearchColour | True | string |
Color de búsqueda en el formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB o #RRGGBB donde cada canal de color es un byte en formato hexadecimal (00 está totalmente desactivado, FF está totalmente activado). Por ejemplo: #FF0000 para rojo, #00FF00 para azul, #000000 para negro, #FFFFFF para blanco. |
|
Desviación máxima del color
|
MaxColourDeviation | True | integer |
El color máximo de un elemento puede desviarse del color de búsqueda antes de que no se considere una coincidencia. 0 para ninguna desviación. La desviación se mide en valores RGB. Por ejemplo: #FF0000 es 4 diferente de #FE0102. Una desviación de 15 sería un buen punto de partida. |
|
Desplazamiento X del píxel izquierdo
|
LeftPixelXOffset | integer |
Desplazamiento X opcional para el borde izquierdo del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento X de píxel derecho
|
RightPixelXOffset | integer |
Desplazamiento X opcional para el borde derecho del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel superior
|
TopPixelYOffset | integer |
Desplazamiento Y opcional para el borde superior del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel inferior
|
BottomPixelYOffset | integer |
Desplazamiento Y opcional para el borde inferior del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Botón del mouse
|
MouseButton | string |
Botón del mouse que se va a presionar (Izquierda, Derecha, Centro, Doble izquierda). |
|
|
Hacer clic en desplazamiento X
|
ClickOffsetX | integer |
Número de píxeles X para desplazar la acción de clic por. Este parámetro admite valores de desplazamiento positivo (derecho) y negativo (izquierdo). |
|
|
Haga clic en Desplazamiento Y.
|
ClickOffsetY | integer |
Número de píxeles Y por el que se va a desplazar la acción de clic. Este parámetro admite valores de desplazamiento positivo (abajo) y negativo (hacia arriba). |
|
|
Desplazamiento relativo a
|
OffsetRelativeTo | string |
Posición relativa de la región de color que se va a desplazar de (Centro / Centro / Centro, Izquierda, Derecha, Superior, Inferior, Superior Izquierda, Superior Derecha, Inferior Izquierda, Inferior Derecha). |
|
|
Retraso en milisegundos
|
DelayInMilliseconds | integer |
Si realiza un doble clic, el retraso (en milisegundos) entre cada uno de los clics. |
|
|
Ocultar agente
|
HideAgent | boolean |
Establézcalo en true para ocultar automáticamente el Agente (si está visible) para asegurarse de que no oculta el elemento que se analiza. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Resultado del comando
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
Resultado del comando (correcto o erróneo). |
|
Mensaje de error
|
ErrorMessage | string |
Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió. |
Haga clic con el botón derecho global en el elemento UIA.
Mueve el mouse al centro, o un borde, esquina o desplazamiento elegido, en relación con un elemento UIA y hace clic en el botón derecho del mouse.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Elemento Focus primero
|
FocusElementFirst | boolean |
¿Debe IA-Connect intentar centrar el elemento antes de hacer clic globalmente? |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Hacer clic en desplazamiento X
|
ClickOffsetX | integer |
Número de píxeles X para desplazar la acción de clic por. Este parámetro admite valores de desplazamiento positivo (derecho) y negativo (izquierdo). |
|
|
Haga clic en Desplazamiento Y.
|
ClickOffsetY | integer |
Número de píxeles Y por el que se va a desplazar la acción de clic. Este parámetro admite valores de desplazamiento positivo (abajo) y negativo (hacia arriba). |
|
|
Desplazamiento relativo a
|
OffsetRelativeTo | string |
Posición relativa del elemento desde el que se va a desplazar (Centro / Centro / Centro, Izquierda, Derecha, Superior, Inferior, Superior Izquierda, Superior Derecha, Inferior Izquierda, Inferior Derecha). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Haga clic en elemento de lista UIA por nombre.
Hace clic en el elemento de lista con el nombre especificado. Normalmente se usa para seleccionar un elemento en un elemento desplegable o de menú.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Expandir primero
|
ExpandFirst | boolean |
Si se establece en true, IA-Connect intentará expandir la lista antes de buscar los elementos del elemento de lista. Esto resulta útil para las listas dinámicas, ya que es posible que los elementos del elemento de lista no se creen hasta que se expanda la lista. |
|
|
Contraer después
|
CollapseAfter | boolean |
Si se establece en true, la lista se contraerá después de ejecutar la búsqueda. |
|
|
Nombre del artículo
|
ItemName | string |
Nombre del elemento que se va a hacer clic. |
|
|
Segundos entre expandir y contraer
|
SecondsBetweenExpandCollapse | double |
Número de segundos que se esperarán entre las acciones de expansión y contraer si se establecen en true. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Haga clic en elemento de lista UIA por índice.
Hace clic en el elemento de lista que coincide con el índice especificado. Normalmente se usa para seleccionar un elemento en un elemento desplegable o de menú.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Expandir primero
|
ExpandFirst | boolean |
Si se establece en true, IA-Connect intentará expandir la lista antes de buscar los elementos del elemento de lista. Esto resulta útil para las listas dinámicas, ya que es posible que los elementos del elemento de lista no se creen hasta que se expanda la lista. |
|
|
Contraer después
|
CollapseAfter | boolean |
Si se establece en true, la lista se contraerá después de ejecutar la búsqueda. |
|
|
Índice de elemento
|
ItemIndex | integer |
Índice de la lista del elemento al que se va a hacer clic. |
|
|
Segundos entre expandir y contraer
|
SecondsBetweenExpandCollapse | double |
Número de segundos que se esperarán entre las acciones de expansión y contraer si se establecen en true. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Maximizar ventana de UIA
Maximiza la ventana con el identificador UIA especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | True | integer |
Manija UIA para la ventana que se va a maximizar. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Minimizar la ventana de UIA
Minimiza la ventana con el identificador UIA especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | True | integer |
Manija UIA para que la ventana se minimice. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Mover elemento UIA
Mueve un elemento UIA a una posición especificada en la pantalla. Esta acción normalmente solo funcionará con elementos Window (que tienen el patrón de transformación).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipo de movimiento horizontal
|
HorizontalMovementType | string |
Tipo de movimiento: Absoluto o relativo. |
|
|
Posición horizontal
|
HorizontalPosition | True | integer |
Nueva posición horizontal del elemento. El tipo de movimiento (por ejemplo, absoluto o relativo) se define mediante la entrada "Tipo de movimiento horizontal". Para dejar la posición horizontal sin cambios, elija un valor de 0 y establezca "Tipo de movimiento horizontal" en "Relative". |
|
Tipo de movimiento vertical
|
VerticalMovementType | string |
Tipo de movimiento: Absoluto o relativo. |
|
|
Posición vertical
|
VerticalPosition | True | integer |
Nueva posición vertical del elemento. El tipo de movimiento (por ejemplo, absoluto o relativo) se define mediante la entrada "Tipo de movimiento vertical". Para dejar la posición vertical sin cambios, elija un valor de 0 y establezca "Tipo de movimiento vertical" en "Relative". |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Resultado del comando
|
UIAMoveElementResult | boolean |
Resultado del comando (correcto o erróneo). |
|
Mensaje de error
|
ErrorMessage | string |
Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió. |
Obtención de patrones de elementos UIA
Recupere qué patrones UIA están disponibles para un elemento UIA y, por tanto, qué acciones de UIA de IA-Connect es probable que tengan un efecto en el elemento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Expandir patrón de contraer disponible
|
ExpandCollapsePatternAvailable | boolean |
El patrón de contraer expansión de UIA está disponible y, por tanto, las acciones que expanden o contraen un elemento (por ejemplo, un menú desplegable) probablemente funcionen. |
|
Invocar patrón disponible
|
InvokePatternAvailable | boolean |
El patrón de invocación UIA está disponible y, por tanto, las acciones que presionan un elemento o hacen clic en un elemento de lista probablemente funcionen. |
|
Patrón de valor de intervalo disponible
|
RangeValuePatternAvailable | boolean |
El patrón de valor de intervalo UIA está disponible y, por tanto, las acciones que desplazan un elemento o control deslizante probablemente funcionen. |
|
Patrón de desplazamiento disponible
|
ScrollPatternAvailable | boolean |
El patrón de desplazamiento UIA está disponible y, por tanto, las acciones que desplazan un elemento probablemente funcionen. |
|
Patrón de elemento de selección disponible
|
SelectionItemPatternAvailable | boolean |
El patrón de elemento de selección UIA está disponible y, por tanto, las acciones que seleccionan un elemento probablemente funcionen. |
|
Patrón de texto disponible
|
TextPatternAvailable | boolean |
El patrón de texto UIA está disponible y, por tanto, las acciones que leen un valor de texto de elemento probablemente funcionen. |
|
Alternar patrón disponible
|
TogglePatternAvailable | boolean |
El patrón de alternancia UIA está disponible y, por tanto, las acciones que comprueban, desactivan o desactivan un elemento es probable que funcionen. |
|
Patrón de valor disponible
|
ValuePatternAvailable | boolean |
El patrón de valor UIA está disponible y, por tanto, las acciones que introducen texto en un elemento o leen un valor de elemento probablemente funcionen. Las barras de desplazamiento también pueden reaccionar a un patrón de valor. |
|
Patrón de ventana disponible
|
WindowPatternAvailable | boolean |
El patrón de ventana de UIA está disponible y, por tanto, las acciones que cierran, maximizan o minimizan un elemento probablemente funcionen. |
|
Patrón de cuadrícula disponible
|
GridPatternAvailable | boolean |
El patrón de cuadrícula UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de elemento de cuadrícula disponible
|
GridItemPatternAvailable | boolean |
El patrón de elemento de cuadrícula UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón IAccessible heredado disponible
|
LegacyIAccessiblePatternAvailable | boolean |
El patrón IAccessible heredado de UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de selección disponible
|
SelectionPatternAvailable | boolean |
El patrón de selección de UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de hoja de cálculo disponible
|
SpreadsheetPatternAvailable | boolean |
El patrón de hoja de cálculo UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de elemento de hoja de cálculo disponible
|
SpreadsheetItemPatternAvailable | boolean |
El patrón de elemento de hoja de cálculo UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de tabla disponible
|
TablePatternAvailable | boolean |
El patrón de tabla UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de elemento de tabla disponible
|
TableItemPatternAvailable | boolean |
El patrón de elemento de tabla UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de texto 2 disponible
|
TextPattern2Available | boolean |
El patrón de texto UIA 2 está disponible. Ia-Connect no usa este patrón. |
|
Patrón de edición de texto disponible
|
TextEditPatternAvailable | boolean |
El patrón de edición de texto UIA está disponible. Ia-Connect no usa este patrón. |
|
Patrón de transformación disponible
|
TransformPatternAvailable | boolean |
El patrón de transformación UIA está disponible. Ia-Connect no usa este patrón. |
Obtención de propiedades del elemento datagrid de UIA
Devuelve las propiedades de tabla de un elemento DataGrid. Se trata de un elemento con filas, columnas, encabezados y celdas (es decir, una tabla).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Nombre alternativo de fila de encabezado
|
AlternativeHeaderRowName | string |
De forma predeterminada, la fila de encabezado de dataGrid tiene el nombre UIA "Fila superior". Si la fila de encabezado tiene un nombre diferente, especifique ese nombre aquí. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de columnas
|
NumberOfColumns | integer |
Número de columnas de datagrid. |
|
Número de columnas visibles
|
NumberOfVisibleColumns | integer |
Número de columnas visibles en la datagrid. |
|
Número de filas
|
NumberOfRows | integer |
Número de filas de la datagrid. |
|
Número de filas visibles
|
NumberOfVisibleRows | integer |
Número de filas visibles en la datagrid. |
|
Primera fila visible
|
FirstVisibleRow | integer |
Índice de la primera fila visible en la datagrid. |
|
Última fila visible
|
LastVisibleRow | integer |
Índice de la última fila visible en la datagrid. |
|
Número de barras de desplazamiento
|
NumberOfScrollbars | integer |
Número de barras de desplazamiento que tiene la datagrid. |
|
Nombres de barra de desplazamiento
|
ScrollbarNames | string |
Lista separada por comas de los nombres de las barras de desplazamiento (por ejemplo, Horizontal, Vertical). |
Obtención de varias propiedades del elemento primario de UIA
Devuelve un árbol jerárquico de elementos primarios del elemento especificado, hasta el escritorio (nivel raíz). El elemento primario se define como el elemento que está en el siguiente nivel hacia arriba el "árbol" de UIA y casi siempre es un elemento contenedor.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de elemento
|
ElementHandle | True | integer |
Identificador UIA del elemento de destino. |
|
Número máximo de elementos primarios que se van a procesar
|
MaxParentsToProcess | integer |
Número máximo de elementos primarios que se van a procesar. De forma predeterminada, se establece en 50. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Elementos primarios de UIA
|
UIAParentElements | array of object |
Lista de todos los elementos primarios ubicados (y sus propiedades). Las propiedades devueltas son las mismas que las devueltas por la acción "Obtener varias propiedades de elemento". |
|
items
|
UIAParentElements | object | |
|
Número de elementos primarios devueltos
|
NumberOfParentElementsReturned | integer |
Número de elementos primarios devueltos desde la búsqueda. |
Obtención de varios elementos UIA como tabla
Enumera los valores de los elementos secundarios de un elemento primario especificado y devuelve en un formato de tabla. Esto se puede usar para devolver filas y columnas de datos de elementos que no son técnicamente tablas, pero que se han organizado conjuntamente en una estructura de tabla. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de esta acción, que se ejecuta como un subproceso del Agente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Subbelement localizado de encabezado de celda de búsqueda
|
SearchCellHeaderSubElementLocalizedControlType | string |
El tipo de control localizado del encabezado de celda que se va a buscar. Deje en blanco si no busca encabezados de celda. |
|
|
Tipo de control de subelemento de encabezado de celda de búsqueda
|
SearchCellHeaderSubElementControlType | integer |
Tipo de control de subelemento de encabezado de celda (un entero no localizado) que se va a buscar. Este es el mismo valor en distintos idiomas. Deje en 0 si no busca encabezados de celda. |
|
|
Tipo de control localizado de subelemento de celda de búsqueda
|
SearchCellSubElementLocalizedControlType | string |
El tipo de control localizado de subelemento de celda que se va a buscar. |
|
|
Tipo de control de subelemento de celda de búsqueda
|
SearchCellSubElementControlType | integer |
Tipo de control de subelemento de celda (un entero no localizado) que se va a buscar. Este es el mismo valor en distintos idiomas. |
|
|
Buscar descendientes para subelementos de celda
|
SearchDescendantsForCellSubElements | boolean |
Si se establece en true, el árbol UIA debajo del elemento ubicado se buscará en subelementos de celda y encabezado de celda (es decir, los valores de elemento que rellenarán las celdas de la tabla de salida). Esto es más exhaustivo, pero puede tardar más tiempo. Es posible que desee establecer esto en false si solo está interesado en los elementos directamente debajo del elemento. |
|
|
Primer subelemento de encabezado de celda que se va a devolver
|
FirstCellHeaderSubElementToReturn | integer |
Índice del primer subelemento de encabezado de celda que se va a devolver, a partir de 1. Si desea devolver los elementos en orden inverso (desde la parte inferior del árbol UIA), también puede especificar un índice negativo a partir de -1. |
|
|
Número máximo de subelementos de encabezado de celda que se van a devolver
|
MaxCellHeaderSubElementsToReturn | integer |
Número máximo de subelementos de encabezado de celda que se van a devolver o 0 para devolver todos los subelementos. |
|
|
Primer subelemento de celda que se va a devolver
|
FirstCellSubElementToReturn | integer |
Índice del primer subelemento de celda que se va a devolver, a partir de 1. Si desea devolver los elementos en orden inverso (desde la parte inferior del árbol UIA), también puede especificar un índice negativo a partir de -1. |
|
|
Número máximo de subelementos de celda que se van a devolver
|
MaxCellSubElementsToReturn | integer |
Número máximo de subelementos de celda que se van a devolver o 0 para devolver todos los subelementos. |
|
|
Número solicitado de columnas
|
RequestedNumberOfColumns | integer |
Número de columnas que desea en la tabla de salida. Este valor debe ser correcto para el elemento que se está leyendo o recibirá resultados inesperados. |
|
|
Prioridad del valor de subelemento de celda
|
CellSubElementValuePriority | integer |
Prioridad para usar el valor de subelemento de celda como valor que se va a usar en la tabla de salida. 1 es la prioridad más alta. 2 es la segunda prioridad. 3 es la tercera prioridad. 0 no se usa. |
|
|
Prioridad del valor de texto del subelemento de celda
|
CellSubElementTextValuePriority | integer |
Prioridad para usar el valor de texto del subetiqueto de celda como valor que se va a usar en la tabla de salida. 1 es la prioridad más alta. 2 es la segunda prioridad. 3 es la tercera prioridad. 0 no se usa. |
|
|
Prioridad del valor del nombre del subelemento de celda
|
CellSubElementNameValuePriority | integer |
Prioridad para usar el nombre del subelemento de celda (común para las etiquetas) como valor que se va a usar en la tabla de salida. 1 es la prioridad más alta. 2 es la segunda prioridad. 3 es la tercera prioridad. 0 no se usa. |
|
|
Ancho mínimo de subelemento de celda
|
MinimumCellSubElementWidth | integer |
Ancho mínimo en píxeles de un subelemento de celda que se va a incluir en la tabla. |
|
|
Altura mínima del subelemento de celda
|
MinimumCellSubElementHeight | integer |
Alto mínimo en píxeles de un subelemento de celda que se va a incluir en la tabla. |
|
|
Cuadro de límite de subbelement de la celda de búsqueda a la izquierda
|
SearchCellSubElementBoundingBoxLeft | integer |
Solo se incluyen subelementos de celda que están totalmente contenidos en el cuadro de límite. De forma predeterminada, el rectángulo de selección es enorme para incluir todos los elementos. |
|
|
Cuadro de límite del subbelement de la celda de búsqueda a la derecha
|
SearchCellSubElementBoundingBoxRight | integer |
Solo se incluyen subelementos de celda que están totalmente contenidos en el cuadro de límite. De forma predeterminada, el rectángulo de selección es enorme para incluir todos los elementos. |
|
|
Cuadro de límite de subbelement de la celda de búsqueda superior
|
SearchCellSubElementBoundingBoxTop | integer |
Solo se incluyen subelementos de celda que están totalmente contenidos en el cuadro de límite. De forma predeterminada, el rectángulo de selección es enorme para incluir todos los elementos. |
|
|
Cuadro de límite de subbelement de la celda de búsqueda inferior
|
SearchCellSubElementBoundingBoxBottom | integer |
Solo se incluyen subelementos de celda que están totalmente contenidos en el cuadro de límite. De forma predeterminada, el rectángulo de selección es enorme para incluir todos los elementos. |
|
|
Leer tabla como subproceso
|
ReadTableAsThread | boolean |
Si se establece en false (valor predeterminado), el agente de IA-Connect leerá la tabla inmediatamente y devolverá el contenido al director. Si lee tablas grandes, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect leerá la tabla como un subproceso del agente y el director de IA-Connect (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del agente, esperando a que se complete. Esto permite que las tablas de gran tamaño se lean sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores solo podían leer tablas inmediatamente, no como subproceso del Agente. |
|
|
Recuperación de datos de salida para el identificador de subproceso
|
RetrieveOutputDataFromThreadId | integer |
Si anteriormente ejecutó esta acción como un subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establézcalo en 0 (valor predeterminado) si lee una tabla (y, por tanto, no recupera los resultados de una consulta anterior se ejecuta como un subproceso del Agente). |
|
|
Segundos para esperar el subproceso
|
SecondsToWaitForThread | integer |
Si "Read table as thread" (Leer tabla como subproceso) se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que lee la tabla no se ha completado en este momento, se producirá una excepción. Establézcalo en 0 para omitir la espera: el Agente seguirá leyendo la tabla, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados (el contenido de la tabla) más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del Agente y, a continuación, volver a ejecutar esta acción "Obtener varios elementos UIA como tabla" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de subelementos de celda encontrados
|
NumberOfCellSubElementsFound | integer |
El número de subelementos de celda (no encabezados) encontró que coinciden con los criterios de búsqueda. |
|
Número de subelementos de celda devueltos
|
NumberOfCellSubElementsReturned | integer |
Número de subelementos de celda (no encabezados) devueltos (puede ser menor que el número de elementos encontrados si se especifica un primer o el número máximo de elementos que se van a devolver). |
|
JSON de contenido de tabla
|
TableContentsJSON | string |
La tabla creada a partir del contenido de varios elementos, en formato JSON. |
|
Número de filas de la tabla
|
NumberOfRowsInTable | integer |
Número de filas de la tabla de salida. |
|
Número de columnas de la tabla
|
NumberOfColumnsInTable | integer |
Número de columnas de la tabla de salida. |
|
Identificador de subproceso
|
ThreadId | integer |
Si esta acción se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar el proceso de la acción y recuperar el contenido de la tabla cuando se haya completado el subproceso. |
Obtención del contenido del elemento datagrid de UIA
Devuelve el contenido de un elemento datagrid. Se trata de un elemento con filas, columnas, encabezados y celdas (es decir, una tabla). Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de esta acción, que se ejecuta como un subproceso del Agente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Recuperar solo columnas en pantalla
|
OnScreenColumnsOnly | boolean |
Si se establece en true, solo se devolverán columnas en pantalla. |
|
|
Recuperar solo filas en pantalla
|
OnScreenRowsOnly | boolean |
Si se establece en true, solo se devolverán filas en pantalla. |
|
|
Devolver valores NULL como en blanco
|
ReturnNullValuesAsBlank | boolean |
Si se establece en true, los valores NULL se devolverán como "" (es decir, en blanco). Si se establece en false, los valores NULL normalmente se devuelven como '(null)'. |
|
|
Nombre alternativo de fila de encabezado
|
AlternativeHeaderRowName | string |
De forma predeterminada, la fila de encabezado de una dataGrid tiene el nombre del elemento UIA "Fila superior". Si la fila de encabezado tiene un nombre diferente, especifique ese nombre aquí. |
|
|
Devolver el nombre de la fila UIA
|
ReturnRowUIAName | boolean |
Si esta entrada se establece en , el nombre UIA de fila se almacenará en una columna de la colección de salida. El nombre de la columna se define mediante la entrada "Nombre de columna para almacenar el nombre de la fila UIA". |
|
|
Nombre de la columna para almacenar el nombre UIA de fila
|
NameOfColumnToStoreRowUIAName | string |
Si la entrada "Return row UIA name" (Devolver nombre UIA de fila) se establece en true, esta entrada especifica el nombre de la columna de la colección de salida para contener el nombre de la fila UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Primer elemento que se va a devolver
|
FirstItemToReturn | integer |
Índice de elemento del primer elemento (fila) que se va a devolver, a partir de 1. |
|
|
Número máximo de elementos que se van a devolver
|
MaxItemsToReturn | integer |
Número máximo de elementos (filas) que se van a devolver o 0 para devolver todos los elementos (filas). |
|
|
Examen de las primeras N filas para las filas vacías
|
ScanFirstNRowsForEmptyRows | integer |
Algunas datagrids tienen algunos elementos de fila vacíos o NULOs en el árbol UIA (normalmente en la parte superior) y IA-Connect omitirán automáticamente estos elementos de fila, ya que no representan nada en la tabla que está visible en la interfaz de usuario. Si esta entrada se establece en 0 (valor predeterminado), el agente de IA-Connect examinará siempre los elementos de fila de la primera fila en adelante, incluso si "Primer elemento que se va a devolver" está establecido para recuperar filas más profundas dentro de la tabla. Esto garantiza la coherencia con los números de índice de fila, pero afecta al rendimiento, ya que es necesario examinar todas las filas de la primera fila a las filas solicitadas. Si está seguro de que los únicos elementos de fila vacíos o NULL de la tabla están dentro de las primeras filas N (por ejemplo, 10), puede establecer esto en N (por ejemplo, 10) para mejorar potencialmente el rendimiento. No establezca en un valor distinto de 0 a menos que sepa lo que está haciendo. |
|
|
Leer tabla como subproceso
|
ReadTableAsThread | boolean |
Si se establece en false (valor predeterminado), el agente de IA-Connect leerá la tabla inmediatamente y devolverá el contenido al director. Si lee tablas grandes, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect leerá la tabla como un subproceso del agente y el director de IA-Connect (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del agente, esperando a que se complete. Esto permite que las tablas de gran tamaño se lean sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores solo podían leer tablas inmediatamente, no como subproceso del Agente. |
|
|
Recuperación de datos de salida para el identificador de subproceso
|
RetrieveOutputDataFromThreadId | integer |
Si anteriormente ejecutó esta acción como un subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si está leyendo una datagrid (y, por lo tanto, no recuperando los resultados de una consulta anterior ejecutada como un subproceso del Agente). |
|
|
Segundos para esperar el subproceso
|
SecondsToWaitForThread | integer |
Si "Read table as thread" (Leer tabla como subproceso) se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que lee la tabla no se ha completado en este momento, se producirá una excepción. Establézcalo en 0 para omitir la espera: el agente seguirá leyendo la datagrid, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados (el contenido de la datagrid) más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del Agente y, a continuación, volver a ejecutar esta acción "Obtener contenido del elemento datagrid de UIA" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente. |
|
|
Desplazar datagrid verticalmente cada N por ciento
|
ScrollDataGridVerticallyEveryNPercent | integer |
Se ha observado el rendimiento de leer algunas redes de datos grandes (por ejemplo: con miles de filas) para mejorar si desplaza periódicamente la red de datos hacia (o cerca) de la ubicación que se desplaza. Si se establece en 0 (valor predeterminado), el datagrid no se desplazará mientras lee el contenido. Si se establece en un valor entre 1 y 100, el datagrid se desplazará periódicamente (cada N por ciento del número total de filas) al leer el contenido. Por ejemplo: si se establece en 20, el datagrid se desplazará a 0, 20, 40, 60, 80 por ciento. Como alternativa, use "Scroll datagrid verticalmente cada N rows" para desplazarse por todas las filas N en lugar de cada N por ciento. |
|
|
Desplazar datagrid verticalmente cada N filas
|
ScrollDataGridVerticallyEveryNRows | integer |
Se ha observado el rendimiento de leer algunas redes de datos grandes (por ejemplo: con miles de filas) para mejorar si desplaza periódicamente la red de datos hacia (o cerca) de la ubicación que se desplaza. Si se establece en 0 (valor predeterminado), el datagrid no se desplazará mientras lee el contenido. Si se establece en un valor 1 o superior, el datagrid se desplazará cada N filas mientras lee el contenido. Por ejemplo: si se establece en 5, la datagrid se desplazará cada 5 filas. Como alternativa, use "Scroll datagrid verticalmente cada N percent" para desplazarse cada N por ciento de las filas en lugar de cada fila N. |
|
|
Desplazamiento del identificador de elemento datagrid verticalmente
|
ScrollDataGridVerticallyElementHandle | integer |
Si desplaza el datagrid verticalmente mientras lee el contenido, esta entrada define cómo IA-Connect ubicará la barra de desplazamiento vertical. Si se establece en 0, IA-Connect intentará desplazar el datagrid directamente, ya sea mediante el patrón "scroll" (si el datagrid lo admite) o buscando la barra de desplazamiento vertical contenida en la datagrid. Como alternativa, puede especificar el identificador de IA-Connect UIA del elemento de barra de desplazamiento vertical (el propio elemento de barra de desplazamiento, no los botones dentro), que es un valor de 1 o superior. |
|
|
Filas mínimas de datagrid para desplazarse
|
MinimumDataGridRowsForScrolling | integer |
Si desplaza el datagrid verticalmente mientras lee el contenido, esta entrada especifica el número mínimo de filas necesarias en la tabla antes de que IA-Connect realice el desplazamiento. Si se establece en 0, IA-Connect se desplazará independientemente del número de filas. Si se establece en un número positivo, IA-Connect solo realizará el desplazamiento cuando el datagrid tenga ese número de filas o más. |
|
|
Generar excepción si no se puede desplazar
|
RaiseExceptionIfCannotScroll | boolean |
Si desplaza el datagrid verticalmente mientras lee el contenido: establezca esta entrada en true si un error al desplazarse debe considerarse una excepción o establecer en false (valor predeterminado) si se debe omitir un error al desplazarse. Entre los errores comunes para desplazarse se incluyen errores al localizar las barras de desplazamiento o las barras de desplazamiento no tienen un patrón UIA adecuado para el desplazamiento ('scroll', 'rangevalue' o 'value'). |
|
|
Nombre alternativo de la barra de desplazamiento vertical
|
AlternativeVerticalScrollbarName | string |
De forma predeterminada, la barra de desplazamiento vertical "row" de una datagrid tiene el nombre del elemento UIA "Barra de desplazamiento vertical". Si la barra de desplazamiento vertical tiene un nombre diferente, especifique ese nombre aquí. Esto se usará si desea IA-Connect desplazar periódicamente la datagrid mientras lee el contenido, el campo "Scroll datagrid vertically element handle" de entrada se establece en 0 (especificando que IA-Connect debe desplazar la datagrid directamente), pero la datagrid no implementa el patrón "scroll". |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
JSON de contenido de Datagrid
|
DataGridContentsJSON | string |
Contenido del elemento datagrid, en formato JSON. |
|
Número de filas de la tabla
|
NumberOfRowsInTable | integer |
Número de filas de la tabla de salida si la tabla se leyó inmediatamente. |
|
Número de columnas de la tabla
|
NumberOfColumnsInTable | integer |
Número de columnas de la tabla de salida si la tabla se leyó inmediatamente. |
|
Identificador de subproceso
|
ThreadId | integer |
Si esta acción se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar el proceso de la acción y recuperar el contenido de datagrid cuando se haya completado el subproceso. |
Obtención del identificador de elemento primario de UIA
Devuelve un identificador para el elemento primario del elemento especificado. El elemento primario se define como el elemento que está en el siguiente nivel hacia arriba el "árbol" de UIA y casi siempre es un elemento contenedor.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de elemento
|
ElementHandle | True | integer |
Identificador UIA del elemento de destino. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de elemento primario
|
ParentElementHandle | integer |
Identificador UIA para el elemento primario. |
Obtención del identificador de UIA para el elemento centrado
Devuelve un identificador para el elemento UIA centrado actualmente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |
Obtención del identificador de UIA para el escritorio
Devuelve un identificador para el escritorio. Se trata de una acción obsoleta porque el identificador "-2" se puede usar para hacer referencia al elemento de escritorio, pero también porque hay muchas acciones que pueden buscar en relación con el escritorio (por ejemplo, "esperar el elemento de escritorio").
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA para el escritorio. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de escritorio. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento de escritorio. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de escritorio. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento de escritorio. |
Obtención del identificador de UIA para la ventana principal del elemento centrado
Devuelve un identificador para la ventana principal del elemento UIA centrado actualmente. La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main".
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
Obtención del identificador de UIA para la ventana principal del identificador de proceso
Una acción Win32 sencilla y rápida que devuelve el identificador de cualquier ventana principal de un proceso (especificado por id. de proceso). La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de proceso de búsqueda
|
ProcessId | True | integer |
Identificador del proceso que se va a esperar (tal como se proporciona en la acción "Ejecutar proceso" en las acciones del entorno o sesión de IA-Connect). |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
Obtención del identificador de UIA para la ventana principal del proceso
Una acción Win32 sencilla y rápida que devuelve el identificador de cualquier ventana principal de un proceso (especificado por nombre). La ventana "Main" suele ser la ventana principal de la aplicación: un cuadro de diálogo de inicio de sesión o una subárbol no suele ser la ventana "Main". La ventana debe existir: IA-Connect no esperará. Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del proceso de búsqueda
|
SearchProcessName | True | string |
Nombre del proceso que se va a buscar, por ejemplo, bloc de notas. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
Obtención del identificador de UIA para la ventana win32 de nivel superior
Una acción rápida de Win32 que devuelve un identificador UIA para cualquier ventana win32 de nivel superior que tenga el nombre de clase o el título de la ventana especificados, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Una ventana de nivel superior es una que está conectada al escritorio. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. La ventana debe existir, IA-Connect no esperará. Es más común usar la acción UIA 'Does UIA desktop element exist' (¿Existe el elemento de escritorio UIA?), que es más eficaz, pero esta acción win32 normalmente se ejecuta más rápido.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de clase de búsqueda
|
SearchClassName | string |
Nombre de clase de elemento de la ventana de nivel superior que se va a buscar, por ejemplo, "Bloc de notas". |
|
|
Título de la ventana de búsqueda
|
SearchWindowTitle | string |
Título de la ventana de nivel superior que se va a buscar. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Identificador de proceso opcional del proceso que posee la ventana (por ejemplo, según lo proporcionado por la salida de la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o Sesión). Establézcalo en 0 para no buscar por identificador de proceso. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales en las propiedades de ventana disponibles. Ejemplo 1: [Width] < 200. Ejemplo 2: [Title] como '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varias ventanas coinciden con la búsqueda, esto le permite especificar la propiedad de ventana por la que ordenar. Se usará junto con "Match index" (Índice de coincidencia) para seleccionar la ventana necesaria. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, se devolverá la ventana coincidente más cercana a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varias ventanas coinciden con la búsqueda, debe coincidir "Índice de coincidencia" desde la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de ventana
|
WindowHandle | integer |
Identificador UIA de la ventana. Esto se puede usar como entrada para realizar más acciones de UIA dentro de esta ventana. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento de ventana. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento window. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento de ventana. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento window. |
Obtención del valor de etiqueta del elemento UIA
Devuelve el valor de la etiqueta en el elemento .
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Valor de etiqueta de elemento
|
ElementLabelValue | string |
Valor de la etiqueta en el elemento . |
Obtención del valor de texto del elemento UIA
Devuelve el valor de texto de un elemento. Normalmente, un valor de texto está asociado a una etiqueta, pero muchos elementos pueden tener esta propiedad.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Valor de texto del elemento
|
ElementTextValue | string |
Valor de texto del elemento. |
Obtener el elemento UIA en coordenadas de pantalla
Devuelve el elemento UIA ubicado en las coordenadas de pantalla especificadas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Coordenada X
|
XCoord | integer |
Valor de coordenada X de pantalla (en píxeles) donde se debe buscar el elemento UIA. |
|
|
Coordenada Y
|
YCoord | integer |
Valor de coordenada Y de pantalla (en píxeles) donde se debe buscar el elemento UIA. |
|
|
Generar excepción si no se encuentra el elemento
|
RaiseExceptionIfElementNotFound | boolean |
¿Debe IA-Connect generar una excepción si un elemento UIA no se encuentra en la ubicación especificada? |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Elemento encontrado
|
ElementFound | boolean |
Devuelve true si se encontró un elemento UIA en la ubicación especificada. |
|
Identificador de elemento
|
ElementHandle | integer |
Identificador UIA del elemento. Esto se puede usar como entrada para realizar acciones UIA adicionales que actúan en este elemento. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |
Obtener el modo de búsqueda de elementos UIA
Recupera el modo de búsqueda de elementos UIA que usa el agente de IA-Connect para las acciones de UIA.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Modo de búsqueda de elementos UIA
|
UIAElementSearchMode | string |
El modo de búsqueda de elementos UIA usado por el agente de IA-Connect. |
Obtener el valor del elemento UIA
Devuelve el valor de un elemento . Normalmente, un valor está asociado a un área de entrada de texto, pero muchos elementos pueden tener esta propiedad.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Valor del elemento
|
ElementValue | string |
Valor del elemento. |
Obtener elementos de elemento de lista UIA
Devuelve una lista de elementos secundarios que se encuentran en el elemento especificado (normalmente, desplegables o elementos de menú).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Expandir primero
|
ExpandFirst | boolean |
Si se establece en true, IA-Connect intentará expandir la lista antes de buscar los elementos del elemento de lista. Esto resulta útil para las listas dinámicas, ya que es posible que los elementos del elemento de lista no se creen hasta que se expanda la lista. |
|
|
Contraer después
|
CollapseAfter | boolean |
Si se establece en true, la lista se contraerá después de ejecutar la búsqueda. |
|
|
Buscar elementos seleccionados
|
CheckForSelectedItems | boolean |
Si se establece en true, la colección de salida contendrá una propiedad adicional que indica si el elemento de lista está seleccionado actualmente. |
|
|
Segundos entre expandir y contraer
|
SecondsBetweenExpandCollapse | double |
Número de segundos que se esperarán entre las acciones de expansión y contraer si se establecen en true. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de elementos de lista
|
NumberOfListItems | integer |
Número de elementos de la lista. |
|
Json de elementos de lista
|
ListItemsJSON | string |
Propiedades de los elementos de la lista, en formato JSON. |
|
Número de elementos seleccionados
|
NumberOfSelectedItems | integer |
Número de elementos seleccionados en la lista. |
|
Índice del primer elemento seleccionado
|
IndexOfFirstSelectedItem | integer |
Índice de la lista del primer elemento seleccionado. |
|
Nombre del elemento seleccionado
|
SelectedItemName | string |
Nombre del elemento seleccionado. |
Obtener elementos de escritorio de UIA
Devuelve una lista de todas las ventanas y diálogos del escritorio.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de control localizado del elemento search
|
SearchElementLocalizedControlType | string |
Filtre los resultados por el tipo de control localizado del elemento. |
|
|
Id. de proceso de búsqueda
|
SearchProcessID | integer |
Si se especifica, la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Primer elemento que se va a devolver
|
FirstItemToReturn | integer |
Índice de elemento del primer elemento que se va a devolver, a partir de 1. Si desea devolver los elementos en orden inverso (desde la parte inferior del árbol UIA), también puede especificar un índice negativo a partir de -1. |
|
|
Número máximo de elementos que se van a devolver
|
MaxItemsToReturn | integer |
Número máximo de elementos que se van a devolver o 0 para devolver todos los elementos. |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se devolverá un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de elementos encontrados
|
NumberOfElementsFound | integer |
Número de elementos de escritorio encontrados que coinciden con los criterios de búsqueda. |
|
Número de elementos devueltos
|
NumberOfElementsReturned | integer |
Número de elementos de escritorio devueltos (puede ser menor que el número de elementos encontrados si se especifica un número máximo de elementos que se van a devolver). |
|
Propiedades del elemento
|
ElementProperties | array of object |
Las propiedades del elemento de los elementos de escritorio encontraron que coinciden con los criterios de búsqueda. |
|
items
|
ElementProperties | object |
Obtener las propiedades del elemento UIA como lista
Devuelve las propiedades de un elemento como una lista de líneas única (una sola colección de líneas o tabla de datos) en lugar de elementos individuales, lo que puede resultar útil en función de cómo quiera usar los datos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de elemento
|
ElementHandle | True | integer |
Identificador UIA del elemento de destino. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de elementos encontrados
|
NumberOfElementsFound | integer |
Número de elementos encontrados. |
|
Número de elementos devueltos
|
NumberOfElementsReturned | integer |
Número de elementos devueltos. |
|
Propiedades del elemento UIA JSON
|
UIAElementPropertiesJSON | string |
Las propiedades UIA del elemento, en formato JSON. |
Obtener propiedades del elemento UIA
Devuelve todas las propiedades de un elemento. Esto puede ser útil si no está seguro de qué campo contiene los valores de propiedad necesarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Valor devuelto del elemento
|
ReturnElementValue | boolean |
Si se establece en true que el valor del elemento ubicado se devolverá. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Id. de marco de trabajo del elemento
|
ElementFrameworkId | string |
Identificador de marco de UIA del elemento. |
|
Tipo de control de elemento
|
ElementControlType | string |
Tipo de control UIA como número. Esto es similar al tipo de control localizado, pero no es específico del lenguaje. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |
|
El elemento está habilitado
|
ElementIsEnabled | boolean |
Devuelve si el elemento está habilitado o no. |
|
El elemento está fuera de pantalla
|
ElementIsOffscreen | boolean |
Devuelve si el elemento está fuera de pantalla o no. |
|
El elemento es el foco del teclado
|
ElementIsKeyboardFocusable | boolean |
Devuelve si el teclado puede centrar el elemento. |
|
El elemento tiene el foco del teclado
|
ElementHasKeyboardFocus | boolean |
Devuelve si el elemento tiene actualmente el foco del teclado. |
|
El elemento es el campo de contraseña
|
ElementIsPasswordField | boolean |
Devuelve si un elemento es un campo de entrada de contraseña. |
|
Tecla de aceleración de elementos
|
ElementAcceleratorKey | string |
Devuelve la tecla de acceso rápido que se podría presionar para activar el elemento. |
|
Clave de acceso de elemento
|
ElementAccessKey | string |
Devuelve la tecla de acceso rápido que se podría presionar para activar un elemento de menú. |
|
Borde izquierdo del elemento
|
ElementLeftEdge | integer |
Distancia en píxeles entre el borde izquierdo del elemento o ventana y el borde izquierdo de la pantalla. |
|
Borde derecho del elemento
|
ElementRightEdge | integer |
Distancia en píxeles entre el borde derecho del elemento o ventana y el borde izquierdo de la pantalla. |
|
Borde superior del elemento
|
ElementTopEdge | integer |
Distancia en píxeles entre el borde superior del elemento o ventana y el borde superior de la pantalla. |
|
Borde inferior del elemento
|
ElementBottomEdge | integer |
Distancia en píxeles entre el borde inferior del elemento o ventana y el borde superior de la pantalla. |
|
Elemento que se puede hacer clic en el punto X
|
ElementClickablePointX | integer |
Coordenada X en píxeles de un punto en el que se puede hacer clic central en el elemento con respecto al borde izquierdo de la pantalla tal y como devuelve la aplicación subyacente. |
|
Elemento que se puede hacer clic en el punto Y
|
ElementClickablePointY | integer |
Coordenada Y en píxeles de un punto en el que se puede hacer clic central en el elemento en relación con el borde superior de la pantalla tal y como devuelve la aplicación subyacente. |
|
Id. de proceso de elemento
|
ElementProcessId | integer |
Identificador de proceso (PID) del proceso que posee este elemento. |
|
Identificador de elemento
|
ElementHandle | integer |
Si la entrada "Return element handle" se estableció en true, contendrá un identificador de elemento numérico que se puede usar en acciones adicionales para actuar como identificador "primario" para otras acciones. |
|
Valor del elemento
|
ElementValue | string |
Si la entrada "Return element value" se estableció en true y si el elemento tiene un patrón de valor, contendrá ese valor. |
|
Valor de texto del elemento
|
ElementTextValue | string |
Si la entrada "Return element value" se estableció en true y si el elemento tiene un patrón de valor de texto, contendrá ese valor de texto. |
Obtener región de color de búsqueda de elementos UIA
Devuelve los detalles de la región de píxeles dentro de un elemento UIA que cumple los criterios de color especificados. El elemento debe traerse primero al principio, ya que el Agente localiza los colores tomando una captura de pantalla en las coordenadas del elemento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Color de búsqueda
|
SearchColour | True | string |
Color de búsqueda en el formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB o #RRGGBB donde cada canal de color es un byte en formato hexadecimal (00 está totalmente desactivado, FF está totalmente activado). Por ejemplo: #FF0000 para rojo, #00FF00 para azul, #000000 para negro, #FFFFFF para blanco. |
|
Desviación máxima del color
|
MaxColourDeviation | True | integer |
El color máximo de un elemento puede desviarse del color de búsqueda antes de que no se considere una coincidencia. 0 para ninguna desviación. La desviación se mide en valores RGB. Por ejemplo: #FF0000 es 4 diferente de #FE0102. Una desviación de 15 sería un buen punto de partida. |
|
Desplazamiento X del píxel izquierdo
|
LeftPixelXOffset | integer |
Desplazamiento X opcional para el borde izquierdo del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento X de píxel derecho
|
RightPixelXOffset | integer |
Desplazamiento X opcional para el borde derecho del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel superior
|
TopPixelYOffset | integer |
Desplazamiento Y opcional para el borde superior del área de búsqueda. Esto le permite aumentar (con valores negativos) o disminuir (con valores positivos) el área de búsqueda. |
|
|
Desplazamiento Y de píxel inferior
|
BottomPixelYOffset | integer |
Desplazamiento Y opcional para el borde inferior del área de búsqueda. Esto le permite aumentar (con valores positivos) o disminuir (con valores negativos) el área de búsqueda. |
|
|
Ocultar agente
|
HideAgent | boolean |
Establézcalo en true para ocultar automáticamente el Agente (si está visible) para asegurarse de que no oculta el elemento que se analiza. |
|
|
Devolver coordenadas de pantalla como físicas
|
ReturnPhysicalCoordinates | boolean |
Establézcalo en true para que las coordenadas de la pantalla se devuelvan como coordenadas físicas. Establézcalo en false para que las coordenadas de pantalla se devuelvan como coordenadas virtuales. Si el escalado de pantalla subyacente es de 100%, las coordenadas físicas y virtuales son las mismas. Las coordenadas de elemento siempre se devuelven como coordenadas virtuales. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de píxeles que coinciden con el color
|
NumberOfPixelsMatchingColour | integer |
Número de píxeles que coinciden con el color especificado. |
|
Color match bounding box element left pixel
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
Coordenada X virtual del píxel izquierdo que coincide con el color especificado, en relación con el elemento virtual de arriba a la izquierda. |
|
Píxel derecho del elemento rectángulo delimitador de coincidencia de color
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
Coordenada X virtual del píxel más derecho que coincide con el color especificado, en relación con el elemento virtual de la parte superior izquierda. |
|
Color match bounding box element top pixel
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
Coordenada Y virtual del píxel superior que coincide con el color especificado, en relación con el elemento virtual de la parte superior izquierda. |
|
Color match bounding box element bottom pixel
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
Coordenada Y virtual del píxel inferior que coincide con el color especificado, en relación con el elemento virtual de la parte superior izquierda. |
|
Color match bounding box element center X pixel
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
Coordenada X virtual del centro del cuadro de límite que contiene píxeles que coinciden con el color especificado, en relación con el elemento virtual de la parte superior izquierda. |
|
Color match bounding box center Y pixel
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
Coordenada Y virtual del centro del cuadro de límite que contiene píxeles que coinciden con el color especificado, en relación con el elemento virtual de la parte superior izquierda. |
|
Color match bounding box screen left pixel (Píxel izquierdo de la pantalla de selección de coincidencia de color)
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
Coordenada X del píxel de pantalla del píxel izquierdo que coincide con el color especificado. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel derecho de la pantalla del rectángulo de selección de coincidencia de color
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
Coordenada X del píxel de pantalla del píxel más derecho que coincide con el color especificado. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel superior de la pantalla del cuadro de selección de coincidencia de color
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
Coordenada Y del píxel de pantalla del píxel superior que coincide con el color especificado. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Píxel inferior de la pantalla del cuadro de selección de coincidencia de color
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
Coordenada Y del píxel de pantalla del píxel inferior que coincide con el color especificado. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Color match bounding box screen center X pixel
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
Coordenada X del píxel de pantalla del centro del cuadro de límite que contiene píxeles que coinciden con el color especificado. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
|
Color coincide con el centro de pantalla del cuadro de selección Y píxel
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
Coordenada Y del píxel de pantalla del centro del cuadro de límite que contiene píxeles que coinciden con el color especificado. Se trata de una coordenada física o virtual en función de la entrada "Devolver coordenadas físicas". |
Obtener varias propiedades del elemento UIA
Devuelve las propiedades de varios elementos. Esto puede ser útil si no está seguro de qué campos contiene los valores de propiedad necesarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Tipo de control localizado del elemento search
|
SearchElementLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Buscar descendientes
|
SearchDescendants | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Valor devuelto del elemento
|
ReturnElementValue | boolean |
Si se establece en true que el valor del elemento ubicado se devolverá. |
|
|
Primer elemento que se va a devolver
|
FirstItemToReturn | integer |
Índice de elemento del primer elemento que se va a devolver, a partir de 1. Si desea devolver los elementos en orden inverso (desde la parte inferior del árbol UIA), también puede especificar un índice negativo a partir de -1. |
|
|
Número máximo de elementos que se van a devolver
|
MaxItemsToReturn | integer |
Número máximo de elementos que se van a devolver o 0 para devolver todos los elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de elementos encontrados
|
NumberOfElementsFound | integer |
Número de elementos encontrados que coinciden con los criterios de búsqueda. |
|
Número de elementos devueltos
|
NumberOfElementsReturned | integer |
Número de elementos devueltos (puede ser menor que el número de elementos encontrados si se especifica un número máximo de elementos que se van a devolver). |
|
Propiedades del elemento
|
ElementProperties | array of object |
Las propiedades del elemento de los elementos encontraron que coinciden con los criterios de búsqueda. |
|
items
|
ElementProperties | object |
Obtener ventanas win32
Una acción rápida de Win32 que devuelve una lista de todas las ventanas win32 que, opcionalmente, tienen el nombre de clase o el título de la ventana especificados, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. Win32 Windows puede incluir elementos inesperados, como la barra de tareas, el escritorio, el menú inicio, las superposiciones transparentes, las ventanas desactivadas o ocultas, por lo que la lista devuelta puede contener más resultados de lo esperado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de clase de búsqueda
|
SearchClassName | string |
Nombre de clase opcional de la ventana de nivel superior que se va a buscar, por ejemplo, "Chrome_WidgetWin_1". |
|
|
Título de la ventana de búsqueda
|
SearchWindowTitle | string |
Título opcional de la ventana de nivel superior que se va a buscar. |
|
|
Recuperar solo ventanas de nivel superior
|
TopLevelWindowsOnly | boolean |
Establézcalo en true para recuperar solo las ventanas win32 que el sistema operativo considera que es de nivel superior. Establézcalo en false para recuperar todas las ventanas win32. Tenga en cuenta que la definición de Win32 de una ventana incluirá elementos que es posible que no reconozca como una ventana y que muchos cuadros de diálogo y cuadros de mensaje se marquen como de nivel superior aunque sean secundarios de una ventana primaria. |
|
|
Recuperar solo ventanas visibles
|
VisibleWindowsOnly | boolean |
Establézcalo en true para recuperar solo las ventanas win32 que el sistema operativo considera visibles. Establézcalo en false para recuperar ventanas Win32 visibles y no visibles. Tenga en cuenta que las ventanas fuera de pantalla o transparentes se pueden marcar como visibles, pero no se pueden ver. |
|
|
Recuperar solo ventanas con una barra de título
|
WindowsWithTitlebarOnly | boolean |
Establézcalo en true para recuperar solo las ventanas Win32 con una barra de título. Establézcalo en false para recuperar ventanas Win32 independientemente de si tienen una barra de título o no. Tenga en cuenta que algunas ventanas transparentes tienen barras de título, pero no se pueden ver. |
|
|
Recuperar solo ventanas con un título
|
WindowsWithTitleOnly | boolean |
Establézcalo en true para recuperar solo las ventanas win32 con un título (es decir, una barra de título que contiene texto). Establézcalo en false para recuperar ventanas win32 independientemente de si tienen un título. Tenga en cuenta que la barra de título es la franja en la parte superior de la ventana, mientras que el título es el texto dentro de ella. |
|
|
Omitir ventanas transparentes
|
IgnoreTransparentWindows | boolean |
Establézcalo en true para recuperar solo las ventanas Win32 que no tienen transparencia. Establézcalo en false para recuperar ventanas Win32 independientemente de si tienen la transparencia establecida o no. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Identificador de proceso opcional del proceso que posee las ventanas (por ejemplo, según lo proporcionado por la salida de la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o Sesión). Establézcalo en 0 para no buscar por identificador de proceso. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Title] como '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varias ventanas coinciden con la búsqueda, esto le permite especificar la propiedad de ventana por la que ordenar. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge], la lista de ventanas se devolverá ordenada por borde superior. Si este campo se deja en blanco, se devolverán ventanas en el orden en que se detectan. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si se especifican varias ventanas que coincidan con la búsqueda y se especifica una columna de ordenación, establezca en true (valor predeterminado) para ordenar ascendentemente o establecer en false para ordenar de forma descendente. |
|
|
Devolver identificador de elemento UIA
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador UIA a cada ventana win32 ubicada en la colección de salida (en la columna "UIAHandle"). Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario" en IA-Connect acciones de UIA. |
|
|
Primer elemento que se va a devolver
|
FirstItemToReturn | integer |
Índice de la primera ventana (fila) que se va a devolver, a partir de 1. |
|
|
Número máximo de elementos que se van a devolver
|
MaxItemsToReturn | integer |
Número máximo de ventanas que se van a devolver o 0 para devolver todos los elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Win32 windows JSON
|
Win32WindowsJSON | string |
Una lista de ventanas Win32 que coinciden con los criterios de búsqueda, en formato JSON. |
|
Número de ventanas Win32
|
NumberOfWin32Windows | integer |
Número de ventanas Win32 devueltas. |
Presione el elemento UIA.
Presiona un elemento (normalmente un botón).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Espere a que se complete el evento de botón
|
Wait | boolean |
Si la automatización espera a que se complete el evento de botón antes de continuar. Si se establece en true, esto puede provocar un tiempo de espera si el botón abre un cuadro de diálogo modal. |
|
|
Botón de clic de Win32
|
Win32ClickButton | boolean |
Si se establece en true, se usa un evento de clic de Win32 en lugar de usar UIA. Se trata de un evento de clic "fire and forget", que puede ser útil al tratar con diálogos modales que se presentan después de un clic o elementos que no tienen un patrón de invocación UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Probar patrón de invocación
|
TryInvokePattern | boolean |
Si se establece en true (valor predeterminado), el agente de IA-Connect intentará usar un patrón de invocación UIA para realizar la acción de presionar (a menos que "botón de clic win32" esté establecido en true). Si el patrón de invocación UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de invocación y volverá inmediatamente a otros patrones elegidos. |
|
|
Prueba del patrón heredado
|
TryLegacyPattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón heredado de UIA para realizar la acción de presión si el patrón de invocación no está disponible (ya sea porque no está presente en el elemento o porque su uso estaba deshabilitado) y si "botón de clic win32" es false. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Restablecer todos los identificadores de elemento UIA
Restablece todos los identificadores de elemento UIA almacenados actualmente por IA-Connect que pueden ser útiles si ha estado identificando muchos elementos y tiene un gran número de identificadores de elemento almacenados. En escenarios con un número extremadamente alto de identificadores de elemento (100 000+), esta acción también se puede usar para liberar el uso de RAM.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Seleccionar elemento UIA
Selecciona un elemento (normalmente un elemento de una lista o lista desplegable).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Texto de entrada en el elemento UIA
Acción UIA que introduce texto en un elemento (normalmente un campo de entrada de texto), reemplazando el texto existente o insertando el nuevo valor en una posición específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Texto que se va a escribir
|
TextToInput | string |
Valor de texto que se va a escribir. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Reemplazar el valor existente
|
ReplaceExistingValue | boolean |
Si hay texto existente en el elemento, ¿debe reemplazarse? |
|
|
Insertar posición
|
InsertPosition | integer |
Posición (índice) para empezar a insertar texto. Si hay texto existente, la posición de inserción se puede usar para insertar en una posición específica dentro del texto existente. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Se produce una excepción si se produce un error en la validación de entrada
|
RaiseExceptionIfInputValidationFails | boolean |
Si está habilitado, el agente de IA-Connect comprobará el nuevo valor del elemento después de introducir el texto solicitado. Si el nuevo valor no coincide con el valor esperado, se generará una excepción. Si esta entrada es false (valor predeterminado), se escribirá una advertencia en el registro, pero no se generará ninguna excepción. |
|
|
Probar patrón de valor
|
TryValuePattern | boolean |
Si se establece en true (valor predeterminado), el agente de IA-Connect intentará usar un patrón de valor UIA para realizar la acción de entrada de texto. Si el patrón de valor UIA no está disponible en el elemento elegido, el agente de IA-Connect revertirá a otros patrones (habilitados o deshabilitados a través de otras entradas para esta acción). Si se establece en false, el agente de IA-Connect no intentará usar un patrón de valor y volverá inmediatamente a otros patrones elegidos. |
|
|
Prueba del patrón heredado
|
TryLegacyPattern | boolean |
Si se establece en true, el agente de IA-Connect intentará usar un patrón heredado de UIA para realizar la acción de entrada de texto si el patrón de valor no está disponible (ya sea porque no está presente en el elemento o porque su uso estaba deshabilitado). |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Texto de entrada en varios elementos UIA
Acción UIA que introduce diferentes fragmentos de texto en varios elementos (normalmente campos de entrada de texto), reemplazando el texto existente o insertando el nuevo valor en una posición específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Elementos de entrada
|
InputElementsJSON | True | string |
Matriz de elementos UIA en los que se va a escribir texto, en formato JSON. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Texto de entrada global en el elemento UIA
Mueve el mouse al centro del elemento, lo centra, hace clic con el botón izquierdo y presiona las teclas. Normalmente se usa con una entrada de texto que no aceptará métodos de entrada UIA nativos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Elemento Focus primero
|
FocusElement | boolean |
¿Debe IA-Connect intentar centrar el elemento antes de hacer clic globalmente? |
|
|
Clic del mouse izquierdo global en el elemento
|
GlobalMouseClickOnElement | boolean |
¿Debe realizarse un clic global del mouse en las coordenadas del elemento (para centrar el elemento) antes de escribir texto? |
|
|
Reemplazar el valor existente con el doble clic del mouse en eliminar
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
¿Debe reemplazarse cualquier valor existente haciendo doble clic en el mouse (para resaltarlo) y, a continuación, eliminarlo? |
|
|
Reemplazar el valor existente mediante la eliminación de CTRL-A
|
ReplaceExistingValueUsingCTRLADelete | boolean |
¿Debe reemplazarse cualquier valor existente presionando Ctrl-A (para resaltar todo) y, a continuación, eliminarlo? Es posible que algunos elementos no admitan el resaltado con Ctrl-A en cuyo caso se debe probar la opción alternativa de "Reemplazar el valor existente mediante la eliminación doble del clic del mouse". |
|
|
Texto que se va a escribir
|
TextToInput | string |
Valor de texto para la entrada global mediante el teclado. |
|
|
Uso de eventos de clave de envío
|
SendKeyEvents | boolean |
Si se establece en true, se usarán los eventos de clave de envío (una API de nivel inferior que envía pulsaciones de teclas simuladas al sistema operativo). Si se establece en false, se usarán claves de envío (una API de nivel superior que envía pulsaciones de tecla al elemento centrado). |
|
|
Intervalo en milisegundos
|
Interval | integer |
Número de milisegundos entre cada pulsación de tecla. |
|
|
No interpretar símbolos
|
DontInterpretSymbols | boolean |
¿Deben no interpretarse los símbolos de "Texto a entrada" como teclas especiales (por ejemplo, + para Mayús, ^ para Ctrl)? Debe establecerse en true si intenta introducir los símbolos reales. |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Validar el punto en el que se puede hacer clic dentro del límite del elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para algunos elementos, UIA no es consciente de un punto en el que se puede hacer clic dentro del elemento y devolverá una coordenada no válida (por ejemplo, 0,0) en lugar del centro del elemento. Si esta entrada se establece en true, IA-Connect comprobará la validez de la coordenada proporcionada por UIA y, si no está dentro del límite del elemento, omitirá el valor proporcionado por UIA y usará el centro del elemento en su lugar. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
¿El proceso tiene ventana Win32?
Una acción Win32 sencilla y rápida que informa de si un proceso (especificado por nombre) tiene ventanas visibles. La ventana debe existir: IA-Connect no esperará. Se recomienda usar la acción "Esperar al elemento de escritorio", que es más eficaz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del proceso de búsqueda
|
SearchProcessName | True | string |
Nombre del proceso que se va a buscar, por ejemplo, bloc de notas. |
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Proceso tiene ventana
|
ProcessHasWindow | boolean |
Devuelve true si el proceso tiene una ventana visible o false si no es así. |
¿Está activado el elemento UIA?
Esta acción devuelve true o false que indica si se activa un elemento (normalmente una casilla o una casilla de radio).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Se comprueba el elemento
|
ElementIsChecked | boolean |
Devuelve true si el elemento está activado o false si no es así. |
¿Existe la ventana win32 de nivel superior?
Una acción rápida de Win32 que indica si existe una ventana win32 de nivel superior. Una ventana de nivel superior es una que está conectada al escritorio. Puede buscar por nombre de clase o título de ventana, o puede especificar filtros de búsqueda más avanzados, incluidos caracteres comodín. Aunque esta acción usa las API de Win32, puede detectar Windows, Java, ModernUI y ventanas web. La ventana debe existir, IA-Connect no esperará. Es más común usar la acción UIA 'Does UIA desktop element exist' (¿Existe el elemento de escritorio UIA?), que es más eficaz, pero esta acción win32 normalmente se ejecuta más rápido.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de clase de búsqueda
|
SearchClassName | string |
Nombre de clase de elemento de la ventana de nivel superior que se va a buscar, por ejemplo, "Bloc de notas". |
|
|
Título de la ventana de búsqueda
|
SearchWindowTitle | string |
Título de la ventana de nivel superior que se va a buscar. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Identificador de proceso opcional del proceso que posee la ventana (por ejemplo, según lo proporcionado por la salida de la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o Sesión). Establézcalo en 0 para no buscar por identificador de proceso. |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales en las propiedades de ventana disponibles. Ejemplo 1: [Width] < 200. Ejemplo 2: [Title] como '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte la documentación para obtener más ejemplos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
La ventana existe
|
WindowExists | boolean |
Devuelve true si la ventana existe o false si no es así. |
¿Existe un elemento de escritorio UIA?
Informa de si existe un elemento de escritorio y proporciona algunas propiedades básicas del elemento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Si se especifica (un valor de 1 o superior), la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco (o 0). |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se devolverá un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si el elemento existe o false si no. |
|
Identificador de elemento
|
ElementHandle | integer |
Identificador UIA del elemento. Esto se puede usar como entrada para realizar acciones UIA adicionales que actúan en este elemento. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |
¿Existe un elemento UIA?
Informa de si existe un elemento y devuelve algunas propiedades básicas del elemento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de ventana principal
|
ParentWindowHandle | True | integer |
Identificador primario de la ventana UIA (un valor de 1 o superior) para que actúe como punto de partida para la búsqueda. Esto se puede detectar a través de inspección mediante acciones como "Esperar elemento de escritorio" o "Esperar elemento". |
|
Nombre del elemento search
|
SearchElementName | string |
El nombre del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Nombre de clase del elemento Search
|
SearchElementClassName | string |
El nombre de clase de elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Identificador de automatización de elementos de búsqueda
|
SearchElementAutomationId | string |
Identificador opcional de automatización de elementos UIA que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Tipo de control localizado del elemento search
|
SearchLocalizedControlType | string |
El tipo de control localizado del elemento UIA opcional que se va a buscar (a partir del identificador de ventana principal). Esto se puede detectar a través de inspección. |
|
|
Id. de proceso de búsqueda
|
SearchProcessId | integer |
Si se especifica (un valor de 1 o superior), la búsqueda solo tendrá en cuenta los elementos que pertenecen a un proceso con este identificador de proceso (PID). Si IA-Connect inicia el proceso, el PID lo proporciona la acción "Ejecutar proceso" en las acciones IA-Connect Entorno o sesión. Si no conoce el PID, deje este campo en blanco (o 0). |
|
|
Subárbol UIA de búsqueda
|
SearchSubTree | boolean |
Si se establece en true, se buscará el árbol UIA completo debajo del identificador de ventana principal. Esto es más exhaustivo, pero puede tardar más tiempo. Si se establece en false, solo se buscarán los elementos directamente debajo del identificador de ventana principal del árbol UIA. |
|
|
Identificador de elemento devuelto
|
ReturnElementHandle | boolean |
Si se establece en true, se devolverá un identificador al elemento ubicado. Este identificador se puede usar en acciones adicionales para actuar como un identificador "primario". |
|
|
Coincidencia de índice
|
MatchIndex | integer |
Si varios elementos coinciden con la búsqueda, qué elemento (a partir de 1) debe coincidir. Se puede usar junto con "Ordenar por columna" para elegir el criterio de ordenación para la coincidencia. |
|
|
Filtro de búsqueda
|
SearchFilter | string |
Un filtro avanzado opcional para restringir aún más la búsqueda mediante operadores condicionales y cualquier campo de elemento. Ejemplo 1: [Width] < 200. Ejemplo 2: [Name] como 'Document*' AND [ClassName] como 'Label*'. Consulte la documentación para obtener más ejemplos. |
|
|
Ordenar por nombre de columna
|
SortByColumn | string |
Si varios elementos coinciden con la búsqueda, esto le permite especificar la propiedad de elemento por la que se va a ordenar. Esto se usará junto con "Match index" para elegir el elemento necesario. Por ejemplo: si "Ordenar por nombre de columna" es [TopEdge] y "Match index" es 1, el elemento coincidente más cercano a la parte superior de la pantalla. |
|
|
El índice de coincidencias es ascendente
|
MatchIndexAscending | boolean |
Si varios elementos coinciden con la búsqueda, debe coincidir 'Match index' en la parte superior de la lista ordenada (true) o desde la parte inferior de la lista ordenada (false). |
|
|
Incluir procesos secundarios
|
IncludeChildProcesses | boolean |
Si se establece en true y se especifica "Id. de proceso de búsqueda", los procesos secundarios de ese identificador de proceso también se incluyen en la búsqueda. Si se establece en false, solo se buscará un proceso que coincida con el "Id. de proceso de búsqueda". |
|
|
Número máximo de elementos que se van a buscar
|
MaxElementsToSearch | integer |
Número máximo de elementos que se van a buscar al buscar el elemento de destino en el árbol de UIA. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Profundidad máxima de búsqueda relativa
|
MaxRelativeSearchDepth | integer |
Profundidad máxima del árbol relativo que se va a buscar elementos secundarios debajo del elemento primario. Los elementos secundarios directos tendrán un valor de profundidad de 1. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Establézcalo en 0 para una profundidad de búsqueda ilimitada. Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Número máximo de elementos secundarios que se van a buscar por nodo
|
MaxChildElementsToSearchPerNode | integer |
Número máximo de elementos secundarios que se van a buscar debajo de cada elemento al buscar el árbol UIA para el elemento de destino. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). De forma predeterminada, se establece en 0 (ilimitado). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Tipos de control localizados de elementos que no se van a recorrer
|
ElementLocalizedControlTypesNotToTraverse | string |
Lista separada por comas de tipos de control localizados del elemento UIA para no atravesar (recorrer paso a paso) al buscar el árbol UIA para el elemento de destino. La búsqueda seguirá comprobando si un elemento individual coincide con los criterios de búsqueda, pero no buscará ningún elemento secundario de ese elemento si su tipo de control localizado está en esta lista de exclusión. Esta entrada solo funciona si el modo de búsqueda de elementos UIA es "Recorrido de árbol" (esto se puede habilitar en la página de configuración del Inspector). Esta entrada se usa normalmente para optimizar la búsqueda de elementos. |
|
|
Flujo de trabajo
|
Workflow | True | string |
Agregue la siguiente expresión aquí: workflow() |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El elemento existe
|
ElementExists | boolean |
Devuelve true si el elemento existe o false si no. |
|
Identificador de elemento
|
ElementHandle | integer |
Identificador UIA del elemento. Esto se puede usar como entrada para realizar acciones UIA adicionales que actúan en este elemento. |
|
Nombre del elemento
|
ElementName | string |
Nombre UIA del elemento. |
|
Nombre de clase de elemento
|
ElementClassName | string |
Nombre de clase UIA del elemento. |
|
Identificador de automatización de elementos
|
ElementAutomationId | string |
Identificador de automatización de UIA del elemento. |
|
Tipo de control localizado de elemento
|
ElementLocalizedControlType | string |
Tipo de control localizado UIA del elemento. |