Gerir variáveis e o painel de variáveis

O painel de variáveis mostra as variáveis de entrada e saída transmitidas para e de fluxos de ambiente de trabalho do Power Automate. Também apresenta todas as variáveis utilizadas no fluxo de ambiente de trabalho atual em Variáveis do fluxo.

Através deste painel, poderá pesquisar por variáveis, mudar o respetivo nome, localizar as suas utilizações, marcando-as como confidenciais, afixando-as e filtrando-as por tipo. A filtragem permite-lhe selecionar se as aplica ou não às variáveis afixadas.

O visualizador de valores variável

Quando um fluxo é executado, o valor atual de cada variável é visível junto do respetivo nome. Selecione o ícone da borracha na parte inferior do painel de variáveis para limpar todos os valores atuais.

Nota

O Power Automate omite automaticamente as variáveis de ações desativadas. Ative uma ação desativada para disponibilizar as variáveis no painel de variáveis.

Para examinar o valor de uma variável em maior detalhe, clique duas vezes nela. O visualizador de valores de variável apresenta o tipo de dados da variável selecionada e expande quaisquer linhas de dados ou tabelas de dados para mostrar o respetivo conteúdo.

Determinados tipos de dados poderão conter elementos aninhados. Por exemplo, um objeto personalizado poderá conter outro objeto personalizado nas suas propriedades. Para ver as propriedades do elemento aninhado, selecione Mais.

Selecione o ícone de seta na parte superior do diálogo para regressar ao elemento principal.

Alterar o nome de uma variável de ambiente de trabalho

Para mudar o nome de uma variável de fluxo de ambiente de trabalho, clique com o botão direito do rato no respetivo nome e selecione Mudar nome. O Power Automate atualiza automaticamente o nome da variável em todas as suas ocorrências.

Importante

Se tentar mudar o nome de uma variável para um nome existente, o Power Automate irá solicitar que confirme a intercalação das duas variáveis. A intercalação não intencional poderá afetar a funcionalidade do seu fluxo e causar erros, pelo que deve assegurar que a intercalação é desejável.

Variáveis e entrada e saída

O Power Automate permite a troca de dados entre fluxos de ambiente de trabalho e de cloud através das variáveis de entrada e de saída, permitindo-lhe expandir as capacidades de automatização

Além disso, pode utilizar variáveis de entrada para definir valores manualmente quando os fluxos são acionados através da consola.

Para encontrar mais informações sobre a transmissão de dados entre fluxos de ambiente de trabalho e de cloud, consulte Acionar fluxos de ambiente de trabalho a partir de fluxos de cloud.

Criar uma variável de entrada

Para criar uma variável de entrada:

1. Selecione o botão de adição (+) no painel de variáveis e, em seguida, Entrada.

   

2. Quando a caixa de diálogo Nova variável de entrada aparece, preencha os seguintes campos:

   • Nome da variável: o nome da variável no fluxo de ambiente de trabalho.
   • Tipo de dados: o tipo da variável texto, número, booleano, objeto personalizado, lista ou tabela de dados.
   • Valor predefinido: o valor predefinido quando o fluxo é executado através do estruturador de fluxos ou da consola. Quando cria um objeto personalizado, lista ou variável de entrada de tabela de dados, o Power Automate permite-lhe construir o valor predefinido através de um elemento visual ou JSON.
   • Nome externo: o nome externo é o nome que aparece no estruturador de fluxos de cloud e na caixa de diálogo de entrada do fluxo ao chamar o fluxo a partir da consola.
   • Descrição: a descrição da variável que aparece no estruturador de fluxos de ambiente de trabalho e de cloud enquanto chama o fluxo.
   • Marcar como confidencial: define se marca a variável como confidencial ou não. Pode encontrar informações sobre variáveis confidenciais em Variáveis confidenciais.
   • Marcar como opcional: define se o preenchimento desta variável de entrada é obrigatório ou não. Ao marcar uma variável de entrada como opcional, permite-lhe receber valores Em branco e omite a passagem de um valor real, o que não resulta num erro. Pode encontrar informações sobre variáveis de entrada opcional em Variáveis de entrada opcional.

   Nota

   Os campos Nome de variável, Tipos de dados e Nome externo são necessários para criar uma variável de entrada.

   Importante

   Se escolher um nome de variável do fluxo existente para uma nova variável de entrada, o Power Automate solicitará que confirme a intercalação das duas variáveis. A intercalação não intencional pode afetar a funcionalidade do seu fluxo e causar erros. Além disso, não pode utilizar o nome de uma variável de entrada ou saída existente.

   

