Ações de automatização da IU

Importante

Para evitar o acesso não autorizado, o Power Automate tem de ser executado com os mesmos privilégios ou mais elevados que as aplicações que automatiza. Para utilizar as ações Automatização da IU (exceto para a ação Utilizar ambiente de trabalho) para interagir com aplicações que são executadas com privilégios elevados, execute o Power Automate como administrador. Para encontrar mais informações sobre como executar o Power Automate como um administrador, aceda a Executar o Power Automate com direitos elevados.

O Power Automate fornece várias ações de automatização de IU para permitir que os utilizadores interajam com aplicações Windows e de ambiente de trabalho. Algumas ações de automatização da IU requerem que defina elementos da IU nas suas propriedades para indicar o elemento que pretende processar.

Para adicionar um novo elemento da IU, adicione Adicionar elemento da IU através da ação de automatização da IU implementada ou do painel Elementos da IU do estruturador de fluxos.

Todos os elementos de IU consistem em seletores que identificam a estrutura hierárquica dos componentes. Os selecionadores utilizam a notação > para indicar que cada elemento está contido dentro do elemento à sua esquerda.

Quando cria um elemento da IU de uma janela da aplicação, o seu seletor tem sempre um elemento raiz chamado :desktop.

Se criar um elemento da IU que indique um componente dentro de uma janela da aplicação, serão criados automaticamente dois elementos da IU. O elemento principal da IU identifica a janela da aplicação, enquanto o elemento subordinado mostra a estrutura hierárquica do componente específico dentro da janela.

Embora os seletores sejam criados automaticamente ao adicionar elementos da IU, alguns cenários específicos precisam de seletores criados manualmente. Quando um seletor personalizado é necessário, pode editar um seletor existente ou criar um de raiz.

Para desenvolver fluxos mais dinâmicos, substitua os operadores Igual a por outros operadores ou expressões regulares. Além disso, se o valor do atributo de um seletor depender dos resultados de ações anteriores, utilize variáveis em vez de valores hard-coded.

Para muitas ações de automatização da IU existem dois modos de execução de ações: físico e simulado. No modo físico, a ferramenta assume o controlo do rato e do teclado da máquina para realizar a ação fisicamente. No modo simulado, a ação é executada programaticamente sem assumir o controlo do rato e do teclado e sem exigir que o ecrã do elemento da IU seja trazido para primeiro plano. É importante observar que a opção simulada pode não ser aplicável a todos os elementos da IU. Para realizar uma ação por simulação, ative o parâmetro Simular ação em algumas ações ou desative o parâmetro Trazer para a frente noutras ações.

Nota

Para encontrar mais informações sobre o desenvolvimento de fluxos de automatização da IU e criar seletores personalizados, aceda a Automatizar fluxos de ambiente de trabalho e Criar um seletor personalizado, respetivamente.

Obter detalhes de uma janela

Obtém uma propriedade de uma janela como o respetivo título ou texto de origem.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Janela	Não	Elemento da IU		A janela cujos detalhes devem ser obtidos
Propriedade Window	N/D	Obter título da janela, Obter texto da janela, Obter localização e estado da janela, Obter nome do processo	Obter título da janela	Escolher a propriedade da janela a extrair
Trazer para primeiro plano	N/A	Valor booleano	Verdadeiro	Especifique se a janela que contém o elemento de IU será trazida para frente durante a execução. Se esta opção estiver desativada, a ação é executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir deslocamento, a desativação desta opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
WindowProperty	Valor geral	As informações da janela obtidas

Exceções

Exceção	Descrição
Falha ao obter propriedade da janela	Indica um problema ao obter a propriedade da janela

Obter detalhes de um elemento da IU na janela

Obtém o valor do atributo de um elemento da IU numa janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O elemento da IU cujos detalhes devem ser obtidos
Nome do atributo	Sim	Valor de texto	Texto próprio	O atributo cujo valor será obtido
Trazer para primeiro plano	N/A	Valor booleano	Verdadeiro	Especifique se a janela que contém o elemento de IU será trazida para frente durante a execução. Se esta opção estiver desativada, a ação é executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir deslocamento, a desativação desta opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
AttributeValue	Valor de texto	O valor do texto do elemento da IU

Exceções

Exceção	Descrição
Falha ao obter atributo do elemento da IU	Indica um problema ao obter o atributo do elemento da IU

Obter caixas de verificação selecionadas na janela

