Partilhar via


IA-Connect UI

IA-Connect é uma plataforma 'RPA' de Robotic Process Automation que adiciona funcionalidade de RPA da nuvem para máquinas virtuais locais ou através de conexões Citrix ou Microsoft Remote Desktop 'RDS'. Este é o módulo para o aplicativo Windows User Interface Automation 'UIA'.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Laboratórios Ultima
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
Metadados do conector
Editora Ultima Negócios
Sítio Web https://www.ultima.com/ultima-labs
Política de privacidade https://www.ultima.com/privacy-policy
Categorias Operações de TI; Produtividade

IA-Connect é uma plataforma de Robotic Process Automation (RPA) que adiciona funcionalidade de RPA do Power Automate Cloud Flows a máquinas virtuais locais ou através de conexões Citrix ou Microsoft Remote Desktop (RDS). Os IA-Connect Connectors fornecem mais de 800 ações, permitindo automatizar todos os tipos de aplicativos locais diretamente de um Power Automate Cloud Flow. Todas as IA-Connect ações estão disponíveis diretamente do seu Power Automate Cloud Flow, proporcionando fácil integração entre aplicativos baseados na nuvem e locais, a capacidade de aproveitar as condições, loops, conteúdo dinâmico, expressões e tratamento de exceções existentes do Power Automate em seus processos de RPA. A utilização dos conectores IA-Connect também fornece histórico de execução completo e auditabilidade do histórico de execução do Flow, ao mesmo tempo em que elimina a necessidade de ter um aplicativo/console/estúdio separado para desenvolver seus processos de RPA.

Pré-requisitos

Para usar qualquer um dos IA-Connect Connectors, você deve instalar o software IA-Connect. Este teste é gratuito durante 30 dias, após os quais necessitará de uma licença IA-Connect.

O software IA-Connect consiste em dois componentes principais:

  • O IA-Connect Orchestrator, que é um WebApp do Azure que você hospedaria em seu próprio locatário do Azure. Isso lida com o roteamento e a segurança de fluxos de RPA para uma ou mais máquinas virtuais locais ou baseadas em nuvem.

  • O IA-Connect Agent and Diretor, que é instalado nas máquinas virtuais onde o software que você deseja automatizar está acessível. Além disso, o IA-Connect Agent pode ser executado dentro de uma sessão Citrix ou Microsoft Remote Desktop Services (RDS), onde os comandos RPA são passados por um canal virtual para a sessão remota para execução. O IA-Connect Agent pode ser executado a partir de um compartilhamento de rede e não requer instalação.

Conectores IA-Connect disponíveis

Os conectores IA-Connect disponíveis são:

  • IA-Connect Código Dinâmico
  • IA-Connect Java
  • IA-Connect JML
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • IA-Connect SAP GUI
  • Sessão IA-Connect
  • IA-Connect UI
  • IA-Connect Web Browser

Como obter credenciais

Para receber sua licença e começar sua avaliação gratuita de 30 dias, envie uma solicitação em nosso site (https://www.ultima.com/IA-Connect/Power-Automate).

Assim que receber um pedido de avaliação, entraremos em contacto consigo através do endereço de e-mail fornecido para ajudar a configurar o software IA-Connect e para lhe fornecer a licença de avaliação. Esta é uma versão de avaliação completa e permitirá que você teste qualquer uma das 800 ações em todos os 9 conectores IA-Connect em seu próprio ambiente durante o período de avaliação.

Introdução ao conector

Depois de submeter um pedido de avaliação para o IA-Connect, poderá descarregar um ficheiro ZIP contendo o software IA-Connect e documentação que abrange a instalação e configuração. Também entraremos em contato para oferecer suporte e orientação durante o processo de instalação, conforme necessário.

Support

Durante o período de teste, você pode entrar em contato com o Ultima Labs (IAConnect@ultima.com) para obter suporte e assistência.

Ao comprar IA-Connect licenças, você receberá tokens de suporte que podem ser trocados por treinamento personalizado ou suporte do Centro de Serviço Técnico (TSC) da Ultima, com sede no Reino Unido.

Problemas conhecidos, erros comuns e perguntas frequentes

Nossa Base de Conhecimento contém uma série de artigos que abrangem quaisquer problemas conhecidos, erros comuns que podem ocorrer ao usar os IA-Connect Connectors e perguntas frequentes. Isso pode ser acessado e https://support.ultima.com/ultimalabs uma conta para acessar esses recursos é fornecida durante a avaliação do IA-Connect e após a compra de uma licença IA-Connect.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API securestring A chave de API para esta api Verdade
IA-Connect Endereço do Orchestrator cadeia (de caracteres) Especifique o endereço do IA-Connect Orchestrator sem o componente HTTP(S) Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Aguarde a imagem de pesquisa visível no elemento UIA

Aguarda até que uma imagem de pesquisa, fornecida como entrada para esta ação, tenha sido visivelmente localizada dentro de um elemento UIA na tela ou até que o tempo especificado tenha passado. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente após a imagem ter sido localizada.

Aguarde a janela principal do ID do processo UIA

Uma ação Win32 simples e rápida que aguarda a existência de uma janela principal de um processo (especificada pela ID do processo) e retorna um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Aguarde a janela principal do processo UIA

Uma ação Win32 simples e rápida que aguarda um tempo especificado para que a janela principal de um processo (especificada pelo nome) exista antes de retornar um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Aguarde a janela Win32 de nível superior da UIA

Uma ação Win32 rápida que aguarda um tempo especificado para que uma janela Win32 de nível superior exista antes de retornar um identificador UIA. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. É mais comum usar a ação UIA 'Esperar pelo elemento da área de trabalho', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.

Aguarde até que a imagem de pesquisa visível não exista no elemento UIA

Aguarda até que uma imagem de pesquisa, fornecida como uma entrada para esta ação, não possa ser visivelmente localizada (ou nunca tenha sido localizada) dentro de um elemento UIA na tela, ou a quantidade especificada de tempo tenha passado e a imagem ainda esteja presente. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente quando a imagem não estiver mais presente.

Aguarde até que o elemento da área de trabalho UIA não exista

Aguarda que um elemento da área de trabalho (normalmente uma janela) não exista mais.

Aguarde até que o elemento UIA não exista

Espera que um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto) deixe de existir.

Aguarde o elemento da área de trabalho UIA

Aguarda a existência de um elemento da área de trabalho (normalmente uma janela).

Aguarde o elemento UIA

Aguarda a existência de um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto).

Alternar elemento UIA

Alterna um elemento (normalmente uma caixa de seleção ou uma caixa de rádio). Isto dá ao elemento o estado oposto ao seu estado atual (por exemplo, verificado torna-se desmarcado e vice-versa). Se você quiser definir um estado específico, use a ação 'Verificar elemento'.

Clique com o botão direito do rato global no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão direito do mouse.

Clique com o botão esquerdo do mouse global no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão esquerdo do mouse.

Clique em UIA item de elemento de lista por nome

Clica no elemento list com o nome especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu.

Clique em UIA item de elemento de lista por índice

Clique no elemento de lista que corresponde ao índice especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu.

Clique global do mouse na região de cores de pesquisa do elemento UIA

Move o mouse sobre uma região de pixels dentro de um elemento UIA que atende aos critérios de cor especificados e executa um clique do mouse. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos.

Clique no meio global do mouse no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, relativo a um elemento UIA e clica no botão do meio do mouse.

Definir a janela UIA como normal

Normaliza a janela com a alça UIA especificada (ou seja, define-a para uma janela de tamanho normal em vez de minimizada ou maximizada).

Definir a porcentagem de rolagem do elemento UIA

Defina a porcentagem de rolagem horizontal e/ou vertical do elemento especificado, se a rolagem for suportada por esse elemento. Se o elemento suportar o padrão 'scroll', você poderá aplicar essa ação diretamente ao elemento e especificar uma quantidade de rolagem horizontal ou vertical (ou ambas). Se o elemento não suportar o padrão 'scroll', essa ação retornará aos padrões 'range value' ou 'value', mas você precisará aplicá-los diretamente ao(s) controle(s) da barra de rolagem, não ao elemento em si.

Definir janela UIA de primeiro plano

Traz uma janela para o primeiro plano.

Definir o elemento UIA como valor de intervalo numérico

Define o valor do elemento que tem um intervalo numérico, por exemplo, uma barra de rolagem.

Definir o elemento UIA como valor numérico

Define o valor do elemento que tem uma entrada numérica, por exemplo, um campo de texto ou uma barra de rolagem.

Definir o modo de pesquisa do elemento UIA

Escolha qual modo de pesquisa de elemento UIA deve ser usado pelo IA-Connect Agent ao executar ações UIA. Normalmente, essa ação só seria usada se você estiver tendo um problema com o modo padrão (Localizar tudo).

Definir o tempo limite da transação UIA

Controla quanto tempo a API UIA aguardará para que um aplicativo retorne as informações sobre um elemento. Esse tempo limite de transação normalmente só seria atingido se o aplicativo não respondesse.

Desenhar retângulo em torno do elemento UIA

Desenha um retângulo em torno do perímetro de um elemento para ajudar a identificar que o elemento encontrado é o necessário. O retângulo é removido automaticamente após 5 segundos.

Elemento UIA de foco

Foca um elemento que o torna o elemento ativo para o foco do teclado e, dependendo do aplicativo, pode trazer a janela do elemento para o primeiro plano.

Existe uma janela Win32 de nível superior

Uma ação rápida do Win32 que informa se existe uma janela Win32 de nível superior. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.

Expandir elemento UIA

Expande um elemento (normalmente um item de menu/menu suspenso). Se o item já estiver expandido, nada acontecerá.

Faça uma captura de tela do local do elemento UIA

Tira uma captura de tela do local de um elemento e retorna uma imagem. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos.

Fechar janela de elemento UIA

Fecha a janela do elemento. Normalmente, só funciona em janelas ou caixas de diálogo.

Global duplo clique esquerdo do mouse no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica duas vezes no botão esquerdo do mouse.

Inserir senha no elemento UIA

Ação UIA que insere uma senha em um elemento (normalmente um campo de entrada de senha), substituindo o texto existente.

Inserir texto em vários elementos da interface do usuário

UIA Action que insere diferentes partes de texto em vários elementos (normalmente campos de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica.

Inserir texto no elemento UIA

Ação UIA que insere texto em um elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica.

Localizar imagem de pesquisa visível dentro do elemento UIA

Retorna se uma imagem de pesquisa, fornecida como entrada para essa ação, foi visivelmente localizada em um elemento da interface do usuário na tela. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela.

Maximizar a janela UIA

Maximiza a janela com a alça UIA especificada.

Minimizar a janela UIA

Minimiza a janela com a alça UIA especificada.

Mover elemento UIA

Move um elemento UIA para uma posição especificada na tela. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação).

O elemento da área de trabalho UIA existe

Relata se um elemento da área de trabalho existe e fornece algumas propriedades básicas do elemento.

O elemento UIA está verificado

Essa ação retorna true ou false indicando se um elemento (normalmente uma caixa de seleção ou caixa de rádio) está marcado.

O elemento UIA existe

Informa se um elemento existe e retorna algumas propriedades básicas do elemento.

O processo tem janela Win32

Uma ação Win32 simples e rápida que relata se um processo (especificado pelo nome) tem alguma janela visível. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Obter a região de cores de pesquisa do elemento UIA

Retorna os detalhes da região de pixels dentro de um elemento UIA que atendem aos critérios de cor especificados. O elemento deve ser trazido para a frente primeiro, porque o Agente localiza as cores fazendo uma captura de tela nas coordenadas do elemento.

Obter conteúdo do elemento de grade de dados UIA

Retorna o conteúdo de um elemento datagrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela). Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente.

Obter elementos da área de trabalho UIA

Retorna uma lista de todas as janelas e caixas de diálogo na área de trabalho.

Obter identificador de elemento pai da UIA

Retorna um identificador para o elemento pai do elemento especificado. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.

Obter identificador UIA para a janela principal do elemento focalizado

Retorna um identificador para a janela principal do elemento UIA focado no momento. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'.

Obter identificador UIA para a janela principal do ID do processo

Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pela ID do processo). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Obter identificador UIA para a janela principal do processo

Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pelo nome). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Obter identificador UIA para a janela Win32 de nível superior

Uma ação Win32 rápida que retorna um identificador UIA para qualquer janela Win32 de nível superior que tenha o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Uma janela de nível superior é aquela que está conectada à área de trabalho. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.

Obter identificador UIA para desktop

Retorna um identificador para a área de trabalho. Esta é uma ação obsoleta porque o identificador '-2' pode ser usado para se referir ao elemento desktop, mas também porque há muitas ações que podem pesquisar em relação à área de trabalho (por exemplo, 'esperar pelo elemento desktop').

Obter identificador UIA para elemento focalizado

Retorna um identificador para o elemento UIA focado no momento.

Obter itens de elemento de lista UIA

Retorna uma lista de itens de elemento filho encontrados sob o elemento especificado (normalmente itens suspensos/de menu).

Obter janelas Win32

Uma ação rápida do Win32 que retorna uma lista de todas as janelas do Win32 que opcionalmente têm o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. Win32 Windows pode incluir itens inesperados, incluindo a barra de tarefas, área de trabalho, menu Iniciar, sobreposições transparentes, fora da tela ou janelas ocultas, para que a lista retornada pode conter mais resultados do que o esperado.

Obter o elemento UIA nas coordenadas da tela

Retorna o elemento UIA localizado nas coordenadas de tela fornecidas.

Obter o modo de pesquisa de elementos UIA

Recupera qual modo de pesquisa de elemento UIA está sendo usado pelo IA-Connect Agent for UIA ações.

Obter padrões de elemento UIA

