Utilizar operações de dados

As operações de dados permitem-lhe manipule dados enquanto compila os seus fluxos de cloud. Pode usá-los para criar, ordenar e reorganizar dados usando atalhos para ajudar a alcançar os seus resultados mais fácil e rapidamente, o que pode economizar tempo e esforço. Quando utiliza operações de dados, pode aumentar a eficiência dos seus fluxos, reduzir o número de erros e facilitar a análise de dados.

Este artigo explica como pode usar operações de dados, como compor, para criar uma única saída a partir de várias entradas, incluindo expressões. Também pode usar operações de dados para unir ou selecionar dados, filtrar matrizes, criar tabelas e analisar JSON. Neste artigo, cada secção fornece uma breve descrição da operação de dados, seguida de um procedimento passo a passo para ajudar a usá-la no seu fluxo de cloud.

Pré-requisitos

• Acesso ao Power Automate.
• Uma ferramenta para enviar pedidos de HTTP POST com uma matriz JSON para o seu fluxo.
• Um fluxo de cloud novo ou existente ao qual pode adicionar operações de dados.

Apresentar um fluxo de cloud no estruturador

Para usar as operações de dados descritas neste artigo, precisa de ter o estruturador aberto com o seu fluxo de cloud novo ou existente.

O Power Automate permite-lhe usar o novo estruturador ou o estruturador clássico para configurar o seu fluxo de cloud. As capturas de ecrã neste artigo usam o novo estruturador, mas os passos são semelhantes em ambos os estruturadores. Obtenha mais informações (com exemplos) em Identificar as diferenças entre o novo estruturador e o estruturador clássico.

Criar um novo fluxo de cloud

Para criar um novo fluxo de cloud, siga estes passos.

1. Inicie sessão no Power Automate.

2. No painel de navegação à esquerda, selecione Criar.

3. Selecione um dos tipos de fluxos de cloud em Começar do zero: Fluxo de cloud automatizado, Fluxo de cloud instantâneo, Fluxo de cloud agendado ou Descrever para estruturar.

   

4. Para Fluxo de cloud automatizado, Fluxo de cloud instantâneo e Fluxo de cloud agendado, siga as instruções e selecione Criar.

5. Para Descrever para estruturar:

   1. Introduza uma descrição do fluxo que pretende criar e selecione Submeter ou selecione a partir das descrições de fluxo sugeridas geradas por IA.

   2. Se estiver satisfeito com o fluxo sugerido, selecione Manter e continuar.

   3. Reveja as suas aplicações e serviços ligados e, em seguida, selecione Criar fluxo.

      O fluxo abre-se no estruturador.

Selecionar um fluxo de cloud

Para selecionar um fluxo de cloud existente, siga estes passos.

1. Inicie sessão no Power Automate.

2. No painel de navegação do lado esquerdo, selecione Os meus fluxos.

3. No separador Fluxos de cloud, selecione o fluxo que pretende abrir.

4. Na barra de comando no topo, selecione Editar.

   O fluxo abre-se no estruturador.

Utilizar a ação de composição

Utilize a ação Operações de Dados – Compor para evitar a necessidade de introduzir dados os mesmos dados várias vezes à medida que concebe um fluxo de cloud. Neste exemplo, é necessário introduzir uma série de dígitos, [0,1,2,3,4,5,6,7,8,9], várias vezes enquanto desenha o seu fluxo. Pode utilizar a ação de composição para salvar a matriz, conforme descrito no procedimento seguinte.

Adicionar a ação Compor

1. Apresentar um fluxo de cloud no estruturador.

2. No seu fluxo, adicione uma ação ao selecionar o sinal de adição (+).

3. No campo de pesquisa Adicionar uma ação, escreva compor.

4. Em Operação de Dados, selecione Compor.

   

5. No campo Entradas, introduza a matriz que pretende referenciar mais tarde.

   

6. Feche o painel de configuração ao selecionar as setas à esquerda (<<) no canto superior direito.

   Sugestão

   Para tornar o cartão Compor mais fácil de encontrar mais tarde, mude o seu nome, selecionando o texto Compor na barra de título do cartão e introduzindo um nome que seja fácil de lembrar.

Utilize as saídas da ação Compor

Use os conteúdos da ação Compor que criou nesta secção numa nova ação. Neste exemplo, usa as saídas da ação Compor numa ação Operação de Dados — Unir. A ação de união pega numa matriz e une-a numa única cadeia com um separador de sua escolha.

1. Apresentar um fluxo de cloud no estruturador.

2. No seu fluxo, adicione uma ação ao selecionar o sinal de adição (+).

3. No campo de pesquisa Adicionar uma ação, escreva unir.

4. Em Operação de Dados, selecione Unir.

5. No campo De, selecione o relâmpago e, em seguida, selecione o valor dinâmico Saídas. Outputs aparece no campo De.

   

6. No campo Participar com, introduza uma vírgula (,) ou o separador desejado.

7. Feche o painel de configuração ao selecionar as setas à esquerda (<<) no canto superior direito.

Utilize a ação de associação

Utilize a ação Operação de Dados - Associar para delimitar uma matriz com o separador à sua escolha. Por exemplo, o seu fluxo recebe um pedido Web que inclui a seguinte matriz de endereços de e-mail: ["d@example.com", "k@example.com", "dal@example.com"]. No entanto, o programa de e-mail precisa que os endereços sejam formatados numa cadeia única, separada por ponto e vírgula. Utilize a ação Operação de Dados - Associar para alterar o delimitador de vírgulas (,) para um ponto e vírgula (;) ao seguir estes passos:

1. Apresentar um fluxo de cloud no estruturador.

2. Adicione uma nova ação, procure por Associar e, em seguida, selecione Operação de Dados - Associar.

   

3. No campo De, introduza a matriz e na caixa Associar com, introduza um ponto e vírgula (;).

   

4. Guarde o fluxo e volte a executá-lo.

5. Após as suas execuções de fluxo, a saída da ação Operação de Dados — Participar é uma cadeia com os endereços ligados por pontos e vírgulas, como mostrado na captura de ecrã seguinte.

   

Utilize a ação de seleção

Utilize a ação Operação de Dados – Selecionar para transformar a forma dos objetos numa matriz. Por exemplo, pode adicionar, remover ou mudar o nome de elementos em cada objeto numa matriz.

Nota

Apesar de poder adicionar ou remover elementos ao usar a ação de seleção, não pode alterar o número de objetos na matriz.

Neste exemplo, os dados introduzem o seu fluxo através de um pedido web neste formato:

[ { "first": "Eugenia", "last": "Lopez" }, { "first": "Elizabeth", "last": "Moore" } ]

Pretende reformular os dados que chegam, renomeando first para FirstName e last para FamilyName e adicionando um novo membro chamado FullName que combina first e last (separado com um espaço).

[ { "FirstName": "Eugenia", "FamilyName": "Lopez", "FullName": "Eugenia Lopez" }, { "FirstName": "Elizabeth", "FamilyName": "Moore", "FullName": "Elizabeth Moore" } ]

Para:

1. Apresentar um fluxo de cloud no estruturador.

2. Elimine o acionador existente clicando com o botão direito do rato no acionador e selecionando Eliminar ou selecionando as reticências verticais (⋮) no painel de configuração, e, em seguida, selecionando Eliminar.

3. 1. Adicione o acionador Quando um pedido HTTP é recebido ao seu fluxo.

4. Selecione Utilize a amostra de payload para gerar o esquema.

   

5. Na caixa que aparece, cole uma amostra da sua matriz de dados de origem e, em seguida, selecione Concluído.

6. Adicione a ação Operação de Dados – Selecionar e, em seguida, configure-a como mostrado na captura de ecrã seguinte.

   

   > A saída da ação de seleção é uma matriz que contém os objetos formados recentemente. Pode, em seguida, utilizar esta matriz em qualquer outra ação, como na ação Compor, referida anteriormente.

Utilize a ação de matriz de filtro

Utilize a ação Operação de Dados - Matriz de filtro para reduzir o número de objetos numa matriz para um subconjunto que corresponde aos critérios fornecidos.

Nota

• Não é possível utilizar a ação da matriz do filtro para alterar a forma dos objetos na matriz.
• O texto no qual usa o filtro é sensível a maiúsculas e minúsculas.

Neste exemplo, utiliza-se a ação da matriz do filtro nesta matriz:

[ { "first": "Eugenia", "last": "Lopez" }, { "first": "Elizabeth", "last": "Moore" } ]

Este exemplo cria uma nova matriz que contém apenas objetos onde first está definido como Eugenia.

1. Apresentar um fluxo de cloud no estruturador.

2. Encontre e, em seguida, adicione a ação Matriz do filtro ao seu fluxo.

3. Na secção Filtrar Consulta, configure a ação de matriz de filtro. Seguindo o exemplo nesta secção, selecione first>é igual a>Eugenia.

   

4. Guarde o fluxo e volte a executá-lo.

Utilize a ação de criação de tabela CSV

Utilize a ação Operação de Dados - Criar tabela CSV para alterar uma entrada de matriz JSON para uma tabela (CSV) com valores separados por vírgulas. Pode, opcionalmente, manter os cabeçalhos visíveis na saída CSV. Neste exemplo, converte-se a seguinte matriz numa tabela CSV:

[ { "first": "Eugenia", "last": "Lopez" }, { "first": "Elizabeth", "last": "Moore" } ]

1. Apresentar um fluxo de cloud no estruturador.

2. Encontre, adicione e, em seguida, configure a ação Operação de Dados – Criar tabela CSV para assemelhar-se à imagem seguinte.

   

   O token Corpo nesta imagem é proveniente de uma ação Quando um pedido HTTP é recebido, no entanto, pode obter a entrada da ação Criar tabela CSV a partir da saída de qualquer ação anterior no seu fluxo, ou pode introduzi-lo diretamente na caixa De.

3. Guarde o fluxo e volte a executá-lo.

   Quando o fluxo é executado, a ação Criar tabela CSV apresenta a saída mostrada na seguinte captura de ecrã.

   

Utilize a ação de criação de tabela HTML

Utilize a ação Operação de Dados - Criar tabela HTML para alterar uma entrada de matriz JSON para uma tabela HTML. Pode, opcionalmente, manter os cabeçalhos visíveis na saída HTML.

Para isso, siga os passos na secção Utilizar a ação Criar tabela CSV, mas utilize a ação Operação de Dados — Criar tabela HTML em vez de Criar tabela CSV.

Sugestão

Se pretender enviar a tabela HTML por e-mail, lembre-se de selecionar IsHtml na ação do e-mail.

Informações relacionadas

• Treinamento: Use Dataverse gatilhos e ações em Power Automate (módulo)
• Formação: Integrar fluxos do Power Automate e Dataverse (percurso de aprendizagem)