Obtém os nomes das caixas de verificação selecionadas num grupo de caixas de verificação ou o estado de uma caixa de verificação específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		A caixa de verificação ou grupo de caixas de verificação
Operação	N/D	Obter os nomes das caixas de verificação selecionadas em grupo, Obter o estado de uma caixa de verificação	Obter os nomes das caixas de verificação selecionadas no grupo	Especifique se deve ser obtido o estado de várias caixas de verificação selecionadas ou apenas de uma
Trazer para primeiro plano	N/A	Valor booleano	Verdadeiro	Especifique se a janela que contém o elemento de IU deve ser trazida para frente durante a execução. Se esta opção estiver desativada, a ação será executada em segundo plano. Observe que nem todos os elementos da IU poderão ser compatíveis com a opção desativada. Além disso, se a execução da ação exigir deslocamento, a desativação desta opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
IsChecked	Valor booleano	O estado da caixa de verificação selecionada
SelectedCheckboxes	Lista de valores de Texto	Os nomes das caixas de verificação selecionadas no grupo de caixas de verificação especificado

Exceções

Exceção	Descrição
Falha ao obter estados das caixas de verificação	Indica um problema ao obter os estados das caixas de verificação especificadas

Obter o botão de opção selecionado na janela

Obtém os nomes dos botões de opção selecionados num grupo de botões de opção ou o estado de um botão de opção específico.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O botão de opção ou grupo de botões de opção
Operação	N/D	Obter o nome do botão de opção selecionado no grupo, Obter o estado do botão de opção	Obter o nome do botão de opção selecionado no grupo	Especifique se deve ser obtido o nome do botão de opção selecionado num grupo de botões de opção ou apenas o estado de um único botão de opção
Trazer para primeiro plano	N/A	Valor booleano	Verdadeiro	Especifique se a janela que contém o elemento de IU será trazida para frente durante a execução. Se esta opção estiver desativada, a ação é executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir deslocamento, a desativação desta opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
IsSelected	Valor booleano	O estado do botão de opção selecionado
SelectedRadiobutton	Valor de texto	O botão de opção selecionado no grupo de botões de opção especificado

Exceções

Exceção	Descrição
Falha ao obter estado do botão de opção	Indica um problema ao obter o estado do botão de opção especificado

Extrair dados a partir de uma janela

Extrai dados de partes específicas de uma janela sob a forma de valores, listas ou tabelas individuais.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Janela	Não	Elemento da IU		A janela a partir da qual os dados são extraídos
Loja extraiu dados em	N/D	uma folha de cálculo do Excel, Uma variável	uma folha de cálculo do Excel	Especifique onde os dados extraídos devem ser armazenados
Trazer para primeiro plano	N/A	Valor booleano	Verdadeiro	Especifique se a janela que contém o elemento de IU será trazida para frente durante a execução. Se esta opção estiver desativada, a ação é executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir deslocamento, a desativação desta opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
ExcelInstance	Instância do Excel	A instância do Excel com os dados extraídos. Utilize esta instância caso para manipular a folha de cálculo (ou guardá-la e fechá-la) utilizando as ações dedicadas do Excel.
DataFromWindow	Valor geral	Os dados extraídos sob a forma de uma tabela de dados

Exceções

Exceção	Descrição
Falha ao extrair	Indica um problema ao extrair dados a partir da janela especificada

Fazer captura de imagem de elemento da IU

Faz uma captura de imagem de um elemento da IU na janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O elemento UI na janela a incluir na captura de ecrã
Modo de guardar	N/D	Área de transferência, Ficheiro	Área de Transferência	Especifique se pretende guardar a imagem num ficheiro ou armazená-la na área de transferência
Image file path	Não	Ficheiro		Defina o caminho completo do ficheiro a guardar
File format	N/D	BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF	BMP	O formato do ficheiro de imagem

Variáveis produzidas

Argumento	Tipo	Descrição
ImageFile	Ficheiro	O caminho do ficheiro de imagem de captura de ecrã gerado

Exceções

Exceção	Descrição
Falha ao obter elemento da IU	Indica um problema ao obter o elemento da IU
Falha ao guardar imagem.	Indica um problema ao guardar a captura de ecrã efetuada
Falha ao fazer captura de ecrã de elemento da IU	Indica um problema ao fazer uma captura de ecrã de um elemento da IU

Foco num campo de texto na janela

