Usar operações de dados com o Power AutomateUse data operations with Power Automate

Neste passo a passo, conheça algumas das operações de dados populares do Power Automate, como compor, unir, selecionar, filtrar uma matriz, criar uma tabela e analisar o JSON, disponíveis para manipular os dados ao criar fluxos.In this walkthrough, you learn about some of the Power Automate’s popular data operations, such as compose, join, select, filter array, create table, and parse JSON that are available to manipulate data when you create flows.

Pré-requisitosPrerequisites

  • Acesso a Power Automate.Access to Power Automate.
  • Uma ferramenta, como o PostMan, para enviar solicitações HTTP POST com uma matriz JSON para o fluxo.A tool such as PostMan to send HTTP POST requests with a JSON array to your flow.

Usar a ação de composiçãoUse the compose action

Use a ação (de composição) Operações de Dados - Compor para não precisar inserir dados idênticos várias vezes durante a criação de um fluxo.Use the Data Operations - Compose (compose) action to save yourself from entering identical data multiple times when you’re designing a flow. Por exemplo, se você precisar inserir uma matriz de dígitos: [0,1,2,3,4,5,6,7,8,9] várias vezes enquanto cria o fluxo, poderá usar a ação de composição para salvar a matriz assim:For example, if you need to enter an array of digits: [0,1,2,3,4,5,6,7,8,9] several times while you design your flow, you could use the compose action to save the array like this:

  1. Pesquise Compor e, em seguida, selecione a ação (de composição) Operações de Dados - Compor.Search for Compose, and then select the Data Operations - Compose (compose) action.

    pesquisar e selecionar a ação de composição

  2. Insira a matriz na caixa Entradas que você deseja referenciar depois:Enter the array into the Inputs box you want to reference later:

    configurar a ação de composição

Dica

Para facilitar a referência posterior, renomeie o cartão Compor clicando no texto "Compor" na barra de título do cartão Compor.For easier reference later, rename the Compose card by clicking on the text "Compose" on the title bar of the Compose card.

Quando você precisar acessar o conteúdo da ação de composição, faça isso via token Saída na lista Adicionar conteúdo dinâmico a partir de aplicativos e conectores usados neste fluxo seguindo estas etapas:When you need to access the contents of the compose action, do so via the Output token on the Add dynamic content from the apps and connectors used in this flow list by following these steps:

  1. Adicione uma ação, como Operações de Dados – Unir.Add an action such as Data Operations – Join.

  2. Selecione o controle ao qual você gostaria de adicionar o conteúdo salvo na ação de composição.Select the control to which you’d like to add the contents you saved in the compose action.

    A lista Adicionar conteúdo dinâmico a partir de aplicativos e conectores usados neste fluxo é aberta.The Add dynamic content from the apps and connectors used in this flow opens.

  3. Em Adicionar conteúdo dinâmico a partir de aplicativos e conectores usados neste fluxo, selecione o token Saída que está na categoria Compor da guia Conteúdo dinâmico.On the Add dynamic content from the apps and connectors used in this flow, select the Output token that’s under the Compose category of the Dynamic content tab.

    usar a saída da ação de composição

Usar a ação de uniãoUse the join action

Use a ação (União) Operações de Dados - Unir para delimitar uma matriz com um separador de sua escolha.Use the Data Operations - Join action (Join) to delimit an array with a separator of your choice. Por exemplo, suponha que seu fluxo receba uma solicitação da Web que inclua a seguinte matriz de endereços de email: ["d@example.com", "k@example.com", "dal@example.com"].For example, assume your flow receives a web request that includes the following array of email addresses: ["d@example.com", "k@example.com", "dal@example.com"]. No entanto, o programa de email requer que os endereços sejam uma única cadeia de caracteres separada por pontos e vírgulas.However, your email program requires addresses to be a single string that's separated with semicolons. Para fazer isso, use a ação (união) Operações de Dados - Unir para alterar o delimitador de vírgula para um ponto e vírgula ";" seguindo estas etapas:To do this, use the Data Operations - Join (join) action to change the comma delimiter to a semicolon “;“ by following these steps:

  1. Adicione uma nova ação, pesquise Unir e, em seguida, selecione a ação (união) Operações de Dados - Unir.Add a new action, search for Join, and then select Data Operations - Join (join).

    pesquisar e selecionar a ação de união

  2. Insira a matriz na caixa De e insira o novo delimitador que você deseja usar na caixa Unir com.Enter the array into the From box, and then enter the new delimiter that you want to use into the Join with box.

    Aqui, usei o ponto e vírgula (;) como o novo delimitador.Here, I’ve used the semicolon (;) as the new delimiter.

    configurar a ação de união

  3. Salve seu fluxo e execute-o.Save your flow, and then run it.

  4. Após a execução do fluxo, a saída da ação Operações de Dados – Unir será:After your flow runs, the output of the Data Operations – Join action will be:

    saída da união

