Moldar dados em fluxos de trabalho no Azure Logic Apps

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Para trabalhar com vários dados nos seus fluxos de trabalho, use as ações integradas de Operações de Dados para não ter de escrever o seu próprio código.

Este guia apresenta e mostra como usar cada ação:

Pré-requisitos

• Uma conta e subscrição do Azure. Crie uma conta Azure gratuita.

• O fluxo de trabalho do aplicativo lógico onde você deseja executar a operação de dados.

  Antes de utilizar uma operação de dados, o seu fluxo de trabalho tem de incluir um accionador como primeiro passo. Após este disparo, inclua quaisquer outras ações necessárias para criar saídas que a operação de dados utilize como entrada.

Ações de operação de dados

As seções a seguir resumem as operações de dados que você pode usar. As operações são organizadas com base nos tipos de dados de origem em que as operações trabalham, mas cada descrição aparece em ordem alfabética. Selecione o nome de qualquer ação para ir diretamente a um exemplo passo a passo.

Ações JSON

As ações a seguir ajudam você a trabalhar com dados no formato JSON (JavaScript Object Notation).

Para criar transformações JSON mais complexas, consulte Executar transformações JSON avançadas com modelos Liquid.

Ações de matriz

As ações a seguir ajudam você a trabalhar com dados em matrizes.

Ação de composição

Use a ação Compor para criar uma única saída, como um objeto JSON, a partir de múltiplas entradas. As suas entradas podem ter vários tipos, como inteiros, booleanos, arrays, objetos JSON e qualquer outro tipo nativo que o Azure Logic Apps suporte, incluindo binário e XML. Podes usar a saída nas ações que seguem a ação Compor . A ação Redigir também ajuda a evitar inserir repetidamente as mesmas entradas enquanto cria o fluxo de trabalho do aplicativo lógico.

Por exemplo, você pode construir uma mensagem JSON a partir de várias variáveis, como variáveis de cadeia de caracteres que armazenam nomes e sobrenomes das pessoas e uma variável inteira que armazena as idades das pessoas. Neste exemplo, a ação Compor aceita as seguintes entradas:

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

E cria a seguinte saída:

{"age":35,"fullName":"Owens,Sophia"}

Para tentar a ação Compor , siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de vista de código, pode copiar deste guia o exemplo da ação Compose e as definições de variáveis da ação Inicializar variáveis para a definição de fluxo de trabalho subjacente da sua própria aplicação lógica: Exemplos de código de operações de dados - Compose. Para obter mais informações sobre a ação Redigir na definição de fluxo de trabalho JSON subjacente, consulte a ação Compor.

Testar o fluxo de trabalho

Para confirmar se a ação Redigir cria os resultados esperados, envie a si mesmo uma notificação que inclua a saída da ação Compor .

1. No fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Compor .

   Este exemplo continua usando a ação do Office 365 Outlook chamada Enviar um email (V2):

   

2. Nesta ação, para cada caixa onde pretende que os resultados apareçam, selecione dentro de cada caixa e, em seguida, selecione a lista de conteúdo dinâmico (ícone de relâmpago).

3. Na lista de conteúdos dinâmicos, na ação Compor , selecione Saídas.

   Neste exemplo, o resultado aparece no corpo do e-mail, portanto, você adiciona o campo Saídas à caixa Corpo :

   

4. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Criar ação de tabela CSV

Para criar uma tabela CSV (valores separados por vírgula) que tenha as propriedades e os valores dos objetos JSON (JavaScript Object Notation) em uma matriz, use a ação chamada Criar tabela CSV. Em seguida, você pode usar a tabela resultante em ações que seguem a ação Criar tabela CSV.

Para tentar a ação Criar tabela CSV, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de visualização de código, pode copiar deste guia o exemplo da ação Criar tabela CSV e as definições de variáveis da ação Inicializar variáveis para a definição de fluxo de trabalho subjacente da sua própria aplicação lógica: Exemplos de código de operações de dados - Criar tabela CSV. Para obter mais informações sobre a ação Criar tabela CSV na definição de fluxo de trabalho JSON subjacente, consulte a ação Tabela.

