Compartilhar via


IA-Connect interface do usuário

IA-Connect é uma plataforma de Automação de Processos Robóticos 'RPA' que adiciona a funcionalidade RPA da Nuvem a máquinas virtuais locais ou em conexões Citrix ou RDS da Área de Trabalho Remota da Microsoft. Este é o módulo para o aplicativo windows User Interface Automation 'UIA'.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Ultima Labs
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
Metadados do conector
Publicador Ultima Business
Site 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 RPA (Automação de Processo Robótico) que adiciona a funcionalidade RPA do Power Automate Cloud Flows a máquinas virtuais locais ou em conexões Citrix ou RDS (Área de Trabalho Remota da Microsoft). Os Conectores IA-Connect fornecem mais de 800 ações, permitindo que você automatize todos os tipos de aplicativo local diretamente de um Power Automate Cloud Flow. Todas as ações IA-Connect estão disponíveis diretamente do Power Automate Cloud Flow, fornecendo fácil integração entre aplicativos baseados em 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 de 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 remove a necessidade de ter um aplicativo/console/estúdio separado para desenvolver seus processos de RPA.

Pré-requisitos

Para usar qualquer um dos conectores IA-Connect, você deve instalar o software IA-Connect. Isso é gratuito para testar por 30 dias, seguindo o qual você exigirá uma licença de 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 manipula o roteamento e a segurança dos Fluxos RPA para uma ou mais máquinas virtuais locais ou baseadas em nuvem.

  • O agente e o diretor do IA-Connect, que é instalado nas máquinas virtuais em que o software que você deseja automatizar está acessível. Além disso, o agente de IA-Connect pode ser executado dentro de uma sessão do Citrix ou dos Serviços de Área de Trabalho Remota da Microsoft (RDS), em que os comandos RPA são passados para baixo um canal virtual para a sessão remota para execução. O agente de IA-Connect pode ser executado em um compartilhamento de rede e não requer instalação.

Conectores de IA-Connect disponíveis

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

  • IA-Connect código dinâmico
  • Java IA-Connect
  • JML de IA-Connect
  • Mainframe IA-Connect
  • IA-Connect Microsoft Office
  • IA-Connect SAP GUI
  • Sessão IA-Connect
  • IA-Connect interface do usuário
  • navegador da Web IA-Connect

Como obter credenciais

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

Depois que uma solicitação de avaliação for recebida, entraremos em contato com você por meio do endereço de email fornecido para ajudar a configurar o software IA-Connect e fornecer a licença de avaliação. Esta é uma avaliação totalmente em destaque e permitirá que você teste qualquer uma das 800 ações em todas as 9 IA-Connect Conectores em seu próprio ambiente durante o período de avaliação.

Introdução ao conector

Depois de enviar uma solicitação de avaliação para IA-Connect, você poderá baixar um arquivo ZIP contendo o software IA-Connect e a documentação que abrange a instalação e a instalação. Também entraremos em contato com você para oferecer suporte e diretrizes por meio do processo de instalação, conforme necessário.

Support

Durante o período de avaliação, 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 resgatados para treinamento ou suporte sob medida do TSC (Centro de Serviço Técnico) com sede no Reino Unido da Ultima.

Problemas conhecidos, erros comuns e perguntas frequentes

Nossa Base de Dados de Conhecimento contém vários artigos que abordam problemas conhecidos, erros comuns que podem ocorrer ao usar os Conectores IA-Connect e perguntas frequentes. Isso é acessível https://support.ultima.com/ultimalabs e uma conta para acessar esses recursos é fornecida durante a avaliação do IA-Connect e ao comprar uma licença IA-Connect.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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
endereço IA-Connect Orchestrator cadeia Especificar o endereço IA-Connect Orchestrator sem o componente HTTP(S) Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

A janela Win32 de nível superior existe

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 de janela ou especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. A janela deve existir, IA-Connect não esperará. É mais comum usar a ação UIA "O elemento da área de trabalho UIA existe" que é mais eficiente, mas essa ação Win32 normalmente é executada mais rapidamente.

Aguardar a imagem de pesquisa visível dentro do elemento UIA

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

Aguardar a janela principal da ID do processo do UIA

Uma ação Win32 simples e rápida que aguarda uma janela principal de um processo (especificada pela ID do processo) existir e retorna um identificador. A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Aguardar 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 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Aguardar o elemento da área de trabalho do UIA

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

Aguardar o elemento UIA

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

Aguarde a janela Win32 de nível superior do UIA

Uma ação rápida do Win32 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 de janela ou especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. É mais comum usar a ação da UIA 'Wait for desktop element' que é mais poderosa, mas essa ação Win32 normalmente é executada mais rapidamente.

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

Aguarda até que uma imagem de pesquisa, fornecida como uma entrada para essa ação, não possa ser visivelmente localizada (ou nunca tenha sido localizada) dentro de um elemento UIA na tela ou a quantidade de tempo especificada tenha passado e a imagem ainda esteja presente. O elemento deve ser trazido para a frente primeiro, pois o Agente captura uma captura de tela nas coordenadas do elemento e pesquisa a imagem de pesquisa fornecida na captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente quando a imagem não está 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

Aguarda que um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto) não exista mais.

Ativar alternância do elemento UIA

Alterna um elemento (normalmente uma caixa de seleção ou uma caixa de rádio). Isso fornece ao elemento o estado oposto ao seu estado atual (por exemplo, checked torna-se desmarcado e vice-versa). Se você quiser definir um estado específico, use a ação "Elemento Check".

Captura de tela do local do elemento UIA

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.

Clique em item de elemento de lista UIA por nome

Clica no elemento de lista com o nome especificado. Normalmente, isso é usado para selecionar um item em um item suspenso/menu.

Clique em item de elemento de lista UIA por índice

Clica no elemento de lista que corresponde ao índice especificado. Normalmente, isso é usado para selecionar um item em um item suspenso/menu.

Clique global no mouse à esquerda 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 no mouse do meio 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 do mouse do meio.

Clique no mouse duplo esquerdo 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 duas vezes no botão esquerdo do mouse.

Clique no mouse à direita 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.

Definir a janela UIA como normal