Define o foco numa caixa de texto de uma janela e torna-a visível.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Campo de texto	Não	Elemento da IU		A caixa de texto à qual o foco deve ser atribuído

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao definir o foco de entrada na caixa de texto da janela	Indica um problema ao definir o foco no campo de texto da página Web especificado

Povoar campo de texto na janela

Preenche uma caixa de texto numa janela com o texto especificado.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Text box	Não	Elemento da IU		A caixa de texto a povoar
Texto a preencher	Não	Entrada direta encriptada ou Valor de texto		O texto para preencher o campo de texto
Simular ação	N/A	Valor booleano	Falso	Simular as teclas físicas através de programação durante o preenchimento de texto a elementos de campo de texto da IU. Esta opção não requer que o ecrã do elemento da IU esteja focado, pois não será trazido automaticamente para primeiro plano. Note que esta opção pode ser aplicada apenas à ação de clique esquerdo e pode não ser aplicável a todos os elementos da IU.
Se o campo não estiver vazio	Sim	Substituir texto, Anexar texto	Substituir texto	Especificar se deve substituir conteúdo existente ou anexar a este.
Clicar antes de preencher	Sim	Clicar com o botão esquerdo, Clicar duas vezes, Não	Clicar com o botão esquerdo	Especificar se é efetuado um clique com o botão esquerdo do rato antes de povoar o campo de texto ou não.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao escrever na caixa de texto	Indica um problema ao povoar o campo de texto especificado

Premir um botão na janela

Prime um botão da janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O botão a premir

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao premir botão	Indica um problema ao premir o botão especificado

Selecionar botão de opção na janela

Seleciona um botão de opção numa janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Radio button	Não	Elemento da IU		O botão de opção a selecionar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao selecionar elemento da IU do botão de opção	Indica um problema ao selecionar o elemento da IU do botão de opção especificado

Definir estado de uma caixa de verificação na janela

Seleciona ou desmarca uma caixa de verificação num formulário de janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Caixa de verificação	Não	Elemento da IU		A caixa de verificação cujo estado deve ser definido
Definir estado da caixa de verificação para	N/D	Marcado, Desmarcado	Selecionada	Especifique se a caixa de verificação será selecionada ou desmarcada

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao definir estado da caixa de verificação	Indica um problema ao definir o estado da caixa de verificação especificada

Definir valor da lista pendente na janela

Define ou limpa as opções selecionadas para uma lista pendente num formulário de janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Lista pendente	Não	Elemento da IU		A lista pendente cujo valor deve ser definido
Operation	N/A	Limpar opções selecionadas, Selecionar opções por nome, Selecionar opções por índice	Limpar opções selecionadas	Especificar se pretende selecionar um valor pelo nome ou pela posição ordinal (1 2 3 ...), ou limpar o valor selecionado da lista pendente
Nomes das opções	Não	Lista de valores de Texto		Introduza uma opção ou uma lista de opções a selecionar na lista pendente. Várias opções fazem sentido apenas ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, só será utilizada a primeira opção da lista especificada.
Utilizar expressões regulares	N/A	Valor booleano	Falso	Especificar os valores de nomes de opção a interpretar como uma expressão regular
Índices de opções	Não	Lista de valores Numéricos		Introduza um índice ou uma lista de índices a selecionar na lista pendente. Várias opções fazem sentido apenas ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, só será utilizada a primeira opção da lista especificada.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao selecionar as opções especificadas na lista pendente	Indica um problema ao selecionar as opções especificadas na lista pendente

Obter janela

Obtém uma janela em execução para automatizar aplicações de ambiente de trabalho.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Get window	N/D	Janela específica, Janela em primeiro plano	Janela específica	Especifique se a pesquisa deve utilizar um seletor ou a janela em primeiro plano
Elemento da IU	Não	Elemento da IU		O seletor da janela a obter
Trazer a janela para a frente	N/D	Valor booleano	Falso	Especifique se a janela deve ser automaticamente colocada em primeiro plano depois de ser adquirida
Fail if window isn't found	N/D	Valor booleano	Verdadeiro	Especifique se pretende esperar indefinidamente que a janela apareça ou se deve falhar se a janela não aparecer dentro de um período de tempo definido
Limite de tempo excedido	Não	Valor numérico		O tempo limite a esperar em segundos

Variáveis produzidas

