Compartir a través de


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.