Recupere quais padrões de UIA estão disponíveis para um elemento UIA e, portanto, quais ações de UIA IA-Connect provavelmente terão um efeito sobre o elemento.

Obter propriedades do elemento datagrid da UIA

Retorna propriedades de tabela de um elemento DataGrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela).

Obter propriedades do elemento UIA

Retorna todas as propriedades de um elemento. Isso pode ser útil se você não tiver certeza de qual campo contém os valores de propriedade necessários.

Obter propriedades do elemento UIA como lista

Retorna as propriedades de um elemento como uma lista de linha única (coleção de linha única / tabela de dados) em vez de itens individuais, isso pode ser útil dependendo de como você pretende usar os dados.

Obter valor de texto do elemento UIA

Retorna o valor de texto de um elemento. Um valor de texto geralmente é associado a um rótulo, mas muitos elementos podem ter essa propriedade.

Obter valor do elemento UIA

Retorna o valor de um elemento. Um valor geralmente é associado a uma área de entrada de texto, mas muitos elementos podem ter essa propriedade.

Obter valor do rótulo do elemento UIA

Retorna o valor do rótulo no elemento .

Obter várias propriedades de elementos UIA

Retorna as propriedades de vários elementos. Isso pode ser útil se você não tiver certeza de quais campos contêm os valores de propriedade necessários.

Obter várias propriedades do elemento pai da UIA

Retorna uma árvore hierárquica de elementos pai do elemento especificado, até a área de trabalho (nível raiz). O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.

Obter vários elementos da UIA como tabela

Enumera os valores dos elementos filho de um elemento pai especificado e retorna em um formato de tabela. Isso pode ser usado para retornar linhas e colunas de dados de elementos que não são tecnicamente tabelas, mas foram organizados juntos em uma estrutura de tabela. Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente.

Pesquisar o primeiro elemento pai da UIA

Pesquisa na hierarquia da árvore UIA o primeiro elemento pai que corresponde aos critérios de pesquisa. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.

Pressione o elemento UIA

Pressiona um elemento (normalmente um botão).

Recolher elemento UIA

Recolhe um elemento (normalmente um item de menu / dropdown). Se o item já estiver recolhido, nada acontecerá.

Redefinir todos os identificadores de elementos UIA

Redefine todos os identificadores de elemento UIA atualmente armazenados por IA-Connect o que pode ser útil se você tiver identificado muitos elementos e tiver um grande número de identificadores de elemento armazenados. Em cenários com números extremamente altos de identificadores de elementos (100.000+), essa ação também pode ser usada para liberar o uso de RAM.

Redimensionar elemento UIA

Redimensiona um elemento UIA. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação).

Retorno de entrada no elemento UIA

Introduz um retorno do Windows/nova linha num elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o retorno numa posição específica.

Selecionar elemento UIA

Seleciona um elemento (normalmente um item em uma lista ou lista suspensa).

Senha de entrada global no elemento UIA

Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de senha que não aceitará métodos de entrada nativos da UIA.

Texto de entrada global no elemento UIA

Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de texto que não aceitará métodos de entrada UIA nativos.

Verificar vários elementos da UIA

Define o estado de vários elementos (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado.

Verifique o elemento UIA

Define o estado de um elemento (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado.

Aguarde a imagem de pesquisa visível no elemento UIA

Aguarda até que uma imagem de pesquisa, fornecida como entrada para esta ação, tenha sido visivelmente localizada dentro de um elemento UIA na tela ou até que o tempo especificado tenha passado. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente após a imagem ter sido localizada.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipo de imagem de pesquisa
SearchImageType string

Define o que a entrada 'Pesquisar imagem' representa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem.

Pesquisar imagem
SearchImage string

A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada.

Tipo de imagem de pesquisa alternativa
AltSearchImageType string

Define o que a entrada 'Imagem de pesquisa alternativa' representa. Se definido como 'Nenhum' ou em branco, não há nenhuma imagem de pesquisa alternativa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem.

Imagem de pesquisa alternativa
AltSearchImage string

Uma imagem de pesquisa alternativa opcional para localizar dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa alternativa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. Se você especificar uma imagem de pesquisa alternativa, o Agente procurará a imagem de pesquisa ou alternativa e relatará qual delas foi localizada.

Desvio máximo de cor
MaxColourDeviation integer

O máximo de cores de pixel de um elemento pode se desviar das cores de pixel da imagem de pesquisa antes que ele não seja considerado uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Isto permite que pequenas diferenças de coloração sejam ignoradas.

Diferenças máximas de pixels
MaxPixelDifferences integer

O número máximo de píxeis que pode diferir (acima do desvio máximo de cor) em toda a imagem pesquisada, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definido para um valor acima de 0, você também deve definir 'Máximo de diferenças de pixels consecutivos'.

Máximo de diferenças consecutivas de pixels
MaxConsecutivePixelDifferences integer

O número máximo de píxeis que pode diferir (acima do desvio máximo de cor), em qualquer linha, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definindo para um valor acima de 0, você também deve definir 'Diferenças máximas de pixels'.

Deslocamento X do pixel esquerdo
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento X do pixel direito
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Deslocamento Y de pixel superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento Y do pixel inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Unidade de deslocamentos do Pixel X
PixelXOffsetsUnit string

Defina como 'Pixel' (o padrão) se os deslocamentos de pixel X esquerdo e direito forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos de pixel X esquerdo e direito forem medidos como uma porcentagem da largura do elemento.

Unidade de deslocamentos Pixel Y
PixelYOffsetsUnit string

Defina como 'Pixel' (o padrão) se os deslocamentos de pixel Y superior e inferior forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos Y de pixel superior e inferior forem medidos como uma porcentagem da altura do elemento.

Índice de imagens de pesquisa
SearchImageIndex integer

Defina como 1 para localizar a primeira instância da imagem de pesquisa (na direção da pesquisa) dentro do elemento UIA. Definido como 2 para a segunda instância, .... , N para a nona instância. Se você também estiver procurando por uma imagem alternativa, o elemento UIA será digitalizado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, procurando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma mistura de ambas as imagens).

Direção da pesquisa de imagens
ImageSearchDirection string

A direção da busca. 'Do topo' pesquisa por linha a partir do topo, digitalizando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha a partir da parte inferior, digitalizando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, digitalizando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, digitalizando de cima para baixo dentro de cada coluna. Isto pode ser usado em conjunto com 'Pesquisar índice de imagem' para localizar a Nona imagem a partir da parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção de pesquisa que você acha que localizará sua imagem mais rapidamente.

Ocultar agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado.

Retornar coordenadas da tela como físicas
ReturnPhysicalCoordinates boolean

Defina como true para que as coordenadas da tela sejam retornadas como coordenadas físicas. Defina como false para que as coordenadas da tela sejam retornadas como coordenadas virtuais. Se o dimensionamento de exibição subjacente for de 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas do elemento são sempre retornadas como coordenadas virtuais.

Mostrar retângulo de realce
ShowHighlightRectangle boolean

Se definido como true, o IA-Connect Agent destacará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detetada.

Segundos de espera pela imagem de pesquisa
SecondsToWait integer

O número de segundos para aguardar até que a imagem de pesquisa seja localizada dentro do elemento UIA. Se a imagem não estiver localizada, uma exceção será gerada se 'Aumentar exceção se a imagem não encontrada' estiver definida como true, caso contrário, a ação informará que a imagem não foi localizada.

Milésimos de segundo entre pesquisas
MillisecondsBetweenSearches integer

O número de milissegundos a aguardar entre cada elemento UIA na verificação na tela. Como o reconhecimento de imagem pode ser caro para a CPU, um atraso pode ajudar a reduzir e distribuir a utilização da CPU. Por exemplo: Se você espera que uma imagem possa levar até 1 minuto para ficar visível, adicionar uma pausa de 5000 milissegundos (5 segundos) entre as verificações reduzirá significativamente a utilização da CPU (reduzindo consideravelmente o número de verificações), mas terá apenas um pequeno impacto no tempo de resposta. O valor mínimo permitido é de 100 milissegundos (1/10 segundo).

Gerar exceção se a imagem não for encontrada
RaiseExceptionIfImageNotFound boolean

Defina como true se IA-Connect gerar uma exceção se a imagem não puder ser localizada após o período de espera.

Recuperar dados de saída para ID de thread
RetrieveOutputDataFromThreadId integer

Se você definiu anteriormente 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), forneça o ID do thread do Agent para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Caso contrário, defina como 0 (o padrão).

Aguarde o thread
WaitForThread boolean

Defina como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado em 'Segundos para aguardar a imagem de pesquisa'. Defina como false para ignorar a espera; O Agente continuará a executar a espera em segundo plano, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente essa ação 'Esperar pela imagem de pesquisa visível no elemento UIA' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Pesquisar imagem localizada
SearchImageLocated boolean

Esta saída será definida como true, se a imagem de pesquisa foi localizada. Esta saída será definida como false, se a imagem de pesquisa não foi localizada.

Qual imagem de pesquisa localizada
WhichSearchImageLocated integer

Essa saída será definida como 0, se nenhuma imagem de pesquisa for localizada. Defina como 1, se a imagem de pesquisa foi localizada. Defina como 2, se a imagem de pesquisa alternativa foi localizada.

Elemento da caixa delimitadora de correspondência de imagem pixel esquerdo
SearchImageBoundingBoxElementLeftPixelXCoord integer

A coordenada X virtual do pixel mais à esquerda correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo.

Pixel direito do elemento da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxElementRightPixelXCoord integer

A coordenada X virtual do pixel mais à direita correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo.

Pixel superior do elemento da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxElementTopPixelYCoord integer

A coordenada Y virtual do pixel mais alto correspondente à imagem especificada, em relação ao elemento virtual no canto superior esquerdo.

Pixel inferior do elemento da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxElementBottomPixelYCoord integer

A coordenada Y virtual do pixel mais inferior correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo.

Elemento da caixa delimitadora de correspondência de imagem centro X pixel
SearchImageBoundingBoxElementCenterPixelXCoord integer

A coordenada X virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual no canto superior esquerdo.

Elemento da caixa delimitadora de correspondência de imagem centro Y pixel
SearchImageBoundingBoxElementCenterPixelYCoord integer

A coordenada Y virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual superior esquerdo.

Tela da caixa delimitadora de correspondência de imagem pixel esquerdo
SearchImageBoundingBoxScreenLeftPixelXCoord integer

A coordenada X do pixel da tela do pixel mais à esquerda correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Tela da caixa delimitadora de correspondência de imagem pixel direito
SearchImageBoundingBoxScreenRightPixelXCoord integer

A coordenada X do pixel mais à direita correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel superior da tela da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxScreenTopPixelYCoord integer

A coordenada Y do pixel da tela correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel inferior da tela da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxScreenBottomPixelYCoord integer

A coordenada Y do pixel da tela que corresponde à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Tela da caixa delimitadora de correspondência de imagem central X pixel
SearchImageBoundingBoxScreenCenterPixelXCoord integer

A coordenada X do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Caixa delimitadora de correspondência de imagem tela central Y pixel
SearchImageBoundingBoxScreenCenterPixelYCoord integer

A coordenada Y do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Thread Id
ThreadId integer

Se você tiver definido 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), essa saída manterá o ID do thread do Agente, que pode ser usado para monitorar o processo da ação e recuperar os resultados mais tarde, quando o thread for concluído.

Aguarde a janela principal do ID do processo UIA

Uma ação Win32 simples e rápida que aguarda a existência de uma janela principal de um processo (especificada pela ID do processo) e retorna um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Parâmetros

Name Chave Necessário Tipo Description
Id do processo de pesquisa
ProcessId True integer

O ID do processo a aguardar (conforme fornecido pela ação 'Executar processo' nas ações Ambiente de IA-Connect / Sessão).

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para aguardar a janela principal do processo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe
ElementExists boolean

Retorna true se o elemento existir ou false se não.

Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

Aguarde a janela principal do processo UIA

Uma ação Win32 simples e rápida que aguarda um tempo especificado para que a janela principal de um processo (especificada pelo nome) exista antes de retornar um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Parâmetros

Name Chave Necessário Tipo Description
Nome do processo de pesquisa
SearchProcessName True string

O nome do processo a pesquisar, por exemplo, bloco de notas.

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para aguardar a janela principal do processo.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

O elemento existe
ElementExists boolean

Retorna true se a janela existir ou false se não.

Aguarde a janela Win32 de nível superior da UIA

Uma ação Win32 rápida que aguarda um tempo especificado para que uma janela Win32 de nível superior exista antes de retornar um identificador UIA. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. É mais comum usar a ação UIA 'Esperar pelo elemento da área de trabalho', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.

Parâmetros

Name Chave Necessário Tipo Description
Pesquisar nome da classe
SearchClassName string

O nome da classe do elemento da janela de nível superior para pesquisar, por exemplo, 'Bloco de Notas'.

Título da janela de pesquisa
SearchWindowTitle string

O título da janela de nível superior para pesquisar.

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para esperar que a janela exista.

Id do processo de pesquisa
SearchProcessId integer

A ID do processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais em relação às propriedades de janela disponíveis. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de janela classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher a janela necessária. Por exemplo: Se 'Ordenar por nome de coluna' for [TopEdge] e 'Índice de correspondência' for 1, a janela correspondente mais próxima da parte superior do ecrã será devolvida.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se várias janelas corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Aumentar exceção se a janela não for encontrada
RaiseExceptionIfWindowNotFound boolean

Deve IA-Connect gerar uma exceção se a janela de pesquisa Win32 não existir após o período de espera?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

O elemento existe
ElementExists boolean

Retorna true se a janela existir ou false se não.

Aguarde até que a imagem de pesquisa visível não exista no elemento UIA