Quando aciona fluxos de ambiente de trabalho diretamente através da consola, e não um fluxo de cloud, o diálogo Entradas de fluxo pede-lhe para definir valores para as variáveis de entrada manualmente. Para objetos personalizados, listas e tabelas de dados, o diálogo permite-lhe preencher valores utilizando um editor visual ou JSON.

Criar uma variável de saída

Para criar uma variável de saída:

1. Selecione o botão de adição (+) no painel de variáveis e, em seguida, Saída.

   

2. Quando a caixa de diálogo Nova variável de saída aparece, preencha os seguintes campos:

   • Nome da variável: o nome da variável no fluxo de ambiente de trabalho.
   • Tipo de dados: o tipo da variável texto, número, booleano, objeto personalizado, lista ou tabela de dados.
   • Nome externo: o nome externo é o nome que aparece no estruturador de fluxos de cloud.
   • Descrição: a descrição da variável que aparece no estruturador de fluxos de ambiente de trabalho ou de cloud enquanto chama o fluxo.
   • Marcar como confidencial: define se marca a variável como confidencial ou não. Pode encontrar informações sobre variáveis confidenciais em Variáveis confidenciais.

   Nota

   Os campos Nome de variável, Tipos de dados e Nome externo são necessários para criar uma variável de saída.

   Importante

   Se escolher um nome de variável do fluxo existente para uma nova variável de saída, o Power Automate solicitará que confirme a intercalação das duas variáveis. A intercalação não intencional pode afetar a funcionalidade do seu fluxo e causar erros. Além disso, não pode utilizar o nome de uma variável de entrada ou saída existente.

   

Gerir variáveis de entrada e de saída

Todas as variáveis de entrada e de saída criadas estão disponíveis na secção apropriada do painel de variáveis.

Pode utilizar este painel para mudar o nome, atualizar, eliminar, encontrar as utilizações, afixar e filtrar cada variável de entrada/saída. A filtragem permite-lhe selecionar se as aplica ou não às variáveis afixadas.

Para atualizar uma variável de entrada/saída:

1. Clique com o botão direito do rato no seu nome no painel de variáveis e selecione Editar.

   Importante

   Se tentar mudar o nome de uma variável de entrada ou saída para um nome de variável de fluxo, o Power Automate solicitará que confirme a intercalação das duas variáveis. A intercalação não intencional pode afetar a funcionalidade do seu fluxo e causar erros. Além disso, não pode utilizar o nome de uma variável de entrada ou saída existente.

   

2. Na caixa de diálogo Editar variável de entrada/saída, atualize os campos pretendidos e selecione Guardar para aplicar as alterações.

   

Variáveis confidenciais

Importante

Os fluxos desenvolvidos em versões mais antigas do Power Automate para computadores (v.2.13 ou anteriores) permanecem inalterados pela funcionalidade de variáveis confidenciais, desde que não os altere. Se executar fluxos de ambiente de trabalho através da consola ou do portal sem os editar, irão manter o comportamento antigo e funcionarão como antes.

Para aplicar a nova funcionalidade, edite e guarde os fluxos com o Power Automate para computadores v.2.14 ou posterior. O Power Automate converterá variáveis de entrada de tipo encriptado passadas e variáveis encriptadas produzidas pela ação Obter palavra-passe do CyberArk, para variáveis de texto marcadas como confidenciais.

Alguns cenários de automatização processam informações confidenciais e requerem processamento especial de variáveis que armazenam e utilizam dados confidenciais durante o runtime. Os fluxos de ambiente de trabalho suportam a criação de variáveis confidenciais, cujos valores são mascarados durante a depuração no painel de variáveis do estruturador de fluxos.

Adicionalmente, se tiver iniciado sessão com uma conta premium da organização, os valores de variáveis confidenciais não são armazenados no Histórico de execuções no portal quando os fluxos de ambientes de trabalho são executados através da consola ou de fluxos de cloud.

Qualquer variável pode tornar-se confidenciais, independentemente do tipo. A confidencialidade aplica-se ao nível da variável; por isso, as listas, linhas de dados, tabelas de dados e objetos personalizados ficam confidenciais como um todo. Não há como marcar um item de lista, uma coluna de tabela de dados ou uma propriedade de variável como confidencial numa variável não confidencial.

