Utilizar operações de dados

As operações de dados permitem-lhe manipular dados enquanto cria os seus fluxos na cloud. Use-os para criar, ordenar e reorganizar dados usando atalhos que o ajudam a alcançar os resultados de forma mais fácil e rápida. Esta abordagem poupa-lhe 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 o ajudar a utilizá-la no seu fluxo na 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 utilizar as operações de dados descritas neste artigo, precisa de abrir o estruturador 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ã seguintes usam o novo designer, mas os passos são semelhantes em ambos os designers. Obtenha mais informações (com exemplos) em Identificar as diferenças entre o novo estruturador e o estruturador clássico.

Criar um novo fluxo na nuvem

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.

    Captura de ecrã dos mosaicos Começar do zero.

  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 na nuvem existente

Para selecionar um fluxo de nuvem 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ção de Dados - Compor para evitar introduzir os mesmos dados várias vezes enquanto concebe um fluxo na nuvem. 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 de composição

  1. Apresente um fluxo de cloud no estruturador.

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

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

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

    Captura de ecrã da ação Compor — Operação de Dados.

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

    Configure a ação “Compose”.

  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 os resultados da ação Compose

Utilize 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 associação recebe uma matriz e associa-a numa única cadeia com um separador da sua escolha.

  1. Apresente um fluxo de cloud no estruturador.

  2. No seu fluxo, adicione uma ação selecionando 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.

    Utilize as saídas da ação Compor.

  6. No campo Join 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. Apresente um fluxo de cloud no estruturador.

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

    Participe na ação.

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

    Configure a ação Associar.

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

  5. Após a execução do seu fluxo, a saída da ação Operação de Dados — Unir é uma cadeia de caracteres com os endereços separados por ponto e vírgula, conforme mostrado na captura de ecrã seguinte.

    Captura de ecrã da entrada de endereços separados por vírgulas, um Associar com valor de ponto e vírgula e saída desses endereços separados por pontos e vírgulas.

Utilize a ação de seleção

Use a Operação de Dados – Selecionar a ação para alterar a forma dos objetos num array. 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 entram no seu fluxo através de um pedido da Web neste formato:

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

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

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

Para o fazer:

  1. Apresente 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. Adicione o acionador Quando um pedido HTTP é recebido ao seu fluxo.

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

    Captura de ecrã da seleção do payload de exemplo.

  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.

    Configurar a ação de seleção.

    > 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 Filtrar matriz

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 Filtrar matriz para alterar a estrutura dos objetos na matriz.
  • O texto no qual usa o filtro é sensível a maiúsculas e minúsculas.

Neste exemplo, o Utilizador utiliza 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. Apresente um fluxo de cloud no estruturador.

  2. Encontre e adicione a ação Filter array ao seu fluxo.

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

    Captura de ecrã na secção De, a primeira linha é definida como Corpo. Na segunda linha, a primeira é definida como Eugenia.

  4. Guarde e execute o fluxo.

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. Mantém 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. Apresente 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.

    Captura de ecrã de Configurar a ação Criar tabela CSV. De está definido como Corpo e Colunas está definido como Automática.

    O token Corpo nesta imagem provém de uma ação Quando um pedido HTTP é recebido . No entanto, podes obter a entrada da ação Criar tabela CSV a partir da saída de qualquer ação anterior no teu fluxo, ou podes inseri-la diretamente na caixa From .

  3. Guarde e execute o fluxo.

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

    Captura de ecrã do resultado da ação Criar tabela CSV, que mostra firstname,familyname na primeira linha, seguidos de Eugenia,Lopez e Elizabeth,Moore.

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. Mantém 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.