Ações de controle de fluxo
O controle de fluxo refere-se ao ato de controlar a ordem em que as ações e subfluxos são executados. O Power Automate permite que você implemente o controle de fluxo por meio das ações de controle de fluxo.
Rótulos são usados para criar pontos de referência para a ação Acessar que altera o ponto de execução do fluxo da área de trabalho. O exemplo a seguir direciona o fluxo a um rótulo anterior no fluxo para repetir uma série de ações.
A ação Executar subfluxo interrompe o subfluxo no qual é colocado e executa outro subfluxo. Quando o segundo subfluxo é concluído, o fluxo volta ao subfluxo original para continuar em execução. O exemplo a seguir executa o subfluxo Calcular Desconto várias vezes durante o tempo de execução do fluxo, para evitar a repetição do mesmo código.
Para organizar visualmente suas ações em grupos e facilitar o gerenciamento, coloque-as entre uma ação Region e uma ação End region e dê um nome distinto à região.
Essas ações não têm nenhum efeito funcional, mas ajudam a agrupar e organizar ações para fins de manutenção e legibilidade. Por exemplo, você pode recolher e expandir uma região para ajudar a focar a atenção onde for necessário.
Você só pode usar as ações Region e End region como pares, e elas devem pertencer ao mesmo escopo para bloquear corretamente. Se uma das duas ações pertencer a outro grupo de ações, como um loop ou uma condicional, as ações não poderão formar uma região adequada.
Observação
Se você criar várias regiões em um subfluxo, não haverá mapeamento predeterminado entre ações específicas Region e End region. Em vez disso, a última ação Region tentará formar um par com a primeira ação End region disponível na sequência.
Comment
Comentário do usuário.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Comment | Sim | Valor do texto | Comentário do usuário |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Terminar
Significa o fim de um bloco.
Parâmetros de entrada
Essa ação não requer entradas.
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
End region
Marca o fim de um grupo de ações.
Parâmetros de entrada
Essa ação não requer entradas.
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Sair de subfluxo
Sai do subfluxo atual e retorna ao ponto em que foi chamado.
Parâmetros de entrada
Essa ação não requer entradas.
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Obter último erro
Recupera o último erro ocorrido no fluxo.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Limpar erro | N/A | Valor booliano | Falso | Depois que o erro for armazenado na variável, ele será limpo para que, na próxima vez que o erro for recuperado, ele não recupere o mesmo valor de erro |
Variáveis produzidas
| Argumento | Type | Description |
|---|---|---|
| LastError | Erro | Os detalhes do último erro ocorrido no fluxo |
Exceções
Essa ação não inclui exceções.
Acesse
Transfere o fluxo de execução para outro ponto, indicado por um rótulo.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Go to label | Não | Valor do texto | Rótulo no fluxo |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Label
Age como o destino de uma instrução 'go to'.
A partir da versão 2.46, os rótulos também podem ser usados em um escopo diferente da ação Ir para correspondente (por exemplo, em um bloco condicional), exceto blocos de erro, loops e/ou outros subfluxos.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Label name | Não | Valor do texto | Rótulo no programa |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Erro no bloco
Marca o início de um bloco para manipular erros de ações.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Name | Não | Valor do texto | O nome do Bloco de Exceções somente para fins de Visual. | |
| Capturar erros de lógica inesperados | N/A | Valor booliano | Falso | Expanda o escopo de tratamento de erros, além de capturar erros de lógica no fluxo, por exemplo, dividir um número por zero ou tentar acessar um item de uma posição fora dos limites. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Região
Marca o início de um grupo de ações.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Name | Sim | Valor do texto | O nome da região. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Executar subfluxo
Executar um subfluxo especificando os argumentos necessários.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Subflow name | No | Subfluxo | O nome do subfluxo a ser chamado | |
| Entrada como expressão | N/A | Valor booliano | False | Defina se a entrada deve ser tratada como uma expressão. Se habilitada, variáveis e expressões podem ser usadas para determinar dinamicamente o subfluxo durante o tempo de execução. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Parar fluxo
Termina o fluxo.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| End flow | Não | Com sucesso, com mensagem de erro | Com êxito | Encerrar a execução do fluxo com êxito ou com um erro |
| Error message | Não | Valor do texto | A mensagem de erro para retornar ao chamador do fluxo ao sair |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Wait
Suspende a execução do fluxo por um número de segundos especificado.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Duration | Não | Valor numérico | Período de tempo em segundos |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.