Partilhar via

Armazenar e gerir valores em variáveis

Este artigo mostra como criar e trabalhar com variáveis para armazenar valores nos seus fluxos de cloud. Por exemplo, as variáveis podem ajudá-lo a monitorizar o número de vezes que um ciclo é executado. Para iterar sobre uma matriz ou verificar uma matriz por um item específico, pode utilizar uma variável para referenciar o item de matriz "aplicar a cada" do número de índice.

Pode criar variáveis para tipos de dados como número inteiro, flutuar, booleano, cadeia, matriz e objeto. Depois de criar uma variável, pode executar outras tarefas, por exemplo:

  • Obter ou referenciar o valor da variável.
  • Aumentar ou diminuir a variável por um valor constante, também conhecido como incremento e diminuição.
  • Atribuir um valor diferente à variável.
  • Inserir ou anexar o valor da variável como o último item numa cadeia ou matriz.

As variáveis existem e são globais apenas dentro do fluxo de cloud que as cria. Além disso, persistem em todas as iterações de ciclo dentro do fluxo.

Quando referencia uma variável, use o nome da variável como token, não o nome da ação, que é a forma habitual de referenciar as saídas de uma ação.

Aviso

Por predefinição, cada iteração nos ciclos "aplicar a cada" é executado em sequência. Pode executar as iterações de ciclo paralelamente para melhorar o desempenho. Se utilizar variáveis nos ciclos "aplicar a cada", tem de executar as iterações de ciclo em sequência se for importante que as variáveis de ciclo obtenham resultados previsíveis.

Pré-requisitos

Antes de poder adicionar ações para criar e trabalhar com variáveis, o seu fluxo deve começar com um acionador. Não é possível utilizar um dispositivo móvel para adicionar variáveis.

Nota

  • O Power Automate usa o estruturador clássico de fluxos de cloud ou o novo estruturador moderno com capacidades do Copilot. Para identificar o estruturador que está a usar, vá para a secção Nota em Explorar o estruturador de fluxos de cloud.
  • Quando alterna entre o estruturador clássico e o novo estruturador, é-lhe pedido para guardar o seu fluxo. Não é possível guardar e alternar até que todos os erros estejam resolvidos.

Inicializar uma variável

Pode criar uma variável e declarar o seu tipo de dados e valor inicial, tudo dentro de uma ação no seu fluxo. Só é possível declarar variáveis a nível global, não dentro de âmbitos, condições e ciclos.

  1. Inicie sessão no Power Automate.

  2. Crie ou abra um fluxo de cloud.

  3. Sob o passo onde pretende adicionar uma variável, siga um destes passos.

    • Para adicionar uma ação abaixo do último passo, selecione o sinal de adição (+).
    • Para adicionar uma ação entre passos, mova o ponteiro do dispositivo de entrada sobre a seta de ligação, para que apareça o sinal de adição (+). Selecione o sinal de adição (+) >Adicionar uma ação.

  4. Na caixa de pesquisa, sob Adicionar uma ação, introduza inicializar variável como o filtro.

  5. Na lista Ações, selecione Inicializar variável – Variável.

  6. Forneça as informações que se seguem sobre a sua variável.

    Property Obrigatório Valor Descrição
    Nome Sim < variable-name> O nome da variável a inicializar.
    Tipo Sim < variable-type> O tipo de dados da variável.
    Valor Não < start-value> O valor inicial da sua variável.
    Dica: embora opcional, defina este valor como uma melhor prática para que saiba sempre o valor inicial da sua variável.

    Exemplo: Captura de ecrã do exemplo de parâmetros de variável.

  7. Adicione as outras ações que pretende. Quando tiver terminado, selecione Guardar.

Nota

Embora a ação Inicializar variável tenha uma secção variable estruturada como uma matriz, a ação só pode criar uma variável de cada vez. Cada nova variável requer uma ação Iniciar variável individual.

Exemplos de outros tipos de variáveis

Variável de cadeia


   "name": "myStringVariable",
   "type": "String",
   "value": "lorem ipsum"

Variável booleana

   "name": "myBooleanVariable",
   "type": "Boolean",
   "value": false

Matriz com números inteiros

   "name": "myArrayVariable",
   "type": "Array",
   "value": [1, 2, 3]

Matriz com cadeias

   "name": "myArrayVariable",
   "type": "Array",
   "value": ["red", "orange", "yellow"]

Obter o valor da variável

Para obter ou referenciar os conteúdos de uma variável, pode utilizar a função variables() no estruturador do Power Automate.

Por exemplo, esta expressão obtém os itens da variável de matriz utilizando a função variables(). A função string() obtém os conteúdos da variável em formato de cadeia: "1, 2, 3, red"

@{string(variables('myArrayVariable'))}

Incrementar variável

Para aumentar ou incrementar uma variável por um valor constante, adicione a ação Incrementar variável ao seu fluxo.

Nota