Aguarda até que uma imagem de pesquisa, fornecida como uma entrada para esta ação, não possa ser visivelmente localizada (ou nunca tenha sido localizada) dentro de um elemento UIA na tela, ou a quantidade especificada de tempo tenha passado e a imagem ainda esteja presente. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente quando a imagem não estiver mais presente.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipo de imagem de pesquisa
SearchImageType string

Define o que a entrada 'Pesquisar imagem' representa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem.

Pesquisar imagem
SearchImage string

A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada.

Tipo de imagem de pesquisa alternativa
AltSearchImageType string

Define o que a entrada 'Imagem de pesquisa alternativa' representa. Se definido como 'Nenhum' ou em branco, não há nenhuma imagem de pesquisa alternativa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem.

Imagem de pesquisa alternativa
AltSearchImage string

Uma imagem de pesquisa alternativa opcional para localizar dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa alternativa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. Se você especificar uma imagem de pesquisa alternativa, o Agente procurará a imagem de pesquisa ou alternativa e relatará qual delas foi localizada.

Desvio máximo de cor
MaxColourDeviation integer

O máximo de cores de pixel de um elemento pode se desviar das cores de pixel da imagem de pesquisa antes que ele não seja considerado uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Isto permite que pequenas diferenças de coloração sejam ignoradas.

Diferenças máximas de pixels
MaxPixelDifferences integer

O número máximo de píxeis que pode diferir (acima do desvio máximo de cor) em toda a imagem pesquisada, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definido para um valor acima de 0, você também deve definir 'Máximo de diferenças de pixels consecutivos'.

Máximo de diferenças consecutivas de pixels
MaxConsecutivePixelDifferences integer

O número máximo de píxeis que pode diferir (acima do desvio máximo de cor), em qualquer linha, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definindo para um valor acima de 0, você também deve definir 'Diferenças máximas de pixels'.

Deslocamento X do pixel esquerdo
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento X do pixel direito
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Deslocamento Y de pixel superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento Y do pixel inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Unidade de deslocamentos do Pixel X
PixelXOffsetsUnit string

Defina como 'Pixel' (o padrão) se os deslocamentos de pixel X esquerdo e direito forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos de pixel X esquerdo e direito forem medidos como uma porcentagem da largura do elemento.

Unidade de deslocamentos Pixel Y
PixelYOffsetsUnit string

Defina como 'Pixel' (o padrão) se os deslocamentos de pixel Y superior e inferior forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos Y de pixel superior e inferior forem medidos como uma porcentagem da altura do elemento.

Índice de imagens de pesquisa
SearchImageIndex integer

Defina como 1 para localizar a primeira instância da imagem de pesquisa (na direção da pesquisa) dentro do elemento UIA. Definido como 2 para a segunda instância, .... , N para a nona instância. Se você também estiver procurando por uma imagem alternativa, o elemento UIA será digitalizado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, procurando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma mistura de ambas as imagens).

Direção da pesquisa de imagens
ImageSearchDirection string

A direção da busca. 'Do topo' pesquisa por linha a partir do topo, digitalizando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha a partir da parte inferior, digitalizando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, digitalizando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, digitalizando de cima para baixo dentro de cada coluna. Isto pode ser usado em conjunto com 'Pesquisar índice de imagem' para localizar a Nona imagem a partir da parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção de pesquisa que você acha que localizará sua imagem mais rapidamente.

Ocultar agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado.

Mostrar retângulo de realce
ShowHighlightRectangle boolean

Se definido como true, o IA-Connect Agent destacará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detetada.

Segundos de espera até que a imagem de pesquisa não exista
SecondsToWait integer

O número de segundos para aguardar até que a imagem de pesquisa não esteja visivelmente localizada dentro do elemento UIA. Se a imagem ainda estiver presente após esse período, uma exceção será gerada se 'Aumentar exceção se a imagem ainda estiver presente' estiver definida como true, caso contrário, a ação informará que a imagem ainda está presente.

Milésimos de segundo entre pesquisas
MillisecondsBetweenSearches integer

O número de milissegundos a aguardar entre cada elemento UIA na verificação na tela. Como o reconhecimento de imagem pode ser caro para a CPU, um atraso pode ajudar a reduzir e distribuir a utilização da CPU. Por exemplo: Se você espera que uma imagem possa levar até 1 minuto para ficar visível, adicionar uma pausa de 5000 milissegundos (5 segundos) entre as verificações reduzirá significativamente a utilização da CPU (reduzindo consideravelmente o número de verificações), mas terá apenas um pequeno impacto no tempo de resposta. O valor mínimo permitido é de 100 milissegundos (1/10 segundo).

Levantar exceção se a imagem ainda estiver presente
RaiseExceptionIfImageStillPresent boolean

Defina como true se IA-Connect gerar uma exceção se a imagem ainda estiver presente após o período de espera.

Recuperar dados de saída para ID de thread
RetrieveOutputDataFromThreadId integer

Se você definiu anteriormente 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), forneça o ID do thread do Agent para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Caso contrário, defina como 0 (o padrão).

Aguarde o thread
WaitForThread boolean

Defina como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado em 'Segundos para aguardar que a imagem de pesquisa não exista'. Defina como false para ignorar a espera; O Agente continuará a executar a espera em um thread em segundo plano, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente esta ação 'Esperar que a imagem de pesquisa visível não exista no elemento UIA' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Pesquisar imagem presente antes de esperar
SearchImagePresentBeforeWait boolean

Esta saída será definida como true, se a imagem de pesquisa estava presente no início do período de espera. Esta saída será definida como false, se a imagem de pesquisa não estiver presente desde o início.

Imagem de pesquisa ainda presente após espera
SearchImageStillPresentAfterWait boolean

Esta saída será definida como true, se a imagem de pesquisa ainda estiver presente, após o período de espera. Esta saída será definida como false, se a imagem de pesquisa não estiver mais presente, durante o período de espera (a ação é concluída imediatamente quando a imagem não estiver mais presente).

Qual imagem de pesquisa ainda presente
WhichSearchImageStillPresent integer

Esta saída será definida como 0, se nenhuma imagem de pesquisa ainda estiver presente, após o período de espera. Defina como 1, se a imagem de pesquisa ainda estiver presente, após o período de espera. Defina como 2, se a imagem de pesquisa alternativa ainda estiver presente, após o período de espera.

Thread Id
ThreadId integer

Se você tiver definido 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), essa saída manterá o ID do thread do Agente, que pode ser usado para monitorar o processo da ação e recuperar os resultados mais tarde, quando o thread for concluído.

Aguarde até que o elemento da área de trabalho UIA não exista

Aguarda que um elemento da área de trabalho (normalmente uma janela) não exista mais.

Parâmetros

Name Chave Necessário Tipo Description
Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Id do processo de pesquisa
SearchProcessId integer

Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0).

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para aguardar que o elemento não exista.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado.

Levantar exceção se o elemento ainda existir
RaiseExceptionIfElementStillExists boolean

Deve IA-Connect gerar uma exceção se o elemento UIA ainda existir após o período de espera?

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe antes de esperar
ElementExistsBeforeWait boolean

Retorna true se o elemento existia antes de esperar ou false se não.

O elemento existe após a espera
ElementExistsAfterWait boolean

Retorna true se o elemento existiu após a espera ou false se não.

Aguarde até que o elemento UIA não exista

Espera que um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto) deixe de existir.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Id do processo de pesquisa
SearchProcessId integer

Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0).

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para aguardar que o elemento não exista.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado.

Levantar exceção se o elemento ainda existir
RaiseExceptionIfElementStillExists boolean

Deve IA-Connect gerar uma exceção se o elemento UIA ainda existir após o período de espera?

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe antes de esperar
ElementExistsBeforeWait boolean

Retorna true se o elemento existia antes de esperar ou false se não.

O elemento existe após a espera
ElementExistsAfterWait boolean

Retorna true se o elemento existiu após a espera ou false se não.

Aguarde o elemento da área de trabalho UIA

Aguarda a existência de um elemento da área de trabalho (normalmente uma janela).

Parâmetros

Name Chave Necessário Tipo Description
Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Id do processo de pesquisa
SearchProcessId integer

Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0).

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para aguardar a existência do elemento.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado.

Levantar exceção se o elemento não for encontrado
RaiseExceptionIfElementNotFound boolean

Deve IA-Connect gerar uma exceção se o elemento UIA não existir após o período de espera?

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe
ElementExists boolean

Retorna true se o elemento existir ou false se não.

Alça do elemento
ElementHandle integer

O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Aguarde o elemento UIA

Aguarda a existência de um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Id do processo de pesquisa
SearchProcessId integer

Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0).

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Segundos de espera
SecondsToWait True integer

O número máximo de segundos para aguardar a existência do elemento.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado.

Levantar exceção se o elemento não for encontrado
RaiseExceptionIfElementNotFound boolean

Deve IA-Connect gerar uma exceção se o elemento UIA não existir após o período de espera?

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe
ElementExists boolean

Retorna true se o elemento existir ou false se não.

Alça do elemento
ElementHandle integer

O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Alternar elemento UIA

Alterna um elemento (normalmente uma caixa de seleção ou uma caixa de rádio). Isto dá ao elemento o estado oposto ao seu estado atual (por exemplo, verificado torna-se desmarcado e vice-versa). Se você quiser definir um estado específico, use a ação 'Verificar elemento'.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique com o botão direito do rato global no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão direito do mouse.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Elemento de foco primeiro
FocusElementFirst boolean

Deve IA-Connect tentar focar o elemento antes de clicar globalmente?

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda).

Clique em deslocamento Y
ClickOffsetY integer

O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima).

Deslocamento em relação a
OffsetRelativeTo string

A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique com o botão esquerdo do mouse global no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão esquerdo do mouse.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Elemento de foco primeiro
FocusElementFirst boolean

Deve IA-Connect tentar focar o elemento antes de clicar globalmente?

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda).

Clique em deslocamento Y
ClickOffsetY integer

O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima).

Deslocamento em relação a
OffsetRelativeTo string

A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique em UIA item de elemento de lista por nome

Clica no elemento list com o nome especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Expandir primeiro
ExpandFirst boolean

Se definido como true, IA-Connect tentará expandir a lista antes de procurar os elementos do item de lista. Isso é útil para listas dinâmicas, pois os elementos do item de lista podem não ser criados até que a lista seja expandida.

Fechar após
CollapseAfter boolean

Se definido como true, a lista será recolhida após a execução da pesquisa.

Nome do item
ItemName string

O nome do item de elemento a ser clicado.

Segundos entre expandir e recolher
SecondsBetweenExpandCollapse double

O número de segundos a aguardar entre as ações de expansão e recolhimento, se estas estiverem definidas como true.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique em UIA item de elemento de lista por índice

Clique no elemento de lista que corresponde ao índice especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Expandir primeiro
ExpandFirst boolean

Se definido como true, IA-Connect tentará expandir a lista antes de procurar os elementos do item de lista. Isso é útil para listas dinâmicas, pois os elementos do item de lista podem não ser criados até que a lista seja expandida.

Fechar após
CollapseAfter boolean

Se definido como true, a lista será recolhida após a execução da pesquisa.

Índice de itens
ItemIndex integer

O índice na lista do item a ser clicado.

Segundos entre expandir e recolher
SecondsBetweenExpandCollapse double

O número de segundos a aguardar entre as ações de expansão e recolhimento, se estas estiverem definidas como true.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique global do mouse na região de cores de pesquisa do elemento UIA

Move o mouse sobre uma região de pixels dentro de um elemento UIA que atende aos critérios de cor especificados e executa um clique do mouse. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Cor da pesquisa
SearchColour True string

Pesquise cores no formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB em que cada canal de cor é um byte em formato hexadecimal (00 está totalmente desligado, FF está totalmente ligado). Por exemplo: #FF0000 para vermelho, #00FF00 para azul, #000000 para preto #FFFFFF para branco.

Desvio máximo de cor
MaxColourDeviation True integer

O máximo que uma cor de elemento pode desviar da cor de pesquisa antes de não ser considerada uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Um desvio de 15 seria um bom ponto de partida.

Deslocamento X do pixel esquerdo
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento X do pixel direito
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Deslocamento Y de pixel superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento Y do pixel inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Botão do rato
MouseButton string

O botão do mouse para pressionar (Esquerda, Direita, Meio, Duplo esquerdo).

Clique em deslocamento X
ClickOffsetX integer

O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda).

Clique em deslocamento Y
ClickOffsetY integer

O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima).

Deslocamento em relação a
OffsetRelativeTo string

A posição relativa da região de cor a ser deslocada (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Atraso em milissegundos
DelayInMilliseconds integer

Se estiver a realizar um duplo clique, o atraso (em milissegundos) entre cada um dos cliques.

Ocultar agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Resultado do comando
UIAGlobalMouseClickElementSearchColourRegionResult boolean

O resultado do comando (sucesso ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada.

Clique no meio global do mouse no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, relativo a um elemento UIA e clica no botão do meio do mouse.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Elemento de foco primeiro
FocusElementFirst boolean

Deve IA-Connect tentar focar o elemento antes de clicar globalmente?

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda).

Clique em deslocamento Y
ClickOffsetY integer

O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima).

Deslocamento em relação a
OffsetRelativeTo string

A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir a janela UIA como normal

Normaliza a janela com a alça UIA especificada (ou seja, define-a para uma janela de tamanho normal em vez de minimizada ou maximizada).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela
WindowHandle True integer

O identificador UIA para a janela a ser normalizada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir a porcentagem de rolagem do elemento UIA

Defina a porcentagem de rolagem horizontal e/ou vertical do elemento especificado, se a rolagem for suportada por esse elemento. Se o elemento suportar o padrão 'scroll', você poderá aplicar essa ação diretamente ao elemento e especificar uma quantidade de rolagem horizontal ou vertical (ou ambas). Se o elemento não suportar o padrão 'scroll', essa ação retornará aos padrões 'range value' ou 'value', mas você precisará aplicá-los diretamente ao(s) controle(s) da barra de rolagem, não ao elemento em si.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Porcentagem de rolagem horizontal
HorizontalScrollPercentage double

