Compartilhar via


Usar operações de dados

As operações de dados permitem que você manipule dados, conforme você criar seus fluxos da nuvem. Você pode usá-los para criar, classificar e reorganizar dados usando atalhos para ajudá-lo a alcançar seus resultados com mais facilidade e rapidez, o que pode economizar tempo e esforço. Ao usar operações de dados, você pode aumentar a eficiência de seus fluxos, reduzir o número de erros e facilitar a análise de dados.

Este artigo explica como você pode usar operações de dados, como compor, para criar uma única saída a partir de várias entradas, incluindo expressões. Você também pode usar operações de dados para unir ou selecionar dados, filtrar matrizes, criar tabelas e analisar JSON. Neste artigo, cada seção fornece uma breve descrição da operação de dados, seguida por um procedimento passo a passo para ajudá-lo a usá-la em seu fluxo da nuvem.

Pré-requisitos

  • Acesso a Power Automate.
  • Uma ferramenta para enviar solicitações HTTP POST com uma matriz JSON para seu fluxo.
  • Um fluxo de nuvem novo ou existente ao qual você pode adicionar operações de dados.

Exibir um fluxo da nuvem no designer

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

O Power Automate permite que você use o novo designer ou o designer clássico para configurar o fluxo da nuvem. As capturas de tela neste artigo usam o novo designer, mas as etapas são semelhantes em ambos os designers. Saiba mais (com exemplos) em Identificar diferenças entre o novo designer e o designer clássico.

Criar um fluxo da nuvem

Para criar um novo fluxo da nuvem, siga estas etapas.

  1. Entre no Power Automate.

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

  3. Selecione um dos tipos de fluxos da nuvem em Iniciar do zero: Fluxo da nuvem automatizadoFluxo da nuvem instantâneo, Fluxo da nuvem agendado ou Descreva-o para projetá-lo.

    Captura de tela dos blocos 'Começar do zero'.

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

  5. Para Descreva-o para projetá-lo:

    1. Insira uma descrição do fluxo que você deseja criar e selecione Enviar ou selecione a partir das descrições de fluxo sugeridas geradas pela IA.

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

    3. Revise seus aplicativos e serviços conectados e selecione Criar fluxo.

      O fluxo é aberto no designer.

Selecionar um fluxo da nuvem existente

Para selecionar um fluxo da nuvem existente, siga estas etapas.

  1. Entre no Power Automate.

  2. No painel de navegação esquerdo, selecione Meus fluxos.

  3. Na guia Fluxos da nuvem, selecione o fluxo que deseja abrir.

  4. Na barra de comandos na parte superior, selecione Editar.

    O fluxo é aberto no designer.

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.

Adicionar a ação Redigir

  1. Exibir um fluxo da nuvem no designer.

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

  3. No campo de pesquisa Adicionar uma ação, digite redigir.

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

    Captura de tela da ação Redigir - Operação de Dados.

  5. No campo Entradas, insira a matriz que você deseja referenciar depois.

    Configurar a ação Redigir.

  6. Feche o painel de configuração selecionando as setas esquerdas (<<) no canto superior direito.

    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.

Usar as saídas da ação Redigir

Use o conteúdo da ação de composição criada nesta seção em uma nova ação. Neste exemplo, você usa as saídas da ação Redigir em uma ação Operação de Dados - Unir. A ação Unir pega uma matriz e a une em uma única string com um separador de sua escolha.

  1. Exibir um fluxo da nuvem no designer.

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

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

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

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

    Usar as Saídas da ação Redigir.

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

  7. Feche o painel de configuração selecionando as setas esquerdas (<<) no canto superior direito.

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. Exibir um fluxo da nuvem no designer.

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

    Ação Unir.

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

    Configurar a ação Unir.

  4. Salve seu fluxo e execute-o.

  5. 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 isto:

  1. Exibir um fluxo da nuvem no designer.

  2. Exclua o gatilho existente clicando com o botão direito do mouse no gatilho e selecionando Excluir ou selecionando as reticências verticais () no painel de configuração e selecionando Excluir.

    1. Adicione o gatilho Quando uma solicitação HTTP é recebida ao seu fluxo.
  3. Selecione Use o conteúdo de amostra para gerar o esquema.

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

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

  5. 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.

    > 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.

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 contendo apenas objetos onde first está definido como Eugenia.

  1. Exibir um fluxo da nuvem no designer.

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

  3. Na seção Consulta de Filtro, configure a ação Filtrar matriz. Seguindo o exemplo desta seção, selecione first>é igual a>Eugenia.

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

  4. Salve e execute seu fluxo.

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. Exibir um fluxo da nuvem no designer.

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

    Captura de tela da configuração da ação Criar tabela CSV. O campo

    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.

  3. 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 firstname,familyname na primeira linha seguida por Eugenia,Lopez e Luiza,Almeida.

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 Usar a ação criar tabela CSV, mas usar a ação Operação de Dados - Criar tabela HTML, 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.