Pode utilizar, manipular e processar variáveis confidenciais em todas as ações sem qualquer limitação, como todas as outras variáveis. Além disso, pode combiná-las com outras variáveis e incluí-las em expressões. Neste caso, os registos processam a expressão completa como confidencial.

O estruturador de fluxos processa a confidencialidade como uma máscara que pode definir como ativada e desativada. Assim, pode desmascarar variáveis confidenciais para ver os seus valores e mascará-los novamente para ocultar os seus valores.

Importante

As variáveis confidenciais não se destinam a fornecer proteção sobre dados com dados codificados. Não deve codificar dados críticos em texto simples, como palavra-passe e PIN, nas propriedades de ações como Definir variável, mesmo que essas variáveis sejam marcadas como confidenciais. Os fluxos de ambiente de trabalho estarão protegidos, mas os valores codificados estão visíveis no modal e na definição de fluxo no Microsoft Dataverse.

Para obter mais informações sobre entradas de texto confidenciais em fluxos de cloud, consulte Gerir entrada de dados confidenciais, como palavras-passe.

Nota

• O valor de uma variável confidencial é visível quando a envia para fora de fluxos de ambiente de trabalho ou é apresentada através da ação Apresentar mensagem.
• A confidencialidade não é herdada em variáveis. Por predefinição, se adicionar ou atribuir uma variável confidencial a outra variável, a variável resultante não será confidencial. A exceção a esta regra aplica-se apenas aos tipos de variáveis de credencial. As variáveis de credenciais, produzidas pela respetiva ação ou pela reatribuição de outra variável, são sempre confidenciais e a sua sensibilidade é aplicada. A mesma exceção também se aplica à propriedade "Palavra-passe" dos tipos de variáveis de credenciais.
• A marcação de uma variável como confidencial oculta os respetivos valores do resumo da ação Definir variável.
• Os detalhes de entrada da ação Definir variável não são visíveis nos registos de fluxo do ambiente de trabalho quando as variáveis contidas foram marcadas como confidenciais.
• Mascarar variáveis confidenciais durante a depuração só proporciona uma forma de proteção básica aos programadores de terceiros de verem os seus ecrãs.

Para marcar uma variável como confidencial, clique com o botão direito no painel de variáveis e selecione Marcar como confidencial. Para para de definir uma variável como confidencial, clique com o botão direito e selecione Marcar como não confidencial.

Além dos menus de contexto, pode utilizar o ícone dedicado junto de cada variável para marcá-la como confidencial ou não confidencial.

Variáveis de entrada e de saída confidenciais

Quando cria ou edita uma variável de entrada ou de saída, pode selecionar Marcar como confidencial no respetivo diálogo para torná-la confidencial.

O valor predefinido de uma variável de entrada é visível no diálogo de criação ou edição quando a confidencialidade está ativada. Este valor só existe para fins de teste e depuração, uma vez que é preciso inicializar cada entrada em execuções de produção através do portal ou da consola. Os valores predefinidos não estão protegidos nos modais de ação e na definição de fluxo no Dataverse.

Por outro lado, o valor predefinido não está visível no painel de variáveis e o diálogo Entrada de fluxo, que aparece quando executa um fluxo de ambiente de trabalho com variáveis de entrada é executado através da consola.

O ícone de olho para revelar o valor não está disponível, a menos que elimine o valor de texto predefinido e forneça um novo. Os novos valores são visíveis ao preencher outros tipos de dados para além de texto.

Variáveis de entrada opcional

Quando cria ou edita uma variável de entrada ou de saída, pode selecionar Marcar como opcional no respetivo diálogo para a tornar opcional.

Por predefinição, as variáveis de entrada são obrigatórias, o que significa que tem de fornecer:

• Um valor predefinido ao criar a mesma, para que possa ser usada durante a depuração (iniciada pela consola), caso não passe outro valor.
• Um valor do respetivo tipo para assegurar a execução adequada.

Se uma variável de entrada estiver marcada como opcional, ambas acima podem ser omitidas, pois pode receber valores Em branco .

Definir o valor predefinido de entradas opcionais como Em Branco

Variáveis de texto

Para definir o valor predefinido de uma variável de texto para Em branco:

• Defina a propriedade Tipo de dados como Texto.
• Ative o controlo Marcar como opcional.
• Certifique-se de que a propriedade Valor predefinido está vazia.