A posição para rolar horizontalmente o elemento (0 a 100 inclusive, decimais suportados) ou -1 deixar a posição de rolagem horizontal inalterada.

Porcentagem de rolagem vertical
VerticalScrollPercentage double

A posição para rolar verticalmente o elemento (0 a 100 inclusive, decimais suportados) ou -1 deixar a posição de rolagem vertical inalterada.

Experimente o padrão de rolagem
TryScrollPattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão de rolagem UIA para executar a ação de rolagem. Se o padrão de rolagem UIA não estiver disponível no elemento escolhido, o Agente IA-Connect voltará para outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de rolagem e voltará imediatamente para outros padrões escolhidos. A ordem dos padrões tentados (se ativados através de entradas para esta ação) são scroll, range value e value.

Experimente o padrão de valores do intervalo
TryRangeValuePattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão de valor de intervalo UIA para executar a ação de rolagem. Se o padrão de valor do intervalo UIA não estiver disponível no elemento escolhido, o IA-Connect Agent retornará a outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor de intervalo e voltará imediatamente para outros padrões escolhidos. A ordem dos padrões tentados (se ativados através de entradas para esta ação) são scroll, range value e value.

Tente o padrão de valor
TryValuePattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão de valor da UIA para executar a ação de rolagem. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o IA-Connect Agent retornará a outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos. A ordem dos padrões tentados (se ativados através de entradas para esta ação) são scroll, range value e value. Aviso: Usar um padrão de valor em um elemento edit simplesmente inserirá o valor no elemento edit.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Resultado do comando
UIASetElementScrollPercentageResult boolean

O resultado do comando (sucesso ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada.

Definir janela UIA de primeiro plano

Traz uma janela para o primeiro plano.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela
WindowHandle True integer

O identificador UIA para a janela, que deve ser definido como a janela de primeiro plano.

Janela de alternância
ToggleWindow boolean

A janela deve ser alternada tentando focar ou clicar nela? Isso ajuda a garantir que a janela seja trazida de forma confiável para o primeiro plano.

A alternância usa o agente global de clique esquerdo do mouse
ToggleUsesGlobalLeftMouseClickAgent boolean

Se optar por alternar a janela, isso especifica se os cliques globais do mouse devem ser usados para focar o IA-Connect Agent primeiro.

Alternar atraso em segundos
ToggleDelay double

Se optar por alternar a janela, isso especifica a pausa após a alternância.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o elemento UIA como valor de intervalo numérico

Define o valor do elemento que tem um intervalo numérico, por exemplo, uma barra de rolagem.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Novo valor
NewValue True double

O valor do intervalo numérico para definir o elemento.

Novo valor é percentagem
NewValueIsPercentage boolean

O novo valor é uma percentagem?

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o elemento UIA como valor numérico

Define o valor do elemento que tem uma entrada numérica, por exemplo, um campo de texto ou uma barra de rolagem.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Novo valor
NewValue True integer

O valor numérico para definir o elemento.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Gerar exceção se a validação de entrada falhar
RaiseExceptionIfInputValidationFails boolean

Se habilitado, o IA-Connect Agent verificará o novo valor do elemento depois de inserir o texto solicitado. Se o novo valor não corresponder ao valor esperado, uma exceção será gerada. Se essa entrada for falsa (o padrão), um aviso será inserido no log, mas nenhuma exceção será gerada.

Tente o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos.

Experimente o padrão herdado
TryLegacyPattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Definir o modo de pesquisa do elemento UIA

Escolha qual modo de pesquisa de elemento UIA deve ser usado pelo IA-Connect Agent ao executar ações UIA. Normalmente, essa ação só seria usada se você estiver tendo um problema com o modo padrão (Localizar tudo).

Parâmetros

Name Chave Necessário Tipo Description
Modo de pesquisa de elemento UIA
UIAElementSearchMode True string

O modo de pesquisa do elemento UIA a ser usado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Resultado do comando
SetUIAElementSearchModeResult boolean

O resultado do comando (sucesso ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada.

Definir o tempo limite da transação UIA

Controla quanto tempo a API UIA aguardará para que um aplicativo retorne as informações sobre um elemento. Esse tempo limite de transação normalmente só seria atingido se o aplicativo não respondesse.

Parâmetros

Name Chave Necessário Tipo Description
Tempo limite em segundos
TimeoutInSeconds True double

O período máximo de tempo que a API UIA aguardará até que um aplicativo retorne as informações sobre um elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Desenhar retângulo em torno do elemento UIA

Desenha um retângulo em torno do perímetro de um elemento para ajudar a identificar que o elemento encontrado é o necessário. O retângulo é removido automaticamente após 5 segundos.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Cor da caneta
PenColour string

A cor do retângulo a desenhar (por exemplo, vermelho, verde, azul, amarelo, roxo ou laranja) ou um código hexadecimal de cordas, por exemplo, #FF0000.

Pixels de espessura da caneta
PenThicknessPixels integer

A espessura (em pixels) da borda do retângulo de realce.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Elemento UIA de foco

Foca um elemento que o torna o elemento ativo para o foco do teclado e, dependendo do aplicativo, pode trazer a janela do elemento para o primeiro plano.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Existe uma janela Win32 de nível superior

Uma ação rápida do Win32 que informa se existe uma janela Win32 de nível superior. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.

Parâmetros

Name Chave Necessário Tipo Description
Pesquisar nome da classe
SearchClassName string

O nome da classe do elemento da janela de nível superior para pesquisar, por exemplo, 'Bloco de Notas'.

Título da janela de pesquisa
SearchWindowTitle string

O título da janela de nível superior para pesquisar.

Id do processo de pesquisa
SearchProcessId integer

A ID do processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais em relação às propriedades de janela disponíveis. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
A janela existe
WindowExists boolean

Retorna true se a janela existir ou false se não.

Expandir elemento UIA

Expande um elemento (normalmente um item de menu/menu suspenso). Se o item já estiver expandido, nada acontecerá.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Faça uma captura de tela do local do elemento UIA

Tira uma captura de tela do local de um elemento e retorna uma imagem. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Formato de imagem
ImageFormat string

O formato de imagem a ser usado para a captura de tela. Isso pode afetar a qualidade e o tamanho dos dados que estão sendo retornados. Os formatos suportados são PNG (o padrão), JPG, BMP e GIF.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Ocultar agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça a captura de tela.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Imagem da tela como Base64
ScreenBitmapBase64 string

A imagem da tela como uma cadeia de caracteres codificada em Base64.

Fechar janela de elemento UIA

Fecha a janela do elemento. Normalmente, só funciona em janelas ou caixas de diálogo.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Global duplo clique esquerdo do mouse no elemento UIA

Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica duas vezes no botão esquerdo do mouse.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Atraso em milissegundos
DelayInMilliseconds integer

O atraso (em milissegundos) entre cada um dos cliques.

Elemento de foco primeiro
FocusElementFirst boolean

Deve IA-Connect tentar focar o elemento antes de clicar globalmente?

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda).

Clique em deslocamento Y
ClickOffsetY integer

O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima).

Deslocamento em relação a
OffsetRelativeTo string

A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Inserir senha no elemento UIA

Ação UIA que insere uma senha em um elemento (normalmente um campo de entrada de senha), substituindo o texto existente.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Palavra-passe para introdução
PasswordToInput True password

O valor da senha a ser inserida.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

A palavra-passe contém a palavra-passe armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha contiver (ou for inteiramente) um identificador de senha armazenado em IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica do IA-Connect Orchestrator, no formato {OrchestratorCredential:FriendlyName}. Essa senha armazenada pode ter sido gerada pela ação 'Gerar senha', por exemplo, ou ser mantida pelo IA-Connect Orchestrator.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tente o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos.

Experimente o padrão herdado
TryLegacyPattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Inserir texto em vários elementos da interface do usuário

UIA Action que insere diferentes partes de texto em vários elementos (normalmente campos de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica.

Parâmetros

Name Chave Necessário Tipo Description
Elementos de entrada
InputElementsJSON True string

Uma matriz de elementos UIA para inserir texto, no formato JSON.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Inserir texto no elemento UIA

Ação UIA que insere texto em um elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Texto a introduzir
TextToInput string

O valor de texto a ser inserido.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Substituir valor existente
ReplaceExistingValue boolean

Se houver texto existente no elemento , ele deve ser substituído?

Inserir posição
InsertPosition integer

A posição (índice) para começar a inserir texto. Se houver texto existente, a posição de inserção pode ser usada para inserir em uma posição específica dentro do texto existente.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Gerar exceção se a validação de entrada falhar
RaiseExceptionIfInputValidationFails boolean

Se habilitado, o IA-Connect Agent verificará o novo valor do elemento depois de inserir o texto solicitado. Se o novo valor não corresponder ao valor esperado, uma exceção será gerada. Se essa entrada for falsa (o padrão), um aviso será inserido no log, mas nenhuma exceção será gerada.

Tente o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos.

Experimente o padrão herdado
TryLegacyPattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Localizar imagem de pesquisa visível dentro do elemento UIA

Retorna se uma imagem de pesquisa, fornecida como entrada para essa ação, foi visivelmente localizada em um elemento da interface do usuário na tela. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipo de imagem de pesquisa
SearchImageType string

Define o que a entrada 'Pesquisar imagem' representa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem.

Pesquisar imagem
SearchImage string

A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada.

Tipo de imagem de pesquisa alternativa
AltSearchImageType string

Define o que a entrada 'Imagem de pesquisa alternativa' representa. Se definido como 'Nenhum' ou em branco, não há nenhuma imagem de pesquisa alternativa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem.

Imagem de pesquisa alternativa
AltSearchImage string

Uma imagem de pesquisa alternativa opcional para localizar dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa alternativa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. Se você especificar uma imagem de pesquisa alternativa, o Agente procurará a imagem de pesquisa ou alternativa e relatará qual delas foi localizada.

Desvio máximo de cor
MaxColourDeviation integer

O máximo de cores de pixel de um elemento pode se desviar das cores de pixel da imagem de pesquisa antes que ele não seja considerado uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Isto permite que pequenas diferenças de coloração sejam ignoradas.

Diferenças máximas de pixels
MaxPixelDifferences integer

O número máximo de píxeis que pode diferir (acima do desvio máximo de cor) em toda a imagem pesquisada, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definido para um valor acima de 0, você também deve definir 'Máximo de diferenças de pixels consecutivos'.

Máximo de diferenças consecutivas de pixels
MaxConsecutivePixelDifferences integer

O número máximo de pixels consecutivos que podem diferir (acima do desvio máximo de cor), em qualquer linha, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definindo para um valor acima de 0, você também deve definir 'Diferenças máximas de pixels'.

Deslocamento X do pixel esquerdo
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento X do pixel direito
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Deslocamento Y de pixel superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento Y do pixel inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Unidade de deslocamentos do Pixel X
PixelXOffsetsUnit string

Defina como 'Pixel' (o padrão) se os deslocamentos de pixel X esquerdo e direito forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos de pixel X esquerdo e direito forem medidos como uma porcentagem da largura do elemento.

Unidade de deslocamentos Pixel Y
PixelYOffsetsUnit string

Defina como 'Pixel' (o padrão) se os deslocamentos de pixel Y superior e inferior forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos Y de pixel superior e inferior forem medidos como uma porcentagem da altura do elemento.

Índice de imagens de pesquisa
SearchImageIndex integer

Defina como 1 para localizar a primeira instância da imagem de pesquisa (na direção da pesquisa) dentro do elemento UIA. Definido como 2 para a segunda instância, .... , N para a nona instância. Se você também estiver procurando por uma imagem alternativa, o elemento UIA será digitalizado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, procurando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma mistura de ambas as imagens).

Direção da pesquisa de imagens
ImageSearchDirection string

A direção da busca. 'Do topo' pesquisa por linha a partir do topo, digitalizando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha a partir da parte inferior, digitalizando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, digitalizando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, digitalizando de cima para baixo dentro de cada coluna. Isto pode ser usado em conjunto com 'Pesquisar índice de imagem' para localizar a Nona imagem a partir da parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção de pesquisa que você acha que localizará sua imagem mais rapidamente.

Ocultar agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado.

Retornar coordenadas da tela como físicas
ReturnPhysicalCoordinates boolean

Defina como true para que as coordenadas da tela sejam retornadas como coordenadas físicas. Defina como false para que as coordenadas da tela sejam retornadas como coordenadas virtuais. Se o dimensionamento de exibição subjacente for de 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas do elemento são sempre retornadas como coordenadas virtuais.

Mostrar retângulo de realce
ShowHighlightRectangle boolean

Se definido como true, o IA-Connect Agent destacará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detetada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Pesquisar imagem localizada
SearchImageLocated boolean

Defina como true, se a imagem de pesquisa foi localizada. Defina como false, se a imagem de pesquisa não foi localizada.

Qual imagem de pesquisa localizada
WhichSearchImageLocated integer

Defina como 0, se nenhuma imagem de pesquisa for localizada. Defina como 1 se a imagem de pesquisa foi localizada. Defina como 2 se a imagem de pesquisa alternativa foi localizada.

Elemento da caixa delimitadora de correspondência de imagem pixel esquerdo
SearchImageBoundingBoxElementLeftPixelXCoord integer

A coordenada X virtual do pixel mais à esquerda correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo.

Pixel direito do elemento da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxElementRightPixelXCoord integer

A coordenada X virtual do pixel mais à direita correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo.

Pixel superior do elemento da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxElementTopPixelYCoord integer