Personalizar colunas e cabeçalhos de tabelas CSV

Por defeito, na ação Criar tabela CSV , a propriedade Colunas cria automaticamente as colunas da tabela com base nos itens do array. Para especificar cabeçalhos e valores personalizados, siga estes passos:

1. Se a propriedade Colunas não aparecer na caixa de informações da ação, na lista Parâmetros avançados, selecione Colunas.

   

2. Abra a lista Colunas e selecione Personalizado.

3. Na propriedade Cabeçalho , introduza o texto personalizado do cabeçalho a utilizar.

4. Na propriedade Valor , introduza o valor personalizado a utilizar.

Para devolver valores do array, use a item() função com a ação Criar tabela CSV . Em ciclo For_each, utilize a função items().

Por exemplo, suponha que você queira colunas de tabela que tenham apenas os valores de propriedade e não os nomes de propriedade de uma matriz. Para retornar apenas esses valores, siga estas etapas para trabalhar no modo de exibição de designer ou no modo de exibição de código.

Este exemplo retorna o seguinte resultado:

Apples,1
Oranges,2

Trabalhar no modo de exibição de designer

Na ação Criar tabela CSV, mantenha a coluna Cabeçalho vazia. Em cada linha da coluna Valor, cancele a referência a cada propriedade de matriz desejada. Cada linha em Valor retorna todos os valores para a propriedade de matriz especificada e se torna uma coluna na tabela.

1. Para cada propriedade de matriz que deseja, na coluna Valor, clique na caixa de edição e, em seguida, selecione o ícone de função, que abre o editor de expressões. Verifique se a lista Função aparece selecionada.

   

2. No editor de expressão, insira a expressão a seguir, mas substitua <array-property-name> pelo nome da propriedade da matriz para o valor desejado. Quando terminar cada expressão, selecione Adicionar.

   Sintaxe: item()?['<array-property-name>']

   Exemplos de valores:

   • item()?['Description']
   • item()?['Product_ID']

   

   Para obter mais informações, consulte a função item().

3. Repita as etapas anteriores para cada propriedade de matriz. Quando terminar, sua ação será semelhante ao exemplo a seguir:

   

4. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Trabalhar na vista de código

Na definição JSON da ação Criar tabela CSV, dentro da matriz columns, defina a propriedade header como uma string vazia. Para cada value propriedade, cancele a referência de cada propriedade de matriz desejada.

1. Na barra de ferramentas do designer, selecione Visualização de código.

2. No editor de códigos, localize a matriz da columns ação. Para cada coluna de valores de matriz desejada, adicione uma propriedade vazia header e a seguinte expressão para a value propriedade:

   Sintaxe:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   Exemplo:

   "Create_CSV_table": {
      "type": "Table",
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "CSV",
         "from": "@variables('myJSONArray')"
      }
   }
   

   Nota

   Se você copiar o exemplo em seu código, certifique-se de incluir a runAfter ação no final da Create_CSV_table definição.

3. Voltar ao designer para rever os resultados.

Testar o fluxo de trabalho

Para confirmar se a ação Criar tabela CSV cria os resultados esperados, envie a si mesmo uma notificação que inclua a saída da ação Criar tabela CSV.

1. No seu fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Criar tabela CSV.

   Este exemplo continua usando a ação do Office 365 Outlook chamada Enviar um email (V2).

2. Nesta ação, para cada caixa onde você deseja que os resultados apareçam, selecione dentro de cada caixa, que abre a lista de conteúdo dinâmico. Nessa lista, na ação Criar tabela CSV, selecione Saída.

   

3. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Criar ação de tabela HTML

Para criar uma tabela HTML que contenha as propriedades e valores dos objetos JSON (JavaScript Object Notation) presentes num array, utilize a ação Criar tabela HTML. Em seguida, você pode usar a tabela resultante em ações que seguem a ação Criar tabela HTML.