Argumento	Tipo	Descrição
WindowTitle	Valor de texto	O título da janela em primeiro plano
AutomationWindow	Instância da janela	A instância da janela específica a utilizar com ações posteriores de Automatização da IU

Exceções

Exceção	Descrição
Falha ao obter janela	Indica um problema ao obter a janela

Atribuir o foco à janela

Ativa e coloca em primeiro plano uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Janela	Não	Elemento da IU		O elemento de IU da janela
Título da janela	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela à qual o foco deve ser atribuído
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Janela não encontrada	Indica que a janela especificada não foi encontrada
Não é possível atribuir o foco à janela	Indica um problema ao atribuir o foco à janela especificada
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo

Definir estado da janela

Restaura, maximiza ou minimiza uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Janela	Não	Elemento da IU		O elemento de IU da janela
Título da janela	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela cujo estado deve ser definido
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar.
Window state	N/D	Restaurado, Maximizado, Minimizado	Restaurado	Escolher o estado em que a janela deve ser apresentada

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Janela não encontrada	Indica que a janela especificada não foi encontrada
Não é possível definir o estado da janela	Indica um problema ao definir o estado da janela especificada
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo

Definir visibilidade da janela

Mostra uma janela oculta ou oculta uma janela visível.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Janela	Não	Elemento da IU		O elemento de IU da janela
Título da janela	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela cuja visibilidade deve ser definida
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar.
Visibility	N/D	Visível, Oculto	Oculto	Escolher o estado para o qual a visibilidade da janela deve ser definido

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Janela não encontrada	Indica que a janela especificada não foi encontrada
Não é possível definir a visibilidade da janela	Indica um problema ao definir a visibilidade da janela especificada
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo

Mover janela

Define a posição de uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Janela	Não	Elemento da IU		O elemento de IU da janela
Título da janela	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela a mover
Window class	Sim	Valor de texto		Se tiver duas janelas com o mesmo título, a Classe da Janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar.
Position X	Não	Valor numérico		A posição X da janela
Position Y	Não	Valor numérico		A posição Y da janela

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Janela não encontrada	Indica que a janela especificada não foi encontrada
Não é possível mover a janela	Indica um problema ao mover a janela especificada
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo

Redimensionar janela

Define o tamanho de uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Janela	Não	Elemento da IU		O elemento de IU da janela
Título da janela	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela a redimensionar
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar
Width	Não	Valor numérico		A nova largura em pixéis
Height	Não	Valor numérico		A nova altura em pixéis

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Janela não encontrada	Indica que a janela especificada não foi encontrada
Não é possível redimensionar a janela	Indica um problema ao redimensionar a janela especificada
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo

Fechar janela

Fecha uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Janela	Não	Elemento da IU		O elemento de IU da janela
Título da janela	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela a fechar
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Janela não encontrada	Indica que a janela especificada não foi encontrada
Não é possível fechar a janela	Indica um problema ao fechar a janela especificada
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo

Se a janela contiver

Marca o início de um bloco condicional de ações consoante um texto ou um elemento da IU específico existe numa janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Check if window	N/D	Contém o elemento da IU, Não contém o elemento da IU, Contém o texto, Não contém o texto	Contém o elemento da IU	Verificar se um texto ou elemento da IU específico existe numa janela
Check UI element state	N/D	Valor booleano	Falso	Verificar se um elemento da IU específico está ativado ou desativado
Texto	Não	Valor de texto		O texto a verificar
Elemento da IU	Não	Elemento da IU		O elemento da IU a verificar
Janela	Não	Elemento da IU		A janela em que a existência do texto deve ser verificada
Estado	N/D	Ativado, desativado	Ativados	O estado do elemento da IU a verificar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Esperar por conteúdo da janela

Suspende a execução da automatização até que um texto ou elemento da IU específico apareça ou desapareça de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Wait until window	N/D	Contém o elemento da IU, Não contém o elemento da IU, Contém o texto, Não contém o texto	Contém o elemento da IU	Indica se deve esperar que um texto ou elemento da IU específico apareça numa janela
Check UI element state	N/D	Valor booleano	Falso	Verificar se um elemento da IU específico está ativado ou desativado
Texto	Não	Valor de texto		O texto a verificar
Elemento da IU	Não	Elemento da IU		O elemento da IU a verificar
Janela	Não	Elemento da IU		A janela em que a existência do texto deve ser verificada
Estado	N/D	Ativado, desativado	Ativados	O estado do elemento da IU a verificar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao esperar por conteúdo da janela	Indica que a operação de espera falhou