A coordenada Y virtual do pixel mais alto correspondente à imagem especificada, em relação ao elemento virtual no canto superior esquerdo.

Pixel inferior do elemento da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxElementBottomPixelYCoord integer

A coordenada Y virtual do pixel mais inferior correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo.

Elemento da caixa delimitadora de correspondência de imagem centro X pixel
SearchImageBoundingBoxElementCenterPixelXCoord integer

A coordenada X virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual no canto superior esquerdo.

Elemento da caixa delimitadora de correspondência de imagem centro Y pixel
SearchImageBoundingBoxElementCenterPixelYCoord integer

A coordenada Y virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual superior esquerdo.

Tela da caixa delimitadora de correspondência de imagem pixel esquerdo
SearchImageBoundingBoxScreenLeftPixelXCoord integer

A coordenada X do pixel da tela do pixel mais à esquerda correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Tela da caixa delimitadora de correspondência de imagem pixel direito
SearchImageBoundingBoxScreenRightPixelXCoord integer

A coordenada X do pixel mais à direita correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel superior da tela da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxScreenTopPixelYCoord integer

A coordenada Y do pixel da tela correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel inferior da tela da caixa delimitadora de correspondência de imagem
SearchImageBoundingBoxScreenBottomPixelYCoord integer

A coordenada Y do pixel da tela que corresponde à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Tela da caixa delimitadora de correspondência de imagem central X pixel
SearchImageBoundingBoxScreenCenterPixelXCoord integer

A coordenada X do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Caixa delimitadora de correspondência de imagem tela central Y pixel
SearchImageBoundingBoxScreenCenterPixelYCoord integer

A coordenada Y do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Maximizar a janela UIA

Maximiza a janela com a alça UIA especificada.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela
WindowHandle True integer

A alça UIA para a janela a ser maximizada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Minimizar a janela UIA

Minimiza a janela com a alça UIA especificada.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela
WindowHandle True integer

A alça UIA para que a janela seja minimizada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Mover elemento UIA

Move um elemento UIA para uma posição especificada na tela. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipo de movimento horizontal
HorizontalMovementType string

O tipo de movimento: Absoluto ou relativo.

Posição horizontal
HorizontalPosition True integer

A nova posição horizontal para o elemento. O tipo de movimento (por exemplo, absoluto ou relativo) é definido pela entrada «Tipo de movimento horizontal». Para deixar a posição horizontal inalterada, escolha um valor de 0 e defina 'Tipo de movimento horizontal' como 'Relativo'.

Tipo de movimento vertical
VerticalMovementType string

O tipo de movimento: Absoluto ou relativo.

Posição vertical
VerticalPosition True integer

A nova posição vertical para o elemento. O tipo de movimento (por exemplo, absoluto ou relativo) é definido pela entrada «Tipo de movimento vertical». Para deixar a posição vertical inalterada, escolha um valor de 0 e defina 'Tipo de movimento vertical' como 'Relativo'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Resultado do comando
UIAMoveElementResult boolean

O resultado do comando (sucesso ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada.

O elemento da área de trabalho UIA existe

Relata se um elemento da área de trabalho existe e fornece algumas propriedades básicas do elemento.

Parâmetros

Name Chave Necessário Tipo Description
Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Id do processo de pesquisa
SearchProcessId integer

Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0).

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe
ElementExists boolean

Retorna true se o elemento existir ou false se não.

Alça do elemento
ElementHandle integer

O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

O elemento UIA está verificado

Essa ação retorna true ou false indicando se um elemento (normalmente uma caixa de seleção ou caixa de rádio) está marcado.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento está verificado
ElementIsChecked boolean

Retorna true se o elemento estiver verificado ou false se não.

O elemento UIA existe

Informa se um elemento existe e retorna algumas propriedades básicas do elemento.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Id do processo de pesquisa
SearchProcessId integer

Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0).

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será pesquisado.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
O elemento existe
ElementExists boolean

Retorna true se o elemento existir ou false se não.

Alça do elemento
ElementHandle integer

O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

O processo tem janela Win32

Uma ação Win32 simples e rápida que relata se um processo (especificado pelo nome) tem alguma janela visível. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Parâmetros

Name Chave Necessário Tipo Description
Nome do processo de pesquisa
SearchProcessName True string

O nome do processo a pesquisar, por exemplo, bloco de notas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Processo tem janela
ProcessHasWindow boolean

Retorna true se o processo tiver uma janela visível, ou false se não.

Obter a região de cores de pesquisa do elemento UIA

Retorna os detalhes da região de pixels dentro de um elemento UIA que atendem aos critérios de cor especificados. O elemento deve ser trazido para a frente primeiro, porque o Agente localiza as cores fazendo uma captura de tela nas coordenadas do elemento.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Cor da pesquisa
SearchColour True string

Pesquise cores no formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB em que cada canal de cor é um byte em formato hexadecimal (00 está totalmente desligado, FF está totalmente ligado). Por exemplo: #FF0000 para vermelho, #00FF00 para azul, #000000 para preto #FFFFFF para branco.

Desvio máximo de cor
MaxColourDeviation True integer

O máximo que uma cor de elemento pode desviar da cor de pesquisa antes de não ser considerada uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Um desvio de 15 seria um bom ponto de partida.

Deslocamento X do pixel esquerdo
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento X do pixel direito
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Deslocamento Y de pixel superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa.

Deslocamento Y do pixel inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa.

Ocultar agente
HideAgent boolean

Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado.

Retornar coordenadas da tela como físicas
ReturnPhysicalCoordinates boolean

Defina como true para que as coordenadas da tela sejam retornadas como coordenadas físicas. Defina como false para que as coordenadas da tela sejam retornadas como coordenadas virtuais. Se o dimensionamento de exibição subjacente for de 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas do elemento são sempre retornadas como coordenadas virtuais.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de pixels correspondentes à cor
NumberOfPixelsMatchingColour integer

O número de pixels que correspondem à cor especificada.

Elemento da caixa delimitadora de correspondência de cores pixel esquerdo
ColourMatchBoundingBoxElementLeftPixelXCoord integer

A coordenada X virtual do pixel mais à esquerda correspondente à cor especificada, em relação ao elemento virtual superior esquerdo.

Elemento da caixa delimitadora de correspondência de cores pixel direito
ColourMatchBoundingBoxElementRightPixelXCoord integer

A coordenada X virtual do pixel mais à direita correspondente à cor especificada, em relação ao elemento virtual superior esquerdo.

Pixel superior do elemento da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementTopPixelYCoord integer

A coordenada Y virtual do pixel mais alto correspondente à cor especificada, em relação ao elemento virtual no canto superior esquerdo.

Pixel inferior do elemento da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementBottomPixelYCoord integer

A coordenada Y virtual do pixel mais inferior correspondente à cor especificada, em relação ao elemento virtual no canto superior esquerdo.

Elemento da caixa delimitadora de correspondência de cor centro X pixel
ColourMatchBoundingBoxElementCenterPixelXCoord integer

A coordenada X virtual do centro da caixa delimitadora contendo pixels correspondentes à cor especificada, em relação ao elemento virtual no canto superior esquerdo.

Elemento da caixa delimitadora de correspondência de cores central Y pixel
ColourMatchBoundingBoxElementCenterPixelYCoord integer

A coordenada Y virtual do centro da caixa delimitadora contendo pixels correspondentes à cor especificada, em relação ao elemento virtual no canto superior esquerdo.

Tela da caixa delimitadora de correspondência de cores pixel esquerdo
ColourMatchBoundingBoxScreenLeftPixelXCoord integer

A coordenada X do pixel da tela do pixel mais à esquerda que corresponde à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel direito do ecrã da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxScreenRightPixelXCoord integer

A coordenada X do pixel da tela correspondente à cor especificada no pixel mais à direita. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel superior da tela da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxScreenTopPixelYCoord integer

A coordenada Y do pixel mais alto do pixel correspondente à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel inferior da tela da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxScreenBottomPixelYCoord integer

A coordenada Y do pixel da parte inferior corresponde à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Caixa delimitadora de correspondência de cores, ecrã central, X pixel
ColourMatchBoundingBoxScreenCenterPixelXCoord integer

A coordenada X do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Caixa delimitadora de correspondência de cores, centro do pixel Y
ColourMatchBoundingBoxScreenCenterPixelYCoord integer

A coordenada Y do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Obter conteúdo do elemento de grade de dados UIA

Retorna o conteúdo de um elemento datagrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela). Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Recuperar apenas colunas na tela
OnScreenColumnsOnly boolean

Se definido como true, apenas as colunas na tela serão retornadas.

Recuperar apenas linhas na tela
OnScreenRowsOnly boolean

Se definido como true, apenas as linhas na tela serão retornadas.

Retornar valores nulos como em branco
ReturnNullValuesAsBlank boolean

Se definido como true, os valores nulos serão retornados como '' (ou seja, em branco). Se definido como false, os valores nulos são normalmente retornados como '(null)'.

Nome alternativo da linha de cabeçalho
AlternativeHeaderRowName string

Por padrão, a linha de cabeçalho em um DataGrid tem o nome do elemento UIA 'Linha Superior'. Se a linha de cabeçalho tiver um nome diferente, especifique esse nome aqui.

Nome da UIA da linha de retorno
ReturnRowUIAName boolean

Se essa entrada estiver definida como , o nome da linha UIA será armazenado em uma coluna na coleção de saída. O nome da coluna é definido pela entrada 'Nome da coluna para armazenar o nome UIA da linha'.

Nome da coluna para armazenar o nome da linha UIA
NameOfColumnToStoreRowUIAName string

Se a entrada 'Nome da UIA da linha de retorno' estiver definida como true, essa entrada especifica o nome da coluna na coleção de saída para manter o nome da UIA da linha.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Primeiro item a devolver
FirstItemToReturn integer

O índice do elemento do primeiro item (linha) a retornar, a partir de 1.

Máximo de itens a devolver
MaxItemsToReturn integer

O número máximo de itens (linhas) a devolver ou 0 a devolver todos os itens (linhas).

Verificar as primeiras N linhas em busca de linhas vazias
ScanFirstNRowsForEmptyRows integer

Algumas grades de dados têm alguns elementos de linha vazios/nulos na árvore UIA (geralmente na parte superior) e IA-Connect ignorarão automaticamente esses elementos de linha, pois eles não representam nada na tabela que é visível na interface do usuário. Se essa entrada for definida como 0 (o padrão), o Agente de IA-Connect sempre verificará os elementos da linha a partir da primeira linha, mesmo que 'Primeiro item a retornar' esteja definido para recuperar linhas mais profundas dentro da tabela. Isso garante a consistência com os números de índice de linha, mas afeta o desempenho, uma vez que todas as linhas, desde a primeira linha até a(s) linha(s) solicitada(s), precisam ser verificadas. Se você tiver certeza de que os únicos elementos de linha vazios / nulos na tabela estão dentro das primeiras linhas N (por exemplo, 10), você pode definir isso como N (por exemplo, 10) para potencialmente melhorar o desempenho. Não defina para um valor diferente de 0, a menos que saiba o que está a fazer.

Ler tabela como thread
ReadTableAsThread boolean

Se definido como false (o padrão), o IA-Connect Agent lerá a tabela imediatamente e retornará o conteúdo ao Diretor. Se estiver lendo tabelas grandes, essa ação pode atingir o tempo limite. Se definido como true, o IA-Connect Agent lerá a tabela como um thread do Agent e o Diretor do IA-Connect (ou Orchestrator, módulo do PowerShell, Blue Prism) poderá monitorar o status desse thread do Agente, aguardando sua conclusão. Isso permite que tabelas grandes sejam lidas sem tempos limites. IA-Connect Agents 9.3 e versões anteriores só podiam ler tabelas imediatamente, não como um thread do Agente.

Recuperar dados de saída para ID de thread
RetrieveOutputDataFromThreadId integer

Se você executou anteriormente essa ação como um thread do Agente e definiu 'Segundos para aguardar o thread' como 0, forneça o ID do thread do Agente para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Defina como 0 (o padrão) se você estiver lendo uma grade de dados (e, portanto, não recuperando os resultados de uma consulta anterior executada como um thread do Agente).

Segundos para esperar pelo thread
SecondsToWaitForThread integer

Se 'Ler tabela como thread' estiver definido como true, quantos segundos aguardar a conclusão do thread do Agente. Se o thread do Agente que lê a tabela não tiver sido concluído nesse período, uma exceção será gerada. Defina como 0 para ignorar a espera: o Agente continuará a ler a grade de dados, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados (o conteúdo da grade de dados) posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente essa ação 'Obter conteúdo do elemento de grade de dados UIA' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente.

Rolar a grade de dados verticalmente a cada N por cento
ScrollDataGridVerticallyEveryNPercent integer

Observou-se que o desempenho da leitura de algumas grades de dados grandes (por exemplo: com milhares de linhas) melhora se você rolar periodicamente a grade de dados para (ou perto) do local que está sendo rolado. Se definido como 0 (o padrão), a grade de dados não será rolada durante a leitura do conteúdo. Se definido como um valor entre 1 e 100, a grade de dados será rolada periodicamente (cada N por cento do número total de linhas) durante a leitura do conteúdo. Por exemplo: Se definido como 20, a grade de dados será rolada em 0, 20, 40, 60, 80%. Como alternativa, use 'Rolar grade de dados verticalmente a cada N linhas' para rolar cada N linhas em vez de cada N por cento.

Rolar a grade de dados verticalmente a cada N linhas
ScrollDataGridVerticallyEveryNRows integer