Para experimentar a ação Criar tabela HTML, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor na vista de código, pode copiar deste guia o exemplo da ação Criar tabela HTML e as definições de variáveis da ação Inicializar variáveis para a definição de fluxo de trabalho subjacente na sua própria aplicação lógica: Exemplos de código de operações de dados - Criar tabela HTML. Para obter mais informações sobre a ação Criar tabela HTML na definição de fluxo de trabalho JSON subjacente, consulte a ação Tabela.

Personalizar colunas e cabeçalhos de tabelas HTML

Por defeito, na ação Criar tabela HTML , a propriedade Colunas cria automaticamente as colunas da tabela com base nos itens do array. Para especificar cabeçalhos e valores personalizados, siga estes passos:

1. Se a propriedade Colunas não aparecer na caixa de informações da ação, na lista Parâmetros avançados, selecione Colunas.

2. Abra a lista Colunas e selecione Personalizado.

3. Na propriedade Cabeçalho , introduza o texto personalizado do cabeçalho a utilizar.

4. Na propriedade Valor , introduza o valor personalizado a utilizar.

Para devolver os valores do array, use a item()função com a ação Criar tabela HTML. Em ciclo For_each, utilize a função items().

Por exemplo, suponha que você queira colunas de tabela que tenham apenas os valores de propriedade e não os nomes de propriedade de uma matriz. Para retornar apenas esses valores, siga estas etapas para trabalhar no modo de exibição de designer ou no modo de exibição de código.

Este exemplo retorna o seguinte resultado:

Apples,1
Oranges,2

Trabalhar no modo de exibição de designer

Na ação Criar tabela HTML, mantenha a coluna Cabeçalho vazia. Em cada linha da coluna Valor, cancele a referência a cada propriedade de matriz desejada. Cada linha em Valor retorna todos os valores para a propriedade de matriz especificada e se torna uma coluna na tabela.

1. Para cada propriedade de matriz que deseja, na coluna Valor, clique na caixa de edição e, em seguida, selecione o ícone de função, que abre o editor de expressões. Verifique se a lista Função aparece selecionada.

2. No editor de expressão, insira a expressão a seguir, mas substitua <array-property-name> pelo nome da propriedade da matriz para o valor desejado. Quando terminar cada expressão, selecione Adicionar.

   Sintaxe: item()?['<array-property-name>']

   Exemplos:

   • item()?['Description']
   • item()?['Product_ID']

   

   Para obter mais informações, consulte a função item().

3. Repita as etapas anteriores para cada propriedade de matriz. Quando terminar, sua ação será semelhante ao exemplo a seguir:

   

Trabalhar na vista de código

Na definição JSON da ação Create HTML table, na matriz columns, defina a propriedade header como uma cadeia vazia. Para cada value propriedade, cancele a referência de cada propriedade de matriz desejada.

1. Na barra de ferramentas do designer, selecione Visualização de código.

2. No editor de códigos, localize a matriz da columns ação. Para cada coluna de valores de matriz desejada, adicione uma propriedade vazia header e a seguinte expressão para a value propriedade:

   Sintaxe:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   Exemplo:

   "Create_HTML_table": {
      "type": "Table",
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "HTML",
         "from": "@variables('myJSONArray')"
      }
   }
   

   Nota

   Se você copiar o exemplo em seu código, certifique-se de incluir a runAfter ação no final da Create_HTML_table definição.

3. Voltar à vista do designer para rever os resultados.

Testar o fluxo de trabalho

Para confirmar se a ação Criar tabela HTML cria os resultados esperados, envie a si mesmo uma notificação que inclua a saída da ação Criar tabela HTML.

1. No fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Criar tabela HTML.

   Este exemplo continua usando a ação do Office 365 Outlook chamada Enviar um email (V2).

2. Nesta ação, para cada caixa onde pretende que os resultados apareçam, selecione dentro de cada caixa e, em seguida, selecione o ícone de relâmpago, que abre a lista de conteúdo dinâmico. Nessa lista, na ação Criar tabela HTML, selecione Saída.

   

3. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Ação de filtro de matriz

Use a ação Filter array para criar um array de subconjunto a partir de um array existente onde os itens do subconjunto cumprem critérios específicos. Pode então utilizar a matriz filtrada resultante em ações subsequentes à ação Filter array.

Para tentar a ação Filtrar matriz , siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor da vista de código, pode copiar a ação de exemplo Filter array e as definições de variáveis da ação Inicializar variáveis deste guia para a definição de fluxo de trabalho subjacente da sua própria aplicação lógica: Exemplos de código de operações de dados - Filter array. Para obter mais informações sobre a ação de Filtragem de Array na definição de fluxo de trabalho JSON subjacente, consulte a ação Consulta.

Testar o fluxo de trabalho

Para confirmar se a ação Filtrar matriz produz os resultados esperados, envie a si próprio uma notificação que inclua o resultado da ação Filtrar matriz.

1. No seu fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Filtrar matriz .

   Este exemplo continua usando a ação do Office 365 Outlook chamada Enviar um email (V2).

2. Nesta ação, conclua as seguintes etapas:

   1. Para cada caixa onde queres que apareçam os resultados, seleciona a caixa e depois o ícone de função. O ícone abre o editor de expressões. Verifique se a lista Função aparece selecionada.

   2. Para obter a saída da matriz da ação Filtrar matriz, insira a expressão a seguir, que usa a função body() com o nome da ação Filtrar matriz e selecione Adicionar.

      body('Filter_array')

      

      A expressão resolvida especifica mostrar as saídas da ação Filter_array no corpo do e-mail ao ser enviado:

      

3. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Juntar-se à ação

Para criar uma cadeia que contenha todos os itens de um array, use a ação Join e separe cada item usando um carácter delimitador específico. Pode usar esta cadeia em ações que seguem a ação Join .

Para tentar a ação Join , siga estes passos no designer do workflow. Ou, se preferir trabalhar no editor da vista de código, pode copiar, deste guia, o exemplo da ação Join e as definições de variável da ação Inicializar variáveis para a definição de fluxo de trabalho subjacente da sua própria aplicação lógica: Exemplos de código para operações de dados - Join. Para obter mais informações sobre a ação Juntar na sua definição de fluxo de trabalho subjacente, consulte a ação Juntar.

Testar o fluxo de trabalho

Para confirmar se a ação Ingressar cria os resultados esperados, envie a si mesmo uma notificação que inclua a saída da ação Ingressar .

1. No seu fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Join.

   Este exemplo continua usando a ação do Office 365 Outlook chamada Enviar um email (V2).

2. Nesta ação, para cada caixa onde pretende que os resultados apareçam, selecione dentro de cada caixa e, em seguida, selecione o ícone de relâmpago, que abre a lista de conteúdo dinâmico. Nessa lista, na ação Ingressar , selecione Saída.

   

3. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Ação de Análise de JSON

Para referenciar ou aceder a propriedades em conteúdo JavaScript Object Notation (JSON), crie campos ou tokens fáceis de usar para essas propriedades utilizando a ação Parse JSON . Pode selecionar estas propriedades da lista dinâmica de conteúdo quando especificar entradas para ações subsequentes no seu fluxo de trabalho. Para esta ação, você pode fornecer um esquema JSON ou gerar um esquema JSON a partir de seu conteúdo JSON de exemplo ou carga útil.

Para experimentar a ação Analisar JSON, siga estas etapas usando o editor de fluxos de trabalho. Ou, se preferir trabalhar no editor na vista de código, pode copiar deste guia o exemplo da ação Parse JSON e as definições de variáveis da ação Inicializar variáveis para a definição subjacente do fluxo de trabalho da sua própria aplicação lógica: Exemplos de código de operações de dados - Parse JSON. Para obter mais informações sobre esta ação na sua definição de fluxo de trabalho subjacente, consulte Ação de Analisar JSON.

