Executar operações de dados nos Aplicativos Lógicos do Azure

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

Este guia de instruções mostra como você pode trabalhar com dados no fluxo de trabalho do aplicativo lógico das seguintes maneiras:

• Crie uma cadeia de caracteres ou um objeto JSON (JavaScript Object Notation) a partir de várias entradas que tenham tipos de dados diferentes. Em seguida, é possível usar essa cadeia de caracteres como uma única entrada, em vez de inserir repetidamente as mesmas entradas.
• Crie tokens amigáveis a partir das propriedades do objeto JSON (JavaScript Object Notation) para que você possa usar facilmente essas propriedades no fluxo de trabalho.
• Crie uma tabela HTML ou CSV a partir de uma matriz.
• Crie uma matriz a partir de outra matriz com base em um filtro ou em uma condição especificada.
• Crie uma matriz com base nas propriedades especificadas para todos os itens em outra matriz.
• Crie uma cadeia de caracteres de todos os itens em uma matriz e separe esses itens usando um caractere especificado.

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

• O fluxo de trabalho do aplicativo lógico no qual você quer executar a operação de dados. Os fluxos de trabalho do aplicativo lógico Standard ou de Consumo dão suporte às operações de dados descritas neste guia.

  Todas as operações de dados estão disponíveis apenas como ações. Portanto, antes de poder usar essas ações, o fluxo de trabalho já deverá começar com um gatilho como primeira etapa e incluir outras ações necessárias para criar as saídas que você quer usar na operação de dados.

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 nos quais as operações funcionam, mas cada descrição aparece em ordem alfabética.

Ações em 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 em matriz

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

Ação para compor

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

Por exemplo, você pode construir uma mensagem JSON a partir de diversas variáveis, como variáveis de cadeia de caracteres que armazenam os nomes e sobrenomes das pessoas e uma variável de inteiro que armazena a idade das pessoas. Neste exemplo, a ação Redigir aceita as seguintes entradas:

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

E cria a seguinte saída:

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

Para experimentar a ação Redigir, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de exibição de código, você 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 do seu próprio aplicativo lógico: Exemplos de código de operação 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 Redigir.

Testar seu fluxo de trabalho

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

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

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

   

2. Nesta ação, para cada caixa em que você deseja que os resultados apareçam, selecione dentro de cada caixa e selecione a lista de conteúdo dinâmico (ícone relâmpago). Na lista, embaixo da ação Compose, selecione Saídas.

   Para este exemplo, o resultado aparece no corpo do email, para que você adicione o campo Saídas à caixa Corpo :

   

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir 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 nomeada Criar tabela CSV. Em seguida, é possível usar a tabela resultante em ações que seguem a ação Criar tabela CSV.

Para experimentar a ação Criar tabela CSV, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de exibição de código, você 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 do seu próprio aplicativo lógico: 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 formato de tabela

Por padrão, a propriedade Colunas cria automaticamente as colunas da tabela com base nos itens do array. Para especificar cabeçalhos e valores personalizados, siga estas etapas:

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 , insira o texto personalizado do cabeçalho para usar.

4. Na propriedade Valor , insira o valor personalizado a ser usado.

Para retornar valores do array, use a item() função com a ação Criar tabela CSV . Em um For_each laço, use a items() função.

Por exemplo, suponha que você queira ter colunas de tabela apenas com 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 na coluna Valor, desreferencie cada propriedade de matriz que você deseja. Cada linha em Valor retorna todos os valores para a propriedade de matriz especificada e torna-se uma coluna na sua tabela.

1. Para cada propriedade de matriz desejada, na coluna Valor, selecione dentro da caixa de edição e 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>']

   Valores de exemplo:

   • 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, a ação será semelhante ao exemplo a seguir:

   

4. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Trabalhar no modo de exibição de código

Na definição JSON da ação Criar tabela CSV, na matriz columns, defina a propriedade header como uma string vazia. Para cada propriedade value, desreferencie cada propriedade de matriz que você deseja.

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

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

   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')"
      }
   }
   

   Observação

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