Observou-se que o desempenho da leitura de algumas grades de dados grandes (por exemplo: com milhares de linhas) melhora se você rolar periodicamente a grade de dados para (ou perto) do local que está sendo rolado. Se definido como 0 (o padrão), a grade de dados não será rolada durante a leitura do conteúdo. Se definido como um valor 1 ou superior, a grade de dados será rolada a cada N linhas durante a leitura do conteúdo. Por exemplo: Se definido como 5, a grade de dados será rolada a cada 5 linhas. Como alternativa, use 'Rolar grade de dados verticalmente a cada N por cento' para rolar cada N por cento das linhas em vez de cada N linhas.

Rolar a grade de dados verticalmente identificador do elemento
ScrollDataGridVerticallyElementHandle integer

Se rolar a grade de dados verticalmente enquanto lê o conteúdo, essa entrada define como IA-Connect localizará a barra de rolagem vertical. Se definido como 0, IA-Connect tentará rolar a grade de dados diretamente, usando o padrão 'scroll' (se a grade de dados suportar) ou procurando pela barra de rolagem vertical contida na grade de dados. Como alternativa, você pode especificar o identificador UIA IA-Connect do elemento da barra de rolagem vertical (o elemento da barra de rolagem em si, não os botões dentro), que é um valor de 1 ou superior.

Linhas mínimas da grade de dados para rolagem
MinimumDataGridRowsForScrolling integer

Se rolar a grade de dados verticalmente enquanto lê o conteúdo, essa entrada especifica o número mínimo de linhas necessárias na tabela antes que IA-Connect execute a rolagem. Se definido como 0, IA-Connect rolará independentemente do número de linhas. Se definido como um número positivo, IA-Connect só executará a rolagem quando a grade de dados tiver esse número de linhas ou mais.

Aumentar exceção se não for possível rolar
RaiseExceptionIfCannotScroll boolean

Se rolar a grade de dados verticalmente durante a leitura do conteúdo: defina essa entrada como true se uma falha na rolagem for considerada uma exceção, ou defina como false (o padrão) se uma falha na rolagem for ignorada. Falhas comuns na rolagem incluem falha na localização das barras de rolagem ou as barras de rolagem não têm um padrão UIA adequado para rolagem ('scroll', 'rangevalue' ou 'value').

Nome alternativo da barra de rolagem vertical
AlternativeVerticalScrollbarName string

Por padrão, a barra de rolagem vertical 'linha' em uma grade de dados tem o nome do elemento UIA 'Barra de rolagem vertical'. Se a barra de rolagem vertical tiver um nome diferente, especifique esse nome aqui. Isso será usado se você quiser que IA-Connect role periodicamente a grade de dados enquanto lê o conteúdo, o campo de entrada 'Scroll datagrid vertically element handle' está definido como 0 (especificando que IA-Connect deve rolar a grade de dados diretamente), mas a grade de dados não implementa o padrão 'scroll'.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Conteúdo da grade de dados JSON
DataGridContentsJSON string

O conteúdo do elemento datagrid, no formato JSON.

Número de linhas na tabela
NumberOfRowsInTable integer

O número de linhas na tabela de saída se a tabela foi lida imediatamente.

Número de colunas na tabela
NumberOfColumnsInTable integer

O número de colunas na tabela de saída, se a tabela foi lida imediatamente.

Thread Id
ThreadId integer

Se essa ação estiver sendo executada como um thread do agente, essa saída manterá o ID do thread do agente, que pode ser usado para monitorar o processo da ação e recuperar o conteúdo da grade de dados quando o thread for concluído.

Obter elementos da área de trabalho UIA

Retorna uma lista de todas as janelas e caixas de diálogo na área de trabalho.

Parâmetros

Name Chave Necessário Tipo Description
Tipo de controle localizado do elemento de pesquisa
SearchElementLocalizedControlType string

Filtre os resultados pelo tipo de controle localizado do elemento.

Id do processo de pesquisa
SearchProcessID integer

Se especificado, a pesquisa considerará apenas elementos pertencentes a um processo com esta ID de processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Primeiro item a devolver
FirstItemToReturn integer

O índice de elementos do primeiro item a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1.

Máximo de itens a devolver
MaxItemsToReturn integer

O número máximo de elementos a devolver ou 0 a devolver todos os itens.

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de elementos encontrados
NumberOfElementsFound integer

O número de elementos da área de trabalho encontrados que correspondem aos critérios de pesquisa.

Número de elementos retornados
NumberOfElementsReturned integer

O número de elementos da área de trabalho retornados (isso pode ser menor do que o número de elementos encontrados se especificar um número máximo de itens a serem retornados).

Propriedades do elemento
ElementProperties array of object

As propriedades dos elementos da área de trabalho encontrados que correspondem aos critérios de pesquisa.

items
ElementProperties object

Obter identificador de elemento pai da UIA

Retorna um identificador para o elemento pai do elemento especificado. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.

Parâmetros

Name Chave Necessário Tipo Description
Alça do elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Identificador do elemento pai
ParentElementHandle integer

Um identificador UIA para o elemento pai.

Obter identificador UIA para a janela principal do elemento focalizado

Retorna um identificador para a janela principal do elemento UIA focado no momento. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

Obter identificador UIA para a janela principal do ID do processo

Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pela ID do processo). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Parâmetros

Name Chave Necessário Tipo Description
Id do processo de pesquisa
ProcessId True integer

O ID do processo a aguardar (conforme fornecido pela ação 'Executar processo' nas ações Ambiente de IA-Connect / Sessão).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

Obter identificador UIA para a janela principal do processo

Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pelo nome). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.

Parâmetros

Name Chave Necessário Tipo Description
Nome do processo de pesquisa
SearchProcessName True string

O nome do processo a pesquisar, por exemplo, bloco de notas.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

Obter identificador UIA para a janela Win32 de nível superior

Uma ação Win32 rápida que retorna um identificador UIA para qualquer janela Win32 de nível superior que tenha o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Uma janela de nível superior é aquela que está conectada à área de trabalho. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.

Parâmetros

Name Chave Necessário Tipo Description
Pesquisar nome da classe
SearchClassName string

O nome da classe do elemento da janela de nível superior para pesquisar, por exemplo, 'Bloco de Notas'.

Título da janela de pesquisa
SearchWindowTitle string

O título da janela de nível superior para pesquisar.

Id do processo de pesquisa
SearchProcessId integer

A ID do processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais em relação às propriedades de janela disponíveis. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de janela classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher a janela necessária. Por exemplo: Se 'Ordenar por nome de coluna' for [TopEdge] e 'Índice de correspondência' for 1, a janela correspondente mais próxima da parte superior do ecrã será devolvida.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se várias janelas corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da UIA do elemento window.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento window.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento window.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento window.

Obter identificador UIA para desktop

Retorna um identificador para a área de trabalho. Esta é uma ação obsoleta porque o identificador '-2' pode ser usado para se referir ao elemento desktop, mas também porque há muitas ações que podem pesquisar em relação à área de trabalho (por exemplo, 'esperar pelo elemento desktop').

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a área de trabalho. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento da área de trabalho.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento desktop.

Id de automação de elementos
ElementAutomationId string

A ID de automação da interface do usuário do elemento da área de trabalho.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado da interface do usuário do elemento da área de trabalho.

Obter identificador UIA para elemento focalizado

Retorna um identificador para o elemento UIA focado no momento.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Alça da janela
WindowHandle integer

O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Obter itens de elemento de lista UIA

Retorna uma lista de itens de elemento filho encontrados sob o elemento especificado (normalmente itens suspensos/de menu).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Expandir primeiro
ExpandFirst boolean

Se definido como true, IA-Connect tentará expandir a lista antes de procurar os elementos do item de lista. Isso é útil para listas dinâmicas, pois os elementos do item de lista podem não ser criados até que a lista seja expandida.

Fechar após
CollapseAfter boolean

Se definido como true, a lista será recolhida após a execução da pesquisa.

Verificar se há itens selecionados
CheckForSelectedItems boolean

Se definido como true, a coleção de saída conterá uma propriedade adicional indicando se o item de lista está selecionado no momento.

Segundos entre expandir e recolher
SecondsBetweenExpandCollapse double

O número de segundos a aguardar entre as ações de expansão e recolhimento, se estas estiverem definidas como true.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de itens da lista
NumberOfListItems integer

O número de itens na lista.

Listar itens JSON
ListItemsJSON string

As propriedades dos itens na lista, no formato JSON.

Número de itens selecionados
NumberOfSelectedItems integer

O número de itens selecionados na lista.

Índice do primeiro item selecionado
IndexOfFirstSelectedItem integer

O índice na lista do primeiro item selecionado.

Nome do item selecionado
SelectedItemName string

O nome do item selecionado.

Obter janelas Win32

Uma ação rápida do Win32 que retorna uma lista de todas as janelas do Win32 que opcionalmente têm o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. Win32 Windows pode incluir itens inesperados, incluindo a barra de tarefas, área de trabalho, menu Iniciar, sobreposições transparentes, fora da tela ou janelas ocultas, para que a lista retornada pode conter mais resultados do que o esperado.

Parâmetros

Name Chave Necessário Tipo Description
Pesquisar nome da classe
SearchClassName string

O nome de classe opcional da janela de nível superior para pesquisar, por exemplo, 'Chrome_WidgetWin_1'.

Título da janela de pesquisa
SearchWindowTitle string

O título opcional da janela de nível superior para pesquisar.

Recuperar apenas janelas de nível superior
TopLevelWindowsOnly boolean

Defina como true para recuperar apenas as janelas do Win32 que o SO considera de nível superior. Defina como false para recuperar todas as janelas do Win32. Observe que a definição do Win32 de uma janela incluirá itens que você pode não reconhecer como uma janela e muitas caixas de diálogo e caixas de mensagem são marcadas como de nível superior, mesmo que sejam filhos de uma janela pai.

Recuperar apenas janelas visíveis
VisibleWindowsOnly boolean

Defina como true para recuperar apenas as janelas do Win32 que o SO considera visíveis. Defina como false para recuperar janelas Win32 visíveis e não visíveis. Observe que as janelas fora da tela ou transparentes podem estar marcadas como visíveis, mas você não pode vê-las.

Recuperar apenas janelas com uma barra de título
WindowsWithTitlebarOnly boolean

Defina como true para recuperar apenas janelas do Win32 com uma barra de título. Defina como false para recuperar janelas do Win32, independentemente de terem uma barra de título ou não. Observe que algumas janelas transparentes têm barras de título, mas você não pode vê-las.

Recuperar apenas janelas com um título
WindowsWithTitleOnly boolean

Defina como true para recuperar apenas janelas do Win32 com um título (ou seja, uma barra de título contendo algum texto). Defina como false para recuperar janelas do Win32, independentemente de terem um título. Observe que a barra de título é a faixa na parte superior da janela, enquanto o título é o texto dentro dela.

Ignorar janelas transparentes
IgnoreTransparentWindows boolean

Defina como true para recuperar apenas janelas do Win32 que não têm transparência. Defina como false para recuperar janelas do Win32, independentemente de terem transparência definida ou não.

Id do processo de pesquisa
SearchProcessId integer

O ID do processo opcional do processo que possui as janelas (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente de IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de janela classificar. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge], então a lista de janelas será devolvida ordenada pela aresta superior. Se este campo for deixado em branco, as janelas serão retornadas na ordem em que forem detetadas.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se várias janelas corresponderem à pesquisa e uma coluna de classificação for especificada, defina como true (padrão) para classificar em ordem crescente ou como false para classificar em sentido descendente.

Retornar identificador de elemento UIA
ReturnElementHandle boolean

Se definido como true, um identificador UIA para cada janela Win32 localizada será retornado na coleção de saída (na coluna 'UIAHandle'). Esse identificador pode ser usado em outras ações para atuar como um identificador 'pai' em IA-Connect ações da UIA.

Primeiro item a devolver
FirstItemToReturn integer

O índice da primeira janela (linha) a retornar, a partir de 1.

Máximo de itens a devolver
MaxItemsToReturn integer

O número máximo de janelas a devolver ou 0 a devolver todos os itens.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Win32 windows JSON
Win32WindowsJSON string

Uma lista de janelas Win32 correspondentes aos critérios de pesquisa, no formato JSON.

Número de janelas Win32
NumberOfWin32Windows integer

O número de janelas Win32 retornado.

Obter o elemento UIA nas coordenadas da tela

Retorna o elemento UIA localizado nas coordenadas de tela fornecidas.

Parâmetros

Name Chave Necessário Tipo Description
Coordenada X
XCoord integer

O valor da coordenada X da tela (em pixels) onde o elemento UIA deve ser pesquisado.

Coordenada Y
YCoord integer

O valor da coordenada Y da tela (em pixels) onde o elemento UIA deve ser pesquisado.

Levantar exceção se o elemento não for encontrado
RaiseExceptionIfElementNotFound boolean

O IA-Connect deve gerar uma exceção se um elemento da interface do usuário não estiver localizado no local especificado?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Elemento encontrado
ElementFound boolean

Retorna true se um elemento UIA foi encontrado no local especificado.

Alça do elemento
ElementHandle integer

O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento.

Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Obter o modo de pesquisa de elementos UIA

Recupera qual modo de pesquisa de elemento UIA está sendo usado pelo IA-Connect Agent for UIA ações.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Modo de pesquisa de elemento UIA
UIAElementSearchMode string

O modo de pesquisa do elemento UIA atual usado pelo Agente IA-Connect.

Obter padrões de elemento UIA

Recupere quais padrões de UIA estão disponíveis para um elemento UIA e, portanto, quais ações de UIA IA-Connect provavelmente terão um efeito sobre o elemento.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Expandir padrão de recolhimento disponível
ExpandCollapsePatternAvailable boolean

O padrão de colapso de expansão da UIA está disponível e, portanto, as ações que expandem ou recolhem um elemento (por exemplo, um menu suspenso) provavelmente funcionarão.

Invocar padrão disponível
InvokePatternAvailable boolean

O padrão de invocação UIA está disponível e, portanto, as ações que pressionam um elemento ou clicam em um item de elemento de lista provavelmente funcionarão.

