Usar operações de dados

As operações de dados permitem que você manipule dados, conforme você criar seus fluxos da nuvem. Use-os para criar, classificar e reorganizar dados usando atalhos que ajudam você a obter seus resultados com mais facilidade e rapidez. Essa abordagem economiza 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 de nuvem no designer

Para usar as operações de dados descritas neste artigo, você precisa abrir o designer 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 a seguir 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 novo fluxo de nuvem

Para criar um novo fluxo de nuvem, siga estas etapas:

  1. Entre em 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 de nuvem existente, siga estas etapas:

  1. Entre em 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 Redigir

Use a ação Operação de Dados – Compor para evitar inserir os mesmos dados várias vezes ao criar um fluxo na 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 de redigir

  1. Exibir um fluxo da nuvem no designer.

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

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

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

    Captura de tela da ação Compor - Operação de dados.

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

    Configurar a ação Compose.

  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 selecionando o sinal de mais (+).

  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.

Use a ação de associaçã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ê 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.

    Participe da ação.

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

    Configurar a ação de Junção.

  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.

Use a ação de seleção

Usar a Operação de Dados – Selecionar a ação para alterar a forma de 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" } ]

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

[ { "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.

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

  4. Selecione Usar o conteúdo de amostra para gerar o esquema.

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

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

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

    Configure a ação de seleção.

    > 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 Filtrar 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 Filtrar matriz 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. Localize e adicione a ação Filtrar matriz ao 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). Mantenha 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 De está definido como Corpo e Colunas está definido como Automático.

    O token Body nesta imagem vem de uma ação quando uma solicitação HTTP é recebida . No entanto, você pode obter a entrada para a ação Criar tabela CSV da saída de qualquer ação anterior no seu fluxo ou digitá-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 nome,sobrenome na primeira linha, seguida 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. Mantenha 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.