Se a imagem

Esta ação marca o início de um bloco condicional de ações consoante uma imagem selecionada é encontrada no ecrã ou não.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
If image	N/D	existe, não existe	existe	Indica se a existência ou ausência da imagem selecionada deve ser verificada
Imagem	Não	Lista de Imagens		As imagens que a ação irá verificar, se existirem
Pesquisar por imagem em	N/D	Ecrã inteiro, Apenas na janela em primeiro plano	Ecrã inteiro	Se pretende procurar a imagem especificada apenas na janela em primeiro plano ou na na totalidade do ecrã visível. Nenhuma das opções irá encontrar a imagem se esta não estiver claramente visível no ecrã
Search mode	N/D	Procurar no ecrã inteiro ou na janela em primeiro plano, Procurar na sub-região especificada do ecrã ou na janela em primeiro plano	Procurar no ecrã inteiro ou na janela em primeiro plano	Indica se deve ser analisado o ecrã inteiro (ou a janela inteira) para encontrar o texto fornecido ou apenas uma sub-região deste
Find all images in the list	N/D	Valor booleano	Falso	Verificar se todas as imagens na lista existem ou não
X1	Sim	Valor numérico		A coordenada X de início da sub-região para procurar o texto fornecido
X2	Sim	Valor numérico		A coordenada X de fim da sub-região para procurar o texto fornecido
Y1	Sim	Valor numérico		A coordenada Y de início da sub-região para procurar o texto fornecido
Y2	Sim	Valor numérico		A coordenada Y de fim da sub-região para procurar o texto fornecido
Tolerance	Sim	Valor numérico	10	Especifique quanto as imagens procuradas podem diferir da imagem originalmente escolhida
Algoritmo de correspondência de imagens	N/D	Básica, Avançada	Básica	Que algoritmo de imagem a utilizar para procurar a imagem

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível verificar a imagem no modo não interativo	Indica que uma imagem não pode ser identificada no modo não interativo
Coordenadas de sub-região inválidas	Indica que as coordenadas da sub-região indicada eram inválidas

Utilizar ambiente de trabalho

Efetua operações relacionadas com o ambiente de trabalho e a barra de tarefas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O elemento da IU a clicar
Tipo de clique	N/A	Clicar com o botão esquerdo, Clicar com o botão direito, Clicar duas vezes	Clicar com o botão esquerdo	O tipo de clique a efetuar
Iniciar nova aplicação ao clicar com o botão esquerdo na barra de tarefas	N/D	Valor booleano	Verdadeiro	Quando este parâmetro é definido como "verdadeiro", garante que será criada uma nova janela de uma aplicação quando fizer clique com o botão esquerdo do rato no respetivo ícone na barra de "iniciação rápida", também conhecida como barra de tarefas do Windows 7 ou superior. Desmarque esta opção para colocar em primeiro plano uma instância já em execução da aplicação.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha na operação da barra de tarefas	Indica que a operação da barra de tarefas falhou

Selecionar separador na janela

Seleciona um separador num grupo de separadores.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tab	Não	Elemento da IU		O separador a selecionar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao selecionar separador	Indica um problema ao selecionar o separador especificado

Esperar por imagem

Esta ação aguarda até que uma imagem específica apareça no ecrã ou na janela em primeiro plano.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Wait for image to	N/D	Aparecer, Desaparecer	Aparecer	Verificar se deve esperar que as imagens apareçam ou desapareçam
Imagem pela qual aguardar	Não	Lista de Imagens		As imagens que a ação irá verificar, se existirem
Pesquisar por imagem em	N/D	Ecrã inteiro, Apenas na janela em primeiro plano	Ecrã inteiro	Se pretende procurar a imagem especificada apenas na janela em primeiro plano ou na na totalidade do ecrã visível. Nenhuma das opções irá encontrar a imagem se esta não estiver claramente visível no ecrã
Search mode	N/D	Procurar no ecrã inteiro ou na janela em primeiro plano, Procurar na sub-região especificada do ecrã ou na janela em primeiro plano	Procurar no ecrã inteiro ou na janela em primeiro plano	Indica se deve ser analisado o ecrã inteiro (ou a janela inteira) para encontrar o texto fornecido ou apenas uma sub-região deste
Wait for all images	N/D	Valor booleano	Falso	Indica se deve esperar que todas as imagens na lista apareçam/desapareçam ou apenas uma delas
X1	Sim	Valor numérico		A coordenada X de início da sub-região para procurar o texto fornecido
X2	Sim	Valor numérico		A coordenada X de fim da sub-região para procurar o texto fornecido
Y1	Sim	Valor numérico		A coordenada Y de início da sub-região para procurar o texto fornecido
Y2	Sim	Valor numérico		A coordenada Y de fim da sub-região para procurar o texto fornecido
Tolerance	Sim	Valor numérico	10	Especifique quanto as imagens procuradas podem diferir da imagem originalmente escolhida
Algoritmo de correspondência de imagens	N/D	Básica, Avançada	Básica	Que algoritmo de imagem a utilizar para procurar a imagem
Falha com erro de tempo limite	N/D	Valor booleano	Falso	Especifique se pretende que a ação aguarde indefinidamente ou falhe após um período de tempo definido