Padrão de valor do intervalo disponível
RangeValuePatternAvailable boolean

O padrão de valor do intervalo UIA está disponível e, portanto, as ações que rolam um elemento ou controle deslizante provavelmente funcionarão.

Padrão de rolagem disponível
ScrollPatternAvailable boolean

O padrão de rolagem UIA está disponível e, portanto, as ações que rolam um elemento provavelmente funcionarão.

Padrão de item de seleção disponível
SelectionItemPatternAvailable boolean

O padrão de item de seleção da UIA está disponível e, portanto, as ações que selecionam um elemento provavelmente funcionarão.

Padrão de texto disponível
TextPatternAvailable boolean

O padrão de texto UIA está disponível e, portanto, as ações que leem um valor de texto de elemento provavelmente funcionarão.

Padrão de alternância disponível
TogglePatternAvailable boolean

O padrão de alternância UIA está disponível e, portanto, as ações que verificam, desmarcam ou alternam um elemento provavelmente funcionarão.

Padrão de valor disponível
ValuePatternAvailable boolean

O padrão de valor UIA está disponível e, portanto, as ações que inserem texto em um elemento ou ler um valor de elemento provavelmente funcionarão. As barras de rolagem também podem reagir a um padrão de valor.

Padrão de janela disponível
WindowPatternAvailable boolean

O padrão de janela UIA está disponível e, portanto, ações que fecham, maximizam ou minimizam um elemento provavelmente funcionarão.

Padrão de grade disponível
GridPatternAvailable boolean

O padrão de grade UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de item de grade disponível
GridItemPatternAvailable boolean

O padrão de item de grade da UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão IAccessible legado disponível
LegacyIAccessiblePatternAvailable boolean

O padrão IAccessible herdado da UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de seleção disponível
SelectionPatternAvailable boolean

O padrão de seleção UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de planilha disponível
SpreadsheetPatternAvailable boolean

O padrão de planilha UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de item de planilha disponível
SpreadsheetItemPatternAvailable boolean

O padrão de item de planilha UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de tabela disponível
TablePatternAvailable boolean

O padrão de tabela UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de item de tabela disponível
TableItemPatternAvailable boolean

O padrão de item de tabela UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de texto 2 disponível
TextPattern2Available boolean

O padrão de texto UIA 2 está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de edição de texto disponível
TextEditPatternAvailable boolean

O padrão de edição de texto UIA está disponível. Este padrão não é usado pelo IA-Connect.

Padrão de transformação disponível
TransformPatternAvailable boolean

O padrão de transformação UIA está disponível. Este padrão não é usado pelo IA-Connect.

Obter propriedades do elemento datagrid da UIA

Retorna propriedades de tabela de um elemento DataGrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Nome alternativo da linha de cabeçalho
AlternativeHeaderRowName string

Por padrão, a linha de cabeçalho em um DataGrid tem o nome da interface do usuário 'Linha Superior'. Se a linha de cabeçalho tiver um nome diferente, especifique esse nome aqui.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de colunas
NumberOfColumns integer

O número de colunas na grade de dados.

Número de colunas visíveis
NumberOfVisibleColumns integer

O número de colunas visíveis na grade de dados.

Número de linhas
NumberOfRows integer

O número de linhas na grade de dados.

Número de linhas visíveis
NumberOfVisibleRows integer

O número de linhas visíveis na grade de dados.

Primeira linha visível
FirstVisibleRow integer

O índice da primeira linha visível na grade de dados.

Última linha visível
LastVisibleRow integer

O índice da última linha visível na grade de dados.

Número de barras de rolagem
NumberOfScrollbars integer

O número de barras de rolagem que a grade de dados tem.

Nomes da barra de rolagem
ScrollbarNames string

Uma lista separada por vírgulas dos nomes das barras de rolagem (por exemplo, Horizontal, Vertical).

Obter propriedades do elemento UIA

Retorna todas as propriedades de um elemento. Isso pode ser útil se você não tiver certeza de qual campo contém os valores de propriedade necessários.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Valor do elemento de retorno
ReturnElementValue boolean

Se definido como true, o valor do elemento localizado será retornado.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Nome do elemento
ElementName string

O nome da interface do usuário do elemento.

Nome da classe do elemento
ElementClassName string

O nome da classe UIA do elemento.

Id de automação de elementos
ElementAutomationId string

A ID de automação da UIA do elemento.

Id da estrutura do elemento
ElementFrameworkId string

A ID da estrutura UIA do elemento .

Tipo de controle de elemento
ElementControlType string

O tipo de controle UIA como um número. Isso é semelhante ao tipo de controle localizado, mas não é específico do idioma.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

O elemento está ativado
ElementIsEnabled boolean

Retorna se o elemento habilitado ou não.

O elemento está fora da tela
ElementIsOffscreen boolean

Retorna se o elemento está fora da tela ou não.

O elemento é focalizável pelo teclado
ElementIsKeyboardFocusable boolean

Retorna se o elemento pode ser focado pelo teclado.

Elemento tem foco do teclado
ElementHasKeyboardFocus boolean

Retorna se o elemento atualmente tem foco no teclado.

O elemento é o campo de senha
ElementIsPasswordField boolean

Retorna se um elemento é um campo de entrada de senha.

Tecla aceleradora do elemento
ElementAcceleratorKey string

Retorna a tecla de atalho que pode ser pressionada para ativar o elemento.

Chave de acesso do elemento
ElementAccessKey string

Retorna a tecla de atalho que pode ser pressionada para ativar um elemento de menu.

Borda esquerda do elemento
ElementLeftEdge integer

A distância em pixels entre a borda esquerda do elemento ou janela e a borda esquerda da tela.

Borda direita do elemento
ElementRightEdge integer

A distância em pixels entre a borda direita do elemento ou janela e a borda esquerda da tela.

Borda superior do elemento
ElementTopEdge integer

A distância em pixels entre a borda superior do elemento ou janela e a borda superior da tela.

Borda inferior do elemento
ElementBottomEdge integer

A distância em pixels entre a borda inferior do elemento ou janela e a borda superior da tela.

Elemento clicável ponto X
ElementClickablePointX integer

A coordenada X em pixels de um ponto central clicável no elemento relativo à borda esquerda da exibição, conforme retornado pelo aplicativo subjacente.

Elemento clicável ponto Y
ElementClickablePointY integer

A coordenada Y em pixels de um ponto central clicável no elemento relativo à borda superior da exibição, conforme retornado pelo aplicativo subjacente.

ID do processo do elemento
ElementProcessId integer

A ID do processo (PID) do processo que possui esse elemento.

Alça do elemento
ElementHandle integer

Se a entrada 'Return element handle' foi definida como true, isso manterá um identificador de elemento numérico que pode ser usado em outras ações para atuar como um identificador 'pai' para ações futuras.

Valor do elemento
ElementValue string

Se a entrada 'Valor do elemento de retorno' foi definida como true e se o elemento tem um padrão de valor, isso manterá esse valor.

Valor do texto do elemento
ElementTextValue string

Se a entrada 'Valor do elemento de retorno' foi definida como true e se o elemento tiver um padrão de valor de texto, isso manterá esse valor de texto.

Obter propriedades do elemento UIA como lista

Retorna as propriedades de um elemento como uma lista de linha única (coleção de linha única / tabela de dados) em vez de itens individuais, isso pode ser útil dependendo de como você pretende usar os dados.

Parâmetros

Name Chave Necessário Tipo Description
Alça do elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de elementos encontrados
NumberOfElementsFound integer

O número de elementos encontrados.

Número de elementos retornados
NumberOfElementsReturned integer

O número de elementos retornados.

Propriedades do elemento UIA JSON
UIAElementPropertiesJSON string

As propriedades UIA do elemento , no formato JSON.

Obter valor de texto do elemento UIA

Retorna o valor de texto de um elemento. Um valor de texto geralmente é associado a um rótulo, mas muitos elementos podem ter essa propriedade.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Valor do texto do elemento
ElementTextValue string

O valor de texto do elemento.

Obter valor do elemento UIA

Retorna o valor de um elemento. Um valor geralmente é associado a uma área de entrada de texto, mas muitos elementos podem ter essa propriedade.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Valor do elemento
ElementValue string

O valor do elemento.

Obter valor do rótulo do elemento UIA

Retorna o valor do rótulo no elemento .

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Valor do rótulo do elemento
ElementLabelValue string

O valor do rótulo no elemento.

Obter várias propriedades de elementos UIA

Retorna as propriedades de vários elementos. Isso pode ser útil se você não tiver certeza de quais campos contêm os valores de propriedade necessários.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Tipo de controle localizado do elemento de pesquisa
SearchElementLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar descendentes
SearchDescendants boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Alça do elemento de retorno
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'.

Valor do elemento de retorno
ReturnElementValue boolean

Se definido como true, o valor do elemento localizado será retornado.

Primeiro item a devolver
FirstItemToReturn integer

O índice de elementos do primeiro item a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1.

Máximo de itens a devolver
MaxItemsToReturn integer

O número máximo de elementos a devolver ou 0 a devolver todos os itens.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de elementos encontrados
NumberOfElementsFound integer

O número de elementos encontrados que correspondem aos critérios de pesquisa.

Número de elementos retornados
NumberOfElementsReturned integer

O número de elementos retornados (isso pode ser menor do que o número de elementos encontrados se especificar um número máximo de itens a serem retornados).

Propriedades do elemento
ElementProperties array of object

As propriedades dos elementos encontrados que correspondem aos critérios de pesquisa.

items
ElementProperties object

Obter várias propriedades do elemento pai da UIA

Retorna uma árvore hierárquica de elementos pai do elemento especificado, até a área de trabalho (nível raiz). O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.

Parâmetros

Name Chave Necessário Tipo Description
Alça do elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Max pais para processar
MaxParentsToProcess integer

O número máximo de elementos pai a processar. Por padrão, isso é definido como 50.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Elementos pai da UIA
UIAParentElements array of object

Uma lista de todos os elementos pai localizados (e suas propriedades). As propriedades retornadas são as mesmas retornadas pela ação 'Obter propriedades de vários elementos'.

items
UIAParentElements object
Número de elementos pai retornados
NumberOfParentElementsReturned integer

O número de elementos pai retornados da pesquisa.

Obter vários elementos da UIA como tabela

Enumera os valores dos elementos filho de um elemento pai especificado e retorna em um formato de tabela. Isso pode ser usado para retornar linhas e colunas de dados de elementos que não são tecnicamente tabelas, mas foram organizados juntos em uma estrutura de tabela. Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Tipo de controle localizado do subelemento do cabeçalho da célula de pesquisa
SearchCellHeaderSubElementLocalizedControlType string

O tipo de controle localizado do subelemento do cabeçalho da célula a ser pesquisado. Deixe em branco se não estiver procurando cabeçalhos de células.

Tipo de controle do subelemento do cabeçalho da célula de pesquisa
SearchCellHeaderSubElementControlType integer

O tipo de controle de subelemento de cabeçalho de célula (um inteiro não localizado) a ser pesquisado. Este é o mesmo valor em diferentes idiomas. Deixe em 0 se não estiver procurando por cabeçalhos de célula.

Tipo de controle localizado do subelemento da célula de pesquisa
SearchCellSubElementLocalizedControlType string

O tipo de controle localizado do subelemento da célula a ser pesquisado.

Tipo de controle de subelemento de célula de pesquisa
SearchCellSubElementControlType integer

O tipo de controle de subelemento de célula (um inteiro não localizado) a ser pesquisado. Este é o mesmo valor em diferentes idiomas.

Pesquisar descendentes para subelementos de célula
SearchDescendantsForCellSubElements boolean

Se definido como true, a árvore UIA abaixo do elemento localizado será pesquisada por subelementos de célula e cabeçalho de célula (ou seja, os valores de elemento que preencherão as células na tabela de saída). Isto é mais exaustivo, mas pode demorar mais tempo. Você pode querer definir isso como false se estiver interessado apenas em elementos diretamente abaixo do elemento.

Primeiro subelemento de cabeçalho de célula a retornar
FirstCellHeaderSubElementToReturn integer

O índice do primeiro subelemento do cabeçalho da célula a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1.

Máximo de subelementos de cabeçalho de célula para retornar
MaxCellHeaderSubElementsToReturn integer

O número máximo de subelementos de cabeçalho de célula a serem retornados ou 0 para retornar todos os subelementos.

Primeiro subelemento de célula a retornar
FirstCellSubElementToReturn integer

O índice do primeiro subelemento de célula a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1.

Máximo de subelementos de célula para retornar
MaxCellSubElementsToReturn integer

O número máximo de subelementos de célula a serem retornados ou 0 a retornar todos os subelementos.

Número de colunas solicitado
RequestedNumberOfColumns integer

O número de colunas que você gostaria na tabela de saída. Esse valor deve estar correto para o elemento que está sendo lido, ou você receberá resultados inesperados.

Prioridade do valor do subelemento de célula
CellSubElementValuePriority integer

A prioridade para usar o valor do subelemento da célula como o valor a ser usado na tabela de saída. 1 é a prioridade máxima. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 é não utilizar.

Prioridade do valor do texto do subelemento da célula
CellSubElementTextValuePriority integer

A prioridade para usar o valor de texto do subelemento de célula como o valor a ser usado na tabela de saída. 1 é a prioridade máxima. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 é não utilizar.

Prioridade do valor do nome do subelemento da célula
CellSubElementNameValuePriority integer

A prioridade para usar o nome do subelemento da célula (comum para rótulos) como o valor a ser usado na tabela de saída. 1 é a prioridade máxima. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 é não utilizar.

Largura mínima do subelemento da célula
MinimumCellSubElementWidth integer

A largura mínima em pixels de um subelemento de célula a ser incluído na tabela.

