Introdução a expressões

  • 3 minutos

Para escrever uma expressão no Power Automate, selecione qualquer ação que tenha uma entrada e, em seguida, selecione o campo de entrada para abrir o menu de opções de fórmula. Observe que você verá um botão de opção azul aparecendo no lado direito do campo de entrada. A metade superior do botão mostra um ícone de raio e a metade inferior mostra fx. A metade inferior desse botão abre o editor de expressões. A seleção do botão fx abre o pop-up de expressão que é mostrado na imagem abaixo. Você também pode digitar uma barra ou "/" no campo de entrada para exibir as opções como uma seleção suspensa. De qualquer forma, você chega ao editor de expressões.

Captura de tela da abertura do menu Conteúdo dinâmico e da seleção de Expression.

Não se confunda: embora o campo de entrada mostre as opções Função e Conteúdo dinâmico abaixo dele, você cria uma expressão que usa funções de Aplicativos Lógicos do Azure. Você também pode adicionar qualquer conteúdo dinâmico disponível nesse fluxo à expressão à medida que o cria.

A caixa de fórmula é um local para digitar a expressão combinando uma ou mais funções. Antes de aprender sobre os diferentes tipos de funções e seu uso, existem alguns pontos em comum que você deve saber. Os nomes das funções não diferenciam maiúsculas de minúsculas.

Dica

Na captura de tela acima, usamos um gatilho Disparar um fluxo manualmente e uma ação Compor. Isso permite que você tenha uma configuração simples para escrever e testar suas expressões sem se preocupar com outras entradas ou ações. Use essa configuração para acompanhar esse aplicativo ou sempre que quiser experimentar algo novo.

Ao inserir uma função na barra de fórmulas, você verá um pop-up com sugestões de sintaxe.

Captura de tela de pop-up com sugestões de sintaxe.

Neste local, você pode ver que a função convertFromUtc tem duas entradas obrigatórias e uma entrada opcional.

  • Timestamp é obrigatório e precisa ser uma cadeia de caracteres.

  • destinationTimeZone é obrigatório e precisa ser uma cadeia de caracteres.

  • format? é opcional e precisa ser uma cadeia de caracteres.

    Observação

    O ponto de interrogação no final de format indica que se trata de uma entrada opcional.

Depois que você insere o carimbo de data/hora como uma cadeia de caracteres e digita uma vírgula, o fluxo requer o destinationTimeZone:

Captura de tela do prompt para destinationTimeZone.

Isso pode parecer complicado. O que ele deseja para o fuso horário? Se observar o pop-up, você verá que ele fornece uma URL que pode ser copiada e faz referência à lista de valores de fuso horário. Seguindo o link, você obtém a cadeia de caracteres para o Nome do fuso horário de destinationTimeZone. Com essa informação, agora podemos concluir a expressão.

convertFromUtc('2024-02-09T12:00:00Z','Eastern Standard Time')

Depois que a expressão for concluída, selecione o botão Adicionar, na parte inferior do editor de expressões, para salvar as alterações. Certifique-se de selecionar Adicionar ao editar uma expressão. Se clicar fora das entradas, você perderá as alterações. O Power Automate não tem Salvamento Automático.

Observação

Se estiver usando o designer herdado, você selecionará Atualizar para salvar sua fórmula.

Com a primeira expressão concluída, agora você pode selecionar Testar no canto superior direito. Em seguida, selecione Testar>Executar fluxo>Concluído.

Depois que o teste for concluído, você verá a barra verde na parte superior informando: "Seu fluxo foi executado com êxito". Expanda a ação Compor e verá o resultado da nossa fórmula convertendo a data e a hora no novo fuso horário em SAÍDAS.

Captura de tela da barra de fluxo bem-sucedido com a mensagem Seu fluxo foi executado com êxito.

Esse mesmo processo ajudará a ver a saída de quaisquer expressões de teste que você criar.