IA-Connect UI
IA-Connect é uma plataforma 'RPA' de Robotic Process Automation que adiciona funcionalidade de RPA da nuvem para máquinas virtuais locais ou através de conexões Citrix ou Microsoft Remote Desktop 'RDS'. Este é o módulo para o aplicativo Windows User Interface Automation 'UIA'.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Laboratórios Ultima |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| Metadados do conector | |
|---|---|
| Editora | Ultima Negócios |
| Sítio Web | https://www.ultima.com/ultima-labs |
| Política de privacidade | https://www.ultima.com/privacy-policy |
| Categorias | Operações de TI; Produtividade |
IA-Connect é uma plataforma de Robotic Process Automation (RPA) que adiciona funcionalidade de RPA do Power Automate Cloud Flows a máquinas virtuais locais ou através de conexões Citrix ou Microsoft Remote Desktop (RDS). Os IA-Connect Connectors fornecem mais de 800 ações, permitindo automatizar todos os tipos de aplicativos locais diretamente de um Power Automate Cloud Flow. Todas as IA-Connect ações estão disponíveis diretamente do seu Power Automate Cloud Flow, proporcionando fácil integração entre aplicativos baseados na nuvem e locais, a capacidade de aproveitar as condições, loops, conteúdo dinâmico, expressões e tratamento de exceções existentes do Power Automate em seus processos de RPA. A utilização dos conectores IA-Connect também fornece histórico de execução completo e auditabilidade do histórico de execução do Flow, ao mesmo tempo em que elimina a necessidade de ter um aplicativo/console/estúdio separado para desenvolver seus processos de RPA.
Pré-requisitos
Para usar qualquer um dos IA-Connect Connectors, você deve instalar o software IA-Connect. Este teste é gratuito durante 30 dias, após os quais necessitará de uma licença IA-Connect.
O software IA-Connect consiste em dois componentes principais:
O IA-Connect Orchestrator, que é um WebApp do Azure que você hospedaria em seu próprio locatário do Azure. Isso lida com o roteamento e a segurança de fluxos de RPA para uma ou mais máquinas virtuais locais ou baseadas em nuvem.
O IA-Connect Agent and Diretor, que é instalado nas máquinas virtuais onde o software que você deseja automatizar está acessível. Além disso, o IA-Connect Agent pode ser executado dentro de uma sessão Citrix ou Microsoft Remote Desktop Services (RDS), onde os comandos RPA são passados por um canal virtual para a sessão remota para execução. O IA-Connect Agent pode ser executado a partir de um compartilhamento de rede e não requer instalação.
Conectores IA-Connect disponíveis
Os conectores IA-Connect disponíveis são:
- IA-Connect Código Dinâmico
- IA-Connect Java
- IA-Connect JML
- IA-Connect Mainframe
- IA-Connect Microsoft Office
- IA-Connect SAP GUI
- Sessão IA-Connect
- IA-Connect UI
- IA-Connect Web Browser
Como obter credenciais
Para receber sua licença e começar sua avaliação gratuita de 30 dias, envie uma solicitação em nosso site (https://www.ultima.com/IA-Connect/Power-Automate).
Assim que receber um pedido de avaliação, entraremos em contacto consigo através do endereço de e-mail fornecido para ajudar a configurar o software IA-Connect e para lhe fornecer a licença de avaliação. Esta é uma versão de avaliação completa e permitirá que você teste qualquer uma das 800 ações em todos os 9 conectores IA-Connect em seu próprio ambiente durante o período de avaliação.
Introdução ao conector
Depois de submeter um pedido de avaliação para o IA-Connect, poderá descarregar um ficheiro ZIP contendo o software IA-Connect e documentação que abrange a instalação e configuração. Também entraremos em contato para oferecer suporte e orientação durante o processo de instalação, conforme necessário.
Support
Durante o período de teste, você pode entrar em contato com o Ultima Labs (IAConnect@ultima.com) para obter suporte e assistência.
Ao comprar IA-Connect licenças, você receberá tokens de suporte que podem ser trocados por treinamento personalizado ou suporte do Centro de Serviço Técnico (TSC) da Ultima, com sede no Reino Unido.
Problemas conhecidos, erros comuns e perguntas frequentes
Nossa Base de Conhecimento contém uma série de artigos que abrangem quaisquer problemas conhecidos, erros comuns que podem ocorrer ao usar os IA-Connect Connectors e perguntas frequentes. Isso pode ser acessado e https://support.ultima.com/ultimalabs uma conta para acessar esses recursos é fornecida durante a avaliação do IA-Connect e após a compra de uma licença IA-Connect.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | securestring | A chave de API para esta api | Verdade |
| IA-Connect Endereço do Orchestrator | cadeia (de caracteres) | Especifique o endereço do IA-Connect Orchestrator sem o componente HTTP(S) | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Aguarde a imagem de pesquisa visível no elemento UIA |
Aguarda até que uma imagem de pesquisa, fornecida como entrada para esta ação, tenha sido visivelmente localizada dentro de um elemento UIA na tela ou até que o tempo especificado tenha passado. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente após a imagem ter sido localizada. |
| Aguarde a janela principal do ID do processo UIA |
Uma ação Win32 simples e rápida que aguarda a existência de uma janela principal de um processo (especificada pela ID do processo) e retorna um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa. |
| Aguarde a janela principal do processo UIA |
Uma ação Win32 simples e rápida que aguarda um tempo especificado para que a janela principal de um processo (especificada pelo nome) exista antes de retornar um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa. |
| Aguarde a janela Win32 de nível superior da UIA |
Uma ação Win32 rápida que aguarda um tempo especificado para que uma janela Win32 de nível superior exista antes de retornar um identificador UIA. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. É mais comum usar a ação UIA 'Esperar pelo elemento da área de trabalho', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente. |
| Aguarde até que a imagem de pesquisa visível não exista no elemento UIA |
Aguarda até que uma imagem de pesquisa, fornecida como uma entrada para esta ação, não possa ser visivelmente localizada (ou nunca tenha sido localizada) dentro de um elemento UIA na tela, ou a quantidade especificada de tempo tenha passado e a imagem ainda esteja presente. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente quando a imagem não estiver mais presente. |
| Aguarde até que o elemento da área de trabalho UIA não exista |
Aguarda que um elemento da área de trabalho (normalmente uma janela) não exista mais. |
| Aguarde até que o elemento UIA não exista |
Espera que um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto) deixe de existir. |
| Aguarde o elemento da área de trabalho UIA |
Aguarda a existência de um elemento da área de trabalho (normalmente uma janela). |
| Aguarde o elemento UIA |
Aguarda a existência de um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto). |
| Alternar elemento UIA |
Alterna um elemento (normalmente uma caixa de seleção ou uma caixa de rádio). Isto dá ao elemento o estado oposto ao seu estado atual (por exemplo, verificado torna-se desmarcado e vice-versa). Se você quiser definir um estado específico, use a ação 'Verificar elemento'. |
| Clique com o botão direito do rato global no elemento UIA |
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão direito do mouse. |
| Clique com o botão esquerdo do mouse global no elemento UIA |
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão esquerdo do mouse. |
| Clique em UIA item de elemento de lista por nome |
Clica no elemento list com o nome especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu. |
| Clique em UIA item de elemento de lista por índice |
Clique no elemento de lista que corresponde ao índice especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu. |
| Clique global do mouse na região de cores de pesquisa do elemento UIA |
Move o mouse sobre uma região de pixels dentro de um elemento UIA que atende aos critérios de cor especificados e executa um clique do mouse. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos. |
| Clique no meio global do mouse no elemento UIA |
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, relativo a um elemento UIA e clica no botão do meio do mouse. |
| Definir a janela UIA como normal |
Normaliza a janela com a alça UIA especificada (ou seja, define-a para uma janela de tamanho normal em vez de minimizada ou maximizada). |
| Definir a porcentagem de rolagem do elemento UIA |
Defina a porcentagem de rolagem horizontal e/ou vertical do elemento especificado, se a rolagem for suportada por esse elemento. Se o elemento suportar o padrão 'scroll', você poderá aplicar essa ação diretamente ao elemento e especificar uma quantidade de rolagem horizontal ou vertical (ou ambas). Se o elemento não suportar o padrão 'scroll', essa ação retornará aos padrões 'range value' ou 'value', mas você precisará aplicá-los diretamente ao(s) controle(s) da barra de rolagem, não ao elemento em si. |
| Definir janela UIA de primeiro plano |
Traz uma janela para o primeiro plano. |
| Definir o elemento UIA como valor de intervalo numérico |
Define o valor do elemento que tem um intervalo numérico, por exemplo, uma barra de rolagem. |
| Definir o elemento UIA como valor numérico |
Define o valor do elemento que tem uma entrada numérica, por exemplo, um campo de texto ou uma barra de rolagem. |
| Definir o modo de pesquisa do elemento UIA |
Escolha qual modo de pesquisa de elemento UIA deve ser usado pelo IA-Connect Agent ao executar ações UIA. Normalmente, essa ação só seria usada se você estiver tendo um problema com o modo padrão (Localizar tudo). |
| Definir o tempo limite da transação UIA |
Controla quanto tempo a API UIA aguardará para que um aplicativo retorne as informações sobre um elemento. Esse tempo limite de transação normalmente só seria atingido se o aplicativo não respondesse. |
| Desenhar retângulo em torno do elemento UIA |
Desenha um retângulo em torno do perímetro de um elemento para ajudar a identificar que o elemento encontrado é o necessário. O retângulo é removido automaticamente após 5 segundos. |
| Elemento UIA de foco |
Foca um elemento que o torna o elemento ativo para o foco do teclado e, dependendo do aplicativo, pode trazer a janela do elemento para o primeiro plano. |
| Existe uma janela Win32 de nível superior |
Uma ação rápida do Win32 que informa se existe uma janela Win32 de nível superior. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente. |
| Expandir elemento UIA |
Expande um elemento (normalmente um item de menu/menu suspenso). Se o item já estiver expandido, nada acontecerá. |
| Faça uma captura de tela do local do elemento UIA |
Tira uma captura de tela do local de um elemento e retorna uma imagem. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos. |
| Fechar janela de elemento UIA |
Fecha a janela do elemento. Normalmente, só funciona em janelas ou caixas de diálogo. |
| Global duplo clique esquerdo do mouse no elemento UIA |
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica duas vezes no botão esquerdo do mouse. |
| Inserir senha no elemento UIA |
Ação UIA que insere uma senha em um elemento (normalmente um campo de entrada de senha), substituindo o texto existente. |
| Inserir texto em vários elementos da interface do usuário |
UIA Action que insere diferentes partes de texto em vários elementos (normalmente campos de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica. |
| Inserir texto no elemento UIA |
Ação UIA que insere texto em um elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica. |
| Localizar imagem de pesquisa visível dentro do elemento UIA |
Retorna se uma imagem de pesquisa, fornecida como entrada para essa ação, foi visivelmente localizada em um elemento da interface do usuário na tela. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. |
| Maximizar a janela UIA |
Maximiza a janela com a alça UIA especificada. |
| Minimizar a janela UIA |
Minimiza a janela com a alça UIA especificada. |
| Mover elemento UIA |
Move um elemento UIA para uma posição especificada na tela. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação). |
| O elemento da área de trabalho UIA existe |
Relata se um elemento da área de trabalho existe e fornece algumas propriedades básicas do elemento. |
| O elemento UIA está verificado |
Essa ação retorna true ou false indicando se um elemento (normalmente uma caixa de seleção ou caixa de rádio) está marcado. |
| O elemento UIA existe |
Informa se um elemento existe e retorna algumas propriedades básicas do elemento. |
| O processo tem janela Win32 |
Uma ação Win32 simples e rápida que relata se um processo (especificado pelo nome) tem alguma janela visível. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa. |
| Obter a região de cores de pesquisa do elemento UIA |
Retorna os detalhes da região de pixels dentro de um elemento UIA que atendem aos critérios de cor especificados. O elemento deve ser trazido para a frente primeiro, porque o Agente localiza as cores fazendo uma captura de tela nas coordenadas do elemento. |
| Obter conteúdo do elemento de grade de dados UIA |
Retorna o conteúdo de um elemento datagrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela). Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente. |
| Obter elementos da área de trabalho UIA |
Retorna uma lista de todas as janelas e caixas de diálogo na área de trabalho. |
| Obter identificador de elemento pai da UIA |
Retorna um identificador para o elemento pai do elemento especificado. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção. |
| Obter identificador UIA para a janela principal do elemento focalizado |
Retorna um identificador para a janela principal do elemento UIA focado no momento. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. |
| Obter identificador UIA para a janela principal do ID do processo |
Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pela ID do processo). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa. |
| Obter identificador UIA para a janela principal do processo |
Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pelo nome). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa. |
| Obter identificador UIA para a janela Win32 de nível superior |
Uma ação Win32 rápida que retorna um identificador UIA para qualquer janela Win32 de nível superior que tenha o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Uma janela de nível superior é aquela que está conectada à área de trabalho. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente. |
| Obter identificador UIA para desktop |
Retorna um identificador para a área de trabalho. Esta é uma ação obsoleta porque o identificador '-2' pode ser usado para se referir ao elemento desktop, mas também porque há muitas ações que podem pesquisar em relação à área de trabalho (por exemplo, 'esperar pelo elemento desktop'). |
| Obter identificador UIA para elemento focalizado |
Retorna um identificador para o elemento UIA focado no momento. |
| Obter itens de elemento de lista UIA |
Retorna uma lista de itens de elemento filho encontrados sob o elemento especificado (normalmente itens suspensos/de menu). |
| Obter janelas Win32 |
Uma ação rápida do Win32 que retorna uma lista de todas as janelas do Win32 que opcionalmente têm o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. Win32 Windows pode incluir itens inesperados, incluindo a barra de tarefas, área de trabalho, menu Iniciar, sobreposições transparentes, fora da tela ou janelas ocultas, para que a lista retornada pode conter mais resultados do que o esperado. |
| Obter o elemento UIA nas coordenadas da tela |
Retorna o elemento UIA localizado nas coordenadas de tela fornecidas. |
| Obter o modo de pesquisa de elementos UIA |
Recupera qual modo de pesquisa de elemento UIA está sendo usado pelo IA-Connect Agent for UIA ações. |
| Obter padrões de elemento UIA |
Recupere quais padrões de UIA estão disponíveis para um elemento UIA e, portanto, quais ações de UIA IA-Connect provavelmente terão um efeito sobre o elemento. |
| Obter propriedades do elemento datagrid da UIA |
Retorna propriedades de tabela de um elemento DataGrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela). |
| Obter propriedades do elemento UIA |
Retorna todas as propriedades de um elemento. Isso pode ser útil se você não tiver certeza de qual campo contém os valores de propriedade necessários. |
| Obter propriedades do elemento UIA como lista |
Retorna as propriedades de um elemento como uma lista de linha única (coleção de linha única / tabela de dados) em vez de itens individuais, isso pode ser útil dependendo de como você pretende usar os dados. |
| Obter valor de texto do elemento UIA |
Retorna o valor de texto de um elemento. Um valor de texto geralmente é associado a um rótulo, mas muitos elementos podem ter essa propriedade. |
| Obter valor do elemento UIA |
Retorna o valor de um elemento. Um valor geralmente é associado a uma área de entrada de texto, mas muitos elementos podem ter essa propriedade. |
| Obter valor do rótulo do elemento UIA |
Retorna o valor do rótulo no elemento . |
| Obter várias propriedades de elementos UIA |
Retorna as propriedades de vários elementos. Isso pode ser útil se você não tiver certeza de quais campos contêm os valores de propriedade necessários. |
| Obter várias propriedades do elemento pai da UIA |
Retorna uma árvore hierárquica de elementos pai do elemento especificado, até a área de trabalho (nível raiz). O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção. |
| Obter vários elementos da UIA como tabela |
Enumera os valores dos elementos filho de um elemento pai especificado e retorna em um formato de tabela. Isso pode ser usado para retornar linhas e colunas de dados de elementos que não são tecnicamente tabelas, mas foram organizados juntos em uma estrutura de tabela. Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente. |
| Pesquisar o primeiro elemento pai da UIA |
Pesquisa na hierarquia da árvore UIA o primeiro elemento pai que corresponde aos critérios de pesquisa. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção. |
| Pressione o elemento UIA |
Pressiona um elemento (normalmente um botão). |
| Recolher elemento UIA |
Recolhe um elemento (normalmente um item de menu / dropdown). Se o item já estiver recolhido, nada acontecerá. |
| Redefinir todos os identificadores de elementos UIA |
Redefine todos os identificadores de elemento UIA atualmente armazenados por IA-Connect o que pode ser útil se você tiver identificado muitos elementos e tiver um grande número de identificadores de elemento armazenados. Em cenários com números extremamente altos de identificadores de elementos (100.000+), essa ação também pode ser usada para liberar o uso de RAM. |
| Redimensionar elemento UIA |
Redimensiona um elemento UIA. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação). |
| Retorno de entrada no elemento UIA |
Introduz um retorno do Windows/nova linha num elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o retorno numa posição específica. |
| Selecionar elemento UIA |
Seleciona um elemento (normalmente um item em uma lista ou lista suspensa). |
| Senha de entrada global no elemento UIA |
Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de senha que não aceitará métodos de entrada nativos da UIA. |
| Texto de entrada global no elemento UIA |
Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de texto que não aceitará métodos de entrada UIA nativos. |
| Verificar vários elementos da UIA |
Define o estado de vários elementos (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado. |
| Verifique o elemento UIA |
Define o estado de um elemento (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado. |
Aguarde a imagem de pesquisa visível no elemento UIA
Aguarda até que uma imagem de pesquisa, fornecida como entrada para esta ação, tenha sido visivelmente localizada dentro de um elemento UIA na tela ou até que o tempo especificado tenha passado. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente após a imagem ter sido localizada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipo de imagem de pesquisa
|
SearchImageType | string |
Define o que a entrada 'Pesquisar imagem' representa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem. |
|
|
Pesquisar imagem
|
SearchImage | string |
A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. |
|
|
Tipo de imagem de pesquisa alternativa
|
AltSearchImageType | string |
Define o que a entrada 'Imagem de pesquisa alternativa' representa. Se definido como 'Nenhum' ou em branco, não há nenhuma imagem de pesquisa alternativa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem. |
|
|
Imagem de pesquisa alternativa
|
AltSearchImage | string |
Uma imagem de pesquisa alternativa opcional para localizar dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa alternativa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. Se você especificar uma imagem de pesquisa alternativa, o Agente procurará a imagem de pesquisa ou alternativa e relatará qual delas foi localizada. |
|
|
Desvio máximo de cor
|
MaxColourDeviation | integer |
O máximo de cores de pixel de um elemento pode se desviar das cores de pixel da imagem de pesquisa antes que ele não seja considerado uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Isto permite que pequenas diferenças de coloração sejam ignoradas. |
|
|
Diferenças máximas de pixels
|
MaxPixelDifferences | integer |
O número máximo de píxeis que pode diferir (acima do desvio máximo de cor) em toda a imagem pesquisada, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definido para um valor acima de 0, você também deve definir 'Máximo de diferenças de pixels consecutivos'. |
|
|
Máximo de diferenças consecutivas de pixels
|
MaxConsecutivePixelDifferences | integer |
O número máximo de píxeis que pode diferir (acima do desvio máximo de cor), em qualquer linha, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definindo para um valor acima de 0, você também deve definir 'Diferenças máximas de pixels'. |
|
|
Deslocamento X do pixel esquerdo
|
LeftPixelXOffset | integer |
Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento X do pixel direito
|
RightPixelXOffset | integer |
Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Deslocamento Y de pixel superior
|
TopPixelYOffset | integer |
Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento Y do pixel inferior
|
BottomPixelYOffset | integer |
Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Unidade de deslocamentos do Pixel X
|
PixelXOffsetsUnit | string |
Defina como 'Pixel' (o padrão) se os deslocamentos de pixel X esquerdo e direito forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos de pixel X esquerdo e direito forem medidos como uma porcentagem da largura do elemento. |
|
|
Unidade de deslocamentos Pixel Y
|
PixelYOffsetsUnit | string |
Defina como 'Pixel' (o padrão) se os deslocamentos de pixel Y superior e inferior forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos Y de pixel superior e inferior forem medidos como uma porcentagem da altura do elemento. |
|
|
Índice de imagens de pesquisa
|
SearchImageIndex | integer |
Defina como 1 para localizar a primeira instância da imagem de pesquisa (na direção da pesquisa) dentro do elemento UIA. Definido como 2 para a segunda instância, .... , N para a nona instância. Se você também estiver procurando por uma imagem alternativa, o elemento UIA será digitalizado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, procurando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma mistura de ambas as imagens). |
|
|
Direção da pesquisa de imagens
|
ImageSearchDirection | string |
A direção da busca. 'Do topo' pesquisa por linha a partir do topo, digitalizando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha a partir da parte inferior, digitalizando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, digitalizando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, digitalizando de cima para baixo dentro de cada coluna. Isto pode ser usado em conjunto com 'Pesquisar índice de imagem' para localizar a Nona imagem a partir da parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção de pesquisa que você acha que localizará sua imagem mais rapidamente. |
|
|
Ocultar agente
|
HideAgent | boolean |
Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado. |
|
|
Retornar coordenadas da tela como físicas
|
ReturnPhysicalCoordinates | boolean |
Defina como true para que as coordenadas da tela sejam retornadas como coordenadas físicas. Defina como false para que as coordenadas da tela sejam retornadas como coordenadas virtuais. Se o dimensionamento de exibição subjacente for de 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas do elemento são sempre retornadas como coordenadas virtuais. |
|
|
Mostrar retângulo de realce
|
ShowHighlightRectangle | boolean |
Se definido como true, o IA-Connect Agent destacará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detetada. |
|
|
Segundos de espera pela imagem de pesquisa
|
SecondsToWait | integer |
O número de segundos para aguardar até que a imagem de pesquisa seja localizada dentro do elemento UIA. Se a imagem não estiver localizada, uma exceção será gerada se 'Aumentar exceção se a imagem não encontrada' estiver definida como true, caso contrário, a ação informará que a imagem não foi localizada. |
|
|
Milésimos de segundo entre pesquisas
|
MillisecondsBetweenSearches | integer |
O número de milissegundos a aguardar entre cada elemento UIA na verificação na tela. Como o reconhecimento de imagem pode ser caro para a CPU, um atraso pode ajudar a reduzir e distribuir a utilização da CPU. Por exemplo: Se você espera que uma imagem possa levar até 1 minuto para ficar visível, adicionar uma pausa de 5000 milissegundos (5 segundos) entre as verificações reduzirá significativamente a utilização da CPU (reduzindo consideravelmente o número de verificações), mas terá apenas um pequeno impacto no tempo de resposta. O valor mínimo permitido é de 100 milissegundos (1/10 segundo). |
|
|
Gerar exceção se a imagem não for encontrada
|
RaiseExceptionIfImageNotFound | boolean |
Defina como true se IA-Connect gerar uma exceção se a imagem não puder ser localizada após o período de espera. |
|
|
Recuperar dados de saída para ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Se você definiu anteriormente 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), forneça o ID do thread do Agent para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Caso contrário, defina como 0 (o padrão). |
|
|
Aguarde o thread
|
WaitForThread | boolean |
Defina como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado em 'Segundos para aguardar a imagem de pesquisa'. Defina como false para ignorar a espera; O Agente continuará a executar a espera em segundo plano, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente essa ação 'Esperar pela imagem de pesquisa visível no elemento UIA' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Pesquisar imagem localizada
|
SearchImageLocated | boolean |
Esta saída será definida como true, se a imagem de pesquisa foi localizada. Esta saída será definida como false, se a imagem de pesquisa não foi localizada. |
|
Qual imagem de pesquisa localizada
|
WhichSearchImageLocated | integer |
Essa saída será definida como 0, se nenhuma imagem de pesquisa for localizada. Defina como 1, se a imagem de pesquisa foi localizada. Defina como 2, se a imagem de pesquisa alternativa foi localizada. |
|
Elemento da caixa delimitadora de correspondência de imagem pixel esquerdo
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
A coordenada X virtual do pixel mais à esquerda correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Pixel direito do elemento da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
A coordenada X virtual do pixel mais à direita correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Pixel superior do elemento da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
A coordenada Y virtual do pixel mais alto correspondente à imagem especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Pixel inferior do elemento da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
A coordenada Y virtual do pixel mais inferior correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de imagem centro X pixel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
A coordenada X virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de imagem centro Y pixel
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
A coordenada Y virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Tela da caixa delimitadora de correspondência de imagem pixel esquerdo
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
A coordenada X do pixel da tela do pixel mais à esquerda correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Tela da caixa delimitadora de correspondência de imagem pixel direito
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
A coordenada X do pixel mais à direita correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel superior da tela da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
A coordenada Y do pixel da tela correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel inferior da tela da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
A coordenada Y do pixel da tela que corresponde à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Tela da caixa delimitadora de correspondência de imagem central X pixel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
A coordenada X do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Caixa delimitadora de correspondência de imagem tela central Y pixel
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
A coordenada Y do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Thread Id
|
ThreadId | integer |
Se você tiver definido 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), essa saída manterá o ID do thread do Agente, que pode ser usado para monitorar o processo da ação e recuperar os resultados mais tarde, quando o thread for concluído. |
Aguarde a janela principal do ID do processo UIA
Uma ação Win32 simples e rápida que aguarda a existência de uma janela principal de um processo (especificada pela ID do processo) e retorna um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Id do processo de pesquisa
|
ProcessId | True | integer |
O ID do processo a aguardar (conforme fornecido pela ação 'Executar processo' nas ações Ambiente de IA-Connect / Sessão). |
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para aguardar a janela principal do processo. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe
|
ElementExists | boolean |
Retorna true se o elemento existir ou false se não. |
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
Aguarde a janela principal do processo UIA
Uma ação Win32 simples e rápida que aguarda um tempo especificado para que a janela principal de um processo (especificada pelo nome) exista antes de retornar um identificador. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do processo de pesquisa
|
SearchProcessName | True | string |
O nome do processo a pesquisar, por exemplo, bloco de notas. |
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para aguardar a janela principal do processo. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
|
O elemento existe
|
ElementExists | boolean |
Retorna true se a janela existir ou false se não. |
Aguarde a janela Win32 de nível superior da UIA
Uma ação Win32 rápida que aguarda um tempo especificado para que uma janela Win32 de nível superior exista antes de retornar um identificador UIA. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. É mais comum usar a ação UIA 'Esperar pelo elemento da área de trabalho', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar nome da classe
|
SearchClassName | string |
O nome da classe do elemento da janela de nível superior para pesquisar, por exemplo, 'Bloco de Notas'. |
|
|
Título da janela de pesquisa
|
SearchWindowTitle | string |
O título da janela de nível superior para pesquisar. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para esperar que a janela exista. |
|
Id do processo de pesquisa
|
SearchProcessId | integer |
A ID do processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais em relação às propriedades de janela disponíveis. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de janela classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher a janela necessária. Por exemplo: Se 'Ordenar por nome de coluna' for [TopEdge] e 'Índice de correspondência' for 1, a janela correspondente mais próxima da parte superior do ecrã será devolvida. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se várias janelas corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Aumentar exceção se a janela não for encontrada
|
RaiseExceptionIfWindowNotFound | boolean |
Deve IA-Connect gerar uma exceção se a janela de pesquisa Win32 não existir após o período de espera? |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
|
O elemento existe
|
ElementExists | boolean |
Retorna true se a janela existir ou false se não. |
Aguarde até que a imagem de pesquisa visível não exista no elemento UIA
Aguarda até que uma imagem de pesquisa, fornecida como uma entrada para esta ação, não possa ser visivelmente localizada (ou nunca tenha sido localizada) dentro de um elemento UIA na tela, ou a quantidade especificada de tempo tenha passado e a imagem ainda esteja presente. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela. O elemento UIA deve existir desde o início. A ação é concluída imediatamente quando a imagem não estiver mais presente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipo de imagem de pesquisa
|
SearchImageType | string |
Define o que a entrada 'Pesquisar imagem' representa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem. |
|
|
Pesquisar imagem
|
SearchImage | string |
A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. |
|
|
Tipo de imagem de pesquisa alternativa
|
AltSearchImageType | string |
Define o que a entrada 'Imagem de pesquisa alternativa' representa. Se definido como 'Nenhum' ou em branco, não há nenhuma imagem de pesquisa alternativa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem. |
|
|
Imagem de pesquisa alternativa
|
AltSearchImage | string |
Uma imagem de pesquisa alternativa opcional para localizar dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa alternativa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. Se você especificar uma imagem de pesquisa alternativa, o Agente procurará a imagem de pesquisa ou alternativa e relatará qual delas foi localizada. |
|
|
Desvio máximo de cor
|
MaxColourDeviation | integer |
O máximo de cores de pixel de um elemento pode se desviar das cores de pixel da imagem de pesquisa antes que ele não seja considerado uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Isto permite que pequenas diferenças de coloração sejam ignoradas. |
|
|
Diferenças máximas de pixels
|
MaxPixelDifferences | integer |
O número máximo de píxeis que pode diferir (acima do desvio máximo de cor) em toda a imagem pesquisada, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definido para um valor acima de 0, você também deve definir 'Máximo de diferenças de pixels consecutivos'. |
|
|
Máximo de diferenças consecutivas de pixels
|
MaxConsecutivePixelDifferences | integer |
O número máximo de píxeis que pode diferir (acima do desvio máximo de cor), em qualquer linha, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definindo para um valor acima de 0, você também deve definir 'Diferenças máximas de pixels'. |
|
|
Deslocamento X do pixel esquerdo
|
LeftPixelXOffset | integer |
Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento X do pixel direito
|
RightPixelXOffset | integer |
Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Deslocamento Y de pixel superior
|
TopPixelYOffset | integer |
Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento Y do pixel inferior
|
BottomPixelYOffset | integer |
Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Unidade de deslocamentos do Pixel X
|
PixelXOffsetsUnit | string |
Defina como 'Pixel' (o padrão) se os deslocamentos de pixel X esquerdo e direito forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos de pixel X esquerdo e direito forem medidos como uma porcentagem da largura do elemento. |
|
|
Unidade de deslocamentos Pixel Y
|
PixelYOffsetsUnit | string |
Defina como 'Pixel' (o padrão) se os deslocamentos de pixel Y superior e inferior forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos Y de pixel superior e inferior forem medidos como uma porcentagem da altura do elemento. |
|
|
Índice de imagens de pesquisa
|
SearchImageIndex | integer |
Defina como 1 para localizar a primeira instância da imagem de pesquisa (na direção da pesquisa) dentro do elemento UIA. Definido como 2 para a segunda instância, .... , N para a nona instância. Se você também estiver procurando por uma imagem alternativa, o elemento UIA será digitalizado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, procurando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma mistura de ambas as imagens). |
|
|
Direção da pesquisa de imagens
|
ImageSearchDirection | string |
A direção da busca. 'Do topo' pesquisa por linha a partir do topo, digitalizando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha a partir da parte inferior, digitalizando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, digitalizando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, digitalizando de cima para baixo dentro de cada coluna. Isto pode ser usado em conjunto com 'Pesquisar índice de imagem' para localizar a Nona imagem a partir da parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção de pesquisa que você acha que localizará sua imagem mais rapidamente. |
|
|
Ocultar agente
|
HideAgent | boolean |
Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado. |
|
|
Mostrar retângulo de realce
|
ShowHighlightRectangle | boolean |
Se definido como true, o IA-Connect Agent destacará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detetada. |
|
|
Segundos de espera até que a imagem de pesquisa não exista
|
SecondsToWait | integer |
O número de segundos para aguardar até que a imagem de pesquisa não esteja visivelmente localizada dentro do elemento UIA. Se a imagem ainda estiver presente após esse período, uma exceção será gerada se 'Aumentar exceção se a imagem ainda estiver presente' estiver definida como true, caso contrário, a ação informará que a imagem ainda está presente. |
|
|
Milésimos de segundo entre pesquisas
|
MillisecondsBetweenSearches | integer |
O número de milissegundos a aguardar entre cada elemento UIA na verificação na tela. Como o reconhecimento de imagem pode ser caro para a CPU, um atraso pode ajudar a reduzir e distribuir a utilização da CPU. Por exemplo: Se você espera que uma imagem possa levar até 1 minuto para ficar visível, adicionar uma pausa de 5000 milissegundos (5 segundos) entre as verificações reduzirá significativamente a utilização da CPU (reduzindo consideravelmente o número de verificações), mas terá apenas um pequeno impacto no tempo de resposta. O valor mínimo permitido é de 100 milissegundos (1/10 segundo). |
|
|
Levantar exceção se a imagem ainda estiver presente
|
RaiseExceptionIfImageStillPresent | boolean |
Defina como true se IA-Connect gerar uma exceção se a imagem ainda estiver presente após o período de espera. |
|
|
Recuperar dados de saída para ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Se você definiu anteriormente 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), forneça o ID do thread do Agent para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Caso contrário, defina como 0 (o padrão). |
|
|
Aguarde o thread
|
WaitForThread | boolean |
Defina como true para aguardar a conclusão do thread do Agente; O Agente aguardará o tempo especificado em 'Segundos para aguardar que a imagem de pesquisa não exista'. Defina como false para ignorar a espera; O Agente continuará a executar a espera em um thread em segundo plano, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente esta ação 'Esperar que a imagem de pesquisa visível não exista no elemento UIA' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Pesquisar imagem presente antes de esperar
|
SearchImagePresentBeforeWait | boolean |
Esta saída será definida como true, se a imagem de pesquisa estava presente no início do período de espera. Esta saída será definida como false, se a imagem de pesquisa não estiver presente desde o início. |
|
Imagem de pesquisa ainda presente após espera
|
SearchImageStillPresentAfterWait | boolean |
Esta saída será definida como true, se a imagem de pesquisa ainda estiver presente, após o período de espera. Esta saída será definida como false, se a imagem de pesquisa não estiver mais presente, durante o período de espera (a ação é concluída imediatamente quando a imagem não estiver mais presente). |
|
Qual imagem de pesquisa ainda presente
|
WhichSearchImageStillPresent | integer |
Esta saída será definida como 0, se nenhuma imagem de pesquisa ainda estiver presente, após o período de espera. Defina como 1, se a imagem de pesquisa ainda estiver presente, após o período de espera. Defina como 2, se a imagem de pesquisa alternativa ainda estiver presente, após o período de espera. |
|
Thread Id
|
ThreadId | integer |
Se você tiver definido 'Wait for thread' como false (o que faz com que o Agente execute a espera em um thread em segundo plano), essa saída manterá o ID do thread do Agente, que pode ser usado para monitorar o processo da ação e recuperar os resultados mais tarde, quando o thread for concluído. |
Aguarde até que o elemento da área de trabalho UIA não exista
Aguarda que um elemento da área de trabalho (normalmente uma janela) não exista mais.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0). |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para aguardar que o elemento não exista. |
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado. |
|
|
Levantar exceção se o elemento ainda existir
|
RaiseExceptionIfElementStillExists | boolean |
Deve IA-Connect gerar uma exceção se o elemento UIA ainda existir após o período de espera? |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe antes de esperar
|
ElementExistsBeforeWait | boolean |
Retorna true se o elemento existia antes de esperar ou false se não. |
|
O elemento existe após a espera
|
ElementExistsAfterWait | boolean |
Retorna true se o elemento existiu após a espera ou false se não. |
Aguarde até que o elemento UIA não exista
Espera que um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto) deixe de existir.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0). |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para aguardar que o elemento não exista. |
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado. |
|
|
Levantar exceção se o elemento ainda existir
|
RaiseExceptionIfElementStillExists | boolean |
Deve IA-Connect gerar uma exceção se o elemento UIA ainda existir após o período de espera? |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe antes de esperar
|
ElementExistsBeforeWait | boolean |
Retorna true se o elemento existia antes de esperar ou false se não. |
|
O elemento existe após a espera
|
ElementExistsAfterWait | boolean |
Retorna true se o elemento existiu após a espera ou false se não. |
Aguarde o elemento da área de trabalho UIA
Aguarda a existência de um elemento da área de trabalho (normalmente uma janela).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0). |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para aguardar a existência do elemento. |
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado. |
|
|
Levantar exceção se o elemento não for encontrado
|
RaiseExceptionIfElementNotFound | boolean |
Deve IA-Connect gerar uma exceção se o elemento UIA não existir após o período de espera? |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe
|
ElementExists | boolean |
Retorna true se o elemento existir ou false se não. |
|
Alça do elemento
|
ElementHandle | integer |
O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
Aguarde o elemento UIA
Aguarda a existência de um elemento (normalmente um elemento individual dentro de uma janela, como um botão ou uma área de entrada de texto).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0). |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Segundos de espera
|
SecondsToWait | True | integer |
O número máximo de segundos para aguardar a existência do elemento. |
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado. |
|
|
Levantar exceção se o elemento não for encontrado
|
RaiseExceptionIfElementNotFound | boolean |
Deve IA-Connect gerar uma exceção se o elemento UIA não existir após o período de espera? |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe
|
ElementExists | boolean |
Retorna true se o elemento existir ou false se não. |
|
Alça do elemento
|
ElementHandle | integer |
O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
Alternar elemento UIA
Alterna um elemento (normalmente uma caixa de seleção ou uma caixa de rádio). Isto dá ao elemento o estado oposto ao seu estado atual (por exemplo, verificado torna-se desmarcado e vice-versa). Se você quiser definir um estado específico, use a ação 'Verificar elemento'.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Clique com o botão direito do rato global no elemento UIA
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão direito do mouse.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Elemento de foco primeiro
|
FocusElementFirst | boolean |
Deve IA-Connect tentar focar o elemento antes de clicar globalmente? |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Clique em deslocamento X
|
ClickOffsetX | integer |
O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda). |
|
|
Clique em deslocamento Y
|
ClickOffsetY | integer |
O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima). |
|
|
Deslocamento em relação a
|
OffsetRelativeTo | string |
A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Clique com o botão esquerdo do mouse global no elemento UIA
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica no botão esquerdo do mouse.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Elemento de foco primeiro
|
FocusElementFirst | boolean |
Deve IA-Connect tentar focar o elemento antes de clicar globalmente? |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Clique em deslocamento X
|
ClickOffsetX | integer |
O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda). |
|
|
Clique em deslocamento Y
|
ClickOffsetY | integer |
O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima). |
|
|
Deslocamento em relação a
|
OffsetRelativeTo | string |
A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Clique em UIA item de elemento de lista por nome
Clica no elemento list com o nome especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Expandir primeiro
|
ExpandFirst | boolean |
Se definido como true, IA-Connect tentará expandir a lista antes de procurar os elementos do item de lista. Isso é útil para listas dinâmicas, pois os elementos do item de lista podem não ser criados até que a lista seja expandida. |
|
|
Fechar após
|
CollapseAfter | boolean |
Se definido como true, a lista será recolhida após a execução da pesquisa. |
|
|
Nome do item
|
ItemName | string |
O nome do item de elemento a ser clicado. |
|
|
Segundos entre expandir e recolher
|
SecondsBetweenExpandCollapse | double |
O número de segundos a aguardar entre as ações de expansão e recolhimento, se estas estiverem definidas como true. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Clique em UIA item de elemento de lista por índice
Clique no elemento de lista que corresponde ao índice especificado. Isso geralmente é usado para selecionar um item em um item suspenso / menu.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Expandir primeiro
|
ExpandFirst | boolean |
Se definido como true, IA-Connect tentará expandir a lista antes de procurar os elementos do item de lista. Isso é útil para listas dinâmicas, pois os elementos do item de lista podem não ser criados até que a lista seja expandida. |
|
|
Fechar após
|
CollapseAfter | boolean |
Se definido como true, a lista será recolhida após a execução da pesquisa. |
|
|
Índice de itens
|
ItemIndex | integer |
O índice na lista do item a ser clicado. |
|
|
Segundos entre expandir e recolher
|
SecondsBetweenExpandCollapse | double |
O número de segundos a aguardar entre as ações de expansão e recolhimento, se estas estiverem definidas como true. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Clique global do mouse na região de cores de pesquisa do elemento UIA
Move o mouse sobre uma região de pixels dentro de um elemento UIA que atende aos critérios de cor especificados e executa um clique do mouse. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Cor da pesquisa
|
SearchColour | True | string |
Pesquise cores no formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB em que cada canal de cor é um byte em formato hexadecimal (00 está totalmente desligado, FF está totalmente ligado). Por exemplo: #FF0000 para vermelho, #00FF00 para azul, #000000 para preto #FFFFFF para branco. |
|
Desvio máximo de cor
|
MaxColourDeviation | True | integer |
O máximo que uma cor de elemento pode desviar da cor de pesquisa antes de não ser considerada uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Um desvio de 15 seria um bom ponto de partida. |
|
Deslocamento X do pixel esquerdo
|
LeftPixelXOffset | integer |
Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento X do pixel direito
|
RightPixelXOffset | integer |
Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Deslocamento Y de pixel superior
|
TopPixelYOffset | integer |
Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento Y do pixel inferior
|
BottomPixelYOffset | integer |
Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Botão do rato
|
MouseButton | string |
O botão do mouse para pressionar (Esquerda, Direita, Meio, Duplo esquerdo). |
|
|
Clique em deslocamento X
|
ClickOffsetX | integer |
O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda). |
|
|
Clique em deslocamento Y
|
ClickOffsetY | integer |
O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima). |
|
|
Deslocamento em relação a
|
OffsetRelativeTo | string |
A posição relativa da região de cor a ser deslocada (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito). |
|
|
Atraso em milissegundos
|
DelayInMilliseconds | integer |
Se estiver a realizar um duplo clique, o atraso (em milissegundos) entre cada um dos cliques. |
|
|
Ocultar agente
|
HideAgent | boolean |
Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
O resultado do comando (sucesso ou falha). |
|
Mensagem de erro
|
ErrorMessage | string |
Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada. |
Clique no meio global do mouse no elemento UIA
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, relativo a um elemento UIA e clica no botão do meio do mouse.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Elemento de foco primeiro
|
FocusElementFirst | boolean |
Deve IA-Connect tentar focar o elemento antes de clicar globalmente? |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Clique em deslocamento X
|
ClickOffsetX | integer |
O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda). |
|
|
Clique em deslocamento Y
|
ClickOffsetY | integer |
O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima). |
|
|
Deslocamento em relação a
|
OffsetRelativeTo | string |
A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir a janela UIA como normal
Normaliza a janela com a alça UIA especificada (ou seja, define-a para uma janela de tamanho normal em vez de minimizada ou maximizada).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela
|
WindowHandle | True | integer |
O identificador UIA para a janela a ser normalizada. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir a porcentagem de rolagem do elemento UIA
Defina a porcentagem de rolagem horizontal e/ou vertical do elemento especificado, se a rolagem for suportada por esse elemento. Se o elemento suportar o padrão 'scroll', você poderá aplicar essa ação diretamente ao elemento e especificar uma quantidade de rolagem horizontal ou vertical (ou ambas). Se o elemento não suportar o padrão 'scroll', essa ação retornará aos padrões 'range value' ou 'value', mas você precisará aplicá-los diretamente ao(s) controle(s) da barra de rolagem, não ao elemento em si.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Porcentagem de rolagem horizontal
|
HorizontalScrollPercentage | double |
A posição para rolar horizontalmente o elemento (0 a 100 inclusive, decimais suportados) ou -1 deixar a posição de rolagem horizontal inalterada. |
|
|
Porcentagem de rolagem vertical
|
VerticalScrollPercentage | double |
A posição para rolar verticalmente o elemento (0 a 100 inclusive, decimais suportados) ou -1 deixar a posição de rolagem vertical inalterada. |
|
|
Experimente o padrão de rolagem
|
TryScrollPattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão de rolagem UIA para executar a ação de rolagem. Se o padrão de rolagem UIA não estiver disponível no elemento escolhido, o Agente IA-Connect voltará para outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de rolagem e voltará imediatamente para outros padrões escolhidos. A ordem dos padrões tentados (se ativados através de entradas para esta ação) são scroll, range value e value. |
|
|
Experimente o padrão de valores do intervalo
|
TryRangeValuePattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão de valor de intervalo UIA para executar a ação de rolagem. Se o padrão de valor do intervalo UIA não estiver disponível no elemento escolhido, o IA-Connect Agent retornará a outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor de intervalo e voltará imediatamente para outros padrões escolhidos. A ordem dos padrões tentados (se ativados através de entradas para esta ação) são scroll, range value e value. |
|
|
Tente o padrão de valor
|
TryValuePattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão de valor da UIA para executar a ação de rolagem. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o IA-Connect Agent retornará a outros padrões escolhidos (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos. A ordem dos padrões tentados (se ativados através de entradas para esta ação) são scroll, range value e value. Aviso: Usar um padrão de valor em um elemento edit simplesmente inserirá o valor no elemento edit. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
UIASetElementScrollPercentageResult | boolean |
O resultado do comando (sucesso ou falha). |
|
Mensagem de erro
|
ErrorMessage | string |
Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada. |
Definir janela UIA de primeiro plano
Traz uma janela para o primeiro plano.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela
|
WindowHandle | True | integer |
O identificador UIA para a janela, que deve ser definido como a janela de primeiro plano. |
|
Janela de alternância
|
ToggleWindow | boolean |
A janela deve ser alternada tentando focar ou clicar nela? Isso ajuda a garantir que a janela seja trazida de forma confiável para o primeiro plano. |
|
|
A alternância usa o agente global de clique esquerdo do mouse
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
Se optar por alternar a janela, isso especifica se os cliques globais do mouse devem ser usados para focar o IA-Connect Agent primeiro. |
|
|
Alternar atraso em segundos
|
ToggleDelay | double |
Se optar por alternar a janela, isso especifica a pausa após a alternância. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir o elemento UIA como valor de intervalo numérico
Define o valor do elemento que tem um intervalo numérico, por exemplo, uma barra de rolagem.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Novo valor
|
NewValue | True | double |
O valor do intervalo numérico para definir o elemento. |
|
Novo valor é percentagem
|
NewValueIsPercentage | boolean |
O novo valor é uma percentagem? |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir o elemento UIA como valor numérico
Define o valor do elemento que tem uma entrada numérica, por exemplo, um campo de texto ou uma barra de rolagem.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Novo valor
|
NewValue | True | integer |
O valor numérico para definir o elemento. |
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Gerar exceção se a validação de entrada falhar
|
RaiseExceptionIfInputValidationFails | boolean |
Se habilitado, o IA-Connect Agent verificará o novo valor do elemento depois de inserir o texto solicitado. Se o novo valor não corresponder ao valor esperado, uma exceção será gerada. Se essa entrada for falsa (o padrão), um aviso será inserido no log, mas nenhuma exceção será gerada. |
|
|
Tente o padrão de valor
|
TryValuePattern | boolean |
Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos. |
|
|
Experimente o padrão herdado
|
TryLegacyPattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado). |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Definir o modo de pesquisa do elemento UIA
Escolha qual modo de pesquisa de elemento UIA deve ser usado pelo IA-Connect Agent ao executar ações UIA. Normalmente, essa ação só seria usada se você estiver tendo um problema com o modo padrão (Localizar tudo).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Modo de pesquisa de elemento UIA
|
UIAElementSearchMode | True | string |
O modo de pesquisa do elemento UIA a ser usado. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
SetUIAElementSearchModeResult | boolean |
O resultado do comando (sucesso ou falha). |
|
Mensagem de erro
|
ErrorMessage | string |
Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada. |
Definir o tempo limite da transação UIA
Controla quanto tempo a API UIA aguardará para que um aplicativo retorne as informações sobre um elemento. Esse tempo limite de transação normalmente só seria atingido se o aplicativo não respondesse.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tempo limite em segundos
|
TimeoutInSeconds | True | double |
O período máximo de tempo que a API UIA aguardará até que um aplicativo retorne as informações sobre um elemento. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Desenhar retângulo em torno do elemento UIA
Desenha um retângulo em torno do perímetro de um elemento para ajudar a identificar que o elemento encontrado é o necessário. O retângulo é removido automaticamente após 5 segundos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Cor da caneta
|
PenColour | string |
A cor do retângulo a desenhar (por exemplo, vermelho, verde, azul, amarelo, roxo ou laranja) ou um código hexadecimal de cordas, por exemplo, #FF0000. |
|
|
Pixels de espessura da caneta
|
PenThicknessPixels | integer |
A espessura (em pixels) da borda do retângulo de realce. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Elemento UIA de foco
Foca um elemento que o torna o elemento ativo para o foco do teclado e, dependendo do aplicativo, pode trazer a janela do elemento para o primeiro plano.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Existe uma janela Win32 de nível superior
Uma ação rápida do Win32 que informa se existe uma janela Win32 de nível superior. Uma janela de nível superior é aquela que está conectada à área de trabalho. Você pode pesquisar por nome de classe ou título da janela, ou pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar nome da classe
|
SearchClassName | string |
O nome da classe do elemento da janela de nível superior para pesquisar, por exemplo, 'Bloco de Notas'. |
|
|
Título da janela de pesquisa
|
SearchWindowTitle | string |
O título da janela de nível superior para pesquisar. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
A ID do processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais em relação às propriedades de janela disponíveis. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
A janela existe
|
WindowExists | boolean |
Retorna true se a janela existir ou false se não. |
Expandir elemento UIA
Expande um elemento (normalmente um item de menu/menu suspenso). Se o item já estiver expandido, nada acontecerá.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Faça uma captura de tela do local do elemento UIA
Tira uma captura de tela do local de um elemento e retorna uma imagem. O elemento deve ser trazido para a frente primeiro, pois a captura de tela está tirando uma cópia da tela no local dos elementos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Formato de imagem
|
ImageFormat | string |
O formato de imagem a ser usado para a captura de tela. Isso pode afetar a qualidade e o tamanho dos dados que estão sendo retornados. Os formatos suportados são PNG (o padrão), JPG, BMP e GIF. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Ocultar agente
|
HideAgent | boolean |
Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça a captura de tela. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Imagem da tela como Base64
|
ScreenBitmapBase64 | string |
A imagem da tela como uma cadeia de caracteres codificada em Base64. |
Fechar janela de elemento UIA
Fecha a janela do elemento. Normalmente, só funciona em janelas ou caixas de diálogo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Global duplo clique esquerdo do mouse no elemento UIA
Move o mouse para o centro, ou uma borda, canto ou deslocamento escolhido, em relação a um elemento UIA e clica duas vezes no botão esquerdo do mouse.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Atraso em milissegundos
|
DelayInMilliseconds | integer |
O atraso (em milissegundos) entre cada um dos cliques. |
|
|
Elemento de foco primeiro
|
FocusElementFirst | boolean |
Deve IA-Connect tentar focar o elemento antes de clicar globalmente? |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Clique em deslocamento X
|
ClickOffsetX | integer |
O número de X pixels para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (direita) e negativos (esquerda). |
|
|
Clique em deslocamento Y
|
ClickOffsetY | integer |
O número de pixels Y para compensar a ação de clique. Este parâmetro suporta valores de deslocamento positivos (para baixo) e negativos (para cima). |
|
|
Deslocamento em relação a
|
OffsetRelativeTo | string |
A posição relativa do elemento a ser deslocado (Centro / Centro / Meio, Esquerda, Direita, Superior, Inferior, Superior Esquerdo, Superior Direito, Inferior Esquerdo, Inferior Direito). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Inserir senha no elemento UIA
Ação UIA que insere uma senha em um elemento (normalmente um campo de entrada de senha), substituindo o texto existente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Palavra-passe para introdução
|
PasswordToInput | True | password |
O valor da senha a ser inserida. |
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
A palavra-passe contém a palavra-passe armazenada
|
PasswordContainsStoredPassword | boolean |
Defina como true se a senha contiver (ou for inteiramente) um identificador de senha armazenado em IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica do IA-Connect Orchestrator, no formato {OrchestratorCredential:FriendlyName}. Essa senha armazenada pode ter sido gerada pela ação 'Gerar senha', por exemplo, ou ser mantida pelo IA-Connect Orchestrator. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tente o padrão de valor
|
TryValuePattern | boolean |
Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos. |
|
|
Experimente o padrão herdado
|
TryLegacyPattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado). |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Inserir texto em vários elementos da interface do usuário
UIA Action que insere diferentes partes de texto em vários elementos (normalmente campos de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Elementos de entrada
|
InputElementsJSON | True | string |
Uma matriz de elementos UIA para inserir texto, no formato JSON. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Inserir texto no elemento UIA
Ação UIA que insere texto em um elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o novo valor em uma posição específica.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Texto a introduzir
|
TextToInput | string |
O valor de texto a ser inserido. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Substituir valor existente
|
ReplaceExistingValue | boolean |
Se houver texto existente no elemento , ele deve ser substituído? |
|
|
Inserir posição
|
InsertPosition | integer |
A posição (índice) para começar a inserir texto. Se houver texto existente, a posição de inserção pode ser usada para inserir em uma posição específica dentro do texto existente. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Gerar exceção se a validação de entrada falhar
|
RaiseExceptionIfInputValidationFails | boolean |
Se habilitado, o IA-Connect Agent verificará o novo valor do elemento depois de inserir o texto solicitado. Se o novo valor não corresponder ao valor esperado, uma exceção será gerada. Se essa entrada for falsa (o padrão), um aviso será inserido no log, mas nenhuma exceção será gerada. |
|
|
Tente o padrão de valor
|
TryValuePattern | boolean |
Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos. |
|
|
Experimente o padrão herdado
|
TryLegacyPattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado). |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Localizar imagem de pesquisa visível dentro do elemento UIA
Retorna se uma imagem de pesquisa, fornecida como entrada para essa ação, foi visivelmente localizada em um elemento da interface do usuário na tela. O elemento deve ser trazido para a frente primeiro, porque o Agente faz uma captura de tela nas coordenadas do elemento e procura a imagem de pesquisa fornecida dentro da captura de tela.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipo de imagem de pesquisa
|
SearchImageType | string |
Define o que a entrada 'Pesquisar imagem' representa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem. |
|
|
Pesquisar imagem
|
SearchImage | string |
A imagem de pesquisa a ser localizada dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. |
|
|
Tipo de imagem de pesquisa alternativa
|
AltSearchImageType | string |
Define o que a entrada 'Imagem de pesquisa alternativa' representa. Se definido como 'Nenhum' ou em branco, não há nenhuma imagem de pesquisa alternativa. Se definida como 'Arquivo de imagem do Diretor', a imagem de pesquisa é um caminho para um arquivo acessível ao Diretor. Se definido como 'Arquivo de imagem do agente', a imagem de pesquisa é um caminho para um arquivo acessível ao agente. Se definido como 'Base64', a imagem de pesquisa é uma representação base64 da imagem. |
|
|
Imagem de pesquisa alternativa
|
AltSearchImage | string |
Uma imagem de pesquisa alternativa opcional para localizar dentro do elemento UIA especificado. Dependendo do 'Tipo de imagem de pesquisa alternativa' especificado, isso pode conter o caminho para um arquivo de imagem (na extremidade do Diretor ou Agente) ou conter a base64 (representação de texto) da imagem a ser pesquisada. Se você especificar uma imagem de pesquisa alternativa, o Agente procurará a imagem de pesquisa ou alternativa e relatará qual delas foi localizada. |
|
|
Desvio máximo de cor
|
MaxColourDeviation | integer |
O máximo de cores de pixel de um elemento pode se desviar das cores de pixel da imagem de pesquisa antes que ele não seja considerado uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Isto permite que pequenas diferenças de coloração sejam ignoradas. |
|
|
Diferenças máximas de pixels
|
MaxPixelDifferences | integer |
O número máximo de píxeis que pode diferir (acima do desvio máximo de cor) em toda a imagem pesquisada, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definido para um valor acima de 0, você também deve definir 'Máximo de diferenças de pixels consecutivos'. |
|
|
Máximo de diferenças consecutivas de pixels
|
MaxConsecutivePixelDifferences | integer |
O número máximo de pixels consecutivos que podem diferir (acima do desvio máximo de cor), em qualquer linha, antes de uma imagem ser considerada como não correspondendo. Isso permite que pequenas diferenças entre imagens sejam ignoradas, mas valores mais altos podem aumentar o tempo necessário para localizar uma imagem. Recomenda-se definir como 0 e aumentar em pequenas quantidades, se necessário. Se estiver definindo para um valor acima de 0, você também deve definir 'Diferenças máximas de pixels'. |
|
|
Deslocamento X do pixel esquerdo
|
LeftPixelXOffset | integer |
Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento X do pixel direito
|
RightPixelXOffset | integer |
Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Deslocamento Y de pixel superior
|
TopPixelYOffset | integer |
Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento Y do pixel inferior
|
BottomPixelYOffset | integer |
Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Unidade de deslocamentos do Pixel X
|
PixelXOffsetsUnit | string |
Defina como 'Pixel' (o padrão) se os deslocamentos de pixel X esquerdo e direito forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos de pixel X esquerdo e direito forem medidos como uma porcentagem da largura do elemento. |
|
|
Unidade de deslocamentos Pixel Y
|
PixelYOffsetsUnit | string |
Defina como 'Pixel' (o padrão) se os deslocamentos de pixel Y superior e inferior forem medidos em pixels. Defina como 'Porcentagem' se os deslocamentos Y de pixel superior e inferior forem medidos como uma porcentagem da altura do elemento. |
|
|
Índice de imagens de pesquisa
|
SearchImageIndex | integer |
Defina como 1 para localizar a primeira instância da imagem de pesquisa (na direção da pesquisa) dentro do elemento UIA. Definido como 2 para a segunda instância, .... , N para a nona instância. Se você também estiver procurando por uma imagem alternativa, o elemento UIA será digitalizado primeiro para a imagem de pesquisa e, em segundo lugar, para a imagem alternativa, procurando a instância solicitada dessa imagem específica (ou seja, o Agente está esperando uma ou outra, não uma mistura de ambas as imagens). |
|
|
Direção da pesquisa de imagens
|
ImageSearchDirection | string |
A direção da busca. 'Do topo' pesquisa por linha a partir do topo, digitalizando da esquerda para a direita dentro de cada linha. 'De baixo' pesquisa por linha a partir da parte inferior, digitalizando da esquerda para a direita dentro de cada linha. 'Da esquerda' pesquisa por coluna da esquerda, digitalizando de cima para baixo dentro de cada coluna. 'Da direita' pesquisa por coluna da direita, digitalizando de cima para baixo dentro de cada coluna. Isto pode ser usado em conjunto com 'Pesquisar índice de imagem' para localizar a Nona imagem a partir da parte superior, inferior, esquerda ou direita. Para melhorar o desempenho, selecione a direção de pesquisa que você acha que localizará sua imagem mais rapidamente. |
|
|
Ocultar agente
|
HideAgent | boolean |
Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado. |
|
|
Retornar coordenadas da tela como físicas
|
ReturnPhysicalCoordinates | boolean |
Defina como true para que as coordenadas da tela sejam retornadas como coordenadas físicas. Defina como false para que as coordenadas da tela sejam retornadas como coordenadas virtuais. Se o dimensionamento de exibição subjacente for de 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas do elemento são sempre retornadas como coordenadas virtuais. |
|
|
Mostrar retângulo de realce
|
ShowHighlightRectangle | boolean |
Se definido como true, o IA-Connect Agent destacará a imagem localizada na tela. Isso pode ser útil durante o desenvolvimento, para ajudar a visualizar que a imagem correta está sendo detetada. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Pesquisar imagem localizada
|
SearchImageLocated | boolean |
Defina como true, se a imagem de pesquisa foi localizada. Defina como false, se a imagem de pesquisa não foi localizada. |
|
Qual imagem de pesquisa localizada
|
WhichSearchImageLocated | integer |
Defina como 0, se nenhuma imagem de pesquisa for localizada. Defina como 1 se a imagem de pesquisa foi localizada. Defina como 2 se a imagem de pesquisa alternativa foi localizada. |
|
Elemento da caixa delimitadora de correspondência de imagem pixel esquerdo
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
A coordenada X virtual do pixel mais à esquerda correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Pixel direito do elemento da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
A coordenada X virtual do pixel mais à direita correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Pixel superior do elemento da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
A coordenada Y virtual do pixel mais alto correspondente à imagem especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Pixel inferior do elemento da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
A coordenada Y virtual do pixel mais inferior correspondente à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de imagem centro X pixel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
A coordenada X virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de imagem centro Y pixel
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
A coordenada Y virtual do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada, em relação ao elemento virtual superior esquerdo. |
|
Tela da caixa delimitadora de correspondência de imagem pixel esquerdo
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
A coordenada X do pixel da tela do pixel mais à esquerda correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Tela da caixa delimitadora de correspondência de imagem pixel direito
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
A coordenada X do pixel mais à direita correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel superior da tela da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
A coordenada Y do pixel da tela correspondente à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel inferior da tela da caixa delimitadora de correspondência de imagem
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
A coordenada Y do pixel da tela que corresponde à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Tela da caixa delimitadora de correspondência de imagem central X pixel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
A coordenada X do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Caixa delimitadora de correspondência de imagem tela central Y pixel
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
A coordenada Y do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à imagem especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
Maximizar a janela UIA
Maximiza a janela com a alça UIA especificada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela
|
WindowHandle | True | integer |
A alça UIA para a janela a ser maximizada. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Minimizar a janela UIA
Minimiza a janela com a alça UIA especificada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela
|
WindowHandle | True | integer |
A alça UIA para que a janela seja minimizada. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Mover elemento UIA
Move um elemento UIA para uma posição especificada na tela. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipo de movimento horizontal
|
HorizontalMovementType | string |
O tipo de movimento: Absoluto ou relativo. |
|
|
Posição horizontal
|
HorizontalPosition | True | integer |
A nova posição horizontal para o elemento. O tipo de movimento (por exemplo, absoluto ou relativo) é definido pela entrada «Tipo de movimento horizontal». Para deixar a posição horizontal inalterada, escolha um valor de 0 e defina 'Tipo de movimento horizontal' como 'Relativo'. |
|
Tipo de movimento vertical
|
VerticalMovementType | string |
O tipo de movimento: Absoluto ou relativo. |
|
|
Posição vertical
|
VerticalPosition | True | integer |
A nova posição vertical para o elemento. O tipo de movimento (por exemplo, absoluto ou relativo) é definido pela entrada «Tipo de movimento vertical». Para deixar a posição vertical inalterada, escolha um valor de 0 e defina 'Tipo de movimento vertical' como 'Relativo'. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
UIAMoveElementResult | boolean |
O resultado do comando (sucesso ou falha). |
|
Mensagem de erro
|
ErrorMessage | string |
Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada. |
O elemento da área de trabalho UIA existe
Relata se um elemento da área de trabalho existe e fornece algumas propriedades básicas do elemento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0). |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe
|
ElementExists | boolean |
Retorna true se o elemento existir ou false se não. |
|
Alça do elemento
|
ElementHandle | integer |
O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
O elemento UIA está verificado
Essa ação retorna true ou false indicando se um elemento (normalmente uma caixa de seleção ou caixa de rádio) está marcado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento está verificado
|
ElementIsChecked | boolean |
Retorna true se o elemento estiver verificado ou false se não. |
O elemento UIA existe
Informa se um elemento existe e retorna algumas propriedades básicas do elemento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
Se especificado (um valor de 1 ou superior), a pesquisa considerará apenas elementos pertencentes a um processo com este ID de Processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco (ou 0). |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será pesquisado. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O elemento existe
|
ElementExists | boolean |
Retorna true se o elemento existir ou false se não. |
|
Alça do elemento
|
ElementHandle | integer |
O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
O processo tem janela Win32
Uma ação Win32 simples e rápida que relata se um processo (especificado pelo nome) tem alguma janela visível. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do processo de pesquisa
|
SearchProcessName | True | string |
O nome do processo a pesquisar, por exemplo, bloco de notas. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Processo tem janela
|
ProcessHasWindow | boolean |
Retorna true se o processo tiver uma janela visível, ou false se não. |
Obter a região de cores de pesquisa do elemento UIA
Retorna os detalhes da região de pixels dentro de um elemento UIA que atendem aos critérios de cor especificados. O elemento deve ser trazido para a frente primeiro, porque o Agente localiza as cores fazendo uma captura de tela nas coordenadas do elemento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Cor da pesquisa
|
SearchColour | True | string |
Pesquise cores no formato 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB em que cada canal de cor é um byte em formato hexadecimal (00 está totalmente desligado, FF está totalmente ligado). Por exemplo: #FF0000 para vermelho, #00FF00 para azul, #000000 para preto #FFFFFF para branco. |
|
Desvio máximo de cor
|
MaxColourDeviation | True | integer |
O máximo que uma cor de elemento pode desviar da cor de pesquisa antes de não ser considerada uma correspondência. 0 para nenhum desvio. O desvio é medido em valores RGB. Por exemplo: #FF0000 é 4 diferente de #FE0102. Um desvio de 15 seria um bom ponto de partida. |
|
Deslocamento X do pixel esquerdo
|
LeftPixelXOffset | integer |
Um deslocamento X opcional para a borda esquerda da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento X do pixel direito
|
RightPixelXOffset | integer |
Um deslocamento X opcional para a borda direita da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Deslocamento Y de pixel superior
|
TopPixelYOffset | integer |
Um deslocamento Y opcional para a borda superior da área de pesquisa. Isto permite-lhe aumentar (com valores negativos) ou diminuir (com valores positivos) a área de pesquisa. |
|
|
Deslocamento Y do pixel inferior
|
BottomPixelYOffset | integer |
Um deslocamento Y opcional para a borda inferior da área de pesquisa. Isto permite-lhe aumentar (com valores positivos) ou diminuir (com valores negativos) a área de pesquisa. |
|
|
Ocultar agente
|
HideAgent | boolean |
Defina como true para ocultar automaticamente o Agente (se visível) para garantir que ele não obscureça o elemento que está sendo analisado. |
|
|
Retornar coordenadas da tela como físicas
|
ReturnPhysicalCoordinates | boolean |
Defina como true para que as coordenadas da tela sejam retornadas como coordenadas físicas. Defina como false para que as coordenadas da tela sejam retornadas como coordenadas virtuais. Se o dimensionamento de exibição subjacente for de 100%, as coordenadas físicas e virtuais serão as mesmas. As coordenadas do elemento são sempre retornadas como coordenadas virtuais. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de pixels correspondentes à cor
|
NumberOfPixelsMatchingColour | integer |
O número de pixels que correspondem à cor especificada. |
|
Elemento da caixa delimitadora de correspondência de cores pixel esquerdo
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
A coordenada X virtual do pixel mais à esquerda correspondente à cor especificada, em relação ao elemento virtual superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de cores pixel direito
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
A coordenada X virtual do pixel mais à direita correspondente à cor especificada, em relação ao elemento virtual superior esquerdo. |
|
Pixel superior do elemento da caixa delimitadora de correspondência de cores
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
A coordenada Y virtual do pixel mais alto correspondente à cor especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Pixel inferior do elemento da caixa delimitadora de correspondência de cores
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
A coordenada Y virtual do pixel mais inferior correspondente à cor especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de cor centro X pixel
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
A coordenada X virtual do centro da caixa delimitadora contendo pixels correspondentes à cor especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Elemento da caixa delimitadora de correspondência de cores central Y pixel
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
A coordenada Y virtual do centro da caixa delimitadora contendo pixels correspondentes à cor especificada, em relação ao elemento virtual no canto superior esquerdo. |
|
Tela da caixa delimitadora de correspondência de cores pixel esquerdo
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
A coordenada X do pixel da tela do pixel mais à esquerda que corresponde à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel direito do ecrã da caixa delimitadora de correspondência de cores
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
A coordenada X do pixel da tela correspondente à cor especificada no pixel mais à direita. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel superior da tela da caixa delimitadora de correspondência de cores
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
A coordenada Y do pixel mais alto do pixel correspondente à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Pixel inferior da tela da caixa delimitadora de correspondência de cores
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
A coordenada Y do pixel da parte inferior corresponde à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Caixa delimitadora de correspondência de cores, ecrã central, X pixel
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
A coordenada X do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
|
Caixa delimitadora de correspondência de cores, centro do pixel Y
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
A coordenada Y do pixel da tela do centro da caixa delimitadora contendo pixels correspondentes à cor especificada. Esta é uma coordenada física ou virtual, dependendo da entrada 'Retornar coordenadas físicas'. |
Obter conteúdo do elemento de grade de dados UIA
Retorna o conteúdo de um elemento datagrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela). Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Recuperar apenas colunas na tela
|
OnScreenColumnsOnly | boolean |
Se definido como true, apenas as colunas na tela serão retornadas. |
|
|
Recuperar apenas linhas na tela
|
OnScreenRowsOnly | boolean |
Se definido como true, apenas as linhas na tela serão retornadas. |
|
|
Retornar valores nulos como em branco
|
ReturnNullValuesAsBlank | boolean |
Se definido como true, os valores nulos serão retornados como '' (ou seja, em branco). Se definido como false, os valores nulos são normalmente retornados como '(null)'. |
|
|
Nome alternativo da linha de cabeçalho
|
AlternativeHeaderRowName | string |
Por padrão, a linha de cabeçalho em um DataGrid tem o nome do elemento UIA 'Linha Superior'. Se a linha de cabeçalho tiver um nome diferente, especifique esse nome aqui. |
|
|
Nome da UIA da linha de retorno
|
ReturnRowUIAName | boolean |
Se essa entrada estiver definida como , o nome da linha UIA será armazenado em uma coluna na coleção de saída. O nome da coluna é definido pela entrada 'Nome da coluna para armazenar o nome UIA da linha'. |
|
|
Nome da coluna para armazenar o nome da linha UIA
|
NameOfColumnToStoreRowUIAName | string |
Se a entrada 'Nome da UIA da linha de retorno' estiver definida como true, essa entrada especifica o nome da coluna na coleção de saída para manter o nome da UIA da linha. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Primeiro item a devolver
|
FirstItemToReturn | integer |
O índice do elemento do primeiro item (linha) a retornar, a partir de 1. |
|
|
Máximo de itens a devolver
|
MaxItemsToReturn | integer |
O número máximo de itens (linhas) a devolver ou 0 a devolver todos os itens (linhas). |
|
|
Verificar as primeiras N linhas em busca de linhas vazias
|
ScanFirstNRowsForEmptyRows | integer |
Algumas grades de dados têm alguns elementos de linha vazios/nulos na árvore UIA (geralmente na parte superior) e IA-Connect ignorarão automaticamente esses elementos de linha, pois eles não representam nada na tabela que é visível na interface do usuário. Se essa entrada for definida como 0 (o padrão), o Agente de IA-Connect sempre verificará os elementos da linha a partir da primeira linha, mesmo que 'Primeiro item a retornar' esteja definido para recuperar linhas mais profundas dentro da tabela. Isso garante a consistência com os números de índice de linha, mas afeta o desempenho, uma vez que todas as linhas, desde a primeira linha até a(s) linha(s) solicitada(s), precisam ser verificadas. Se você tiver certeza de que os únicos elementos de linha vazios / nulos na tabela estão dentro das primeiras linhas N (por exemplo, 10), você pode definir isso como N (por exemplo, 10) para potencialmente melhorar o desempenho. Não defina para um valor diferente de 0, a menos que saiba o que está a fazer. |
|
|
Ler tabela como thread
|
ReadTableAsThread | boolean |
Se definido como false (o padrão), o IA-Connect Agent lerá a tabela imediatamente e retornará o conteúdo ao Diretor. Se estiver lendo tabelas grandes, essa ação pode atingir o tempo limite. Se definido como true, o IA-Connect Agent lerá a tabela como um thread do Agent e o Diretor do IA-Connect (ou Orchestrator, módulo do PowerShell, Blue Prism) poderá monitorar o status desse thread do Agente, aguardando sua conclusão. Isso permite que tabelas grandes sejam lidas sem tempos limites. IA-Connect Agents 9.3 e versões anteriores só podiam ler tabelas imediatamente, não como um thread do Agente. |
|
|
Recuperar dados de saída para ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Se você executou anteriormente essa ação como um thread do Agente e definiu 'Segundos para aguardar o thread' como 0, forneça o ID do thread do Agente para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Defina como 0 (o padrão) se você estiver lendo uma grade de dados (e, portanto, não recuperando os resultados de uma consulta anterior executada como um thread do Agente). |
|
|
Segundos para esperar pelo thread
|
SecondsToWaitForThread | integer |
Se 'Ler tabela como thread' estiver definido como true, quantos segundos aguardar a conclusão do thread do Agente. Se o thread do Agente que lê a tabela não tiver sido concluído nesse período, uma exceção será gerada. Defina como 0 para ignorar a espera: o Agente continuará a ler a grade de dados, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados (o conteúdo da grade de dados) posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente essa ação 'Obter conteúdo do elemento de grade de dados UIA' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente. |
|
|
Rolar a grade de dados verticalmente a cada N por cento
|
ScrollDataGridVerticallyEveryNPercent | integer |
Observou-se que o desempenho da leitura de algumas grades de dados grandes (por exemplo: com milhares de linhas) melhora se você rolar periodicamente a grade de dados para (ou perto) do local que está sendo rolado. Se definido como 0 (o padrão), a grade de dados não será rolada durante a leitura do conteúdo. Se definido como um valor entre 1 e 100, a grade de dados será rolada periodicamente (cada N por cento do número total de linhas) durante a leitura do conteúdo. Por exemplo: Se definido como 20, a grade de dados será rolada em 0, 20, 40, 60, 80%. Como alternativa, use 'Rolar grade de dados verticalmente a cada N linhas' para rolar cada N linhas em vez de cada N por cento. |
|
|
Rolar a grade de dados verticalmente a cada N linhas
|
ScrollDataGridVerticallyEveryNRows | integer |
Observou-se que o desempenho da leitura de algumas grades de dados grandes (por exemplo: com milhares de linhas) melhora se você rolar periodicamente a grade de dados para (ou perto) do local que está sendo rolado. Se definido como 0 (o padrão), a grade de dados não será rolada durante a leitura do conteúdo. Se definido como um valor 1 ou superior, a grade de dados será rolada a cada N linhas durante a leitura do conteúdo. Por exemplo: Se definido como 5, a grade de dados será rolada a cada 5 linhas. Como alternativa, use 'Rolar grade de dados verticalmente a cada N por cento' para rolar cada N por cento das linhas em vez de cada N linhas. |
|
|
Rolar a grade de dados verticalmente identificador do elemento
|
ScrollDataGridVerticallyElementHandle | integer |
Se rolar a grade de dados verticalmente enquanto lê o conteúdo, essa entrada define como IA-Connect localizará a barra de rolagem vertical. Se definido como 0, IA-Connect tentará rolar a grade de dados diretamente, usando o padrão 'scroll' (se a grade de dados suportar) ou procurando pela barra de rolagem vertical contida na grade de dados. Como alternativa, você pode especificar o identificador UIA IA-Connect do elemento da barra de rolagem vertical (o elemento da barra de rolagem em si, não os botões dentro), que é um valor de 1 ou superior. |
|
|
Linhas mínimas da grade de dados para rolagem
|
MinimumDataGridRowsForScrolling | integer |
Se rolar a grade de dados verticalmente enquanto lê o conteúdo, essa entrada especifica o número mínimo de linhas necessárias na tabela antes que IA-Connect execute a rolagem. Se definido como 0, IA-Connect rolará independentemente do número de linhas. Se definido como um número positivo, IA-Connect só executará a rolagem quando a grade de dados tiver esse número de linhas ou mais. |
|
|
Aumentar exceção se não for possível rolar
|
RaiseExceptionIfCannotScroll | boolean |
Se rolar a grade de dados verticalmente durante a leitura do conteúdo: defina essa entrada como true se uma falha na rolagem for considerada uma exceção, ou defina como false (o padrão) se uma falha na rolagem for ignorada. Falhas comuns na rolagem incluem falha na localização das barras de rolagem ou as barras de rolagem não têm um padrão UIA adequado para rolagem ('scroll', 'rangevalue' ou 'value'). |
|
|
Nome alternativo da barra de rolagem vertical
|
AlternativeVerticalScrollbarName | string |
Por padrão, a barra de rolagem vertical 'linha' em uma grade de dados tem o nome do elemento UIA 'Barra de rolagem vertical'. Se a barra de rolagem vertical tiver um nome diferente, especifique esse nome aqui. Isso será usado se você quiser que IA-Connect role periodicamente a grade de dados enquanto lê o conteúdo, o campo de entrada 'Scroll datagrid vertically element handle' está definido como 0 (especificando que IA-Connect deve rolar a grade de dados diretamente), mas a grade de dados não implementa o padrão 'scroll'. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Conteúdo da grade de dados JSON
|
DataGridContentsJSON | string |
O conteúdo do elemento datagrid, no formato JSON. |
|
Número de linhas na tabela
|
NumberOfRowsInTable | integer |
O número de linhas na tabela de saída se a tabela foi lida imediatamente. |
|
Número de colunas na tabela
|
NumberOfColumnsInTable | integer |
O número de colunas na tabela de saída, se a tabela foi lida imediatamente. |
|
Thread Id
|
ThreadId | integer |
Se essa ação estiver sendo executada como um thread do agente, essa saída manterá o ID do thread do agente, que pode ser usado para monitorar o processo da ação e recuperar o conteúdo da grade de dados quando o thread for concluído. |
Obter elementos da área de trabalho UIA
Retorna uma lista de todas as janelas e caixas de diálogo na área de trabalho.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchElementLocalizedControlType | string |
Filtre os resultados pelo tipo de controle localizado do elemento. |
|
|
Id do processo de pesquisa
|
SearchProcessID | integer |
Se especificado, a pesquisa considerará apenas elementos pertencentes a um processo com esta ID de processo (PID). Se IA-Connect iniciado o processo, o PID é fornecido pela ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão. Se você não conhece o PID, deixe este campo em branco. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Primeiro item a devolver
|
FirstItemToReturn | integer |
O índice de elementos do primeiro item a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1. |
|
|
Máximo de itens a devolver
|
MaxItemsToReturn | integer |
O número máximo de elementos a devolver ou 0 a devolver todos os itens. |
|
|
Incluir processos filho
|
IncludeChildProcesses | boolean |
Se definido como true e um 'Search process Id' for especificado, os processos filho desse processo Id também serão incluídos na pesquisa. Se definido como falso, apenas um processo correspondente ao 'ID do processo de pesquisa' exato será retornado. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de elementos encontrados
|
NumberOfElementsFound | integer |
O número de elementos da área de trabalho encontrados que correspondem aos critérios de pesquisa. |
|
Número de elementos retornados
|
NumberOfElementsReturned | integer |
O número de elementos da área de trabalho retornados (isso pode ser menor do que o número de elementos encontrados se especificar um número máximo de itens a serem retornados). |
|
Propriedades do elemento
|
ElementProperties | array of object |
As propriedades dos elementos da área de trabalho encontrados que correspondem aos critérios de pesquisa. |
|
items
|
ElementProperties | object |
Obter identificador de elemento pai da UIA
Retorna um identificador para o elemento pai do elemento especificado. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça do elemento
|
ElementHandle | True | integer |
O identificador UIA para o elemento de destino. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificador do elemento pai
|
ParentElementHandle | integer |
Um identificador UIA para o elemento pai. |
Obter identificador UIA para a janela principal do elemento focalizado
Retorna um identificador para a janela principal do elemento UIA focado no momento. A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
Obter identificador UIA para a janela principal do ID do processo
Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pela ID do processo). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Id do processo de pesquisa
|
ProcessId | True | integer |
O ID do processo a aguardar (conforme fornecido pela ação 'Executar processo' nas ações Ambiente de IA-Connect / Sessão). |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
Obter identificador UIA para a janela principal do processo
Uma ação Win32 simples e rápida que retorna o identificador para qualquer janela principal de um processo (especificado pelo nome). A janela 'Principal' é normalmente a janela principal da aplicação: uma caixa de diálogo ou sub-janela de início de sessão geralmente não é a janela 'Principal'. A janela deve existir: IA-Connect não vai esperar. Recomenda-se usar a ação 'Esperar pelo elemento da área de trabalho', que é mais poderosa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do processo de pesquisa
|
SearchProcessName | True | string |
O nome do processo a pesquisar, por exemplo, bloco de notas. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
Obter identificador UIA para a janela Win32 de nível superior
Uma ação Win32 rápida que retorna um identificador UIA para qualquer janela Win32 de nível superior que tenha o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Uma janela de nível superior é aquela que está conectada à área de trabalho. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. A janela deve existir, IA-Connect não vou esperar. É mais comum usar a ação UIA 'O elemento da área de trabalho UIA existe', que é mais poderosa, mas essa ação do Win32 normalmente é executada mais rapidamente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar nome da classe
|
SearchClassName | string |
O nome da classe do elemento da janela de nível superior para pesquisar, por exemplo, 'Bloco de Notas'. |
|
|
Título da janela de pesquisa
|
SearchWindowTitle | string |
O título da janela de nível superior para pesquisar. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
A ID do processo opcional do processo que possui a janela (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais em relação às propriedades de janela disponíveis. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de janela classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher a janela necessária. Por exemplo: Se 'Ordenar por nome de coluna' for [TopEdge] e 'Índice de correspondência' for 1, a janela correspondente mais próxima da parte superior do ecrã será devolvida. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se várias janelas corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da UIA do elemento window. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento window. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento window. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento window. |
Obter identificador UIA para desktop
Retorna um identificador para a área de trabalho. Esta é uma ação obsoleta porque o identificador '-2' pode ser usado para se referir ao elemento desktop, mas também porque há muitas ações que podem pesquisar em relação à área de trabalho (por exemplo, 'esperar pelo elemento desktop').
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a área de trabalho. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento da área de trabalho. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento desktop. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da interface do usuário do elemento da área de trabalho. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado da interface do usuário do elemento da área de trabalho. |
Obter identificador UIA para elemento focalizado
Retorna um identificador para o elemento UIA focado no momento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Alça da janela
|
WindowHandle | integer |
O identificador UIA para a janela. Isso pode ser usado como uma entrada para outras ações da UIA dentro desta janela. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
Obter itens de elemento de lista UIA
Retorna uma lista de itens de elemento filho encontrados sob o elemento especificado (normalmente itens suspensos/de menu).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Expandir primeiro
|
ExpandFirst | boolean |
Se definido como true, IA-Connect tentará expandir a lista antes de procurar os elementos do item de lista. Isso é útil para listas dinâmicas, pois os elementos do item de lista podem não ser criados até que a lista seja expandida. |
|
|
Fechar após
|
CollapseAfter | boolean |
Se definido como true, a lista será recolhida após a execução da pesquisa. |
|
|
Verificar se há itens selecionados
|
CheckForSelectedItems | boolean |
Se definido como true, a coleção de saída conterá uma propriedade adicional indicando se o item de lista está selecionado no momento. |
|
|
Segundos entre expandir e recolher
|
SecondsBetweenExpandCollapse | double |
O número de segundos a aguardar entre as ações de expansão e recolhimento, se estas estiverem definidas como true. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de itens da lista
|
NumberOfListItems | integer |
O número de itens na lista. |
|
Listar itens JSON
|
ListItemsJSON | string |
As propriedades dos itens na lista, no formato JSON. |
|
Número de itens selecionados
|
NumberOfSelectedItems | integer |
O número de itens selecionados na lista. |
|
Índice do primeiro item selecionado
|
IndexOfFirstSelectedItem | integer |
O índice na lista do primeiro item selecionado. |
|
Nome do item selecionado
|
SelectedItemName | string |
O nome do item selecionado. |
Obter janelas Win32
Uma ação rápida do Win32 que retorna uma lista de todas as janelas do Win32 que opcionalmente têm o nome da classe especificado ou o título da janela, ou você pode especificar filtros de pesquisa mais avançados, incluindo curingas. Embora essa ação use APIs do Win32, ela pode detetar Windows, Java, ModernUI e janelas da Web. Win32 Windows pode incluir itens inesperados, incluindo a barra de tarefas, área de trabalho, menu Iniciar, sobreposições transparentes, fora da tela ou janelas ocultas, para que a lista retornada pode conter mais resultados do que o esperado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar nome da classe
|
SearchClassName | string |
O nome de classe opcional da janela de nível superior para pesquisar, por exemplo, 'Chrome_WidgetWin_1'. |
|
|
Título da janela de pesquisa
|
SearchWindowTitle | string |
O título opcional da janela de nível superior para pesquisar. |
|
|
Recuperar apenas janelas de nível superior
|
TopLevelWindowsOnly | boolean |
Defina como true para recuperar apenas as janelas do Win32 que o SO considera de nível superior. Defina como false para recuperar todas as janelas do Win32. Observe que a definição do Win32 de uma janela incluirá itens que você pode não reconhecer como uma janela e muitas caixas de diálogo e caixas de mensagem são marcadas como de nível superior, mesmo que sejam filhos de uma janela pai. |
|
|
Recuperar apenas janelas visíveis
|
VisibleWindowsOnly | boolean |
Defina como true para recuperar apenas as janelas do Win32 que o SO considera visíveis. Defina como false para recuperar janelas Win32 visíveis e não visíveis. Observe que as janelas fora da tela ou transparentes podem estar marcadas como visíveis, mas você não pode vê-las. |
|
|
Recuperar apenas janelas com uma barra de título
|
WindowsWithTitlebarOnly | boolean |
Defina como true para recuperar apenas janelas do Win32 com uma barra de título. Defina como false para recuperar janelas do Win32, independentemente de terem uma barra de título ou não. Observe que algumas janelas transparentes têm barras de título, mas você não pode vê-las. |
|
|
Recuperar apenas janelas com um título
|
WindowsWithTitleOnly | boolean |
Defina como true para recuperar apenas janelas do Win32 com um título (ou seja, uma barra de título contendo algum texto). Defina como false para recuperar janelas do Win32, independentemente de terem um título. Observe que a barra de título é a faixa na parte superior da janela, enquanto o título é o texto dentro dela. |
|
|
Ignorar janelas transparentes
|
IgnoreTransparentWindows | boolean |
Defina como true para recuperar apenas janelas do Win32 que não têm transparência. Defina como false para recuperar janelas do Win32, independentemente de terem transparência definida ou não. |
|
|
Id do processo de pesquisa
|
SearchProcessId | integer |
O ID do processo opcional do processo que possui as janelas (por exemplo, conforme fornecido pela saída da ação 'Executar processo' nas ações Ambiente de IA-Connect / Sessão). Defina como 0 para não pesquisar por ID do processo. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Título] como '*Excel' E [IsMinimised] = False E [IsResizeable] = True. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se várias janelas corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de janela classificar. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge], então a lista de janelas será devolvida ordenada pela aresta superior. Se este campo for deixado em branco, as janelas serão retornadas na ordem em que forem detetadas. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se várias janelas corresponderem à pesquisa e uma coluna de classificação for especificada, defina como true (padrão) para classificar em ordem crescente ou como false para classificar em sentido descendente. |
|
|
Retornar identificador de elemento UIA
|
ReturnElementHandle | boolean |
Se definido como true, um identificador UIA para cada janela Win32 localizada será retornado na coleção de saída (na coluna 'UIAHandle'). Esse identificador pode ser usado em outras ações para atuar como um identificador 'pai' em IA-Connect ações da UIA. |
|
|
Primeiro item a devolver
|
FirstItemToReturn | integer |
O índice da primeira janela (linha) a retornar, a partir de 1. |
|
|
Máximo de itens a devolver
|
MaxItemsToReturn | integer |
O número máximo de janelas a devolver ou 0 a devolver todos os itens. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Win32 windows JSON
|
Win32WindowsJSON | string |
Uma lista de janelas Win32 correspondentes aos critérios de pesquisa, no formato JSON. |
|
Número de janelas Win32
|
NumberOfWin32Windows | integer |
O número de janelas Win32 retornado. |
Obter o elemento UIA nas coordenadas da tela
Retorna o elemento UIA localizado nas coordenadas de tela fornecidas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Coordenada X
|
XCoord | integer |
O valor da coordenada X da tela (em pixels) onde o elemento UIA deve ser pesquisado. |
|
|
Coordenada Y
|
YCoord | integer |
O valor da coordenada Y da tela (em pixels) onde o elemento UIA deve ser pesquisado. |
|
|
Levantar exceção se o elemento não for encontrado
|
RaiseExceptionIfElementNotFound | boolean |
O IA-Connect deve gerar uma exceção se um elemento da interface do usuário não estiver localizado no local especificado? |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Elemento encontrado
|
ElementFound | boolean |
Retorna true se um elemento UIA foi encontrado no local especificado. |
|
Alça do elemento
|
ElementHandle | integer |
O identificador UIA para o elemento . Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento. |
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
Obter o modo de pesquisa de elementos UIA
Recupera qual modo de pesquisa de elemento UIA está sendo usado pelo IA-Connect Agent for UIA ações.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Modo de pesquisa de elemento UIA
|
UIAElementSearchMode | string |
O modo de pesquisa do elemento UIA atual usado pelo Agente IA-Connect. |
Obter padrões de elemento UIA
Recupere quais padrões de UIA estão disponíveis para um elemento UIA e, portanto, quais ações de UIA IA-Connect provavelmente terão um efeito sobre o elemento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Expandir padrão de recolhimento disponível
|
ExpandCollapsePatternAvailable | boolean |
O padrão de colapso de expansão da UIA está disponível e, portanto, as ações que expandem ou recolhem um elemento (por exemplo, um menu suspenso) provavelmente funcionarão. |
|
Invocar padrão disponível
|
InvokePatternAvailable | boolean |
O padrão de invocação UIA está disponível e, portanto, as ações que pressionam um elemento ou clicam em um item de elemento de lista provavelmente funcionarão. |
|
Padrão de valor do intervalo disponível
|
RangeValuePatternAvailable | boolean |
O padrão de valor do intervalo UIA está disponível e, portanto, as ações que rolam um elemento ou controle deslizante provavelmente funcionarão. |
|
Padrão de rolagem disponível
|
ScrollPatternAvailable | boolean |
O padrão de rolagem UIA está disponível e, portanto, as ações que rolam um elemento provavelmente funcionarão. |
|
Padrão de item de seleção disponível
|
SelectionItemPatternAvailable | boolean |
O padrão de item de seleção da UIA está disponível e, portanto, as ações que selecionam um elemento provavelmente funcionarão. |
|
Padrão de texto disponível
|
TextPatternAvailable | boolean |
O padrão de texto UIA está disponível e, portanto, as ações que leem um valor de texto de elemento provavelmente funcionarão. |
|
Padrão de alternância disponível
|
TogglePatternAvailable | boolean |
O padrão de alternância UIA está disponível e, portanto, as ações que verificam, desmarcam ou alternam um elemento provavelmente funcionarão. |
|
Padrão de valor disponível
|
ValuePatternAvailable | boolean |
O padrão de valor UIA está disponível e, portanto, as ações que inserem texto em um elemento ou ler um valor de elemento provavelmente funcionarão. As barras de rolagem também podem reagir a um padrão de valor. |
|
Padrão de janela disponível
|
WindowPatternAvailable | boolean |
O padrão de janela UIA está disponível e, portanto, ações que fecham, maximizam ou minimizam um elemento provavelmente funcionarão. |
|
Padrão de grade disponível
|
GridPatternAvailable | boolean |
O padrão de grade UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de item de grade disponível
|
GridItemPatternAvailable | boolean |
O padrão de item de grade da UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão IAccessible legado disponível
|
LegacyIAccessiblePatternAvailable | boolean |
O padrão IAccessible herdado da UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de seleção disponível
|
SelectionPatternAvailable | boolean |
O padrão de seleção UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de planilha disponível
|
SpreadsheetPatternAvailable | boolean |
O padrão de planilha UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de item de planilha disponível
|
SpreadsheetItemPatternAvailable | boolean |
O padrão de item de planilha UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de tabela disponível
|
TablePatternAvailable | boolean |
O padrão de tabela UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de item de tabela disponível
|
TableItemPatternAvailable | boolean |
O padrão de item de tabela UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de texto 2 disponível
|
TextPattern2Available | boolean |
O padrão de texto UIA 2 está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de edição de texto disponível
|
TextEditPatternAvailable | boolean |
O padrão de edição de texto UIA está disponível. Este padrão não é usado pelo IA-Connect. |
|
Padrão de transformação disponível
|
TransformPatternAvailable | boolean |
O padrão de transformação UIA está disponível. Este padrão não é usado pelo IA-Connect. |
Obter propriedades do elemento datagrid da UIA
Retorna propriedades de tabela de um elemento DataGrid. Este é um elemento com linhas, colunas, cabeçalho e células (ou seja, uma tabela).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Nome alternativo da linha de cabeçalho
|
AlternativeHeaderRowName | string |
Por padrão, a linha de cabeçalho em um DataGrid tem o nome da interface do usuário 'Linha Superior'. Se a linha de cabeçalho tiver um nome diferente, especifique esse nome aqui. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de colunas
|
NumberOfColumns | integer |
O número de colunas na grade de dados. |
|
Número de colunas visíveis
|
NumberOfVisibleColumns | integer |
O número de colunas visíveis na grade de dados. |
|
Número de linhas
|
NumberOfRows | integer |
O número de linhas na grade de dados. |
|
Número de linhas visíveis
|
NumberOfVisibleRows | integer |
O número de linhas visíveis na grade de dados. |
|
Primeira linha visível
|
FirstVisibleRow | integer |
O índice da primeira linha visível na grade de dados. |
|
Última linha visível
|
LastVisibleRow | integer |
O índice da última linha visível na grade de dados. |
|
Número de barras de rolagem
|
NumberOfScrollbars | integer |
O número de barras de rolagem que a grade de dados tem. |
|
Nomes da barra de rolagem
|
ScrollbarNames | string |
Uma lista separada por vírgulas dos nomes das barras de rolagem (por exemplo, Horizontal, Vertical). |
Obter propriedades do elemento UIA
Retorna todas as propriedades de um elemento. Isso pode ser útil se você não tiver certeza de qual campo contém os valores de propriedade necessários.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Valor do elemento de retorno
|
ReturnElementValue | boolean |
Se definido como true, o valor do elemento localizado será retornado. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome do elemento
|
ElementName | string |
O nome da interface do usuário do elemento. |
|
Nome da classe do elemento
|
ElementClassName | string |
O nome da classe UIA do elemento. |
|
Id de automação de elementos
|
ElementAutomationId | string |
A ID de automação da UIA do elemento. |
|
Id da estrutura do elemento
|
ElementFrameworkId | string |
A ID da estrutura UIA do elemento . |
|
Tipo de controle de elemento
|
ElementControlType | string |
O tipo de controle UIA como um número. Isso é semelhante ao tipo de controle localizado, mas não é específico do idioma. |
|
Tipo de controle localizado do elemento
|
ElementLocalizedControlType | string |
O tipo de controle localizado UIA do elemento. |
|
O elemento está ativado
|
ElementIsEnabled | boolean |
Retorna se o elemento habilitado ou não. |
|
O elemento está fora da tela
|
ElementIsOffscreen | boolean |
Retorna se o elemento está fora da tela ou não. |
|
O elemento é focalizável pelo teclado
|
ElementIsKeyboardFocusable | boolean |
Retorna se o elemento pode ser focado pelo teclado. |
|
Elemento tem foco do teclado
|
ElementHasKeyboardFocus | boolean |
Retorna se o elemento atualmente tem foco no teclado. |
|
O elemento é o campo de senha
|
ElementIsPasswordField | boolean |
Retorna se um elemento é um campo de entrada de senha. |
|
Tecla aceleradora do elemento
|
ElementAcceleratorKey | string |
Retorna a tecla de atalho que pode ser pressionada para ativar o elemento. |
|
Chave de acesso do elemento
|
ElementAccessKey | string |
Retorna a tecla de atalho que pode ser pressionada para ativar um elemento de menu. |
|
Borda esquerda do elemento
|
ElementLeftEdge | integer |
A distância em pixels entre a borda esquerda do elemento ou janela e a borda esquerda da tela. |
|
Borda direita do elemento
|
ElementRightEdge | integer |
A distância em pixels entre a borda direita do elemento ou janela e a borda esquerda da tela. |
|
Borda superior do elemento
|
ElementTopEdge | integer |
A distância em pixels entre a borda superior do elemento ou janela e a borda superior da tela. |
|
Borda inferior do elemento
|
ElementBottomEdge | integer |
A distância em pixels entre a borda inferior do elemento ou janela e a borda superior da tela. |
|
Elemento clicável ponto X
|
ElementClickablePointX | integer |
A coordenada X em pixels de um ponto central clicável no elemento relativo à borda esquerda da exibição, conforme retornado pelo aplicativo subjacente. |
|
Elemento clicável ponto Y
|
ElementClickablePointY | integer |
A coordenada Y em pixels de um ponto central clicável no elemento relativo à borda superior da exibição, conforme retornado pelo aplicativo subjacente. |
|
ID do processo do elemento
|
ElementProcessId | integer |
A ID do processo (PID) do processo que possui esse elemento. |
|
Alça do elemento
|
ElementHandle | integer |
Se a entrada 'Return element handle' foi definida como true, isso manterá um identificador de elemento numérico que pode ser usado em outras ações para atuar como um identificador 'pai' para ações futuras. |
|
Valor do elemento
|
ElementValue | string |
Se a entrada 'Valor do elemento de retorno' foi definida como true e se o elemento tem um padrão de valor, isso manterá esse valor. |
|
Valor do texto do elemento
|
ElementTextValue | string |
Se a entrada 'Valor do elemento de retorno' foi definida como true e se o elemento tiver um padrão de valor de texto, isso manterá esse valor de texto. |
Obter propriedades do elemento UIA como lista
Retorna as propriedades de um elemento como uma lista de linha única (coleção de linha única / tabela de dados) em vez de itens individuais, isso pode ser útil dependendo de como você pretende usar os dados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça do elemento
|
ElementHandle | True | integer |
O identificador UIA para o elemento de destino. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de elementos encontrados
|
NumberOfElementsFound | integer |
O número de elementos encontrados. |
|
Número de elementos retornados
|
NumberOfElementsReturned | integer |
O número de elementos retornados. |
|
Propriedades do elemento UIA JSON
|
UIAElementPropertiesJSON | string |
As propriedades UIA do elemento , no formato JSON. |
Obter valor de texto do elemento UIA
Retorna o valor de texto de um elemento. Um valor de texto geralmente é associado a um rótulo, mas muitos elementos podem ter essa propriedade.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor do texto do elemento
|
ElementTextValue | string |
O valor de texto do elemento. |
Obter valor do elemento UIA
Retorna o valor de um elemento. Um valor geralmente é associado a uma área de entrada de texto, mas muitos elementos podem ter essa propriedade.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor do elemento
|
ElementValue | string |
O valor do elemento. |
Obter valor do rótulo do elemento UIA
Retorna o valor do rótulo no elemento .
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor do rótulo do elemento
|
ElementLabelValue | string |
O valor do rótulo no elemento. |
Obter várias propriedades de elementos UIA
Retorna as propriedades de vários elementos. Isso pode ser útil se você não tiver certeza de quais campos contêm os valores de propriedade necessários.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Tipo de controle localizado do elemento de pesquisa
|
SearchElementLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar descendentes
|
SearchDescendants | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Alça do elemento de retorno
|
ReturnElementHandle | boolean |
Se definido como true, um identificador para o elemento localizado será retornado. Este identificador pode ser usado em outras ações para atuar como um identificador 'pai'. |
|
|
Valor do elemento de retorno
|
ReturnElementValue | boolean |
Se definido como true, o valor do elemento localizado será retornado. |
|
|
Primeiro item a devolver
|
FirstItemToReturn | integer |
O índice de elementos do primeiro item a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1. |
|
|
Máximo de itens a devolver
|
MaxItemsToReturn | integer |
O número máximo de elementos a devolver ou 0 a devolver todos os itens. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de elementos encontrados
|
NumberOfElementsFound | integer |
O número de elementos encontrados que correspondem aos critérios de pesquisa. |
|
Número de elementos retornados
|
NumberOfElementsReturned | integer |
O número de elementos retornados (isso pode ser menor do que o número de elementos encontrados se especificar um número máximo de itens a serem retornados). |
|
Propriedades do elemento
|
ElementProperties | array of object |
As propriedades dos elementos encontrados que correspondem aos critérios de pesquisa. |
|
items
|
ElementProperties | object |
Obter várias propriedades do elemento pai da UIA
Retorna uma árvore hierárquica de elementos pai do elemento especificado, até a área de trabalho (nível raiz). O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça do elemento
|
ElementHandle | True | integer |
O identificador UIA para o elemento de destino. |
|
Max pais para processar
|
MaxParentsToProcess | integer |
O número máximo de elementos pai a processar. Por padrão, isso é definido como 50. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Elementos pai da UIA
|
UIAParentElements | array of object |
Uma lista de todos os elementos pai localizados (e suas propriedades). As propriedades retornadas são as mesmas retornadas pela ação 'Obter propriedades de vários elementos'. |
|
items
|
UIAParentElements | object | |
|
Número de elementos pai retornados
|
NumberOfParentElementsReturned | integer |
O número de elementos pai retornados da pesquisa. |
Obter vários elementos da UIA como tabela
Enumera os valores dos elementos filho de um elemento pai especificado e retorna em um formato de tabela. Isso pode ser usado para retornar linhas e colunas de dados de elementos que não são tecnicamente tabelas, mas foram organizados juntos em uma estrutura de tabela. Essa ação também pode ser usada para recuperar os resultados de uma execução anterior dessa ação, executada como um thread do Agente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Tipo de controle localizado do subelemento do cabeçalho da célula de pesquisa
|
SearchCellHeaderSubElementLocalizedControlType | string |
O tipo de controle localizado do subelemento do cabeçalho da célula a ser pesquisado. Deixe em branco se não estiver procurando cabeçalhos de células. |
|
|
Tipo de controle do subelemento do cabeçalho da célula de pesquisa
|
SearchCellHeaderSubElementControlType | integer |
O tipo de controle de subelemento de cabeçalho de célula (um inteiro não localizado) a ser pesquisado. Este é o mesmo valor em diferentes idiomas. Deixe em 0 se não estiver procurando por cabeçalhos de célula. |
|
|
Tipo de controle localizado do subelemento da célula de pesquisa
|
SearchCellSubElementLocalizedControlType | string |
O tipo de controle localizado do subelemento da célula a ser pesquisado. |
|
|
Tipo de controle de subelemento de célula de pesquisa
|
SearchCellSubElementControlType | integer |
O tipo de controle de subelemento de célula (um inteiro não localizado) a ser pesquisado. Este é o mesmo valor em diferentes idiomas. |
|
|
Pesquisar descendentes para subelementos de célula
|
SearchDescendantsForCellSubElements | boolean |
Se definido como true, a árvore UIA abaixo do elemento localizado será pesquisada por subelementos de célula e cabeçalho de célula (ou seja, os valores de elemento que preencherão as células na tabela de saída). Isto é mais exaustivo, mas pode demorar mais tempo. Você pode querer definir isso como false se estiver interessado apenas em elementos diretamente abaixo do elemento. |
|
|
Primeiro subelemento de cabeçalho de célula a retornar
|
FirstCellHeaderSubElementToReturn | integer |
O índice do primeiro subelemento do cabeçalho da célula a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1. |
|
|
Máximo de subelementos de cabeçalho de célula para retornar
|
MaxCellHeaderSubElementsToReturn | integer |
O número máximo de subelementos de cabeçalho de célula a serem retornados ou 0 para retornar todos os subelementos. |
|
|
Primeiro subelemento de célula a retornar
|
FirstCellSubElementToReturn | integer |
O índice do primeiro subelemento de célula a retornar, a partir de 1. Se desejar retornar os elementos na ordem inversa (da parte inferior da árvore UIA), você pode, alternativamente, especificar um índice negativo a partir de -1. |
|
|
Máximo de subelementos de célula para retornar
|
MaxCellSubElementsToReturn | integer |
O número máximo de subelementos de célula a serem retornados ou 0 a retornar todos os subelementos. |
|
|
Número de colunas solicitado
|
RequestedNumberOfColumns | integer |
O número de colunas que você gostaria na tabela de saída. Esse valor deve estar correto para o elemento que está sendo lido, ou você receberá resultados inesperados. |
|
|
Prioridade do valor do subelemento de célula
|
CellSubElementValuePriority | integer |
A prioridade para usar o valor do subelemento da célula como o valor a ser usado na tabela de saída. 1 é a prioridade máxima. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 é não utilizar. |
|
|
Prioridade do valor do texto do subelemento da célula
|
CellSubElementTextValuePriority | integer |
A prioridade para usar o valor de texto do subelemento de célula como o valor a ser usado na tabela de saída. 1 é a prioridade máxima. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 é não utilizar. |
|
|
Prioridade do valor do nome do subelemento da célula
|
CellSubElementNameValuePriority | integer |
A prioridade para usar o nome do subelemento da célula (comum para rótulos) como o valor a ser usado na tabela de saída. 1 é a prioridade máxima. 2 é a segunda prioridade. 3 é a terceira prioridade. 0 é não utilizar. |
|
|
Largura mínima do subelemento da célula
|
MinimumCellSubElementWidth | integer |
A largura mínima em pixels de um subelemento de célula a ser incluído na tabela. |
|
|
Altura mínima do subelemento da célula
|
MinimumCellSubElementHeight | integer |
A altura mínima em pixels de um subelemento de célula a ser incluído na tabela. |
|
|
Caixa delimitadora do subelemento da célula de pesquisa à esquerda
|
SearchCellSubElementBoundingBoxLeft | integer |
Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos. |
|
|
Caixa delimitadora do subelemento da célula de pesquisa à direita
|
SearchCellSubElementBoundingBoxRight | integer |
Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos. |
|
|
Topo da caixa delimitadora do subelemento da célula de pesquisa
|
SearchCellSubElementBoundingBoxTop | integer |
Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos. |
|
|
Parte inferior da caixa delimitadora do subelemento da célula de pesquisa
|
SearchCellSubElementBoundingBoxBottom | integer |
Inclua apenas subelementos de célula que estejam totalmente contidos na caixa delimitadora. Por padrão, a caixa delimitadora é enorme para incluir todos os elementos. |
|
|
Ler tabela como thread
|
ReadTableAsThread | boolean |
Se definido como false (o padrão), o IA-Connect Agent lerá a tabela imediatamente e retornará o conteúdo ao Diretor. Se estiver lendo tabelas grandes, essa ação pode atingir o tempo limite. Se definido como true, o IA-Connect Agent lerá a tabela como um thread do Agent e o Diretor do IA-Connect (ou Orchestrator, módulo do PowerShell, Blue Prism) poderá monitorar o status desse thread do Agente, aguardando sua conclusão. Isso permite que tabelas grandes sejam lidas sem tempos limites. IA-Connect Agents 9.3 e versões anteriores só podiam ler tabelas imediatamente, não como um thread do Agente. |
|
|
Recuperar dados de saída para ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Se você executou anteriormente essa ação como um thread do Agente e definiu 'Segundos para aguardar o thread' como 0, forneça o ID do thread do Agente para recuperar os resultados. Este ID de thread do agente terá sido fornecido pela chamada anterior para esta ação. Defina como 0 (o padrão) se você estiver lendo uma tabela (e, portanto, não recuperando os resultados de uma consulta anterior executada como um thread do Agente). |
|
|
Segundos para esperar pelo thread
|
SecondsToWaitForThread | integer |
Se 'Ler tabela como thread' estiver definido como true, quantos segundos aguardar a conclusão do thread do Agente. Se o thread do Agente que lê a tabela não tiver sido concluído nesse período, uma exceção será gerada. Defina como 0 para ignorar a espera: o Agente continuará a ler a tabela, mas também estará disponível para a próxima ação. Em seguida, você pode recuperar os resultados (o conteúdo da tabela) posteriormente usando a ação 'Esperar que o thread do agente seja concluído com êxito' para aguardar a conclusão do thread do agente e, em seguida, executar novamente essa ação 'Obter vários elementos da interface do usuário como tabela' com a entrada 'Recuperar dados de saída para ID do thread' definida como a ID do thread do agente. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Número de subelementos de célula encontrados
|
NumberOfCellSubElementsFound | integer |
O número de subelementos de célula (não cabeçalhos) encontrados que correspondem aos critérios de pesquisa. |
|
Número de subelementos de célula retornados
|
NumberOfCellSubElementsReturned | integer |
O número de subelementos de célula (não cabeçalhos) retornados (isso pode ser menor do que o número de elementos encontrados se especificar um primeiro ou número máximo de itens a retornar). |
|
Conteúdo do índice JSON
|
TableContentsJSON | string |
A tabela criada a partir do conteúdo de vários elementos, no formato JSON. |
|
Número de linhas na tabela
|
NumberOfRowsInTable | integer |
O número de linhas na tabela de saída. |
|
Número de colunas na tabela
|
NumberOfColumnsInTable | integer |
O número de colunas na tabela de saída. |
|
Thread Id
|
ThreadId | integer |
Se essa ação estiver sendo executada como um thread do agente, essa saída manterá o ID do thread do agente, que pode ser usado para monitorar o processo da ação e recuperar o conteúdo da tabela quando o thread for concluído. |
Pesquisar o primeiro elemento pai da UIA
Pesquisa na hierarquia da árvore UIA o primeiro elemento pai que corresponde aos critérios de pesquisa. O elemento pai é definido como o elemento que está no próximo nível acima da 'árvore' UIA e é quase sempre um elemento de contenção.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça do elemento
|
ElementHandle | True | integer |
O identificador UIA para o elemento de destino. |
|
Tipo de controle localizado do elemento pai de pesquisa
|
SearchParentLocalizedControlType | string |
O tipo de controle localizado do elemento UIA pai a ser pesquisado. Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar tipo de controle de elemento pai
|
SearchParentControlType | integer |
O tipo de controle de elemento UIA pai (um inteiro não localizado) para pesquisar. Este é o mesmo valor em diferentes idiomas. |
|
|
Max pais para processar
|
MaxParentsToProcess | integer |
O número máximo de elementos pai a processar. Por padrão, isso é definido como 50. |
|
|
Aumentar exceção se o elemento pai não for encontrado
|
RaiseExceptionIfParentElementNotFound | boolean |
Deve IA-Connect gerar uma exceção se o elemento UIA de pesquisa não estiver localizado? |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Elemento pai encontrado
|
ParentElementFound | boolean |
Retorna true se o elemento UIA pai de pesquisa foi encontrado. |
|
Identificador do elemento pai
|
ParentElementHandle | integer |
O identificador UIA para o elemento pai localizado. Isso pode ser usado como uma entrada para outras ações da UIA que atuam sobre esse elemento. |
|
Nome do elemento pai
|
ParentElementName | string |
O nome da interface do usuário do elemento pai localizado. |
|
Nome da classe do elemento pai
|
ParentElementClassName | string |
O nome da classe UIA do elemento pai localizado. |
|
ID de automação do elemento pai
|
ParentElementAutomationId | string |
A ID de automação da UIA do elemento pai localizado. |
|
Tipo de controle localizado do elemento pai
|
ParentElementLocalizedControlType | string |
O tipo de controle localizado da UIA do elemento pai localizado. |
Pressione o elemento UIA
Pressiona um elemento (normalmente um botão).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Aguarde a conclusão do evento do botão
|
Wait | boolean |
Se a automação aguardar a conclusão do evento de botão antes de continuar. Se definido como true, isso pode causar um tempo limite se o botão abrir uma caixa de diálogo modal. |
|
|
Botão de clique do Win32
|
Win32ClickButton | boolean |
Se definido como true, um evento de clique do Win32 é usado em vez de usar UIA. Este é um evento de clique 'disparar e esquecer', que pode ser útil ao lidar com caixas de diálogo modais que são apresentadas após um clique ou elementos que não têm um padrão de invocação UIA. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tente invocar o padrão
|
TryInvokePattern | boolean |
Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de invocação UIA para executar a ação de pressionar (a menos que 'Win32 click button' esteja definido como true). Se o padrão de invocação UIA não estiver disponível no elemento escolhido, o Agente IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de invocação e voltará imediatamente para outros padrões escolhidos. |
|
|
Experimente o padrão herdado
|
TryLegacyPattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de pressionar se o padrão de chamada não estiver disponível (porque não está presente no elemento ou porque seu uso foi desativado) e se 'Win32 click button' for false. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Recolher elemento UIA
Recolhe um elemento (normalmente um item de menu / dropdown). Se o item já estiver recolhido, nada acontecerá.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Redefinir todos os identificadores de elementos UIA
Redefine todos os identificadores de elemento UIA atualmente armazenados por IA-Connect o que pode ser útil se você tiver identificado muitos elementos e tiver um grande número de identificadores de elemento armazenados. Em cenários com números extremamente altos de identificadores de elementos (100.000+), essa ação também pode ser usada para liberar o uso de RAM.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Redimensionar elemento UIA
Redimensiona um elemento UIA. Essa ação normalmente só funcionará com elementos Window (que têm o padrão de transformação).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Redimensionar o tipo de largura
|
ResizeWidthType | string |
O tipo de redimensionamento de largura: Absoluto ou relativo. |
|
|
Nova largura
|
NewWidth | True | integer |
A nova largura do elemento. O tipo de redimensionamento (por exemplo, absoluto ou relativo) é definido pela entrada 'Redimensionar tipo de largura'. Para deixar a largura inalterada, escolha um valor de 0 e defina 'Redimensionar tipo de largura' como 'Relativo'. |
|
Redimensionar tipo de altura
|
ResizeHeightType | string |
O tipo de redimensionamento de altura: Absoluto ou relativo. |
|
|
Nova altura
|
NewHeight | True | integer |
A nova altura do elemento. O tipo de redimensionamento (por exemplo, absoluto ou relativo) é definido pela entrada 'Redimensionar tipo de altura'. Para deixar a altura inalterada, escolha um valor de 0 e defina 'Redimensionar tipo de altura' como 'Relativo'. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado do comando
|
UIAResizeElementResult | boolean |
O resultado do comando (sucesso ou falha). |
|
Mensagem de erro
|
ErrorMessage | string |
Se o comando não foi bem-sucedido, ele conterá a mensagem de erro que foi retornada. |
Retorno de entrada no elemento UIA
Introduz um retorno do Windows/nova linha num elemento (normalmente um campo de entrada de texto), substituindo o texto existente ou inserindo o retorno numa posição específica.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Substituir valor existente
|
ReplaceExistingValue | boolean |
Se houver texto existente no elemento , ele deve ser substituído? |
|
|
Inserir posição
|
InsertPosition | integer |
A posição (índice) para começar a inserir texto. Se houver texto existente, a posição de inserção pode ser usada para inserir em uma posição específica dentro do texto existente. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Gerar exceção se a validação de entrada falhar
|
RaiseExceptionIfInputValidationFails | boolean |
Se habilitado, o IA-Connect Agent verificará o novo valor do elemento depois de inserir o texto solicitado. Se o novo valor não corresponder ao valor esperado, uma exceção será gerada. Se essa entrada for falsa (o padrão), um aviso será inserido no log, mas nenhuma exceção será gerada. |
|
|
Tente o padrão de valor
|
TryValuePattern | boolean |
Se definido como true (o padrão), o IA-Connect Agent tentará usar um padrão de valor UIA para executar a ação de entrada de texto. Se o padrão de valor da UIA não estiver disponível no elemento escolhido, o Agente de IA-Connect retornará a outros padrões (habilitados ou desabilitados por meio de outras entradas para esta ação). Se definido como false, o IA-Connect Agent não tentará usar um padrão de valor e voltará imediatamente para outros padrões escolhidos. |
|
|
Experimente o padrão herdado
|
TryLegacyPattern | boolean |
Se definido como true, o IA-Connect Agent tentará usar um padrão herdado da UIA para executar a ação de entrada de texto se o padrão de valor não estiver disponível (porque ele não está presente no elemento ou porque seu uso foi desabilitado). |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Selecionar elemento UIA
Seleciona um elemento (normalmente um item em uma lista ou lista suspensa).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Senha de entrada global no elemento UIA
Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de senha que não aceitará métodos de entrada nativos da UIA.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Elemento de foco primeiro
|
FocusElement | boolean |
Deve IA-Connect tentar focar o elemento antes de clicar globalmente? |
|
|
Clique com o botão esquerdo do rato global no elemento
|
GlobalMouseClickOnElement | boolean |
Deve ser realizado um clique global do rato nas coordenadas do elemento (para focar o elemento) antes de introduzir texto? |
|
|
Substitua o valor existente usando o duplo clique do mouse em excluir
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Qualquer valor existente deve ser substituído por clicar duas vezes no mouse (para realçá-lo) e, em seguida, excluir? |
|
|
Substitua o valor existente usando CTRL-A excluir
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Qualquer valor existente deve ser substituído pressionando Ctrl-A (para realçar tudo) e, em seguida, excluindo? Alguns elementos podem não suportar realce com Ctrl-A caso em que a opção alternativa de 'Substituir valor existente usando exclusão de clique duplo do mouse' deve ser tentada. |
|
|
Palavra-passe para introdução
|
PasswordToInput | True | password |
O valor da senha para entrada global usando o teclado. |
|
Usar enviar eventos-chave
|
SendKeyEvents | boolean |
Se definido como true, os eventos de envio de chave (uma API de nível inferior que envia pressionamentos de teclas simulados para o sistema operacional) serão usados. Se definido como false, as teclas de envio (uma API de nível superior que envia pressionamentos de teclas para o elemento focado) serão usadas em vez disso. |
|
|
Intervalo em milissegundos
|
Interval | integer |
O número de milissegundos entre cada pressionamento de tecla. |
|
|
Não interprete símbolos
|
DontInterpretSymbols | boolean |
Os símbolos na 'Palavra-passe para introduzir' não devem ser interpretados como teclas especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais. |
|
|
A palavra-passe contém a palavra-passe armazenada
|
PasswordContainsStoredPassword | boolean |
Defina como true se a senha contiver (ou for inteiramente) um identificador de senha armazenado em IA-Connect, no formato {IAConnectPassword:StoredPasswordIdentifier} ou uma credencial genérica do IA-Connect Orchestrator, no formato {OrchestratorCredential:FriendlyName}. Essa senha armazenada pode ter sido gerada pela ação 'Gerar senha', por exemplo, ou ser mantida pelo IA-Connect Orchestrator. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Texto de entrada global no elemento UIA
Move o mouse para o centro do elemento, foca-o, clica com o botão esquerdo e pressiona as teclas. Normalmente usado com uma entrada de texto que não aceitará métodos de entrada UIA nativos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Elemento de foco primeiro
|
FocusElement | boolean |
Deve IA-Connect tentar focar o elemento antes de clicar globalmente? |
|
|
Clique com o botão esquerdo do rato global no elemento
|
GlobalMouseClickOnElement | boolean |
Deve ser realizado um clique global do rato nas coordenadas do elemento (para focar o elemento) antes de introduzir texto? |
|
|
Substitua o valor existente usando o duplo clique do mouse em excluir
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Qualquer valor existente deve ser substituído por clicar duas vezes no mouse (para realçá-lo) e, em seguida, excluir? |
|
|
Substitua o valor existente usando CTRL-A excluir
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Qualquer valor existente deve ser substituído pressionando Ctrl-A (para realçar tudo) e, em seguida, excluindo? Alguns elementos podem não suportar realce com Ctrl-A caso em que a opção alternativa de 'Substituir valor existente usando exclusão de clique duplo do mouse' deve ser tentada. |
|
|
Texto a introduzir
|
TextToInput | string |
O valor de texto para entrada global usando o teclado. |
|
|
Usar enviar eventos-chave
|
SendKeyEvents | boolean |
Se definido como true, os eventos de envio de chave (uma API de nível inferior que envia pressionamentos de teclas simulados para o sistema operacional) serão usados. Se definido como false, as teclas de envio (uma API de nível superior que envia pressionamentos de teclas para o elemento focado) serão usadas em vez disso. |
|
|
Intervalo em milissegundos
|
Interval | integer |
O número de milissegundos entre cada pressionamento de tecla. |
|
|
Não interprete símbolos
|
DontInterpretSymbols | boolean |
Os símbolos no 'Texto a introduzir' não devem ser interpretados como teclas especiais (por exemplo, + para Shift, ^ para Ctrl)? Isso deve ser definido como true se você estiver tentando inserir os símbolos reais. |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Validar ponto clicável dentro do limite do elemento
|
ValidateClickablePointWithinElementBoundary | boolean |
Para alguns elementos, a interface do usuário não está ciente de um ponto clicável dentro do elemento e retornará uma coordenada inválida (por exemplo, 0,0) em vez do centro do elemento. Se essa entrada for definida como true, IA-Connect verificará a validade da coordenada fornecida pela UIA e, se não estiver dentro do limite do elemento, ignorará o valor fornecido pela UIA e usará o centro do elemento. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Verificar vários elementos da UIA
Define o estado de vários elementos (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Elementos de entrada
|
InputElementsJSON | True | string |
Uma matriz de elementos UIA para verificar, no formato JSON. |
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |
Verifique o elemento UIA
Define o estado de um elemento (normalmente uma caixa de seleção ou caixa de rádio) como marcado ou desmarcado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Alça da janela pai
|
ParentWindowHandle | True | integer |
O identificador de janela UIA pai (um valor de 1 ou superior) para atuar como o ponto de partida para a pesquisa. Isso pode ser descoberto por meio da Inspeção usando ações como 'Esperar pelo elemento da área de trabalho' ou 'Esperar pelo elemento'. |
|
Nome do elemento de pesquisa
|
SearchElementName | string |
O nome do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Nome da classe do elemento de pesquisa
|
SearchElementClassName | string |
O nome de classe do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
ID de automação do elemento de pesquisa
|
SearchElementAutomationId | string |
O ID de automação do elemento UIA opcional a ser pesquisado (a partir do identificador de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Tipo de controle localizado do elemento de pesquisa
|
SearchLocalizedControlType | string |
O tipo de controle localizado do elemento UIA opcional a ser pesquisado (a partir da alça de janela pai). Isso pode ser descoberto através da inspeção. |
|
|
Pesquisar subárvore UIA
|
SearchSubTree | boolean |
Se definido como true, toda a árvore UIA abaixo do identificador da janela pai será pesquisada. Isto é mais exaustivo, mas pode demorar mais tempo. Se definido como false, somente os elementos diretamente abaixo da alça da janela pai na árvore UIA serão pesquisados. |
|
|
Elemento de verificação
|
CheckElement | boolean |
O elemento deve ser verificado (true) ou desmarcado (false)? |
|
|
Índice de correspondência
|
MatchIndex | integer |
Se vários elementos corresponderem à pesquisa, qual elemento (a partir de 1) deve ser correspondido. Pode ser usado em conjunto com 'Classificar por coluna' para escolher a ordem de classificação para correspondência. |
|
|
Filtro de pesquisa
|
SearchFilter | string |
Um filtro avançado opcional para restringir ainda mais a pesquisa usando operadores condicionais e qualquer campo de elemento. Exemplo 1: [Largura] < 200. Exemplo 2: [Nome] como 'Documento*' E [ClassName] como 'Rótulo*'. Consulte a documentação para obter mais exemplos. |
|
|
Ordenar por nome de coluna
|
SortByColumn | string |
Se vários elementos corresponderem à pesquisa, isso permitirá que você especifique qual propriedade de elemento classificar. Isso será usado em conjunto com 'Índice de correspondência' para escolher o elemento necessário. Por exemplo: Se 'Ordenar por nome da coluna' for [TopEdge] e 'Índice de correspondência' for 1, então o elemento correspondente mais próximo da parte superior do ecrã será correspondido. |
|
|
O índice de correspondência está em ascensão
|
MatchIndexAscending | boolean |
Se vários elementos corresponderem à pesquisa, 'Índice de correspondência' deve corresponder a partir do topo da lista ordenada (true) ou da parte inferior da lista ordenada (false). |
|
|
Máximo de elementos a pesquisar
|
MaxElementsToSearch | integer |
O número máximo de elementos a serem pesquisados ao procurar o elemento de destino na árvore UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Profundidade máxima relativa de pesquisa
|
MaxRelativeSearchDepth | integer |
A profundidade máxima relativa da árvore para procurar elementos filho abaixo do elemento pai. Os elementos filho direto terão um valor de profundidade de 1. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Defina como 0 para uma profundidade de pesquisa ilimitada. Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Máximo de elementos filho para pesquisa por nó
|
MaxChildElementsToSearchPerNode | integer |
O número máximo de elementos filho a serem pesquisados abaixo de cada elemento ao pesquisar o elemento de destino na árvore da UIA. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Por padrão, isso é definido como 0 (ilimitado). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Tipos de controle localizados em elementos que não devem ser atravessados
|
ElementLocalizedControlTypesNotToTraverse | string |
Uma lista separada por vírgulas de tipos de controle localizados no elemento UIA para não atravessar (entrar) ao pesquisar a árvore UIA para o elemento de destino. A pesquisa ainda verificará se um elemento individual corresponde aos critérios de pesquisa, no entanto, não pesquisará nenhum elemento filho desse elemento se seu tipo de controle localizado estiver nessa lista de exclusão. Essa entrada só funciona se o modo de pesquisa do elemento UIA for "Caminhada em árvore" (isso pode ser ativado na página de configurações no Inspetor). Essa entrada é normalmente usada para otimizar a pesquisa de elementos. |
|
|
Workflow
|
Workflow | True | string |
Adicione a seguinte expressão aqui: workflow() |