Normaliza a janela com a alça UIA especificada (ou seja, define-a como 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 houver suporte para rolagem por esse elemento. Se o elemento der suporte ao 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 der suporte ao padrão 'scroll', essa ação retornará aos padrões 'valor de intervalo' ou 'valor', mas você precisará aplicá-los diretamente aos controles da barra de rolagem, não ao elemento em si.

Definir janela UIA em 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 agente de IA-Connect ao executar ações UIA. Normalmente, essa ação só será usada se você estiver tendo um problema com o modo padrão (Localizar tudo).

Definir o tempo limite da transação UIA

Controla por quanto tempo a API UIA aguardará 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 ao redor do elemento UIA

Desenha um retângulo ao redor 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 collapse

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

Elemento UIA de foco

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

Expandir elemento UIA

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

Fechar a janela do elemento UIA

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

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.

Localizar imagem de pesquisa visível dentro do elemento UIA

Retorna se uma imagem de pesquisa, fornecida como uma entrada para essa ação, foi visivelmente localizada dentro de um elemento UIA na tela. O elemento deve ser trazido para a frente primeiro, pois o Agente captura uma captura de tela nas coordenadas do elemento e pesquisa a imagem de pesquisa fornecida na captura de tela.

Maximizar a janela UIA

Maximiza a janela com o identificador UIA especificado.

Minimizar a janela do UIA

Minimiza a janela com o identificador UIA especificado.

Mover elemento UIA

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

O elemento da área de trabalho do UIA existe

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

O elemento UIA está marcado

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

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

O processo tem a janela Win32

Uma ação Win32 simples e rápida que informa se um processo (especificado pelo nome) tem janelas visíveis. A janela deve existir: IA-Connect não esperará. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Obter a região de cores da pesquisa de elementos UIA

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

Obter conteúdo do elemento datagrid do UIA

Retorna o conteúdo de um elemento datagrid. Esse é 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 do UIA

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

Obter itens de elemento de lista UIA

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

Obter janelas do Win32

Uma ação win32 rápida que retorna uma lista de todas as janelas Win32 que, opcionalmente, têm o nome da classe ou o título da janela especificado, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. O Win32 Windows pode incluir itens inesperados, incluindo a barra de tarefas, a área de trabalho, o menu iniciar, sobreposições transparentes, janelas fora da tela ou ocultas, portanto, 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 identificador do elemento pai do 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' do UIA e é quase sempre um elemento que contém.

Obter o identificador UIA para a janela principal da ID do processo

Uma ação Win32 simples e rápida que retorna o identificador de qualquer janela principal de um processo (especificada pela ID do processo). A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Obter o identificador UIA para a janela principal do elemento focalizado

Retorna um identificador para a janela principal do elemento UIA focado no momento. A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'.

Obter o identificador UIA para a janela principal do processo

Uma ação Win32 simples e rápida que retorna o identificador de qualquer janela principal de um processo (especificada pelo nome). A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. A janela deve existir: IA-Connect não esperará. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

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

Uma ação rápida do Win32 que retorna um identificador UIA para qualquer janela Win32 de nível superior que tenha o nome da classe ou o título da janela especificado 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 Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. A janela deve existir, IA-Connect não esperará. É mais comum usar a ação UIA "O elemento da área de trabalho UIA existe" que é mais eficiente, mas essa ação Win32 normalmente é executada mais rapidamente.

Obter o identificador UIA para o elemento focalizado

Retorna um identificador para o elemento UIA focado no momento.

Obter o identificador UIA para área de trabalho

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

Obter o modo de pesquisa do elemento UIA

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

Obter o 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 o valor do rótulo do elemento UIA

Retorna o valor do rótulo no elemento.

Obter padrões de elemento UIA

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

Obter propriedades do elemento datagrid do UIA

Retorna as propriedades da tabela de um elemento DataGrid. Esse é 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 única lista de linhas (coleção de linhas/tabela de dados) em vez de itens individuais, isso talvez seja ú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 várias propriedades do elemento pai do 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' do UIA e é quase sempre um elemento que contém.

Obter várias propriedades do elemento 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ários elementos 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 do UIA

Pesquisa a hierarquia de árvore do UIA para 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' do UIA e é quase sempre um elemento que contém.

Pressione o elemento UIA

Pressiona um elemento (normalmente um botão).

Redefinir todos os identificadores de elemento UIA

Redefine todos os identificadores de elemento UIA atualmente armazenados por IA-Connect que podem ser úteis se você estiver identificando muitos elementos e tiver um grande número de identificadores de elementos armazenados. Em cenários com um número extremamente alto de identificadores de elemento (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 de janela (que têm o padrão de transformação).

Região de cores da pesquisa de elementos UIA do mouse global

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.

Retorno de entrada para o elemento UIA

Insere um retorno do Windows/nova linha em um elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o retorno em uma 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, concentra-o, clica à esquerda e pressiona as teclas. Normalmente usado com uma entrada de senha que não aceitará métodos de entrada UIA nativos.

Texto de entrada em vários elementos UIA

Ação UIA 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.

Texto de entrada global no elemento UIA

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

Texto de entrada no elemento UIA

Ação UIA que insere o 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.

Verificar o elemento UIA

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

Verificar vários elementos UIA

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

A janela Win32 de nível superior existe

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 de janela ou especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. A janela deve existir, IA-Connect não esperará. É mais comum usar a ação UIA "O elemento da área de trabalho UIA existe" que é mais eficiente, mas essa ação Win32 normalmente é executada mais rapidamente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da classe de pesquisa
SearchClassName string

O nome da classe de elemento da janela de nível superior a ser pesquisado, por exemplo, 'Bloco de notas'.

Título da janela de pesquisa
SearchWindowTitle string

O título da janela de nível superior a ser pesquisado.

ID do processo de pesquisa
SearchProcessId integer

A ID de processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação "Executar Processo" nas ações de Ambiente/Sessão do IA-Connect). 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 (começando em 1) deverá 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' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
A janela existe
WindowExists boolean

Retornará true se a janela existir ou false se não existir.

Aguardar a imagem de pesquisa visível dentro do elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 'Imagem de pesquisa' representa. Se definido como "Arquivo de imagem do diretor", a imagem de pesquisa será um caminho para um arquivo acessível ao Diretor. Se definido como "Arquivo de imagem do agente", a imagem de pesquisa será um caminho para um arquivo acessível ao Agente. Se definido como 'Base64', a imagem de pesquisa será uma representação base64 da imagem.

Imagem de pesquisa
SearchImage string

A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'tipo de imagem de pesquisa' especificado, isso pode manter o caminho para um arquivo de imagem (no final 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 haverá nenhuma imagem de pesquisa alternativa. Se definido como "Arquivo de imagem do diretor", a imagem de pesquisa será um caminho para um arquivo acessível ao Diretor. Se definido como "Arquivo de imagem do agente", a imagem de pesquisa será um caminho para um arquivo acessível ao Agente. Se definido como 'Base64', a imagem de pesquisa será uma representação base64 da imagem.

Imagem de pesquisa alternativa
AltSearchImage string

Uma imagem de pesquisa alternativa opcional a ser localizada dentro do elemento UIA especificado. Dependendo do 'tipo de imagem de pesquisa alternativo' especificado, isso pode manter o caminho para um arquivo de imagem (no final 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 pesquisa ou a imagem de pesquisa alternativa e relatará qual delas estava localizada.

Desvio máximo de cores
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. Isso permite que pequenas diferenças de coloração sejam ignoradas.

Diferenças máximas de pixel
MaxPixelDifferences integer

O número máximo de pixels que podem ser diferentes (acima do desvio máximo de cores), em toda a imagem de pesquisa, antes que uma imagem seja considerada como não correspondente. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. É recomendável definir como 0 e aumentar em pequenas quantidades, se necessário. Se a configuração for um valor acima de 0, você também deverá definir "Diferenças máximas de pixel consecutivas".

Diferenças máximas de pixel consecutivas
MaxConsecutivePixelDifferences integer

O número máximo de pixels que podem ser diferentes (acima do desvio máximo de cores), em qualquer linha, antes que uma imagem seja considerada como não correspondente. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. É recomendável definir como 0 e aumentar em pequenas quantidades, se necessário. Se a configuração for um valor acima de 0, você também deverá definir 'Diferenças máximas de pixel'.

Deslocamento do pixel X à esquerda
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel X à direita
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Deslocamento do pixel Y superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel Y inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Unidade de deslocamentos do Pixel X
PixelXOffsetsUnit string

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

Unidade de deslocamentos do 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 de pixel Y superior e inferior forem medidos como uma porcentagem da altura do elemento.

Índice de imagem 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 instância N. Se você também estiver procurando uma imagem alternativa, o elemento UIA será verificado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, pesquisando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma combinação de ambas as imagens).

Direção da pesquisa de imagem
ImageSearchDirection string

A direção da pesquisa. 'De cima' pesquisa por linha da parte superior, verificando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha da parte inferior, verificando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, verificando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, verificando de cima para baixo dentro de cada coluna. Isso pode ser usado em conjunto com "Índice de imagem de pesquisa" para localizar a imagem Nth na parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção da 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 de 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 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas de elemento sempre são retornadas como coordenadas virtuais.

Mostrar retângulo de realce
ShowHighlightRectangle boolean

Se definido como true, o agente de IA-Connect realçará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detectada.

Segundos para aguardar a imagem de pesquisa
SecondsToWait integer

O número de segundos a aguardar até que a imagem de pesquisa esteja localizada dentro do elemento UIA. Se a imagem não estiver localizada, uma exceção será gerada se 'Gerar exceção se a imagem não for encontrada' estiver definida como true, caso contrário, a ação relatará que a imagem não estava localizada.

Milissegundos entre pesquisas
MillisecondsBetweenSearches integer

O número de milissegundos a aguardar entre cada elemento UIA 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 5.000 milissegundos (5 segundos) entre verificações reduzirá significativamente a utilização da CPU (reduzindo consideravelmente o número de verificações), mas só terá um pequeno impacto no tempo de resposta. O valor mínimo permitido é 100 milissegundos (1/10 segundo).

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

Defina como true se IA-Connect deve 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 a ID do thread
RetrieveOutputDataFromThreadId integer

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

Aguardar thread
WaitForThread boolean

Defina como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado por "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 "Aguardar 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 "Aguardar a imagem de pesquisa visível dentro do elemento UIA" com a entrada "Recuperar dados de saída para id de thread" definida para a ID de thread do Agente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Imagem de pesquisa localizada
SearchImageLocated boolean

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

Qual imagem de pesquisa está localizada
WhichSearchImageLocated integer

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

Imagem corresponder elemento de caixa delimitadora pixel esquerdo
SearchImageBoundingBoxElementLeftPixelXCoord integer

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

Imagem corresponder ao pixel direito do elemento de caixa delimitadora
SearchImageBoundingBoxElementRightPixelXCoord integer

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

Imagem corresponder ao pixel superior do elemento da caixa delimitadora
SearchImageBoundingBoxElementTopPixelYCoord integer

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

Imagem corresponder ao pixel inferior do elemento da caixa delimitadora
SearchImageBoundingBoxElementBottomPixelYCoord integer

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

Imagem corresponder ao pixel X da caixa delimitadora da caixa delimitadora
SearchImageBoundingBoxElementCenterPixelXCoord integer

A coordenada X virtual do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada, em relação ao elemento virtual superior esquerdo.

Imagem corresponde ao pixel Y da caixa delimitadora da caixa delimitadora
SearchImageBoundingBoxElementCenterPixelYCoord integer

A coordenada Y virtual do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada, em relação ao elemento virtual superior esquerdo.

Imagem corresponde ao pixel esquerdo da tela da caixa delimitadora
SearchImageBoundingBoxScreenLeftPixelXCoord integer

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

Imagem corresponder ao pixel direito da tela da caixa delimitadora
SearchImageBoundingBoxScreenRightPixelXCoord integer

A coordenada X do pixel de tela do pixel mais à direita que corresponde à imagem especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Imagem corresponder ao pixel superior da tela da caixa delimitadora
SearchImageBoundingBoxScreenTopPixelYCoord integer

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

Imagem corresponder ao pixel inferior da tela da caixa delimitadora
SearchImageBoundingBoxScreenBottomPixelYCoord integer

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

Imagem corresponder ao pixel X do centro de tela da caixa delimitadora
SearchImageBoundingBoxScreenCenterPixelXCoord integer

A coordenada X do pixel de tela do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Imagem de correspondência de caixa delimitadora centro de tela Y pixel
SearchImageBoundingBoxScreenCenterPixelYCoord integer

A coordenada Y do pixel de tela do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada. Essa é 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 conterá a ID de thread do Agente que pode ser usada para monitorar o processo da ação e recuperar os resultados posteriormente, quando o thread for concluído.

Aguardar a janela principal da ID do processo do UIA

Uma ação Win32 simples e rápida que aguarda uma janela principal de um processo (especificada pela ID do processo) existir e retorna um identificador. A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do processo de pesquisa
ProcessId True integer

A ID do processo a ser aguardada (conforme fornecido pela ação 'Executar Processo' nas ações IA-Connect Ambiente/Sessão).

Segundos para esperar
SecondsToWait True integer

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

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
O elemento existe
ElementExists boolean

Retornará true se o elemento existir ou false se não existir.

Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

Aguardar 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 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo de pesquisa
SearchProcessName True string

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

Segundos para esperar
SecondsToWait True integer

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

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

O elemento existe
ElementExists boolean

Retornará true se a janela existir ou false se não existir.

Aguardar o elemento da área de trabalho do UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

ID do processo de pesquisa
SearchProcessId integer

Se especificado (um valor igual a 1 ou superior), a pesquisa considerará apenas os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Alça do elemento Return
ReturnElementHandle boolean

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

Segundos para esperar
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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será retornado.

Gerar 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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento existe
ElementExists boolean

Retornará true se o elemento existir ou false se não existir.

Identificador de elemento
ElementHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Aguardar o elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

ID do processo de pesquisa
SearchProcessId integer

Se especificado (um valor igual a 1 ou superior), a pesquisa considerará apenas os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Alça do elemento Return
ReturnElementHandle boolean

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

Segundos para esperar
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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será retornado.

Gerar 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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento existe
ElementExists boolean

Retornará true se o elemento existir ou false se não existir.

Identificador de elemento
ElementHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Aguarde a janela Win32 de nível superior do UIA

Uma ação rápida do Win32 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 de janela ou especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. É mais comum usar a ação da UIA 'Wait for desktop element' que é mais poderosa, mas essa ação Win32 normalmente é executada mais rapidamente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da classe de pesquisa
SearchClassName string

O nome da classe de elemento da janela de nível superior a ser pesquisado, por exemplo, 'Bloco de notas'.

Título da janela de pesquisa
SearchWindowTitle string

O título da janela de nível superior a ser pesquisado.

Segundos para esperar
SecondsToWait True integer

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

ID do processo de pesquisa
SearchProcessId integer

A ID de processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação "Executar Processo" nas ações de Ambiente/Sessão do IA-Connect). 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 (começando em 1) deverá 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' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se várias janelas corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

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

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

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

O elemento existe
ElementExists boolean

Retornará true se a janela existir ou false se não existir.

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

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 'Imagem de pesquisa' representa. Se definido como "Arquivo de imagem do diretor", a imagem de pesquisa será um caminho para um arquivo acessível ao Diretor. Se definido como "Arquivo de imagem do agente", a imagem de pesquisa será um caminho para um arquivo acessível ao Agente. Se definido como 'Base64', a imagem de pesquisa será uma representação base64 da imagem.

Imagem de pesquisa
SearchImage string

A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'tipo de imagem de pesquisa' especificado, isso pode manter o caminho para um arquivo de imagem (no final 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 haverá nenhuma imagem de pesquisa alternativa. Se definido como "Arquivo de imagem do diretor", a imagem de pesquisa será um caminho para um arquivo acessível ao Diretor. Se definido como "Arquivo de imagem do agente", a imagem de pesquisa será um caminho para um arquivo acessível ao Agente. Se definido como 'Base64', a imagem de pesquisa será uma representação base64 da imagem.

Imagem de pesquisa alternativa
AltSearchImage string

Uma imagem de pesquisa alternativa opcional a ser localizada dentro do elemento UIA especificado. Dependendo do 'tipo de imagem de pesquisa alternativo' especificado, isso pode manter o caminho para um arquivo de imagem (no final 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 pesquisa ou a imagem de pesquisa alternativa e relatará qual delas estava localizada.

Desvio máximo de cores
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. Isso permite que pequenas diferenças de coloração sejam ignoradas.

Diferenças máximas de pixel
MaxPixelDifferences integer

O número máximo de pixels que podem ser diferentes (acima do desvio máximo de cores), em toda a imagem de pesquisa, antes que uma imagem seja considerada como não correspondente. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. É recomendável definir como 0 e aumentar em pequenas quantidades, se necessário. Se a configuração for um valor acima de 0, você também deverá definir "Diferenças máximas de pixel consecutivas".

Diferenças máximas de pixel consecutivas
MaxConsecutivePixelDifferences integer

O número máximo de pixels que podem ser diferentes (acima do desvio máximo de cores), em qualquer linha, antes que uma imagem seja considerada como não correspondente. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. É recomendável definir como 0 e aumentar em pequenas quantidades, se necessário. Se a configuração for um valor acima de 0, você também deverá definir 'Diferenças máximas de pixel'.

Deslocamento do pixel X à esquerda
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel X à direita
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Deslocamento do pixel Y superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel Y inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Unidade de deslocamentos do Pixel X
PixelXOffsetsUnit string

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

Unidade de deslocamentos do 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 de pixel Y superior e inferior forem medidos como uma porcentagem da altura do elemento.

Índice de imagem 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 instância N. Se você também estiver procurando uma imagem alternativa, o elemento UIA será verificado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, pesquisando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma combinação de ambas as imagens).

Direção da pesquisa de imagem
ImageSearchDirection string

A direção da pesquisa. 'De cima' pesquisa por linha da parte superior, verificando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha da parte inferior, verificando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, verificando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, verificando de cima para baixo dentro de cada coluna. Isso pode ser usado em conjunto com "Índice de imagem de pesquisa" para localizar a imagem Nth na parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção da 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 agente de IA-Connect realçará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detectada.

Segundos para aguardar a imagem de pesquisa não existir
SecondsToWait integer

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

Milissegundos entre pesquisas
MillisecondsBetweenSearches integer

O número de milissegundos a aguardar entre cada elemento UIA 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 5.000 milissegundos (5 segundos) entre verificações reduzirá significativamente a utilização da CPU (reduzindo consideravelmente o número de verificações), mas só terá um pequeno impacto no tempo de resposta. O valor mínimo permitido é 100 milissegundos (1/10 segundo).

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

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

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

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

Aguardar thread
WaitForThread boolean

Defina como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado por "Segundos para aguardar a imagem de pesquisa não existir". 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 "Aguardar 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 "Aguardar que a imagem de pesquisa visível não exista dentro do elemento UIA" com a entrada "Recuperar dados de saída para id de thread" definida para a ID de thread do Agente.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Imagem de pesquisa presente antes da espera
SearchImagePresentBeforeWait boolean

Essa saída será definida como true, se a imagem de pesquisa estiver presente no início do período de espera. Essa 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 a espera
SearchImageStillPresentAfterWait boolean

Essa saída será definida como true, se a imagem de pesquisa ainda estiver presente, após o período de espera. Essa 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 será concluída imediatamente depois que a imagem não estiver mais presente).

Qual imagem de pesquisa ainda está presente
WhichSearchImageStillPresent integer

Essa saída será definida como 0, se nenhuma imagem de pesquisa ainda estiver presente, após o período de espera. Definido como 1, se a imagem de pesquisa ainda estiver presente, após o período de espera. Definido 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 conterá a ID de thread do Agente que pode ser usada para monitorar o processo da ação e recuperar os resultados posteriormente, 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

Nome Chave Obrigatório Tipo Description
Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

ID do processo de pesquisa
SearchProcessId integer

Se especificado (um valor igual a 1 ou superior), a pesquisa considerará apenas os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Segundos para esperar
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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será retornado.

Gerar 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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento existe antes da espera
ElementExistsBeforeWait boolean

Retornará true se o elemento existir antes de esperar ou false se não existir.

O elemento existe após a espera
ElementExistsAfterWait boolean

Retornará true se o elemento existir depois de esperar ou false se não existir.

Aguarde até que o elemento UIA não exista

Aguarda que um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto) não exista mais.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