Variáveis produzidas

Argumento	Tipo	Descrição
X	Valor numérico	A coordenada X do ponto onde o texto foi encontrado no ecrã. Se o texto tiver sido pesquisado na janela em primeiro plano, este valor é relativo ao canto superior esquerdo da janela.
Y	Valor numérico	A coordenada Y do ponto onde o texto foi encontrado no ecrã. Se o texto tiver sido pesquisado na janela em primeiro plano, este valor é relativo ao canto superior esquerdo da janela.

Exceções

Exceção	Descrição
Falha ao esperar por imagem	Indica que a operação de espera falhou
Não é possível verificar a imagem no modo não interativo	Indica que uma imagem não pode ser identificada no modo não interativo
Coordenadas de sub-região inválidas	Indica que as coordenadas da sub-região indicada eram inválidas

Pairar o rato sobre o elemento da IU na janela

Pairar o rato sobre qualquer elemento da IU na janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		Selecione o elemento da IU sobre o qual o rato deve pairar na janela

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao pairar sobre elemento	Indica que pairar sobre o elemento falhou

Clique num elemento da IU na janela

Clica em qualquer elemento da IU de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O elemento da IU a clicar
Tipo de clique	N/A	Clicar com o botão esquerdo, Clicar com o botão direito, Clicar duas vezes, Clicar com o botão central, Clicar com o botão esquerdo para baixo, Clicar com o botão esquerdo para cima, Clicar com o botão direito para baixo, Clicar com o botão direito para cima	Clicar com o botão esquerdo	O tipo de clique a efetuar
Simular ação	N/A	Valor booleano	Falso	Especifique se simula o movimento do cursor do rato sobre o elemento antes de clicar. Esta opção não requer que o ecrã do elemento da IU esteja focado, pois não será trazido automaticamente para primeiro plano. Note que esta opção pode ser aplicada apenas à ação de clique esquerdo e pode não ser aplicável a todos os elementos da IU.
Mouse position relative to UI element	N/A	Canto superior esquerdo, Centro superior, Canto superior direito, Esquerda ao meio, Centro ao meio, Direita ao meio, Canto inferior esquerdo, Centro inferior, Canto inferior direito	Centro ao meio	Especifique a secção do elemento da IU para a qual o rato será movido antes de clicar
Offset X	Sim	Valor de texto	0	Desvio do rato, em pixéis, da posição para a direita
Offset Y	Sim	Valor de texto	0	Desvio do rato, em pixéis, da posição para baixo

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao clicar	Indica que o clique falhou

Selecionar opção de menu numa janela

Seleciona uma opção num menu de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		A opção de menu a selecionar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao selecionar opção	Indica um problema ao selecionar a opção de menu especificada

Arrastar e largar elemento da IU numa janela