3. Alterne de volta para o modo de exibição do designer e examine os resultados.

Testar seu fluxo de trabalho

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

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

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

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

   

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir mostra o resultado:

Criar ação de tabela HTML

Para criar uma tabela HTML que tenha as propriedades e os valores de objetos JSON (JavaScript Object Notation) em uma matriz, use a ação Criar tabela HTML. Em seguida, é possível 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 de exibição de código, você poderá copiar deste guia para a definição de fluxo de trabalho subjacente do seu próprio aplicativo lógico o exemplo da ação Criar tabela HTML e as definições de variáveis da ação Inicializar variáveis: 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 formato de tabela

Por padrão, a propriedade Colunas cria automaticamente as colunas da tabela com base nos itens do array. Para especificar cabeçalhos e valores personalizados, siga estas etapas:

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 , insira o texto personalizado do cabeçalho para usar.

4. Na propriedade Valor , insira o valor personalizado a ser usado.

Para retornar valores do array, use a item() função com a ação Criar tabela HTML . Em um For_each laço, use a items() função.

Por exemplo, suponha que você queira ter colunas de tabela apenas com 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 na coluna Valor, desreferencie cada propriedade de matriz que você deseja. Cada linha em Valor retorna todos os valores para a propriedade de matriz especificada e torna-se uma coluna na sua tabela.

1. Para cada propriedade de matriz desejada, na coluna Valor, selecione dentro da caixa de edição e 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, a ação será semelhante ao exemplo a seguir:

   

Trabalhar no modo de exibição de código

Na definição JSON da ação Create HTML table, dentro da matriz columns, defina a propriedade header como uma cadeia de caracteres vazia. Para cada propriedade value, desreferencie cada propriedade de matriz que você deseja.

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

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

   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')"
      }
   }
   

   Observação

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

3. Alterne de volta para o modo de exibição do designer e examine os resultados.

Testar seu fluxo de trabalho

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

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

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

2. Nesta ação, para cada caixa em que você deseja que os resultados apareçam, selecione dentro de cada caixa e selecione o ícone relâmpago, que abre a lista de conteúdo dinâmico. A partir dessa lista, na ação Criar tabela HTML , selecione Saída.

   

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir mostra o resultado:

Ação filtrar matriz

Use a ação Filter array para criar um array de subconjunto a partir de um array existente, onde os itens do subconjunto atendem a critérios específicos. Você pode então usar o array filtrado resultante em ações subsequentes à ação Filtrar array.

Para experimentar a ação Filtrar matriz, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de exibição de código, você pode copiar deste guia o exemplo da ação Filtrar matriz e as definições de variáveis para a ação Inicializar variáveis para a definição subjacente do fluxo de trabalho do seu próprio aplicativo lógico: Exemplos de código de operações de dados - Filtrar matriz. Para obter mais informações sobre a ação Filtrar matriz na definição do fluxo de trabalho JSON subjacente, consulte a ação Consultar.

Testar seu fluxo de trabalho

Para confirmar se a ação Filtrar matriz gera os resultados esperados, envie a si uma notificação que inclua a saída da ação Filtrar matriz.

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

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

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

   1. Para cada caixa onde você quer que os resultados apareçam, selecione a caixa e depois selecione 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 de matriz da ação Filtrar matriz, insira a seguinte expressão, que usa a função body() com o nome da ação Filtrar matriz e, em seguida, selecione Adicionar.

      body('Filter_array')

      

      A expressão resolvida especifica para mostrar as saídas da ação Filter_array no corpo do email quando enviado:

      

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir mostra o resultado:

Ação unir

Para criar uma cadeia de caracteres contendo todos os itens de uma matriz e separar esses itens com um caractere delimitador específico, use a ação Unir. Em seguida, você poderá usar a cadeia de caracteres em ações que seguem a ação Unir.