Testar o fluxo de trabalho

Para confirmar se a ação de Analisar JSON cria os resultados esperados, envie uma notificação que inclua a saída da ação de Analisar JSON.

1. Em seu fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Analisar JSON .

   Este exemplo continua usando a ação do Office 365 Outlook chamada Enviar um email (V2).

2. Nesta ação, para cada caixa onde pretende que os resultados apareçam, selecione dentro de cada caixa de edição e, em seguida, selecione o ícone de relâmpago, que abre a lista de conteúdo dinâmico. Nessa lista, na ação Analisar JSON , selecione as propriedades do objeto JSON analisado.

   Este exemplo seleciona as seguintes propriedades: Corpo PrimeiroNome, Corpo Sobrenome e Corpo Email.

   

   Quando terminar, a ação Enviar um e-mail será semelhante ao exemplo a seguir:

   

3. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Selecionar ação

Por padrão, a ação Selecionar cria uma matriz que contém objetos JSON criados a partir dos valores em uma matriz existente. Por exemplo, você pode criar um objeto JSON para cada valor em uma matriz inteira. Especifique as propriedades que cada objeto JSON deve ter e mapeie os valores da matriz de origem para as propriedades. Embora você possa alterar os objetos JSON do componente, a matriz de saída sempre tem o mesmo número de itens que a matriz de origem. Para usar a matriz de saída da ação Selecionar, as ações subsequentes devem aceitar matrizes como entrada ou talvez seja necessário transformar a matriz de saída em outro formato compatível.

Para tentar a ação Selecionar , siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de visualização de código, pode copiar deste guia o exemplo da ação Select e as definições de variável da ação Inicializar variáveis para a definição subjacente do fluxo de trabalho da sua própria aplicação lógica: Exemplos de código de operações de dados - Select. Para obter mais informações sobre essa ação na definição de fluxo de trabalho subjacente, consulte Selecionar ação.

Testar o fluxo de trabalho

Para confirmar se a ação Selecionar cria os resultados esperados, envie a si mesmo uma notificação que inclua a saída da ação Selecionar .

1. No seu fluxo de trabalho, adicione uma ação que possa enviar os resultados da ação Selecionar .

2. Nesta ação, conclua as seguintes etapas:

   1. Para cada caixa onde queres que apareçam os resultados, seleciona a caixa e depois o ícone de função. O ícone abre o editor de expressões. Verifique se a lista Função aparece selecionada.

   2. Para obter a saída da matriz da ação Selecionar, digite a seguinte expressão, que usa a função body() com o nome da ação Selecionar, e selecione Adicionar:

      body('Select')

      

      A expressão resolvida especifica que se deve mostrar as saídas da ação Selecionar no corpo do e-mail quando este é enviado.

      

3. Salve seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar>Executar.

Se usar a ação Office 365 Outlook - Enviar um email (V2), o seguinte exemplo mostra o resultado:

Resolver problemas em operações de dados

Corrigir a saída de CSV ou de tabela HTML formatada incorretamente

Se a ação Criar tabela CSV ou Criar tabela HTML devolver dados formatados incorretamente, certifique-se de que os seus dados de entrada incluem quebras de linha entre linhas.

Formatação incorreta:

Fruit,Number Apples,1 Oranges,2

Formatação correta:

Fruit,Number
Apples,1
Oranges,2

Para adicionar quebras de linha entre linhas, adicione uma das seguintes expressões à tabela:

replace(body('Create_CSV_table'),'\r\n','<br/>')

replace(body('Create_HTML_table'),'\r\n','<br/>')

Por exemplo:

{
   "Send_an_email": {
      "inputs": {
         "body": {
            "Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
            "Subject": "Create CSV table results",
            "To": "sophia.owen@fabrikam.com"
         }
      }
   }
}

Conteúdos relacionados

• Conectores gerenciados para Aplicativos Lógicos do Azure
• Conectores integrados para Logic Apps do Azure