Usar operações de dados

  • Artigo

Neste artigo, você aprenderá sobre algumas operações de dados comuns no Power Automate, como redigir, unir, selecionar, filtrar matrizes, criar tabelas e analisar JSON. Use estas operações para manipular dados ao criar fluxos.

Observação

As diferentes seções deste artigo não estão relacionadas e não dependem umas das outras. As diferentes seções usam exemplos diferentes.

Aqui está um vídeo rápido sobre operações de dados.

Pré-requisitos

  • Acesso a Power Automate.
  • Uma ferramenta para enviar solicitações HTTP POST com uma matriz JSON para seu fluxo.

Usar a ação de composição

Use a ação Operação de Dados - Compor para não precisar inserir os mesmos dados várias vezes quando criar um um fluxo de nuvem. Neste exemplo, você precisa inserir uma matriz de dígitos ([0,1,2,3,4,5,6,7,8,9]) várias vezes ao criar seu fluxo. Você pode usar a ação de composição para salvar a matriz, conforme descrito no procedimento a seguir.

  1. Procure Redigir e selecione a ação Redigir - Operação de Dados.

Captura de tela da pesquisa e seleção da ação Redigir.

  1. Na caixa Entradas, insira a matriz que você deseja referenciar depois.

    Captura de tela da configuração da ação Redigir.

Dica

Para facilitar a localização do cartão Redigir mais tarde, renomeie-o selecionando o texto Redigir na barra de título do cartão e inserindo um nome fácil de lembrar.

Quando precisar acessar o conteúdo da ação de composição, siga as etapas a seguir.

  1. Adicione uma ação, como Unir - Operação de Dados.

  2. Selecione o controle ao qual você gostaria de adicionar o conteúdo salvo na ação de composição.

    A tela Adicionar conteúdo dinâmico a partir de aplicativos e conectores usados neste fluxo é aberta.

  3. Na guia Conteúdo dinâmico, na seção Compor, selecione Saídas.

    Captura de tela do uso de Saídas da ação Redigir.

Usar a ação de unir

Use a ação Operação de Dados - Unir para delimitar uma matriz com o separador de sua escolha. Por exemplo, o fluxo recebe uma solicitação da Web que inclui a seguinte matriz de endereços de email: ["d@example.com", "k@example.com", "dal@example.com"]. No entanto, o programa de email exige que os endereços sejam formatados uma única cadeia de caracteres, separada por ponto-e-vírgula. Você usa a ação Operação de Dados - Unir para alterar o delimitador de vírgula (,) para um ponto-e-vírgula (;) seguindo estas etapas:

  1. Adicione uma nova ação, pesquise Unir e, em seguida, selecione Operação de Dados - Unir.

    Captura de tela da pesquisa e seleção da ação Unir.

  2. Na caixa De, insira a matriz. Na caixa Unir com, digite um ponto-e-vírgula (;).

    Captura de tela da configuração da ação Unir.

  3. Salve seu fluxo e execute-o.

  4. Após a execução do fluxo, a saída da ação Operação de Dados – Unir será uma cadeia de caracteres com os endereços unidos por ponto e vírgula, conforme mostrado na captura de tela a seguir.

    Captura de tela da entrada de endereços separados por vírgulas, uma ação Unir com valor de ponto e vírgula e saída desses endereços separados por ponto e vírgula.

Usar a ação de seleção

Use a ação Operação de Dados – Selecionar para transformar a forma dos objetos em uma matriz. Por exemplo, você pode adicionar, remover ou renomear elementos em cada objeto em uma matriz.

Observação

Embora você possa adicionar ou remover elementos usando a ação de seleção, não pode alterar o número de objetos na matriz.

Neste exemplo, os dados entram no fluxo por meio de uma solicitação da Web neste formato:

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

Você deseja remodelar os dados recebidos, renomeando first como FirstName e last como FamilyName, e adicionar um novo membro chamado FullName que combina first e last (separados por um espaço).

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

Para fazer isso:

  1. Adicione o gatilho Quando uma solicitação HTTP é recebida ao seu fluxo.

  2. Selecione Use o conteúdo de amostra para gerar o esquema.

    Captura de tela da seleção da carga de amostra.

  3. Na caixa exibida, cole um exemplo de sua matriz dos dados de origem e, em seguida, selecione Concluído.

  4. Adicione a ação Operação de Dados – Selecionar e configure-a conforme mostrado na captura de tela a seguir.

    Configure a ação selecionar.

Usar a ação de filtro da matriz

Use a ação Filtrar matriz - Operações de Dados para reduzir o número de objetos em uma matriz a um subconjunto que corresponda aos critérios fornecidos.

Observação

  • Você não pode usar a ação da matriz de filtro para alterar a forma dos objetos na matriz.
  • O texto no qual você filtra diferencia maiúsculas de minúsculas.

Neste exemplo, você usa a ação de matriz de filtro nesta matriz:

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

Este exemplo cria uma nova matriz que apenas objetos em que first é definido como Eugenia.

  1. Encontre e adicione a ação Filtrar matriz para o seu fluxo.

  2. Configure a ação da matriz de filtro conforme mostrado na captura de tela a seguir.

    Captura de tela da seção De, a primeira linha é definida como Corpo. Na segunda linha, a primeira é igual a Eugenia.

  3. Salve e execute seu fluxo.

Usar a ação criar tabela CSV

Use a ação Criar tabela CSV - Operações de Dados para alterar a entrada da matriz do JSON para uma tabela com valores separados por vírgula (CSV). Você pode manter os cabeçalhos visíveis na saída CSV. Neste exemplo, você converte a seguinte matriz em uma tabela CSV:

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

  1. Localize, adicione e configure a ação Criar tabela CSV – Operações de Dados para parecer com a imagem a seguir.

    Captura de tela da configuração da ação Criar tabela CSV. O campo De está definido como Corpo e Colunas está definido como Automático.

    O token Corpo nesta imagem é obtido de uma ação Quando uma solicitação HTTP é recebida. No entanto, você pode obter a entrada para a ação Criar tabela CSV na saída de qualquer ação anterior no fluxo ou pode inseri-la diretamente na caixa De.

  2. Salve e execute seu fluxo.

    Quando seu fluxo é executado, a ação Criar tabela CSV exibe a saída mostrada na captura de tela a seguir.

    Captura de tela da saída da ação Criar tabela CSV, mostrando

Usar a ação criar tabela HTML

Use a ação Criar tabela HTML - Operações de Dados para alterar uma entrada da matriz JSON para uma tabela HTML. Você pode manter os cabeçalhos visíveis na saída HTML.

Para fazer isso, siga as etapas na seção Usar a ação Criar tabela CSV anterior para criar uma tabela CSV. Use a ação Criar tabela HTML - Operação de Dados em vez de Criar tabela CSV.

Dica

Se você pretende enviar a tabela HTML por email, lembre-se de selecionar IsHtml na ação de email.