Entrada numérica em branco

Para definir o valor predefinido de uma variável numérica para Em branco:

• Defina a propriedade Tipo de dados como Número.
• Ative o controlo Marcar como opcional.
• Certifique-se de que a propriedade Valor predefinido está vazia.

Entrada booleano em branco

Para definir o valor predefinido de uma variável booleano para Em branco:

• Defina a propriedade Tipo de dados como Booleano.
• Ative o controlo Marcar como opcional.
• Certifique-se de que a propriedade Valor predefinido está definida como <Em Branco>.

Entrada de objeto personalizado em branco

Para definir o valor predefinido de um objeto personalizado para Em branco:

• Defina a propriedade Tipo de dados como Objeto personalizado.
• Ative o controlo Marcar como opcional.
• Certifique-se de que a propriedade Valor predefinido está definida como <Em Branco>. Para o fazer, selecione Editar junto da propriedade e, na janela Editar objeto personalizado, ative o controlo Editor JSON. Elimine todo o conteúdo e, em seguida, selecione Guardar.

Entrada de lista em branco

Para definir o valor predefinido de uma lista para Em branco:

• Defina a propriedade Tipo de dados como Lista.
• Ative o controlo Marcar como opcional.
• Certifique-se de que a propriedade Valor predefinido está definida como <Em Branco>. Para o fazer, selecione Editar junto da propriedade e, na janela Editar lista, ative o controlo Editor JSON. Elimine todo o conteúdo e, em seguida, selecione Guardar.

Entrada de tabela de dados em branco

Para definir o valor predefinido de uma tabela de dados para Em branco:

• Defina a propriedade Tipo de dados como Tabela de dados.
• Ative o controlo Marcar como opcional.
• Certifique-se de que a propriedade Valor predefinido está definida como <Em Branco>. Para o fazer, selecione Editar junto da propriedade e, na janela Editar tabela de dados, ative o controlo Editor JSON. Elimine todo o conteúdo e, em seguida, selecione Guardar.

Editar variáveis ao depurar um fluxo de ambiente de trabalho

Na consola de design, o Power Automate para computadores suporta a edição de tipos de variável comuns enquanto executa o fluxo no depurador. Atualmente, os tipos de dados suportados incluem valores, texto, numérico, datetime e booleano.

Como editar variáveis durante a execução de um fluxo no depurador

Existem dois métodos que pode utilizar para começar a modificar manualmente valores da variável de fluxo na consola de design.
Coloque um ponto de interrupção num determinado ponto antes de querer alterar o valor da variável de fluxo. Execute o fluxo e aguarde até que o fluxo seja colocado em pausa no ponto de interrupção selecionado. O painel de variáveis de fluxo encontra-se no canto inferior direito da consola — localize o nome da variável na lista e clique duas vezes junto dele para abrir o visualizador de variáveis.

Modificar um valor numérico:

Abra a variável que requer edição, coloque o cursor no campo de entrada e edite manualmente o valor numérico. Em alternativa, existem botões para contar para cima ou para baixo a partir do valor atual no lado direito da entrada no visualizador de variáveis. Note, não pode alterar o valor para algo diferente do numérico.

Modificar um valor de texto:

Abra a variável que requer edição, coloque o cursor no campo de entrada e edite manualmente o valor de texto. Existe uma caixa de verificação para encapsular texto no campo de entrada, o que facilita a visualização no editor. As variáveis de valor de texto aceitam números como entradas, mas tenha em consideração que, se modificar este valor e tentar passá-lo para uma ação com um parâmetro de entrada que só aceita um valor numérico, o fluxo emite um erro de exceção quando atingir esse ponto.

Modificar um valor booleano:

Abra a variável que requer edição, coloque o cursor no campo de entrada e, em seguida, edite manualmente o valor booleano. Utilize a lista pendente para selecionar true ou false.

Modificar um valor datetime:

Abra a variável que requer edição, coloque o cursor no campo de entrada e edite manualmente o valor datetime. Existe uma mensagem de aviso que aparece no visualizador de variáveis se introduzir um valor que não seja aceitável.

Problemas e limitações conhecidos

• Problema: os fluxos criados ou editados com o Power Automate para computadores, versão 2.14 ou posterior, são incompatíveis com versões mais antigas do Power Automate para computadores. Não é possível utilizar versões mais antigas do Power Automate para computadores para abrir ou executar estes fluxos.

  Soluções: nenhuma.