Usar a ação de seleçãoUse the select action

Use a ação (seleção) Operações de Dados – Selecionar para transformar a forma dos objetos em uma matriz.Use the Data Operations – Select (select) to transform the shape of the objects in an array. Por exemplo, você pode adicionar, remover ou renomear os elementos de cada objeto em uma matriz.For example, you may add, remove, or rename elements in each object in an array.

Observação

Embora você possa adicionar ou remover os elementos usando a ação de seleção, não pode alterar o número de objetos na matriz.While you can add or remove elements using the select action, you cannot change the number of objects in the array.

Por exemplo, será possível usar a ação de seleção se os dados inserirem seu fluxo via solicitação da Web neste formato:For example, you can use the select action if data enters your flow via a web request in this format:

[ { "first": "Deon", "last": "Herb" }, { "first": "K", "last": "Herb" } ]

e você gostaria de remodelar os dados de entrada renomeando "primeiro" como "Nome", "último" como "Sobrenome" e adicionar um novo membro denominado "NomedeFamília" que combina o "primeiro" e o "último" (separados por um espaço):and you’d like to reshape the incoming data by renaming "first" to "FirstName", "last" to "LastName" and adding a new member named "FamilyName" that combines "first" and "last" (separated with a space):

[ { "FirstName": "Deon", "FamilyName": "Herb", "FullName": "Deon Herb" }, { "FirstName": "K", "FamilyName": "Herb", "FullName": "K Herb" } ].[ { "FirstName": "Deon", "FamilyName": "Herb", "FullName": "Deon Herb" }, { "FirstName": "K", "FamilyName": "Herb", "FullName": "K Herb" } ].

Para fazer isso:To do this:

  1. Adicione a ação (solicitar) Solicitação/Resposta – Resposta ao fluxo.Add the Request / Response – Response (request) action to your flow.

  2. Selecione Usar o conteúdo de exemplo para gerar o esquema no cartão Solicitar.Select the Use sample payload to generate schema from the Request card.

  3. Na caixa exibida, cole um exemplo de sua matriz dos dados de origem e, em seguida, selecione o botão Concluído.In the box that displays, paste a sample of your source data array, and then select the Done button.

  4. Adicione a ação (seleção) Operações de Dados – Selecionar e configure-a como a imagem a seguir.Add the Data Operations – Select (select) action, and then configure it like the following image.

    configurar a ação de seleção

    Dica

    A saída da ação de seleção é uma matriz que contém os objetos recém-modelados.The output from the select action is an array that contains the newly shaped objects. Em seguida, você poderá usar essa matriz em qualquer outra ação, como Compor, analisada anteriormente.You can then use this array in any other action, such as Compose, discussed earlier.

Usar a ação de filtro da matrizUse the filter array action

Use a ação (filtro da matriz) Operações de Dados - Filtrar matriz para reduzir o número de objetos em uma matriz a um subconjunto que corresponda aos critérios fornecidos.Use Data Operations - Filter array (filter array) to reduce the number of objects in an array to a subset that matches the criteria you provide.

Observação

O filtro da matriz não pode ser usado para alterar a forma dos objetos em uma matriz.Filter array cannot be used to change the shape of the objects in an array. Além disso, o texto no qual você filtra diferencia as letras maiúsculas e minúsculas.Also, the text on which you filter is case sensitive.