ID do processo de pesquisa
SearchProcessId integer

Se especificado (um valor igual a 1 ou superior), a pesquisa considerará apenas os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Segundos para esperar
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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será retornado.

Gerar 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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento existe antes da espera
ElementExistsBeforeWait boolean

Retornará true se o elemento existir antes de esperar ou false se não existir.

O elemento existe após a espera
ElementExistsAfterWait boolean

Retornará true se o elemento existir depois de esperar ou false se não existir.

Ativar alternância do elemento UIA

Alterna um elemento (normalmente uma caixa de seleção ou uma caixa de rádio). Isso fornece ao elemento o estado oposto ao seu estado atual (por exemplo, checked torna-se desmarcado e vice-versa). Se você quiser definir um estado específico, use a ação "Elemento Check".

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Captura de tela do local do elemento UIA

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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador 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 com suporte são PNG (o padrão), JPG, BMP e GIF.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Imagem de tela como Base64
ScreenBitmapBase64 string

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

Clique em item de elemento de lista UIA por nome

Clica no elemento de lista com o nome especificado. Normalmente, isso é usado para selecionar um item em um item suspenso/menu.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador 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 pesquisar 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.

Recolher 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 elas forem definidas como verdadeiras.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 item de elemento de lista UIA por índice

Clica no elemento de lista que corresponde ao índice especificado. Normalmente, isso é usado para selecionar um item em um item suspenso/menu.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador 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 pesquisar 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.

Recolher após
CollapseAfter boolean

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

