Executar operações de dados em 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 em seu fluxo de trabalho de aplicativo lógico das seguintes maneiras:

• Crie uma cadeia de caracteres ou um objeto JSON (JavaScript Object Notation) a partir de várias entradas com diferentes tipos de dados. Em seguida, você pode usar essa cadeia de caracteres como uma única entrada, em vez de inserir repetidamente as mesmas entradas.
• Crie tokens amigáveis a partir de propriedades de objeto JSON (JavaScript Object Notation) para que você possa usar facilmente essas propriedades em seu 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 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 subscrição do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.

• O fluxo de trabalho do aplicativo lógico onde você deseja executar a operação de dados. Os fluxos de trabalho do aplicativo lógico Consumo e Padrão 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, seu fluxo de trabalho já deve começar com um gatilho como a primeira etapa e incluir quaisquer outras ações necessárias para criar as saídas que você deseja 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 em que as operações trabalham, mas cada descrição aparece em ordem alfabética.

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

Para construir uma única saída, como um objeto JSON, a partir de várias entradas, use a ação chamada Compose. Suas entradas podem ter vários tipos, como inteiros, booleanos, matrizes, objetos JSON e qualquer outro tipo nativo que os Aplicativos Lógicos do Azure suportem, por exemplo, binário e XML. Em seguida, você pode usar a saída em ações que se seguem após 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 visualização de código, você pode copiar o exemplo Compor e Inicializar definições de ação variável deste guia 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 - Compor. 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). Na lista, sob a 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 :

   

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 você usar a ação Office 365 Outlook - Enviar um email, 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 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, você pode copiar o exemplo Criar tabela CSV e Inicializar definições de ação variável deste guia 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 - 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 o formato da tabela

Por padrão, a propriedade Columns é definida para criar automaticamente as colunas da tabela com base nos itens da matriz. 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 Header, especifique o texto do cabeçalho personalizado a ser usado.

4. Na propriedade Value, especifique o valor personalizado a ser usado.

Para retornar valores da matriz, você pode usar a item() função com a ação Criar tabela CSV. Em um For_each loop, você pode usar a items() função.

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, dentro da columns matriz, defina a header propriedade como uma cadeia de caracteres 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. Volte para a visualização do designer para revisar 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 você usar a ação Office 365 Outlook - Enviar um email, o exemplo a seguir 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 de visualização de código, você pode copiar o exemplo Criar tabela HTML e Inicializar definições de ação variável deste guia 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 - 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 o formato da tabela

Por padrão, a propriedade Columns é definida para criar automaticamente as colunas da tabela com base nos itens da matriz. 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 Header, especifique o texto do cabeçalho personalizado a ser usado.

4. Na propriedade Value, especifique o valor personalizado a ser usado.

Para retornar valores da matriz, você pode usar a item() função com a ação Criar tabela HTML. Em um For_each loop, você pode usar a items() função.

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, dentro da columns matriz, defina a header propriedade como uma cadeia de caracteres 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. Volte para a visualização do designer para revisar 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 você usar a ação Office 365 Outlook - Enviar um email, o exemplo a seguir mostra o resultado:

Ação de filtro de matriz

Para criar uma matriz de subconjunto a partir de uma matriz existente em que os itens de subconjunto atendam a critérios específicos, use a ação Filtrar matriz . Em seguida, você pode usar a matriz filtrada resultante em ações que seguem a ação Filtrar matriz .

Para tentar a ação Filtrar matriz , siga estas etapas usando o designer de fluxo de trabalho. Ou, se preferir trabalhar no editor de visualização de código, você pode copiar o exemplo Filtrar matriz e Inicializar definições de ação variável deste guia 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 - Matriz de filtro. 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 cria os resultados esperados, envie a si mesmo uma notificação que inclua a saída 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 você deseja que os resultados apareçam, selecione dentro de cada caixa e, em seguida, selecione o ícone de função, que abre o editor de expressão. 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 você usar a ação Office 365 Outlook - Enviar um email, o exemplo a seguir mostra o resultado:

Juntar-se à ação

Para criar uma string que contenha todos os itens de uma matriz e separar esses itens com um caractere delimitador específico, use a ação Juntar. Em seguida, pode usar a cadeia de caracteres em ações que seguem a ação de União.

Para experimentar a ação Ingressar, siga estas etapas usando o designer do fluxo de trabalho. Ou, se preferir trabalhar no editor de visualização de código, pode copiar os exemplos das definições de ação de Unir e Inicializar variável deste guia 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 - Juntar. 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 você usar a ação Office 365 Outlook - Enviar um email, o exemplo a seguir mostra o resultado:

Ação de Análise de JSON

Para fazer referência ou acessar propriedades no conteúdo JSON (JavaScript Object Notation), você pode criar campos ou tokens amigáveis para essas propriedades usando a ação Analisar JSON . Dessa forma, você pode selecionar essas propriedades na lista de conteúdo dinâmico ao especificar entradas para ações subsequentes em 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 de visualização de código, você pode copiar o exemplo Analisar JSON e Inicializar definições de ação variável deste guia 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 - Analisar 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: Body FirstName, Body LastName e Body 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 você usar a ação Office 365 Outlook - Enviar um email, o exemplo a seguir 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, você pode copiar o exemplo Selecionar e Inicializar definições de ação variável deste guia 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 - Selecionar. 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 você deseja que os resultados apareçam, selecione dentro de cada caixa e, em seguida, selecione o ícone de função, que abre o editor de expressão. 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 você usar a ação Office 365 Outlook - Enviar um email, o exemplo a seguir mostra o resultado:

Resolução de Problemas

Formatar dados da tabela

Se a tabela CSV ou HTML for retornada com formatação incorreta, verifique se os dados de entrada têm 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'),'','<br/>')

replace(body('Create_HTML_table'),'','<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