Por exemplo, você pode usar o filtro da matriz nesta matriz:For example, you can use filter array on this array:

[ { "first": "Deon", "last": "Herb" }, { "first": "K", "last": "Herb" } ]

para criar uma nova matriz que contenha apenas os objetos nos quais primeiro está definido como "Deon".to create a new array that contains only objects in which first is set to “Deon”.

Vamos fazer isso.Let's do this.

  1. Localize e adicione a ação (filtro da matriz) Operações de Dados - Filtrar matriz ao fluxo.Find, and then add the Data Operations - Filter array (filter array) action to your flow.

  2. Configure a ação de filtro da matriz como a seguinte imagem.Configure the filter array action like the following image.

    configurar a ação de filtro da matriz

  3. Salve e execute seu fluxo.Save, and then run your flow.

    Você pode usar PostMan para gerar uma solicitação da Web que envia uma matriz JSON para o fluxo.You can use PostMan to generate a web request that sends a JSON array to your flow.

  4. Quando o fluxo é executado, supondo que a entrada JSON se pareça com essa matriz:When your flow runs, assuming the JSON input looks like this array:

    [ { "first": "Deon", "last": "Herb" }, { "first": "K", "last": "Herb" } ],[ { "first": "Deon", "last": "Herb" }, { "first": "K", "last": "Herb" } ],

    a saída se parece com essa matriz (observe que somente os objetos nos quais primeiro está definido como "Deon" são incluídos na saída da ação):the output looks like this array (notice that only objects in which first is set to “Deon” are included in the output of the action):

    [ { "first": "Deon", "last": "Herb" } ]

Usar a ação de criação da tabela csvUse the create csv table action

Use a ação (criação da tabela csv) Operações de Dados – Criar tabela CSV para alterar a entrada da matriz do JSON para uma tabela com valores separados por vírgula (CSV).Use the Data Operations - Create CSV table (create csv table) to change a JSON array input into a comma separated value (CSV) table. Opcionalmente, você pode manter os cabeçalhos visíveis na saída CSV.Optionally, you can keep the headers visible in the CSV output. Por exemplo, é possível converter a seguinte matriz em uma tabela CSV usando a ação Criar tabela CSV:For example, you can convert the following array into a CSV table by using the Create CSV table action:

[ { "first": "Deon", "last": "Herb" }, { "first": "K", "last": "Herb" } ]

  1. Localize, adicione e configure a ação Operações de Dados – Criar tabela CSV para parecer com a imagem a seguir.Find, add, and then configure the Data Operations - Create CSV table action to resemble the following image.

    configurar a ação de criação da tabela csv

    Observação: o token Corpo nesta imagem vem de uma ação Solicitação/Resposta – Resposta, 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 digitar diretamente na caixa De.Note: The Body token in this image comes from a Request / Response – Response action, however, you could get the input for the Create CSV table action from the output of any previous action in your flow, or you can enter it directly into the From box.

  2. Salve e execute seu fluxo.Save, and then run your flow.

    Quando o fluxo é executado, a saída Criar tabela CSV se parece com essa imagem:When your flow runs, the Create CSV table output looks like this image:

    criar saída da tabela csv

usar a ação de criação da tabela csvUse the create html table action

Use Operações de Dados - Criar tabela HTML para alterar uma entrada da matriz JSON para uma tabela HTML.Use Data Operations - Create HTML table to change a JSON array input into an HTML table. Opcionalmente, você pode manter os cabeçalhos visíveis na saída HTML.Optionally, you can keep the headers visible in the HTML output.

Para fazer isso, siga as etapas na seção de criação da tabela csv para obter um exemplo detalhado.To do this, follow the steps in the create csv table section for a detailed example. Use a ação Operações de Dados - Criar tabela HTML, em vez da ação Operações de Dados – Criar tabela CSV.Be sure to use the Data Operations - Create HTML table action, instead of the Data Operations - Create CSV table action.

Dica

Se você planeja enviar a tabela HTML por email, lembre de selecionar "IsHtml" na ação de email.If you plan to send the HTML table via email, remember to select "IsHtml" in the email action.