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 |
| 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() |