Altura mínima do subelemento da célula
MinimumCellSubElementHeight integer

A altura mínima em pixels de um subelemento de célula a ser incluído na tabela.

Caixa delimitadora do subelemento da célula de pesquisa à esquerda
SearchCellSubElementBoundingBoxLeft integer

Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Caixa delimitadora do subelemento da célula de pesquisa à direita
SearchCellSubElementBoundingBoxRight integer

Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Topo da caixa delimitadora do subelemento da célula de pesquisa
SearchCellSubElementBoundingBoxTop integer

Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Parte inferior da caixa delimitadora do subelemento da célula de pesquisa
SearchCellSubElementBoundingBoxBottom integer

Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Ler tabela como thread
ReadTableAsThread boolean

Se definido como false (o padrão), o IA-Connect Agent lerá a tabela imediatamente e retornará o conteúdo ao Diretor. Se estiver lendo tabelas grandes, essa ação pode atingir o tempo limite. Se definido como true, o IA-Connect Agent lerá a tabela como um thread do Agent e o Diretor do IA-Connect (ou Orchestrator, módulo do PowerShell, Blue Prism) poderá monitorar o status desse thread do Agente, aguardando sua conclusão. Isso permite que tabelas grandes sejam lidas sem tempos limites. IA-Connect Agents 9.3 e versões anteriores só podiam ler tabelas imediatamente, não como um thread do Agente.

Recuperar dados de saída para ID de thread
RetrieveOutputDataFromThreadId integer

Se você executou anteriormente essa ação como um thread do Agente e definiu 'Segundos para aguardar o thread' como 0, forneça o ID do thread do Agente para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Defina como 0 (o padrão) se você estiver lendo uma tabela (e, portanto, não recuperando os resultados de uma consulta anterior executada como um thread do Agente).

Segundos para esperar pelo thread
SecondsToWaitForThread integer

Se 'Ler tabela como thread' estiver definido como true, quantos segundos aguardar a conclusão do thread do Agente. Se o thread do Agente que lê a tabela não tiver sido concluído nesse período, uma exceção será gerada. Defina como 0 para ignorar a espera: o Agente continuará a ler a tabela, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados (o conteúdo da tabela) posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente essa ação 'Obter vários elementos da interface do usuário como tabela' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Número de subelementos de célula encontrados
NumberOfCellSubElementsFound integer

O número de subelementos de célula (não cabeçalhos) encontrados que correspondem aos critérios de pesquisa.

Número de subelementos de célula retornados
NumberOfCellSubElementsReturned integer

O número de subelementos de célula (não cabeçalhos) retornados (isso pode ser menor do que o número de elementos encontrados se especificar um primeiro ou número máximo de itens a retornar).

Conteúdo do índice JSON
TableContentsJSON string

A tabela criada a partir do conteúdo de vários elementos, no formato JSON.

Número de linhas na tabela
NumberOfRowsInTable integer

O número de linhas na tabela de saída.

Número de colunas na tabela
NumberOfColumnsInTable integer

O número de colunas na tabela de saída.

Thread Id
ThreadId integer

Se essa ação estiver sendo executada como um thread do agente, essa saída manterá o ID do thread do agente, que pode ser usado para monitorar o processo da ação e recuperar o conteúdo da tabela quando o thread for concluído.

Pesquisar o primeiro elemento pai da UIA

Pesquisa na hierarquia da árvore UIA o primeiro elemento pai que corresponde aos critérios de pesquisa. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.

Parâmetros

Name Chave Necessário Tipo Description
Alça do elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Tipo de controle localizado do elemento pai de pesquisa
SearchParentLocalizedControlType string

O tipo de controle localizado do elemento UIA pai a ser pesquisado. Isso pode ser descoberto através da inspeção.

Pesquisar tipo de controle de elemento pai
SearchParentControlType integer

O tipo de controle de elemento UIA pai (um inteiro não localizado) para pesquisar. Este é o mesmo valor em diferentes idiomas.

Max pais para processar
MaxParentsToProcess integer

O número máximo de elementos pai a processar. Por padrão, isso é definido como 50.

Aumentar exceção se o elemento pai não for encontrado
RaiseExceptionIfParentElementNotFound boolean

Deve IA-Connect gerar uma exceção se o elemento UIA de pesquisa não estiver localizado?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Elemento pai encontrado
ParentElementFound boolean

Retorna true se o elemento UIA pai de pesquisa foi encontrado.

Identificador do elemento pai
ParentElementHandle integer

O identificador UIA para o elemento pai localizado. Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento.

Nome do elemento pai
ParentElementName string

O nome da interface do usuário do elemento pai localizado.

Nome da classe do elemento pai
ParentElementClassName string

O nome da classe UIA do elemento pai localizado.

ID de automação do elemento pai
ParentElementAutomationId string

A ID de automação da UIA do elemento pai localizado.

Tipo de controle localizado do elemento pai
ParentElementLocalizedControlType string

O tipo de controle localizado da UIA do elemento pai localizado.

Pressione o elemento UIA

Pressiona um elemento (normalmente um botão).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Aguarde a conclusão do evento do botão
Wait boolean

Se a automação aguardar a conclusão do evento de botão antes de continuar. Se definido como true, isso pode causar um tempo limite se o botão abrir uma caixa de diálogo modal.

Botão de clique do Win32
Win32ClickButton boolean

Se definido como true, um evento de clique do Win32 é usado em vez de usar UIA. Este é um evento de clique 'disparar e esquecer', que pode ser útil ao lidar com caixas de diálogo modais que são apresentadas após um clique ou elementos que não têm um padrão de invocação UIA.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tente invocar o padrão
TryInvokePattern boolean

Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de invocação UIA para executar a ação de pressionar (a menos que 'Win32 click button' esteja definido como true). Se o padrão de invocação UIA não estiver disponível no elemento escolhido, o Agente IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de invocação e voltará imediatamente para outros padrões escolhidos.

Experimente o padrão herdado
TryLegacyPattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de pressionar se o padrão de chamada não estiver disponível (porque não está presente no elemento ou porque seu uso foi desativado) e se 'Win32 click button' for false.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Recolher elemento UIA

Recolhe um elemento (normalmente um item de menu / dropdown). Se o item já estiver recolhido, nada acontecerá.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Redefinir todos os identificadores de elementos UIA

Redefine todos os identificadores de elemento UIA atualmente armazenados por IA-Connect o que pode ser útil se você tiver identificado muitos elementos e tiver um grande número de identificadores de elemento armazenados. Em cenários com números extremamente altos de identificadores de elementos (100.000+), essa ação também pode ser usada para liberar o uso de RAM.

Parâmetros

Name Chave Necessário Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Redimensionar elemento UIA

Redimensiona um elemento UIA. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Redimensionar o tipo de largura
ResizeWidthType string

O tipo de redimensionamento de largura: Absoluto ou relativo.

Nova largura
NewWidth True integer

A nova largura do elemento. O tipo de redimensionamento (por exemplo, absoluto ou relativo) é definido pela entrada 'Redimensionar tipo de largura'. Para deixar a largura inalterada, escolha um valor de 0 e defina 'Redimensionar tipo de largura' como 'Relativo'.

Redimensionar tipo de altura
ResizeHeightType string

O tipo de redimensionamento de altura: Absoluto ou relativo.

Nova altura
NewHeight True integer

A nova altura do elemento. O tipo de redimensionamento (por exemplo, absoluto ou relativo) é definido pela entrada 'Redimensionar tipo de altura'. Para deixar a altura inalterada, escolha um valor de 0 e defina 'Redimensionar tipo de altura' como 'Relativo'.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Devoluções

Name Caminho Tipo Description
Resultado do comando
UIAResizeElementResult boolean

O resultado do comando (sucesso ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada.

Retorno de entrada no elemento UIA

Introduz um retorno do Windows/nova linha num elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o retorno numa posição específica.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Substituir valor existente
ReplaceExistingValue boolean

Se houver texto existente no elemento , ele deve ser substituído?

Inserir posição
InsertPosition integer

A posição (índice) para começar a inserir texto. Se houver texto existente, a posição de inserção pode ser usada para inserir em uma posição específica dentro do texto existente.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Gerar exceção se a validação de entrada falhar
RaiseExceptionIfInputValidationFails boolean

Se habilitado, o IA-Connect Agent verificará o novo valor do elemento depois de inserir o texto solicitado. Se o novo valor não corresponder ao valor esperado, uma exceção será gerada. Se essa entrada for falsa (o padrão), um aviso será inserido no log, mas nenhuma exceção será gerada.

Tente o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos.

Experimente o padrão herdado
TryLegacyPattern boolean

Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Selecionar elemento UIA

Seleciona um elemento (normalmente um item em uma lista ou lista suspensa).

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Senha de entrada global no elemento UIA

Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de senha que não aceitará métodos de entrada nativos da UIA.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Elemento de foco primeiro
FocusElement boolean

Deve IA-Connect tentar focar o elemento antes de clicar globalmente?

Clique com o botão esquerdo do rato global no elemento
GlobalMouseClickOnElement boolean

Deve ser realizado um clique global do rato nas coordenadas do elemento (para focar o elemento) antes de introduzir texto?

Substitua o valor existente usando o duplo clique do mouse em excluir
ReplaceExistingValueUsingDoubleClickDelete boolean

Qualquer valor existente deve ser substituído por clicar duas vezes no mouse (para realçá-lo) e, em seguida, excluir?

Substitua o valor existente usando CTRL-A excluir
ReplaceExistingValueUsingCTRLADelete boolean

Qualquer valor existente deve ser substituído pressionando Ctrl-A (para realçar tudo) e, em seguida, excluindo? Alguns elementos podem não suportar realce com Ctrl-A caso em que a opção alternativa de 'Substituir valor existente usando exclusão de clique duplo do mouse' deve ser tentada.

Palavra-passe para introdução
PasswordToInput True password

O valor da senha para entrada global usando o teclado.

Usar enviar eventos-chave
SendKeyEvents boolean

Se definido como true, os eventos de envio de chave (uma API de nível inferior que envia pressionamentos de teclas simulados para o sistema operacional) serão usados. Se definido como false, as teclas de envio (uma API de nível superior que envia pressionamentos de teclas para o elemento focado) serão usadas em vez disso.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada pressionamento de tecla.

Não interprete símbolos
DontInterpretSymbols boolean

Os símbolos na 'Palavra-passe para introduzir' não devem ser interpretados como teclas especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

A palavra-passe contém a palavra-passe armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha contiver (ou for inteiramente) um identificador de senha armazenado em IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica do IA-Connect Orchestrator, no formato {OrchestratorCredential:FriendlyName}. Essa senha armazenada pode ter sido gerada pela ação 'Gerar senha', por exemplo, ou ser mantida pelo IA-Connect Orchestrator.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Texto de entrada global no elemento UIA

Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de texto que não aceitará métodos de entrada UIA nativos.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Elemento de foco primeiro
FocusElement boolean

Deve IA-Connect tentar focar o elemento antes de clicar globalmente?

Clique com o botão esquerdo do rato global no elemento
GlobalMouseClickOnElement boolean

Deve ser realizado um clique global do rato nas coordenadas do elemento (para focar o elemento) antes de introduzir texto?

Substitua o valor existente usando o duplo clique do mouse em excluir
ReplaceExistingValueUsingDoubleClickDelete boolean

Qualquer valor existente deve ser substituído por clicar duas vezes no mouse (para realçá-lo) e, em seguida, excluir?

Substitua o valor existente usando CTRL-A excluir
ReplaceExistingValueUsingCTRLADelete boolean

Qualquer valor existente deve ser substituído pressionando Ctrl-A (para realçar tudo) e, em seguida, excluindo? Alguns elementos podem não suportar realce com Ctrl-A caso em que a opção alternativa de 'Substituir valor existente usando exclusão de clique duplo do mouse' deve ser tentada.

Texto a introduzir
TextToInput string

O valor de texto para entrada global usando o teclado.

Usar enviar eventos-chave
SendKeyEvents boolean

Se definido como true, os eventos de envio de chave (uma API de nível inferior que envia pressionamentos de teclas simulados para o sistema operacional) serão usados. Se definido como false, as teclas de envio (uma API de nível superior que envia pressionamentos de teclas para o elemento focado) serão usadas em vez disso.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada pressionamento de tecla.

Não interprete símbolos
DontInterpretSymbols boolean

Os símbolos no 'Texto a introduzir' não devem ser interpretados como teclas especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Validar ponto clicável dentro do limite do elemento
ValidateClickablePointWithinElementBoundary boolean

Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Verificar vários elementos da UIA

Define o estado de vários elementos (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado.

Parâmetros

Name Chave Necessário Tipo Description
Elementos de entrada
InputElementsJSON True string

Uma matriz de elementos UIA para verificar, no formato JSON.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Verifique o elemento UIA

Define o estado de um elemento (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado.

Parâmetros

Name Chave Necessário Tipo Description
Alça da janela pai
ParentWindowHandle True integer

O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'.

Nome do elemento de pesquisa
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Nome da classe do elemento de pesquisa
SearchElementClassName string

O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

ID de automação do elemento de pesquisa
SearchElementAutomationId string

O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção.

Tipo de controle localizado do elemento de pesquisa
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção.

Pesquisar subárvore UIA
SearchSubTree boolean

Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados.

Elemento de verificação
CheckElement boolean

O elemento deve ser verificado (true) ou desmarcado (false)?

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência.

Filtro de pesquisa
SearchFilter string

Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos.

Ordenar por nome de coluna
SortByColumn string

Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido.

O índice de correspondência está em ascensão
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false).

Máximo de elementos a pesquisar
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Profundidade máxima relativa de pesquisa
MaxRelativeSearchDepth integer

A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Máximo de elementos filho para pesquisa por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Tipos de controle localizados em elementos que não devem ser atravessados
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()