Para experimentar a ação Unir, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de exibição de código, você pode copiar deste guia o exemplo da ação Join e as definições de variáveis da ação Inicializar variáveis para a definição de fluxo de trabalho subjacente do seu próprio aplicativo lógico: Exemplos de código de operações de dados - Join. Para obter mais informações sobre a ação Unir na definição de fluxo de trabalho subjacente, consulte a ação Unir.

Testar seu fluxo de trabalho

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

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

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

2. Nesta ação, para cada caixa em que você deseja que os resultados apareçam, selecione dentro de cada caixa e selecione o ícone relâmpago, que abre a lista de conteúdo dinâmico. A partir dessa lista, na ação Ingressar, selecione Saída.

   

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir mostra o resultado:

Ação analisar JSON

Para referenciar ou acessar propriedades em conteúdo JavaScript Object Notation (JSON), crie campos ou tokens amigáveis para essas propriedades usando a ação Parse JSON . Você pode selecionar essas propriedades da lista dinâmica de conteúdo ao especificar entradas para ações subsequentes no seu fluxo de trabalho. Para esta ação, é possível fornecer um esquema JSON ou gerar um esquema JSON a partir do conteúdo de JSON de exemplo ou carga.

Para experimentar a ação Analisar o JSON, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor no modo de exibição de código, você 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 de fluxo de trabalho subjacente do seu próprio aplicativo lógico: Exemplos de código de operações de dados - Parse JSON. Para obter mais informações sobre essa ação na definição no fluxo de trabalho subjacente, consulte Ação analisar JSON.

Testar seu fluxo de trabalho

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

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

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

2. Nesta ação, selecione dentro de cada caixa de texto em que você deseja que os resultados apareçam 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: Nome Primeiro do Corpo, Sobrenome do Corpo e E-mail do Corpo.

   

   Ao concluir, a ação Enviar um email será semelhante ao seguinte exemplo:

   

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir mostra o resultado:

Ação selecionar

Por padrão, a ação Selecionar cria uma matriz que contém objetos JSON criados a partir dos valores de uma matriz existente. Por exemplo, você pode criar um objeto JSON para cada valor em uma matriz de inteiros. Especifique as propriedades que cada objeto JSON deve ter e mapeie os valores da matriz de origem para as propriedades. Embora seja possível alterar os objetos JSON do componente, a matriz de saída sempre terá 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 deverão aceitar matrizes como entrada ou será necessário transformar a matriz de saída em outro formato compatível.

Para experimentar a ação Selecionar, siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor no modo de exibição de código, você pode copiar, deste guia, o exemplo da ação Select e as definições de variáveis da ação Initialize variables para a definição de fluxo de trabalho subjacente do seu próprio aplicativo lógico: Exemplos de código de operações de dados - Select. Para obter mais informações sobre essa ação na definição do fluxo de trabalho subjacente, consulte Ação selecionar.

Testar seu fluxo de trabalho

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

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

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

   1. Para cada caixa onde você quer que os resultados apareçam, selecione a caixa e depois selecione 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 de matriz da ação Selecionar, insira a seguinte expressão, que usa a função body() com o nome da ação Selecionar e, em seguida, selecione Adicionar:

      body('Select')

      

      A expressão resolvida especifica para mostrar as saídas da ação Selecionar no corpo do email quando enviado:

      

3. Salve o fluxo de trabalho e execute-o manualmente. Na barra de ferramentas do designer, selecione Executar>Executar.

Se você usar a ação Office 365 Outlook - Enviar um e-mail (V2), o exemplo a seguir mostra o resultado:

Solução de problemas

Formatar dados da tabela

Se sua tabela CSV ou tabela HTML devolver dados formatados incorretamente, certifique-se de que seus dados de entrada incluam 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 as linhas, adicione uma das expressões a seguir à sua 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údo relacionado

• Conectores gerenciados dos Aplicativos Lógicos do Azure
• Conectores internos de Aplicativos Lógicos do Azure