Índice de item
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 elas forem definidas como verdadeiras.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 no mouse à esquerda 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Elemento Focus primeiro
FocusElementFirst boolean

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

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de pixels X para compensar a ação de clique. Esse parâmetro dá suporte a 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. Esse parâmetro dá suporte a 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 de (Centro/Centro/Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique no mouse do meio 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 do mouse do meio.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Elemento Focus primeiro
FocusElementFirst boolean

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

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de pixels X para compensar a ação de clique. Esse parâmetro dá suporte a 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. Esse parâmetro dá suporte a 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 de (Centro/Centro/Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique no mouse duplo esquerdo 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 duas vezes no botão esquerdo do mouse.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Atraso em milissegundos
DelayInMilliseconds integer

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

Elemento Focus primeiro
FocusElementFirst boolean

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

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de pixels X para compensar a ação de clique. Esse parâmetro dá suporte a 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. Esse parâmetro dá suporte a 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 de (Centro/Centro/Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Clique no mouse à direita 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Elemento Focus primeiro
FocusElementFirst boolean

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

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Clique em deslocamento X
ClickOffsetX integer

O número de pixels X para compensar a ação de clique. Esse parâmetro dá suporte a 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. Esse parâmetro dá suporte a 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 de (Centro/Centro/Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo 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 como uma janela de tamanho normal em vez de minimizada ou maximizada).

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de 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 houver suporte para rolagem por esse elemento. Se o elemento der suporte ao 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 der suporte ao padrão 'scroll', essa ação retornará aos padrões 'valor de intervalo' ou 'valor', mas você precisará aplicá-los diretamente aos controles da barra de rolagem, não ao elemento em si.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Porcentagem de rolagem horizontal
HorizontalScrollPercentage double

A posição para rolar horizontalmente o elemento (0 a 100 inclusive, decimais com suporte) ou -1 para 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 com suporte) ou -1 para deixar a posição de rolagem vertical inalterada.

Experimentar o padrão de rolagem
TryScrollPattern boolean

Se definido como true, o agente de IA-Connect 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 retornará a outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de rolagem e retornará imediatamente a outros padrões escolhidos. A ordem dos padrões tentados (se habilitados por meio de entradas para essa ação) são rolagem, valor de intervalo e valor.

Experimentar o padrão de valor de intervalo
TryRangeValuePattern boolean

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

Experimentar o padrão de valor
TryValuePattern boolean

Se definido como true, o agente IA-Connect tentará usar um padrão de valor UIA para executar a ação de rolagem. Se o padrão de valor UIA não estiver disponível no elemento escolhido, o agente de IA-Connect retornará a outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de valor e retornará imediatamente a outros padrões escolhidos. A ordem dos padrões tentados (se habilitados por meio de entradas para essa ação) são rolagem, valor de intervalo e valor. Aviso: usar um padrão de valor em um elemento de edição simplesmente inserirá o valor no elemento de edição.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Resultado do comando
UIASetElementScrollPercentageResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Definir janela UIA em primeiro plano

Traz uma janela para o primeiro plano.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela
WindowHandle True integer

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

Janela de alternância
ToggleWindow boolean

A janela deve ser alternada ao tentar se concentrar 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 de clique global do mouse esquerdo
ToggleUsesGlobalLeftMouseClickAgent boolean

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

Atraso de alternância 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Novo valor
NewValue True double

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

Novo valor é percentual
NewValueIsPercentage boolean

O novo valor é uma porcentagem?

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Novo valor
NewValue True integer

O valor numérico para o qual definir o elemento.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 agente de IA-Connect 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.

Experimentar o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o agente IA-Connect tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor 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 essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de valor e retornará imediatamente a outros padrões escolhidos.

Experimentar o padrão herdado
TryLegacyPattern boolean

Se definido como true, o agente IA-Connect tentará usar um padrão herdado 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 agente de IA-Connect ao executar ações UIA. Normalmente, essa ação só será usada se você estiver tendo um problema com o modo padrão (Localizar tudo).

Parâmetros

Nome Chave Obrigató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()

Retornos

Nome Caminho Tipo Description
Resultado do comando
SetUIAElementSearchModeResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Definir o tempo limite da transação UIA

Controla por quanto tempo a API UIA aguardará 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

Nome Chave Obrigatório Tipo Description
Tempo limite, em segundos
TimeoutInSeconds True double

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

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Desenhar retângulo ao redor do elemento UIA

Desenha um retângulo ao redor 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Cor da caneta
PenColour string

A cor do retângulo a ser desenhado (por exemplo, vermelho, verde, azul, amarelo, roxo ou laranja) ou um código hexáxe de cadeia de caracteres, 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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 collapse

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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

Concentra 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Expandir elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Fechar a janela do elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Senha para entrada
PasswordToInput True password

O valor da senha a ser inserido.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

A senha contém senha armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha contiver (ou for inteiramente) um identificador de senha armazenado IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica 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 Orquestrador IA-Connect.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

Experimentar o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o agente IA-Connect tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor 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 essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de valor e retornará imediatamente a outros padrões escolhidos.

Experimentar o padrão herdado
TryLegacyPattern boolean

Se definido como true, o agente IA-Connect tentará usar um padrão herdado 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 uma entrada para essa ação, foi visivelmente localizada dentro de um elemento UIA na tela. O elemento deve ser trazido para a frente primeiro, pois o Agente captura uma captura de tela nas coordenadas do elemento e pesquisa a imagem de pesquisa fornecida na captura de tela.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 'Imagem de pesquisa' representa. Se definido como "Arquivo de imagem do diretor", a imagem de pesquisa será um caminho para um arquivo acessível ao Diretor. Se definido como "Arquivo de imagem do agente", a imagem de pesquisa será um caminho para um arquivo acessível ao Agente. Se definido como 'Base64', a imagem de pesquisa será uma representação base64 da imagem.

Imagem de pesquisa
SearchImage string

A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'tipo de imagem de pesquisa' especificado, isso pode manter o caminho para um arquivo de imagem (no final 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 haverá nenhuma imagem de pesquisa alternativa. Se definido como "Arquivo de imagem do diretor", a imagem de pesquisa será um caminho para um arquivo acessível ao Diretor. Se definido como "Arquivo de imagem do agente", a imagem de pesquisa será um caminho para um arquivo acessível ao Agente. Se definido como 'Base64', a imagem de pesquisa será uma representação base64 da imagem.

Imagem de pesquisa alternativa
AltSearchImage string

Uma imagem de pesquisa alternativa opcional a ser localizada dentro do elemento UIA especificado. Dependendo do 'tipo de imagem de pesquisa alternativo' especificado, isso pode manter o caminho para um arquivo de imagem (no final 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 pesquisa ou a imagem de pesquisa alternativa e relatará qual delas estava localizada.

Desvio máximo de cores
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. Isso permite que pequenas diferenças de coloração sejam ignoradas.

Diferenças máximas de pixel
MaxPixelDifferences integer

O número máximo de pixels que podem ser diferentes (acima do desvio máximo de cores), em toda a imagem de pesquisa, antes que uma imagem seja considerada como não correspondente. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. É recomendável definir como 0 e aumentar em pequenas quantidades, se necessário. Se a configuração for um valor acima de 0, você também deverá definir "Diferenças máximas de pixel consecutivas".

Diferenças máximas de pixel consecutivas
MaxConsecutivePixelDifferences integer

O número máximo de pixels consecutivos que podem ser diferentes (acima do desvio máximo de cores), em qualquer linha, antes que uma imagem seja considerada como não correspondente. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. É recomendável definir como 0 e aumentar em pequenas quantidades, se necessário. Se a configuração for um valor acima de 0, você também deverá definir 'Diferenças máximas de pixel'.

Deslocamento do pixel X à esquerda
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel X à direita
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Deslocamento do pixel Y superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel Y inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Unidade de deslocamentos do Pixel X
PixelXOffsetsUnit string

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

Unidade de deslocamentos do 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 de pixel Y superior e inferior forem medidos como uma porcentagem da altura do elemento.

Índice de imagem 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 instância N. Se você também estiver procurando uma imagem alternativa, o elemento UIA será verificado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, pesquisando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma combinação de ambas as imagens).

Direção da pesquisa de imagem
ImageSearchDirection string

A direção da pesquisa. 'De cima' pesquisa por linha da parte superior, verificando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha da parte inferior, verificando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, verificando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, verificando de cima para baixo dentro de cada coluna. Isso pode ser usado em conjunto com "Índice de imagem de pesquisa" para localizar a imagem Nth na parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção da 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 de 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 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas de elemento sempre são retornadas como coordenadas virtuais.

Mostrar retângulo de realce
ShowHighlightRectangle boolean

Se definido como true, o agente de IA-Connect realçará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detectada.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Imagem de pesquisa localizada
SearchImageLocated boolean

Definido como true, se a imagem de pesquisa estiver localizada. Definido como false, se a imagem de pesquisa não estiver localizada.

Qual imagem de pesquisa está localizada
WhichSearchImageLocated integer

Definido como 0, se nenhuma imagem de pesquisa estiver localizada. Defina como 1 se a imagem de pesquisa estiver localizada. Defina como 2 se a imagem de pesquisa alternativa estiver localizada.

Imagem corresponder elemento de caixa delimitadora pixel esquerdo
SearchImageBoundingBoxElementLeftPixelXCoord integer

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

Imagem corresponder ao pixel direito do elemento de caixa delimitadora
SearchImageBoundingBoxElementRightPixelXCoord integer

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

Imagem corresponder ao pixel superior do elemento da caixa delimitadora
SearchImageBoundingBoxElementTopPixelYCoord integer

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

Imagem corresponder ao pixel inferior do elemento da caixa delimitadora
SearchImageBoundingBoxElementBottomPixelYCoord integer

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

Imagem corresponder ao pixel X da caixa delimitadora da caixa delimitadora
SearchImageBoundingBoxElementCenterPixelXCoord integer

A coordenada X virtual do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada, em relação ao elemento virtual superior esquerdo.

Imagem corresponde ao pixel Y da caixa delimitadora da caixa delimitadora
SearchImageBoundingBoxElementCenterPixelYCoord integer

A coordenada Y virtual do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada, em relação ao elemento virtual superior esquerdo.

Imagem corresponde ao pixel esquerdo da tela da caixa delimitadora
SearchImageBoundingBoxScreenLeftPixelXCoord integer

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

Imagem corresponder ao pixel direito da tela da caixa delimitadora
SearchImageBoundingBoxScreenRightPixelXCoord integer

A coordenada X do pixel de tela do pixel mais à direita que corresponde à imagem especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Imagem corresponder ao pixel superior da tela da caixa delimitadora
SearchImageBoundingBoxScreenTopPixelYCoord integer

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

Imagem corresponder ao pixel inferior da tela da caixa delimitadora
SearchImageBoundingBoxScreenBottomPixelYCoord integer

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

Imagem corresponder ao pixel X do centro de tela da caixa delimitadora
SearchImageBoundingBoxScreenCenterPixelXCoord integer

A coordenada X do pixel de tela do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Imagem de correspondência de caixa delimitadora centro de tela Y pixel
SearchImageBoundingBoxScreenCenterPixelYCoord integer

A coordenada Y do pixel de tela do centro da caixa delimitadora que contém pixels que correspondem à imagem especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Maximizar a janela UIA

Maximiza a janela com o identificador UIA especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela
WindowHandle True integer

O identificador UIA para que a janela seja maximizado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Minimizar a janela do UIA

Minimiza a janela com o identificador UIA especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela
WindowHandle True integer

O identificador UIA para a janela a ser 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 de janela (que têm o padrão de transformação).

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 do 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 do 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()

Retornos

Nome Caminho Tipo Description
Resultado do comando
UIAMoveElementResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

O elemento da área de trabalho do UIA existe

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

ID do processo de pesquisa
SearchProcessId integer

Se especificado (um valor igual a 1 ou superior), a pesquisa considerará apenas os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Alça do elemento Return
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Esse 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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será retornado.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento existe
ElementExists boolean

Retornará true se o elemento existir ou false se não existir.

Identificador de elemento
ElementHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

O elemento UIA está marcado

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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento está marcado
ElementIsChecked boolean

Retornará true se o elemento for verificado ou falso se não for.

O elemento UIA existe

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

ID do processo de pesquisa
SearchProcessId integer

Se especificado (um valor igual a 1 ou superior), a pesquisa considerará apenas os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Alça do elemento Return
ReturnElementHandle boolean

Se definido como true, um identificador para o elemento localizado será retornado. Esse 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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será pesquisado.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
O elemento existe
ElementExists boolean

Retornará true se o elemento existir ou false se não existir.

Identificador de elemento
ElementHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

O processo tem a janela Win32

Uma ação Win32 simples e rápida que informa se um processo (especificado pelo nome) tem janelas visíveis. A janela deve existir: IA-Connect não esperará. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo de pesquisa
SearchProcessName True string

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

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
O processo tem janela
ProcessHasWindow boolean

Retornará true se o processo tiver uma janela visível ou false, caso contrário.

Obter a região de cores da pesquisa de elementos UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Cor da pesquisa
SearchColour True string

Cor da pesquisa no formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB em que cada canal de cores é um byte no formato hex (00 está totalmente desativado, FF está totalmente ativado). Por exemplo: #FF0000 para vermelho, #00FF00 para azul, nº 0000000 para preto, #FFFFFF para branco.

Desvio máximo de cores
MaxColourDeviation True integer

O máximo que uma cor de elemento pode desviar da cor da pesquisa antes de não ser considerado 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 do pixel X à esquerda
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel X à direita
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Deslocamento do pixel Y superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel Y inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (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 de 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 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas de elemento sempre são retornadas como coordenadas virtuais.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Número de pixels correspondentes à cor
NumberOfPixelsMatchingColour integer

O número de pixels que correspondem à cor especificada.

Pixel esquerdo do elemento de caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementLeftPixelXCoord integer

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

Pixel direito do elemento de caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementRightPixelXCoord integer

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

Pixel superior do elemento de caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementTopPixelYCoord integer

A coordenada Y virtual do pixel mais alto que corresponde à cor especificada, em relação ao elemento virtual superior esquerdo.

Pixel inferior do elemento da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementBottomPixelYCoord integer

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

X pixel do elemento da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxElementCenterPixelXCoord integer

A coordenada X virtual do centro da caixa delimitadora que contém pixels que correspondem à cor especificada, em relação ao elemento virtual superior esquerdo.

Cor da correspondência da caixa delimitadora do elemento Y pixel
ColourMatchBoundingBoxElementCenterPixelYCoord integer

A coordenada Y virtual do centro da caixa delimitadora que contém pixels que correspondem à cor especificada, em relação ao elemento virtual superior esquerdo.

Pixel esquerdo da tela da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxScreenLeftPixelXCoord integer

A coordenada X do pixel de tela do pixel mais à esquerda que corresponde à cor especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel direito da tela da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxScreenRightPixelXCoord integer

A coordenada X do pixel de tela do pixel mais à direita que corresponde à cor especificada. Essa é 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 de tela do pixel superior que corresponde à cor especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Pixel inferior da tela inferior da caixa delimitadora de correspondência de cores
ColourMatchBoundingBoxScreenBottomPixelYCoord integer

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

Color match bounding box screen center X pixel
ColourMatchBoundingBoxScreenCenterPixelXCoord integer

A coordenada X do pixel de tela do centro da caixa delimitadora que contém pixels que correspondem à cor especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Color match bounding box screen center Y pixel
ColourMatchBoundingBoxScreenCenterPixelYCoord integer

A coordenada Y do pixel de tela do centro da caixa delimitadora que contém pixels que correspondem à cor especificada. Essa é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'.

Obter conteúdo do elemento datagrid do UIA

Retorna o conteúdo de um elemento datagrid. Esse é 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Recuperar somente colunas na tela
OnScreenColumnsOnly boolean

Se definido como true, somente as colunas na tela serão retornadas.

Recuperar somente linhas na tela
OnScreenRowsOnly boolean

Se definido como true, somente 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 normalmente são retornados como '(null)'.

Nome da linha de cabeçalho alternativo
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 UIA da linha 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 UIA da linha
NameOfColumnToStoreRowUIAName string

Se a entrada 'Nome UIA da linha de retorno' for definida como true, essa entrada especifica o nome da coluna na coleção de saída para manter o nome UIA da linha.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Primeiro item a ser retornado
FirstItemToReturn integer

O índice de elemento do primeiro item (linha) a ser retornado, começando a partir de 1.

Máximo de itens a serem retornados
MaxItemsToReturn integer

O número máximo de itens (linhas) a serem retornados ou 0 para retornar todos os itens (linhas).

Verificar as primeiras linhas N em busca de linhas vazias
ScanFirstNRowsForEmptyRows integer

Alguns datagrids 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 esteja visível na interface do usuário. Se essa entrada for definida como 0 (o padrão), o agente de IA-Connect sempre examinará os elementos de linha da primeira linha em diante, mesmo que "Primeiro item a ser retornado" esteja definido para recuperar linhas mais profundas dentro da tabela. Isso garante a consistência com números de índice de linha, mas afeta o desempenho, pois todas as linhas da primeira linha para as linhas solicitadas 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 como um valor diferente de 0, a menos que você saiba o que está fazendo.

Ler tabela como thread
ReadTableAsThread boolean

Se definido como false (o padrão), o agente de IA-Connect lerá a tabela imediatamente e retornará o conteúdo para o Diretor. Se estiver lendo tabelas grandes, essa ação poderá acabar. Se definido como true, o agente de IA-Connect lerá a tabela como um thread do Agente e o IA-Connect Director (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 tempo limite. IA-Connect Agentes 9.3 e anteriores só podiam ler tabelas imediatamente, não como um thread do Agente.

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

Se você executou essa ação anteriormente como um thread do Agent e definiu "Segundos para aguardar o thread" como 0, forneça a ID de thread do Agente para recuperar os resultados. Essa ID de thread do Agente terá sido fornecida pela chamada anterior para essa ação. Defina como 0 (o padrão) se você estiver lendo uma datagrid (e, portanto, não recuperar os resultados de uma consulta anterior executada como um thread do Agente).

Segundos para aguardar o thread
SecondsToWaitForThread integer

Se 'Ler tabela como thread' for 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 neste momento, uma exceção será gerada. Definido como 0 para ignorar a espera: o Agente continuará a ler o datagrid, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados (o conteúdo do datagrid) posteriormente usando a ação "Aguardar 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 datagrid do UIA" com a entrada "Recuperar dados de saída para id de thread" definida para a ID do thread do Agente.

Rolar o datagrid verticalmente a cada N por cento
ScrollDataGridVerticallyEveryNPercent integer

O desempenho da leitura de algumas grandes datagrids (por exemplo: com milhares de linhas) foi observado para melhorar se você rolar periodicamente a datagrid para (ou perto) do local que está sendo rolado. Se definido como 0 (o padrão), o datagrid não será rolado durante a leitura do conteúdo. Se definido como um valor entre 1 e 100, o datagrid será periódicamente rolado (cada N por cento do número total de linhas) durante a leitura do conteúdo. Por exemplo: se definido como 20, o datagrid será rolado em 0, 20, 40, 60, 80%. Como alternativa, use 'Rolagem de dados verticalmente cada N linhas' para rolar cada N linhas em vez de cada N por cento.

Rolar o datagrid verticalmente a cada N linhas
ScrollDataGridVerticallyEveryNRows integer

O desempenho da leitura de algumas grandes datagrids (por exemplo: com milhares de linhas) foi observado para melhorar se você rolar periodicamente a datagrid para (ou perto) do local que está sendo rolado. Se definido como 0 (o padrão), o datagrid não será rolado durante a leitura do conteúdo. Se definido como um valor 1 ou superior, o datagrid será rolado a cada N linhas durante a leitura do conteúdo. Por exemplo: se definido como 5, o datagrid será rolado a cada 5 linhas. Como alternativa, use 'Rolagem de dados verticalmente a cada N por cento' para rolar cada N por cento das linhas em vez de cada N linhas.

Rolagem do identificador de elementos verticalmente datagrid
ScrollDataGridVerticallyElementHandle integer

Se rolar a datagrid verticalmente durante a leitura do conteúdo, essa entrada definirá como IA-Connect localizará a barra de rolagem vertical. Se definido como 0, IA-Connect tentará rolar a datagrid diretamente, usando o padrão 'scroll' (se a datagrid der suporte a ele) ou pesquisando a barra de rolagem vertical contida no datagrid. Como alternativa, você pode especificar o identificador UIA IA-Connect do elemento de barra de rolagem vertical (o elemento da barra de rolagem em si, não os botões dentro), que é um valor igual a 1 ou superior.

Linhas de datagrid mínimas para rolagem
MinimumDataGridRowsForScrolling integer

Se rolar a datagrid verticalmente durante a leitura de conteúdo, essa entrada especificará o número mínimo de linhas necessárias na tabela antes de IA-Connect executará 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 o datagrid tiver esse número de linhas ou mais.

Gerar exceção se não puder rolar
RaiseExceptionIfCannotScroll boolean

Se rolar a datagrid verticalmente durante a leitura do conteúdo: defina essa entrada como true se uma falha na rolagem deve ser considerada uma exceção ou definida como false (o padrão) se uma falha na rolagem deve ser ignorada. Falhas comuns na rolagem incluem falha ao localizar as barras de rolagem ou as barras de rolagem não têm um padrão UIA adequado para rolagem ('scroll', 'rangevalue' ou 'value').

Nome da barra de rolagem vertical alternativa
AlternativeVerticalScrollbarName string

Por padrão, a barra de rolagem vertical 'row' em um datagrid 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 datagrid durante a leitura do conteúdo, o campo "Rolagem de datagrid verticalmente identificador de elemento" é definido como 0 (especificando que IA-Connect deve rolar a datagrid diretamente), mas o datagrid não implementa o padrão de "rolagem".

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Conteúdo do Datagrid 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 conterá a ID de thread do Agente que pode ser usada para monitorar o processo da ação e recuperar o conteúdo de datagrid quando o thread for concluído.

Obter elementos da área de trabalho do UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de controle localizado do elemento search
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 os elementos pertencentes a um processo com essa ID de Processo (PID). Se IA-Connect iniciado o processo, o PID será fornecido pela ação "Executar Processo" nas ações IA-Connect Ambiente/Sessão. Se você não souber o PID, deixe esse campo em branco.

Alça do elemento Return
ReturnElementHandle boolean

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

Primeiro item a ser retornado
FirstItemToReturn integer

O índice de elementos do primeiro item a ser retornado, começando a partir de 1. Se você quiser retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você poderá, como alternativa, especificar um índice negativo a partir de -1.

Máximo de itens a serem retornados
MaxItemsToReturn integer

O número máximo de elementos a serem retornados ou 0 para retornar todos os itens.

Incluir processos filho
IncludeChildProcesses boolean

Se definido como true e uma 'ID do processo de pesquisa' for especificada, os processos filho dessa ID do processo também serão incluídos na pesquisa. Se definido como false, somente um processo correspondente à 'ID do processo de pesquisa' exato será retornado.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome 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 do elemento dos elementos da área de trabalho encontradas que correspondem aos critérios de pesquisa.

items
ElementProperties object

Obter itens de elemento de lista UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador 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 pesquisar 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.

Recolher 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 elas forem definidas como verdadeiras.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Número de itens de 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 do Win32

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da classe de pesquisa
SearchClassName string

O nome da classe opcional da janela de nível superior a ser pesquisado, por exemplo, "Chrome_WidgetWin_1".

Título da janela de pesquisa
SearchWindowTitle string

O título opcional da janela de nível superior a ser pesquisado.

Recuperar somente janelas de nível superior
TopLevelWindowsOnly boolean

Definido como true para recuperar apenas janelas Win32 que o sistema operacional considera ser de nível superior. Defina como false para recuperar todas as janelas do Win32. Observe que a definição 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 somente janelas visíveis
VisibleWindowsOnly boolean

Defina como true para recuperar apenas janelas Win32 que o sistema operacional considera visíveis. Defina como false para recuperar janelas Win32 visíveis e não visíveis. Observe que janelas offscreen ou transparentes podem ser marcadas como visíveis, mas você não pode vê-las.

Recuperar somente janelas com uma barra de título
WindowsWithTitlebarOnly boolean

Defina como true para recuperar apenas janelas Win32 com uma barra de título. Defina como false para recuperar janelas Win32, independentemente de elas terem ou não uma barra de título. Observe que algumas janelas transparentes têm barras de título, mas você não pode vê-las.

Recuperar somente janelas com um título
WindowsWithTitleOnly boolean

Defina como true para recuperar apenas janelas Win32 com um título (ou seja, uma barra de título que contém algum texto). Defina como false para recuperar janelas Win32, independentemente de elas 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 Win32 que não têm transparência. Defina como false para recuperar janelas Do Win32, independentemente de elas terem a transparência definida ou não.

ID do processo de pesquisa
SearchProcessId integer

A ID de processo opcional do processo que possui as janelas (por exemplo, conforme fornecido pela saída da ação "Executar Processo" nas ações IA-Connect Ambiente/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' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique por qual propriedade de janela será classificada. Por exemplo: se 'Classificar por nome de coluna' for [TopEdge], a lista de janelas será retornada ordenada pela borda superior. Se esse campo for deixado em branco, as janelas serão retornadas na ordem em que forem detectadas.

O índice de correspondência é crescente
MatchIndexAscending boolean

Se várias janelas corresponderem à pesquisa e uma coluna de classificação for especificada, defina como true (padrão) para classificar crescente ou definida como false para classificar decrescente.

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 ações IA-Connect UIA.

Primeiro item a ser retornado
FirstItemToReturn integer

O índice da primeira janela (linha) a ser retornado, começando a partir de 1.

Máximo de itens a serem retornados
MaxItemsToReturn integer

O número máximo de janelas a serem retornadas ou 0 para retornar todos os itens.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Win32 windows JSON
Win32WindowsJSON string

Uma lista de janelas Win32 que correspondem aos critérios de pesquisa, no formato JSON.

Número de janelas Win32
NumberOfWin32Windows integer

O número de janelas Win32 retornadas.

Obter o elemento UIA nas coordenadas da tela

Retorna o elemento UIA localizado nas coordenadas de tela fornecidas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Coordenada X
XCoord integer

O valor da coordenada X da tela (em pixels) em que o elemento UIA deve ser pesquisado.

Coordenada Y
YCoord integer

O valor da coordenada Y da tela (em pixels) em que o elemento UIA deve ser pesquisado.

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

Deve IA-Connect gerar uma exceção se um elemento UIA não estiver localizado no local especificado?

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Elemento encontrado
ElementFound boolean

Retorna true se um elemento UIA foi encontrado no local especificado.

Identificador de elemento
ElementHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Obter o identificador do elemento pai do 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' do UIA e é quase sempre um elemento que contém.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de elemento pai
ParentElementHandle integer

Um identificador UIA para o elemento pai.

Obter o identificador UIA para a janela principal da ID do processo

Uma ação Win32 simples e rápida que retorna o identificador de qualquer janela principal de um processo (especificada pela ID do processo). A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do processo de pesquisa
ProcessId True integer

A ID do processo a ser aguardada (conforme fornecido pela ação 'Executar Processo' nas ações IA-Connect Ambiente/Sessão).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

Obter o identificador UIA para a janela principal do elemento focalizado

Retorna um identificador para a janela principal do elemento UIA focado no momento. A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

Obter o identificador UIA para a janela principal do processo

Uma ação Win32 simples e rápida que retorna o identificador de qualquer janela principal de um processo (especificada pelo nome). A janela 'Main' normalmente é a janela principal do aplicativo: uma caixa de diálogo de logon ou uma sub-janela geralmente não é a janela 'Principal'. A janela deve existir: IA-Connect não esperará. É recomendável usar a ação "Aguardar elemento da área de trabalho", que é mais eficiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do processo de pesquisa
SearchProcessName True string

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

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

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

Uma ação rápida do Win32 que retorna um identificador UIA para qualquer janela Win32 de nível superior que tenha o nome da classe ou o título da janela especificado 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 Win32, ela pode detectar janelas Windows, Java, ModernUI e Web. A janela deve existir, IA-Connect não esperará. É mais comum usar a ação UIA "O elemento da área de trabalho UIA existe" que é mais eficiente, mas essa ação Win32 normalmente é executada mais rapidamente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da classe de pesquisa
SearchClassName string

O nome da classe de elemento da janela de nível superior a ser pesquisado, por exemplo, 'Bloco de notas'.

Título da janela de pesquisa
SearchWindowTitle string

O título da janela de nível superior a ser pesquisado.

ID do processo de pesquisa
SearchProcessId integer

A ID de processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação "Executar Processo" nas ações de Ambiente/Sessão do IA-Connect). 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 (começando em 1) deverá 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' AND [IsMinimised] = False AND [IsResizeable] = True. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se várias janelas corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento window.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento window.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento de janela.

Obter o identificador UIA para o elemento focalizado

Retorna um identificador para o elemento UIA focado no momento.

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

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

Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação UIA do elemento.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

Obter o identificador UIA para área de trabalho

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Identificador de janela
WindowHandle integer

O identificador UIA para a área de trabalho. Isso pode ser usado como uma entrada para outras ações do UIA nessa janela.

Nome do elemento
ElementName string

O nome UIA do elemento da área de trabalho.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento desktop.

ID de automação de elementos
ElementAutomationId string

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

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento da área de trabalho.

Obter o modo de pesquisa do elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Modo de pesquisa de elemento UIA
UIAElementSearchMode string

A corrente de modo de pesquisa do elemento UIA usada pelo agente de IA-Connect.

Obter o 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Valor do elemento
ElementValue string

O valor do elemento.

Obter o valor do rótulo do elemento UIA

Retorna o valor do rótulo no elemento.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Valor do rótulo do elemento
ElementLabelValue string

O valor do rótulo no elemento.

Obter padrões de elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Expandir o padrão de recolhimento disponível
ExpandCollapsePatternAvailable boolean

O padrão de recolhimento de expansão do UIA está disponível e, portanto, as ações que expandem ou recolhem um elemento (por exemplo, um menu suspenso) provavelmente funcionarão.

Padrão de invocação disponível
InvokePatternAvailable boolean

O padrão de invocação UIA está disponível e, portanto, ações que pressionam um elemento ou clicam em um item de elemento de lista provavelmente funcionarão.

Padrão de valor de intervalo disponível
RangeValuePatternAvailable boolean

O padrão de valor de intervalo UIA está disponível e, portanto, 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, 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 UIA está disponível e, portanto, 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, 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, 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, ações que inseriam texto em um elemento ou leem um valor de elemento provavelmente funcionarão. 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. Esse 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 UIA está disponível. Esse padrão não é usado pelo IA-Connect.

Padrão IAccessible herdado disponível
LegacyIAccessiblePatternAvailable boolean

O padrão IAccessible herdado do UIA está disponível. Esse 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. Esse 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. Esse 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. Esse 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. Esse padrão não é usado pelo IA-Connect.

Padrão de item de tabela disponível
TableItemPatternAvailable boolean

O padrão de item da tabela UIA está disponível. Esse 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. Esse 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. Esse 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. Esse padrão não é usado pelo IA-Connect.

Obter propriedades do elemento datagrid do UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Nome da linha de cabeçalho alternativo
AlternativeHeaderRowName string

Por padrão, a linha de cabeçalho em um DataGrid tem o nome UIA '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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Número de colunas
NumberOfColumns integer

O número de colunas no datagrid.

Número de colunas visíveis
NumberOfVisibleColumns integer

O número de colunas visíveis no datagrid.

Número de linhas
NumberOfRows integer

O número de linhas no datagrid.

Número de linhas visíveis
NumberOfVisibleRows integer

O número de linhas visíveis no datagrid.

Primeira linha visível
FirstVisibleRow integer

O índice da primeira linha visível no datagrid.

Última linha visível
LastVisibleRow integer

O índice da última linha visível no datagrid.

Número de barras de rolagem
NumberOfScrollbars integer

O número de barras de rolagem que o datagrid 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Alça do elemento Return
ReturnElementHandle boolean

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

Valor do elemento Return
ReturnElementValue boolean

Se definido como true que o valor do elemento localizado será retornado.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Nome do elemento
ElementName string

O nome UIA do elemento.

Nome da classe de elemento
ElementClassName string

O nome da classe UIA do elemento.

ID de automação de elementos
ElementAutomationId string

A ID de automação 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 da linguagem.

Tipo de controle localizado do elemento
ElementLocalizedControlType string

O tipo de controle localizado UIA do elemento.

O elemento está habilitado
ElementIsEnabled boolean

Retorna se o elemento está 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 no teclado
ElementIsKeyboardFocusable boolean

Retorna se o elemento pode ser focalizado pelo teclado.

O elemento tem o foco do teclado
ElementHasKeyboardFocus boolean

Retorna se o elemento atualmente tem o foco do teclado.

O elemento é o campo senha
ElementIsPasswordField boolean

Retorna se um elemento é um campo de entrada de senha.

Tecla aceleradora de elemento
ElementAcceleratorKey string

Retorna a tecla de acesso que pode ser pressionada para ativar o elemento.

Chave de acesso do elemento
ElementAccessKey string

Retorna a tecla de acesso 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 exibição.

Borda direita do elemento
ElementRightEdge integer

A distância em pixels entre a borda direita do elemento ou janela e a borda esquerda da exibição.

Borda superior do elemento
ElementTopEdge integer

A distância em pixels entre a borda superior do elemento ou janela e a borda superior da exibição.

Borda inferior do elemento
ElementBottomEdge integer

A distância em pixels entre a borda inferior do elemento ou janela e a borda superior da exibição.

Ponto clicável do elemento X
ElementClickablePointX integer

A coordenada X em pixels de um ponto clicável central no elemento relativo à borda esquerda da exibição, conforme retornado pelo aplicativo subjacente.

Ponto clicável do elemento Y
ElementClickablePointY integer

A coordenada Y em pixels de um ponto clicável central no elemento em relação à 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.

Identificador de elemento
ElementHandle integer

Se a entrada 'Alça do elemento Return' foi definida como true, isso conterá um identificador de elemento numérico que pode ser usado em outras ações para atuar como um identificador 'pai' para outras ações.

Valor do elemento
ElementValue string

Se a entrada 'Valor do elemento Return' tiver sido definida como true e se o elemento tiver um padrão de valor, isso manterá esse valor.

Valor do texto do elemento
ElementTextValue string

Se a entrada 'Valor do elemento Return' 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 única lista de linhas (coleção de linhas/tabela de dados) em vez de itens individuais, isso talvez seja útil dependendo de como você pretende usar os dados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Valor do texto do elemento
ElementTextValue string

O valor de texto do elemento.

Obter várias propriedades do elemento pai do 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' do UIA e é quase sempre um elemento que contém.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de elemento
ElementHandle True integer

O identificador UIA para o elemento de destino.

Máximo de pais para processar
MaxParentsToProcess integer

O número máximo de elementos pai a serem processados. Por padrão, isso é definido como 50.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome Caminho Tipo Description
Elementos pai do 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 várias propriedades de elemento".

items
UIAParentElements object
Número de elementos pai retornados
NumberOfParentElementsReturned integer

O número de elementos pai retornados da pesquisa.

Obter várias propriedades do elemento 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Tipo de controle localizado do elemento search
SearchElementLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Pesquisar descendentes
SearchDescendants boolean

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

Alça do elemento Return
ReturnElementHandle boolean

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

Valor do elemento Return
ReturnElementValue boolean

Se definido como true que o valor do elemento localizado será retornado.

Primeiro item a ser retornado
FirstItemToReturn integer

O índice de elementos do primeiro item a ser retornado, começando a partir de 1. Se você quiser retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você poderá, como alternativa, especificar um índice negativo a partir de -1.

Máximo de itens a serem retornados
MaxItemsToReturn integer

O número máximo de elementos a serem retornados ou 0 para retornar todos os itens.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Retornos

Nome 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 de elemento dos elementos encontrados que correspondem aos critérios de pesquisa.

items
ElementProperties object

Obter vários elementos 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Tipo de controle localizado de subelemento de cabeçalho de célula de pesquisa
SearchCellHeaderSubElementLocalizedControlType string

O tipo de controle localizado do subelemento de cabeçalho da célula a ser pesquisado. Deixe em branco se não estiver procurando cabeçalhos de célula.

Tipo de controle de subelemento de cabeçalho de célula de pesquisa
SearchCellHeaderSubElementControlType integer

O tipo de controle de subelemento do cabeçalho da célula (um inteiro não localizado) a ser pesquisado. Esse é o mesmo valor em diferentes idiomas. Deixe em 0 se não estiver procurando cabeçalhos de célula.

Tipo de controle localizado de subelemento de célula de pesquisa
SearchCellSubElementLocalizedControlType string

O tipo de controle localizado do subelemento de 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. Esse é o mesmo valor em diferentes idiomas.

Pesquisar descendentes por subelementos de célula
SearchDescendantsForCellSubElements boolean

Se definido como true, a árvore UIA abaixo do elemento localizado será pesquisada por subelementos de cabeçalho de célula e célula (ou seja, os valores de elemento que preencherão as células na tabela de saída). Isso é mais completo, mas pode levar mais tempo. Talvez você deseje definir isso como false se estiver interessado apenas em elementos diretamente abaixo do elemento.

Primeiro subelemento de cabeçalho de célula a ser retornado
FirstCellHeaderSubElementToReturn integer

O índice do primeiro subelemento de cabeçalho de célula a ser retornado, começando a partir de 1. Se você quiser retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você poderá, como alternativa, especificar um índice negativo a partir de -1.

Subelementos máximos de cabeçalho de célula a serem retornados
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 ser retornado
FirstCellSubElementToReturn integer

O índice do primeiro subelemento de célula a ser retornado, a partir de 1. Se você quiser retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você poderá, como alternativa, especificar um índice negativo a partir de -1.

Subelementos máximos de célula a serem retornados
MaxCellSubElementsToReturn integer

O número máximo de subelementos de célula a serem retornados ou 0 para retornar todos os subelementos.

Número solicitado de colunas
RequestedNumberOfColumns integer

O número de colunas que você deseja 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 de subelemento de célula como o valor a ser usado na tabela de saída. 1 é a prioridade mais alta. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 não é usado.

Prioridade do valor do texto do subelemento de 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 mais alta. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 não é usado.

Prioridade do valor do nome do subelemento de célula
CellSubElementNameValuePriority integer

A prioridade para usar o nome do subelemento de célula (comum para rótulos) como o valor a ser usado na tabela de saída. 1 é a prioridade mais alta. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 não é usado.

Largura mínima do subelemento de 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 de célula
MinimumCellSubElementHeight integer

A altura mínima em pixels de um subelemento de célula a ser incluído na tabela.

Caixa delimitadora de subelemento de célula de pesquisa à esquerda
SearchCellSubElementBoundingBoxLeft integer

Inclua somente subelementos de célula que estão totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Caixa delimitadora de subelemento de célula de pesquisa à direita
SearchCellSubElementBoundingBoxRight integer

Inclua somente subelementos de célula que estão totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Caixa delimitadora de subelemento de célula de pesquisa superior
SearchCellSubElementBoundingBoxTop integer

Inclua somente subelementos de célula que estão totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos.

Caixa delimitadora de subelemento de célula de pesquisa na parte inferior
SearchCellSubElementBoundingBoxBottom integer

Inclua somente subelementos de célula que estão 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 agente de IA-Connect lerá a tabela imediatamente e retornará o conteúdo para o Diretor. Se estiver lendo tabelas grandes, essa ação poderá acabar. Se definido como true, o agente de IA-Connect lerá a tabela como um thread do Agente e o IA-Connect Director (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 tempo limite. IA-Connect Agentes 9.3 e anteriores só podiam ler tabelas imediatamente, não como um thread do Agente.

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

Se você executou essa ação anteriormente como um thread do Agent e definiu "Segundos para aguardar o thread" como 0, forneça a ID de thread do Agente para recuperar os resultados. Essa ID de thread do Agente terá sido fornecida pela chamada anterior para essa ação. Defina como 0 (o padrão) se você estiver lendo uma tabela (e, portanto, não recuperar os resultados de uma consulta anterior executada como um thread do Agente).

Segundos para aguardar o thread
SecondsToWaitForThread integer

Se 'Ler tabela como thread' for 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 neste momento, uma exceção será gerada. Definido 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 "Aguardar 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 UIA como tabela" com a entrada "Recuperar dados de saída para id de thread" definida para a ID do thread do Agente.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome 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 máximo número de itens a serem retornados).

JSON do conteúdo da tabela
TableContentsJSON string

A tabela criada com base no 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 conterá a ID de thread do Agente que pode ser usada 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 do UIA

Pesquisa a hierarquia de árvore do UIA para 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' do UIA e é quase sempre um elemento que contém.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de 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 por meio da Inspeção.

Tipo de controle de elemento pai de pesquisa
SearchParentControlType integer

O tipo de controle de elemento UIA pai (um inteiro não localizado) a ser pesquisado. Esse é o mesmo valor em diferentes idiomas.

Máximo de pais para processar
MaxParentsToProcess integer

O número máximo de elementos pai a serem processados. Por padrão, isso é definido como 50.

Gerar 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()

Retornos

Nome Caminho Tipo Description
Elemento pai encontrado
ParentElementFound boolean

Retorna true se o elemento UIA pai da pesquisa foi encontrado.

Identificador de 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 nesse elemento.

Nome do elemento pai
ParentElementName string

O nome UIA do elemento pai localizado.

Nome da classe de 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 UIA do elemento pai localizado.

Tipo de controle localizado do elemento pai
ParentElementLocalizedControlType string

O tipo de controle localizado UIA do elemento pai localizado.

Pressione o elemento UIA

Pressiona um elemento (normalmente um botão).

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Aguardar a conclusão do evento de 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 poderá 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 será usado em vez de usar o UIA. Esse é um evento de clique "disparar e esquecer", que pode ser útil ao lidar com caixas de diálogo modais 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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

Experimente o padrão de invocação
TryInvokePattern boolean

Se definido como true (o padrão), o agente de IA-Connect tentará usar um padrão de invocação UIA para executar a ação de imprensa (a menos que 'botão de clique Win32' 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 essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de invocação e retornará imediatamente a outros padrões escolhidos.

Experimentar o padrão herdado
TryLegacyPattern boolean

Se definido como true, o agente de IA-Connect tentará usar um padrão herdado UIA para executar a ação de imprensa se o padrão de invocação não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado) e se o "botão de clique win32" for falso.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Redefinir todos os identificadores de elemento UIA

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

Parâmetros

Nome Chave Obrigató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 de janela (que têm o padrão de transformação).

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

Tipo de largura de redimensionamento
ResizeWidthType string

O tipo de tamanho de largura redimensionado: 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 'Tipo de largura redimensionar'. Para deixar a largura inalterada, escolha um valor de 0 e defina "Tipo de largura redimensionada" como "Relativo".

Tipo de altura de redimensionamento
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 'Tipo de altura de redimensionamento'. 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()

Retornos

Nome Caminho Tipo Description
Resultado do comando
UIAResizeElementResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Região de cores da pesquisa de elementos UIA do mouse global

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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Cor da pesquisa
SearchColour True string

Cor da pesquisa no formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB em que cada canal de cores é um byte no formato hex (00 está totalmente desativado, FF está totalmente ativado). Por exemplo: #FF0000 para vermelho, #00FF00 para azul, nº 0000000 para preto, #FFFFFF para branco.

Desvio máximo de cores
MaxColourDeviation True integer

O máximo que uma cor de elemento pode desviar da cor da pesquisa antes de não ser considerado 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 do pixel X à esquerda
LeftPixelXOffset integer

Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel X à direita
RightPixelXOffset integer

Um deslocamento X opcional para a borda direita da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Deslocamento do pixel Y superior
TopPixelYOffset integer

Um deslocamento Y opcional para a borda superior da área de pesquisa. Isso permite que você aumente (com valores negativos) ou diminua (com valores positivos) a área de pesquisa.

Deslocamento do pixel Y inferior
BottomPixelYOffset integer

Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isso permite que você aumente (com valores positivos) ou diminua (com valores negativos) a área de pesquisa.

Botão do mouse
MouseButton string

O botão do mouse a ser pressionado (Esquerda, Direita, Meio, Duplo à Esquerda).

Clique em deslocamento X
ClickOffsetX integer

O número de pixels X para compensar a ação de clique. Esse parâmetro dá suporte a 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. Esse parâmetro dá suporte a 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 cores a ser deslocada de (Centro/Centro/Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito).

Atraso em milissegundos
DelayInMilliseconds integer

Se estiver executando um clique duplo, 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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Retornos

Nome Caminho Tipo Description
Resultado do comando
UIAGlobalMouseClickElementSearchColourRegionResult boolean

O resultado do comando (êxito ou falha).

Mensagem de erro
ErrorMessage string

Se o comando não tiver sido bem-sucedido, isso conterá a mensagem de erro retornada.

Retorno de entrada para o elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Substituir o valor existente
ReplaceExistingValue boolean

Se houver texto existente no elemento, isso deverá 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 poderá ser usada para inserir em uma posição específica dentro do texto existente.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 agente de IA-Connect 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.

Experimentar o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o agente IA-Connect tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor 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 essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de valor e retornará imediatamente a outros padrões escolhidos.

Experimentar o padrão herdado
TryLegacyPattern boolean

Se definido como true, o agente IA-Connect tentará usar um padrão herdado 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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, concentra-o, clica à esquerda e pressiona as teclas. Normalmente usado com uma entrada de senha que não aceitará métodos de entrada UIA nativos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Elemento Focus primeiro
FocusElement boolean

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

Clique no elemento do mouse à esquerda global
GlobalMouseClickOnElement boolean

Um clique global do mouse deve ser executado nas coordenadas do elemento (para concentrar o elemento) antes de inserir o texto?

Substituir o valor existente usando a exclusão de clique duplo do mouse
ReplaceExistingValueUsingDoubleClickDelete boolean

Algum valor existente deve ser substituído clicando duas vezes no mouse (para realçá-lo) e excluindo?

Substituir o valor existente usando CTRL-A exclusão
ReplaceExistingValueUsingCTRLADelete boolean

Algum valor existente deve ser substituído pressionando Ctrl-A (para realçar tudo) e excluindo? Alguns elementos podem não dar suporte ao realce com Ctrl-A nesse caso, a opção alternativa de 'Substituir valor existente usando a exclusão de clique duplo do mouse' deve ser tentada.

Senha para entrada
PasswordToInput True password

O valor da senha para a entrada global usando o teclado.

Usar eventos de chave de envio
SendKeyEvents boolean

Se definido como true, os eventos de chave de envio (uma API de nível inferior que envia pressionamentos de tecla simulados para o sistema operacional) serão usados. Se definido como false, as chaves de envio (uma API de nível superior que envia pressionamentos de teclas para o elemento focalizado) serão usadas.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada tecla.

Símbolos de interpretação dont
DontInterpretSymbols boolean

Os símbolos na 'Senha para entrada' não devem ser interpretados como chaves especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais.

A senha contém senha armazenada
PasswordContainsStoredPassword boolean

Defina como true se a senha contiver (ou for inteiramente) um identificador de senha armazenado IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica 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 Orquestrador IA-Connect.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Texto de entrada em vários elementos UIA

Ação UIA 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

Nome Chave Obrigató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()

Texto de entrada global no elemento UIA

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Elemento Focus primeiro
FocusElement boolean

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

Clique no elemento do mouse à esquerda global
GlobalMouseClickOnElement boolean

Um clique global do mouse deve ser executado nas coordenadas do elemento (para concentrar o elemento) antes de inserir o texto?

Substituir o valor existente usando a exclusão de clique duplo do mouse
ReplaceExistingValueUsingDoubleClickDelete boolean

Algum valor existente deve ser substituído clicando duas vezes no mouse (para realçá-lo) e excluindo?

Substituir o valor existente usando CTRL-A exclusão
ReplaceExistingValueUsingCTRLADelete boolean

Algum valor existente deve ser substituído pressionando Ctrl-A (para realçar tudo) e excluindo? Alguns elementos podem não dar suporte ao realce com Ctrl-A nesse caso, a opção alternativa de 'Substituir valor existente usando a exclusão de clique duplo do mouse' deve ser tentada.

Texto para entrada
TextToInput string

O valor do texto para a entrada global usando o teclado.

Usar eventos de chave de envio
SendKeyEvents boolean

Se definido como true, os eventos de chave de envio (uma API de nível inferior que envia pressionamentos de tecla simulados para o sistema operacional) serão usados. Se definido como false, as chaves de envio (uma API de nível superior que envia pressionamentos de teclas para o elemento focalizado) serão usadas.

Intervalo em milissegundos
Interval integer

O número de milissegundos entre cada tecla.

Símbolos de interpretação dont
DontInterpretSymbols boolean

Os símbolos no 'Texto para entrada' não devem ser interpretados como chaves 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 serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

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

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

Para alguns elementos, o UIA 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 pelo UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pelo UIA e usará o centro do elemento.

Workflow
Workflow True string

Adicione a seguinte expressão aqui: workflow()

Texto de entrada no elemento UIA

Ação UIA que insere o 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Texto para entrada
TextToInput string

O valor de texto a ser inserido.

Índice de correspondência
MatchIndex integer

Se vários elementos corresponderem à pesquisa, qual elemento (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Substituir o valor existente
ReplaceExistingValue boolean

Se houver texto existente no elemento, isso deverá 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 poderá ser usada para inserir em uma posição específica dentro do texto existente.

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 agente de IA-Connect 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.

Experimentar o padrão de valor
TryValuePattern boolean

Se definido como true (o padrão), o agente IA-Connect tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor 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 essa ação). Se definido como false, o agente de IA-Connect não tentará usar um padrão de valor e retornará imediatamente a outros padrões escolhidos.

Experimentar o padrão herdado
TryLegacyPattern boolean

Se definido como true, o agente IA-Connect tentará usar um padrão herdado 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()

Verificar 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

Nome Chave Obrigatório Tipo Description
Identificador de janela pai
ParentWindowHandle True integer

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

Nome do elemento Search
SearchElementName string

O nome do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Nome da classe do elemento Search
SearchElementClassName string

O nome da classe de elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

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

A ID de automação do elemento UIA opcional a ser pesquisada (começando pelo identificador da janela pai). Isso pode ser descoberto por meio da Inspeção.

Tipo de controle localizado do elemento search
SearchLocalizedControlType string

O tipo de controle localizado do elemento UIA opcional a ser pesquisado (começando pelo identificador da janela pai). Isso pode ser descoberto por meio 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. Isso é mais completo, mas pode levar mais tempo. Se definido como false, somente os elementos diretamente abaixo do identificador da janela pai na árvore UIA serão pesquisados.

Elemento Check
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 (começando em 1) deverá 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 'Document*' AND [ClassName] como 'Label*'. Consulte a documentação para obter mais exemplos.

Classificar por nome de coluna
SortByColumn string

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

O índice de correspondência é crescente
MatchIndexAscending boolean

Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deverá corresponder na parte superior da lista classificada (true) ou na parte inferior da lista classificada (false).

Máximo de elementos a serem pesquisados
MaxElementsToSearch integer

O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de pesquisa relativa máxima
MaxRelativeSearchDepth integer

A profundidade de árvore relativa máxima para pesquisar elementos filho abaixo do elemento pai. Os elementos filho diretos terão um valor de profundidade de 1. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 pesquisar por nó
MaxChildElementsToSearchPerNode integer

O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar na árvore UIA o elemento de destino. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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 de elemento para não atravessar
ElementLocalizedControlTypesNotToTraverse string

Uma lista separada por vírgulas de tipos de controle localizados do elemento UIA para não atravessar (intervir) ao pesquisar na árvore UIA o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, ele não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funcionará se o modo de pesquisa do elemento UIA for "Tree walk" (isso pode ser habilitado 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()

Verificar vários elementos 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

Nome Chave Obrigató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()