Usar operações de dados com o Power Automate

Neste passo a passo, conheça algumas operações de dados comuns do Power Automate — como compor, unir, selecionar, filtrar matrizes, criar tabelas e analisar o JSON — disponíveis para manipular dados ao criar fluxos.

Pré-requisitos

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

Usar a ação de composição

Use a ação Operação de Dados - Compor ação para evitar a necessidade de inserir os mesmos dados várias vezes ao projetar 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. Pesquise Compor e, em seguida, selecione a ação Operação de Dados - Compor.

    Procure e selecione a ação redigir.

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

    Configure a ação redigir.

Tip

Para facilitar a localização do cartão Compor mais tarde, renomeie-o selecionando o texto Compor 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 estas etapas:

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

  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.

    Use a saída da ação redigir.

Usar a ação de junção

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ê usará 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.

    Procure e selecione a ação ingressar.

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

    Configure a ação ingressar.

  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 imagem a seguir.

    Entrada de endereços separados por vírgulas, uma união 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.

Note

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.

    Selecione o conteúdo 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 imagem a seguir.

    Configure a ação selecionar.

    Captura de tela mostrando a ação de seleção. De é definido como Corpo. Na seção Mapa, FirstName é definido como primeiro, FamilyName é definido como último e FullName é definido como primeiro e último, separados por um espaço.:::image-end:::

    Tip

    A saída da ação de seleção é uma matriz que contém os objetos recém-modelados. Você poderá usar essa matriz em qualquer outra ação, como a ação de composição, abordada anteriormente.

Usar a ação de filtro da matriz

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

Note

  • 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" } ]

para criar uma nova matriz contendo apenas objetos em que first é definido como Eugenia.

Vamos fazer isso.

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

  2. Configure a ação filtrar matriz conforme mostrado na imagem a seguir.

    Na seção De, a primeira linha é definida como Corpo. Na segunda linha, a primeira é definida como Eugenia.

  3. Salve e execute seu fluxo.

    Você pode usar PostMan para gerar uma solicitação da Web que envia uma matriz JSON para o fluxo.

  4. Quando seu fluxo é executado, a saída tem a aparência da seguinte matriz. Note que apenas objetos nos quais first está definido como Eugenia estão incluídos na saída da ação.

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

Usar a ação criar tabela CSV

Use a ação Operação de Dados – Criar tabela CSV 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 Operação de Dados – Criar tabela CSV para parecer com a imagem a seguir.

    Configure a ação criar tabela CSV. De é definido como Corpo, e Colunas é 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 o fluxo é executado, a ação Criar tabela CSV exibe a saída mostrada na imagem a seguir.

Saída da ação de criar tabela CSV, mostrando "primeiro,último" na primeira linha seguido de "Eugenia,Lopez" e "Elizabeth,Moore".

Usar a ação criar tabela HTML

Use a ação Operação de Dados - Criar tabela HTML 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 anterior para criar uma tabela CSV, mas use a ação Operação de Dados - Criar tabela HTML em vez de Criar tabela CSV.

Tip

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