Partilhar via

Utilizar operações de dados

  • Artigo

Neste artigo, irá ficar conhecer algumas operações de dados comuns no Power Automate, tais como compor, participar, selecionar, filtrar matrizes, criar tabelas e analisar JSON. Utilize estas operações para manipular dados quando cria fluxos.

Nota

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

Eis um vídeo curto sobre operações de dados.

Pré-requisitos

  • Acesso ao Power Automate.
  • Uma ferramenta para enviar pedidos de HTTP POST com uma matriz JSON para o seu fluxo.

Utilizar a ação de composição

Utilize a ação Operações de Dados – Compor para evitar a necessidade de introduzir dados os mesmos dados várias vezes à medida que concebe um fluxo de cloud. 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.

  1. Pesquise por compor e, em seguida, selecione a ação Compor – Operação de Dados.

Captura de ecrã de pesquisar por e selecionar a ação Compor.

  1. Na caixa Entradas, introduza a matriz que pretende referenciar mais tarde.

    Captura de ecrã de configurar a ação Compor.

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.

Quando precisar de aceder ao conteúdo da ação de composição, faça-o seguindo estes passos.

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

  2. Selecione o controlo ao qual pretende adicionar os conteúdos guardados na ação de composição.

    O ecrã Adicionar conteúdo dinâmico a partir das aplicações e dos conectores utilizados neste fluxo é aberto.

  3. No separador Conteúdo dinâmico, na secção Compor, selecione Saídas.

    Captura de ecrã de utilizar Saídas da ação Compor.

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. Adicione uma nova ação, procure por Associar e, em seguida, selecione Operação de Dados - Associar.

    Captura de ecrã de pesquisar por e selecionar a ação Participar.

  2. Na caixa De, introduza a matriz e na caixa Associar com, introduza um ponto e vírgula (;).

    Captura de ecrã de configurar a ação Participar.

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

  4. Após as suas execuções de fluxo, a saída da ação Operação de Dados – Participar será uma cadeia com os endereços ligados por pontos e vírgulas, como mostrado na captura de ecrã seguinte.

    Captura de ecrã da entrada de endereços separados por vírgulas, um Participar 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

Utilize a ação Operação de Dados – Selecionar para transformar a forma dos objetos numa matriz. 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 introduzem o seu fluxo através de um pedido web neste formato:

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

Pretende reformular os dados que chegam, renomeando first para FirstName e last para FamilyName e adicionando um novo membro chamado FullName que combina first e last (separado com um espaço).

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

Para tal:

  1. Adicione o acionador Quando um pedido HTTP é recebido ao seu fluxo.

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

    Captura de ecrã de selecionar o payload de amostra.

  3. Na caixa que aparece, cole uma amostra da sua matriz de dados de origem e, em seguida, selecione Concluído.

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

Utilize a ação de matriz de filtro

Utilize a ação Matriz de filtro – Operação de Dados 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 da matriz do filtro para alterar a forma dos objetos na matriz.
  • O texto no qual usa o filtro é sensível a maiúsculas e minúsculas.

Neste exemplo, utiliza-se 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 os objetos no qual first está definido como Eugenia.

  1. Encontre e, em seguida, adicione a ação Matriz do filtro ao seu fluxo.

  2. Configure a ação da matriz de filtro, conforme mostrado na captura de ecrã seguinte.

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

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

Utilize a ação de criação de tabela CSV

Utilize a ação Criar tabela CSV – Operação de Dados para alterar uma entrada de matriz JSON para uma tabela (CSV) com valores separados por vírgulas. Pode, opcionalmente, manter 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. Encontre, adicione e, em seguida, configure a ação Criar tabela CSV – Operação de Dados para se assemelhar à 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 é proveniente de uma ação Quando um pedido HTTP é recebido, no entanto, pode obter a entrada da ação Criar tabela CSV a partir da saída de qualquer ação anterior no seu fluxo, ou pode introduzi-lo diretamente na caixa De.

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

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

    Captura de ecrã da saída da ação Criar tabela CSV a mostrar

Utilize a ação de criação de tabela HTML

Utilize a ação Criar tabela HTML – Operação de Dados para alterar uma entrada de matriz JSON para uma tabela HTML. Pode, opcionalmente, manter os cabeçalhos visíveis na saída HTML.

Para tal, siga os passos na secção anterior Utilizar a ação criar tabela CSV para criar uma tabela CSV. Utilize a ação Criar tabela HTML — Operação de Dados, 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.