A ação Incrementar variável funciona apenas com variáveis inteiras e flutuantes.

  1. No estruturador do Power Automate, sob o passo em que pretende aumentar uma variável existente, selecione o sinal de adição (+).

    Para adicionar uma ação entre passos, mova o ponteiro do dispositivo de entrada sobre a seta de ligação até que apareça o sinal de adição (+). Selecione o sinal de adição (+) >Adicionar uma ação.

  2. Na caixa de pesquisa, introduza incrementar variável como filtro.

  3. Na lista Ações, selecione Incrementar variável – Variável.

  4. Forneça estas informações para incrementar a sua variável:

    Propriedade Necessário Valor Descrição
    Nome Sim < variable-name> O nome para a variável a incrementar
    Valor Não < increment-value> O valor utilizado para incrementar a variável. O valor predefinido é um.

    Dica: embora opcional, defina este valor como uma melhor prática para que saiba sempre o valor específico para incrementar a sua variável.

    Exemplo:

    Captura de ecrã do exemplo da ação Incrementar variável.

  5. Quando tiver terminado, selecione Guardar na barra de ferramentas do estruturador.

Exemplo: Criar contador de ciclos

As variáveis são comumente usadas para contar o número de vezes que um ciclo é executado. Este exemplo mostra como criar e usar variáveis para esta tarefa criando um ciclo que conta os anexos num e-mail.

  1. No Power Automate, crie um fluxo de cloud e adicione um acionador que verifica novos e-mails e quaisquer anexos.

    Este exemplo utiliza o acionador do Office 365 Outlook para Quando recebe um novo e-mail (V3). Só pode configurar este acionador quando o e-mail tiver anexos. No entanto, pode utilizar qualquer conector que verifique novos e-mails com anexos, como o conector do Outlook.com.

  2. No acionador, para verificar se há anexos e passar esses anexos para o seu fluxo, selecione Sim para estas propriedades:

    • Incluir Anexos
    • Apenas com Anexos

  3. Adicione a ação Inicializar variável com os seguintes valores:

    • Nome: Contagem
    • Tipo: Número inteiro
    • Valor: 0 (valor inicial)

  4. Adicione um ciclo aplicar a cada para percorrer os anexos.

    1. Sob a ação Iniciar variável, selecione Novo passo.
    2. Na caixa de pesquisa, introduza aplicar a cada como o filtro de pesquisa e selecione Aplicar a cada.

    Captura de ecrã de adicionar um ciclo Aplicar a cada – Controlo.

  5. No ciclo, selecione dentro da caixa Selecionar uma saída dos passos anteriores. Quando aparecer a lista de conteúdos dinâmicos, selecione Anexos.

    A propriedade Anexos passa uma matriz, que tem todos os anexos de e-mail do e-mail para o seu ciclo.

  6. No ciclo Aplicar a cada, selecione o sinal de adição (+) para Adicionar uma ação.

  7. Na caixa de pesquisa, introduza incrementar variável como filtro.

  8. Na lista de ações, selecione Incrementar variável.

    Nota

    A ação Incrementar variável tem de aparecer dentro do ciclo.

  9. Na ação Incrementar variável, na lista Nome, selecione a variável Contagem.

  10. Sob o ciclo, adicione qualquer ação que lhe envie o número de anexos. Na sua ação, inclua o valor da variável Contagem. Por exemplo, na seguinte captura de ecrã, Enviar um e-mail (V2) envia o número de anexos:

    Captura de ecrã da adição de uma ação que envia resultados.

  11. Na barra de ferramentas do estruturador, selecione Guardar.

Diminuir variável

Para diminuir uma variável por um valor constante, siga os passos para aumentar uma variável, exceto que encontra e seleciona a ação Diminuir variável. Esta ação funciona apenas com variáveis de números inteiros e flutuantes.

Eis as propriedades para a ação Diminuir variável:

Propriedade Necessário Valor Descrição
Nome Sim < variable-name> O nome para a variável a diminuir
Valor Não < increment-value> O valor utilizado para diminuir a variável. O valor predefinido é um.

Dica: embora opcional, defina este valor como uma melhor prática para que saiba sempre o valor específico para diminuir a sua variável.

Definir variável

Para atribuir um valor diferente a uma variável existente, siga os passos para aumentar uma variável, exceto que:

  1. Em vez disso, localiza e seleciona a ação Definir variável.

  2. Forneça o nome e o valor da variável que pretende atribuir. Tanto o novo valor como a variável têm de ter o mesmo tipo de dados. O valor é necessário porque esta ação não tem um valor predefinido.

Eis as propriedades para a ação Definir variável:

Propriedade Necessário Valor Descrição
Nome Sim < variable-name> O nome para a variável a alterar
Valor Sim < new-value> O valor a que pretende atribuir a variável. Ambos têm de ter o mesmo tipo de dados.

Nota

A menos que esteja a incrementar ou a diminuir variáveis, mudar variáveis dentro de ciclos pode criar resultados inesperados se executar ciclos em paralelo. Para estes casos, tente definir o seu ciclo para ser executado sequencialmente, que é a predefinição.

Anexar à variável

Para variáveis que armazenam cadeias ou matrizes, pode inserir ou anexar o valor de uma variável como o último item nessas cadeias ou matrizes. Pode seguir os passos para aumentar uma variável, exceto que segue estes passos:

  1. Localize e selecione uma destas ações com base no facto de a sua variável ser uma cadeia ou uma matriz.

    • Anexar a variável de cadeia
    • Anexar a variável de matriz

  2. Forneça o valor a anexar como o último item na cadeia ou matriz. Este valor é obrigatório.

Eis as propriedades para as ações Anexar a...:

Propriedade Necessário Valor Descrição
Nome Sim < variable-name> O nome para a variável a alterar
Valor Sim < append-value> O valor que quer anexar, que pode ter qualquer tipo

Conectores do Power Automate