Arrasta e larga um elemento da IU de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU a arrastar	Não	Elemento da IU		O elemento da IU a arrastar
Elemento da IU a largar	Não	Elemento da IU		O elemento da IU a largar
Tipo de clique	N/A	Clicar com o botão esquerdo, Clicar com o botão direito	Clicar com o botão esquerdo	Especifique o botão do rato a utilizar para clicar e manter premido enquanto o elemento da IU é arrastado para o respetivo destino
Mouse down offset X	Sim	Valor de texto	0	Desviar para a direita por esta quantidade de pixéis o clique do rato que será utilizado para agarrar o elemento da IU a arrastar
Mouse down offset Y	Sim	Valor de texto	0	Desviar para baixo por esta quantidade de pixéis o clique do rato que será utilizado para agarrar o elemento da IU a arrastar
Mouse down position relative to drag-target UI element	N/D	Canto superior esquerdo, Centro superior, Canto superior direito, Esquerda ao meio, Centro ao meio, Direita ao meio, Canto inferior esquerdo, Centro inferior, Canto inferior direito	Centro ao meio	Especifique a secção do elemento da IU para largar o rato antes de clicar
Mouse up offset X	Sim	Valor de texto	0	Desviar para a direita por esta quantidade de pixéis a ação de soltar o botão do rato que será utilizada para agarrar o elemento da IU a arrastar
Mouse up offset Y	Sim	Valor de texto	0	Desviar para baixo por esta quantidade de pixéis a ação de soltar o botão do rato que será utilizada para agarrar o elemento da IU a arrastar
Mouse up position relative to drop-target UI element	N/D	Canto superior esquerdo, Centro superior, Canto superior direito, Esquerda ao meio, Centro ao meio, Direita ao meio, Canto inferior esquerdo, Centro inferior, Canto inferior direito	Centro ao meio	Especifique a secção do elemento da IU para arrastar o rato depois de clicar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O elemento da IU a arrastar não foi encontrado	Indica que o elemento da IU a arrastar não foi encontrado
O elemento da IU de destino não foi encontrado	Indica que o elemento da IU de destino não foi encontrado
Falha ao arrastar e largar	Indica um problema ao arrastar e largar o elemento da IU especificado

Expandir/fechar nó da árvore na janela

Expande ou fecha um nó de uma vista de árvore que reside numa janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Elemento da IU	Não	Elemento da IU		O nó da árvore a expandir/fechar
Caminho das pastas	Sim	Valor de texto		Um caminho separado por barras composto por nomes de pastas que indica o nó da árvore a expandir ou fechar
Use regular expressions	N/D	Valor booleano	Falso	Especifique se o nome de cada pasta existente no caminho deve ser interpretado como uma expressão regular
Operation	N/D	Expandir, Fechar	Expandir	Especifique se o nó da árvore deve ser expandido ou fechado

Nota

O motor de expressão regular do Power Automate é .NET. Para encontrar mais informações sobre expressões regulares, aceda a Linguagem de Expressão Regular – Referência Rápida.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao definir nó da árvore para o estado especificado	Indica um problema ao definir o nó da árvore para o estado especificado

Se a janela

Esta ação marca o início de um bloco condicional de ações consoante uma janela está aberta ou não, ou consoante uma janela tem o foco (está em primeiro plano) ou não.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Get window	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Window title	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Janela	Não	Elemento da IU		O elemento de IU da janela
Instância da janela	Não	Valor numérico		A instância ou o identificador da janela a verificar
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar.
Check if window	N/D	Está aberto, não está aberto, está focado, não está focado	Está aberta	O estado da janela a verificar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Esperar por janela

Suspende a execução ou o processo até que uma janela específica seja aberta, fechada, ganhe ou perca o foco.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Find window	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de IU da janela	Especifique se a janela deve ser procurada utilizando um elemento da IU ou uma combinação de título/classe de janela
Window title	Sim	Valor de texto		O título da janela. É possível utilizar carateres universais, como "?" ou "*".
Janela	Não	Elemento da IU		O elemento de IU da janela
Instância da janela	Não	Valor numérico		A instância ou o identificador da janela a verificar
Window class	Sim	Valor de texto		Se existirem duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Neste caso, introduza a classe da janela a utilizar
Wait for window to	N/D	Abrir, Fechar, Ganhar o foco, Perder o foco	Em aberto	Indica se deve esperar que uma janela específica seja aberta, fechada, ganhe o foco (ou seja, passe a ser a janela em primeiro plano) ou perca o foco (ou seja, deixe de ser a janela em primeiro plano).
Focus window after it opens	N/D	Valor booleano	Falso	Trazer a janela para a frente após esta ser aberta, para que as ações posteriores sejam direcionadas para esta janela

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível atribuir o foco à janela	Indica um problema ao atribuir o foco à janela especificada
Falha ao esperar por janela	Indica que a operação de espera falhou
Não é possível efetuar uma ação relacionada com janelas no modo não interativo	Indica um problema ao efetuar uma ação relacionada com janelas no modo não interativo