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

  • Artigo

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.

Para outras maneiras de trabalhar com os dados, revise as funções de manipulação de dados fornecidas pelos Aplicativos Lógicos do Azure.

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. Este fluxo de trabalho já deve ter um gatilho como a primeira etapa do fluxo de trabalho. 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 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 e estão organizadas com base nos tipos de dados de origem em que as operações funcionam, mas cada descrição aparece em ordem alfabética.

Ações de JSON

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

Ação Descrição
Compor Crie uma mensagem ou cadeia de caracteres a partir de várias entradas que podem ter diversos tipos de dados. Em seguida, é possível usar essa cadeia de caracteres como uma única entrada, em vez de inserir repetidamente as mesmas entradas. Por exemplo, você pode criar uma única mensagem JSON a partir de várias entradas.
Analisar JSON Crie tokens de dados amigáveis para propriedades no conteúdo JSON para que você possa usar as propriedades nos aplicativos lógicos com mais facilidade.

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 Descrição
Criar tabela CSV Crie uma tabela CSV (valores separados por vírgula) a partir de uma matriz.
Criar tabela HTML Crie uma tabela HTML a partir de uma matriz.
Filtrar matriz Crie um subconjunto de matriz a partir de uma matriz com base no filtro especificado ou condição específica.
Join Crie uma cadeia de caracteres a partir de todos os itens em uma matriz e separe cada item com o caractere especificado.
Selecionar Crie uma matriz a partir de propriedades especificadas para todos os itens em uma matriz diferente.

Ação para compor

Para construir uma única saída, como um objeto JSON a partir de várias entradas, use a ação nomeada Redigir. As entradas podem ter vários tipos, como inteiros, boolianos, matrizes, objetos JSON e outro tipo nativo com suporte dos Aplicativos Lógicos do Azure, por exemplo, binário e XML. Em seguida, você pode usar a saída em ações que seguem após a ação Redigir. 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 você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Redigir e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do próprio aplicativo lógico: Exemplos de código de operação de dados – Redigir. Para obter mais informações sobre a ação Redigir na definição de fluxo de trabalho JSON subjacente, consulte a ação Redigir.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com o gatilho Recorrência seguido por várias ações Inicializar variável. Essas ações são configuradas para criar duas variáveis de cadeia de caracteres e uma variável de número inteiro.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the Compose action.

  2. No fluxo de trabalho em que você quer criar a saída, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira redigir.

  4. Na lista de ações, selecione a ação nomeada Redigir.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa Entradas, insira as entradas a serem usadas para criar a saída.

    Para este exemplo, selecione dentro da caixa Entradas , que abre a lista de conteúdo dinâmico. Nessa lista, selecione as variáveis criadas anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

    A captura de tela a seguir mostra o exemplo concluído da ação Redigir:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

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

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 nomeada Enviar um email.

  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 Compôr, selecione Saídas.

    Para este exemplo, o resultado aparece no corpo do email, portanto, adicione o campo Saídas à caixa Corpo.

    Screenshot showing the Azure portal, designer for an example Consumption workflow, and the

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

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

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 você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Criar tabela CSV e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do 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.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com o gatilho Recorrência seguido por uma ação Inicializar variável. A ação é configurada para criar uma variável em que o valor inicial é um matriz que possui algumas propriedades e valores no formato JSON.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. No fluxo de trabalho em que você quer criar a tabela CSV, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, digite criar tabela csv.

  4. Na lista de ações, selecione a ação nomeada Criar tabela CSV.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa De, insira a matriz ou a expressão que será usada para criar a tabela.

    Para este exemplo, selecione dentro da caixa Entradas , que abre a lista de conteúdo dinâmico. Nessa lista, selecione a variável criada anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

    Observação

    Para criar tokens amigáveis para as propriedades em objetos JSON para que você possa selecionar essas propriedades como entradas, use a ação nomeada Analisar o JSON antes de usar a ação Criar tabela CSV.

    A captura de tela a seguir mostra o exemplo concluído da ação Criar tabela CSV:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

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

Personalizar formato de 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 estas etapas:

  1. Se a propriedade Colunas não aparecer na caixa de informações de ação, na lista Adicionar novos parâmetros, 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 função item() com a ação Criar tabela CSV. Em um loop For_each, você pode usar a função items().

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, clique na caixa de edição para que a lista dinâmica de conteúdo apareça.

  2. Nessa lista, selecione Expressão para abrir o editor de expressões.

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

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

    Exemplos:

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

    Screenshot showing the

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

    Screenshot showing the

  5. Para resolver expressões em versões mais descritivas, alterne para o modo de exibição de código e volte para o modo de exibição de designer. Depois, reabra a ação recolhida:

    A ação Criar tabela CSV agora é semelhante ao seguinte exemplo:

    Screenshot showing the

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

Na definição de JSON da ação, 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. No designer, alterne para a exibição de código.

    • Consumo: na barra de ferramentas do designer, selecione Modo de exibição de código.
    • Standard: no menu de navegação do fluxo de trabalho, em Desenvolvedor, selecione 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": {
   "inputs": {
      "columns": [
         { 
            "header": "",
            "value": "@item()?['Description']"
         },
         { 
            "header": "",
            "value": "@item()?['Product_ID']"
         }
      ],
      "format": "CSV",
      "from": "@variables('myJSONArray')"
   }
}

  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 nomeada Enviar um email.

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

    Screenshot showing a Consumption workflow with the

    Observação

    Se a lista dinâmica de conteúdo mostrar a mensagem Não foi possível encontrar saídas para corresponder a este formato de entrada, selecione Ver mais ao lado do rótulo Criar tabela CSV na lista.

    Screenshot showing a Consumption workflow and the dynamic content list with

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

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

Observação

Se a tabela retornar com a formatação incorreta, consulte como verificar a formatação dos dados da tabela.

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 você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Criar tabela HTML e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do 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.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com o gatilho Recorrência seguido por uma ação Inicializar variável. A ação é configurada para criar uma variável em que o valor inicial é um matriz que possui algumas propriedades e valores no formato JSON.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. No fluxo de trabalho em que você quer criar a tabela HTML, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, digite criar tabela html.

  4. Na lista de ações, selecione a ação nomeada Criar tabela HTML.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa De, insira a matriz ou a expressão que será usada para criar a tabela.

    Para este exemplo, selecione dentro da caixa Entradas , que abre a lista de conteúdo dinâmico. Nessa lista, selecione a variável criada anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

    Observação

    Para criar tokens amigáveis para as propriedades em objetos JSON para que você possa selecionar essas propriedades como entradas, use a ação nomeada Analisar o JSON antes de usar a ação Criar tabela HTML.

    A captura de tela a seguir mostra o exemplo concluído da ação Criar tabela HTML:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

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

Personalizar formato de 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 estas etapas:

  1. Abra a lista Colunas e selecione Personalizado.

  2. Na propriedade Header, especifique o texto do cabeçalho personalizado a ser usado.

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

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

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, clique na caixa de edição para que a lista dinâmica de conteúdo apareça.

  2. Nessa lista, selecione Expressão para abrir o editor de expressões.

  3. 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 e selecione OK. Para obter mais informações, consulte a função item().

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

    Exemplos:

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

    Screenshot showing the

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

    Screenshot showing the

  5. Para resolver expressões em versões mais descritivas, alterne para o modo de exibição de código e volte para o modo de exibição de designer. Depois, reabra a ação recolhida:

    A ação Criar tabela HTML agora é semelhante ao seguinte exemplo:

    Screenshot showing the

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

Na definição de JSON da ação, 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. No designer, alterne para a exibição de código.

    • Consumo: na barra de ferramentas do designer, selecione Modo de exibição de código.
    • Standard: no menu de navegação do fluxo de trabalho, em Desenvolvedor, selecione 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": {
   "inputs": {
      "columns": [
         { 
            "header": "",
            "value": "@item()?['Description']"
         },
         { 
            "header": "",
            "value": "@item()?['Product_ID']"
         }
      ],
      "format": "HTML",
      "from": "@variables('myJSONArray')"
   }
}

  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 nomeada Enviar um email.

  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 HTML , selecione Saída.

    Screenshot showing a Consumption workflow with the

    Observação

    • Se a lista dinâmica de conteúdo mostrar a mensagem Não foi possível encontrar saídas para corresponder a este formato de entrada, selecione Ver mais ao lado do rótulo Criar tabela HTML na lista.

      Screenshot showing a Consumption workflow and the dynamic content list with

    • Ao incluir a saída da tabela HTML em uma ação de email, defina a propriedade Is HTML como Sim nas opções avançadas da ação de email. Dessa forma, a ação de e-mail formata corretamente a tabela HTML. No entanto, se a tabela retornar com a formatação incorreta, consulte como verificar a formatação dos dados da tabela.

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

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

Ação filtrar matriz

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

Para experimentar a ação Filtrar matriz, siga estas etapas usando o designer de fluxo de trabalho. Ou, se você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Filtrar matriz e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do próprio aplicativo lógico: Exemplos de código de operação 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.

Observação

Qualquer texto de filtro que você usa nessa condição diferencia maiúsculas de minúsculas. Além disso, essa ação não pode alterar o formato ou os componentes dos itens na matriz.

Para ações que usam a saída de matriz da ação Filtrar matriz, essas ações devem aceitar matrizes como entrada, ou talvez seja necessário transformar a matriz de saída em outro formato compatível.

Se você chamar um ponto de extremidade HTTP e receber uma resposta JSON, use a ação Analisar o JSON para processar a resposta JSON. Caso contrário, a ação Filtrar matriz pode ler apenas o corpo da resposta e não a estrutura do conteúdo JSON.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com o gatilho Recorrência seguido por uma ação Inicializar variável. A ação é configurada para criar onde o valor inicial é uma matriz que possui alguns valores inteiros de exemplo.

    Observação

    Embora este exemplo use uma matriz de inteiros simples, essa ação é especialmente útil para matrizes de objeto JSON em que é possível filtrar com base em propriedades e valores dos objetos.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. No fluxo de trabalho em que você quer criar a matriz filtrada, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira filtrar matriz.

  4. Na lista de ações, selecione a ação nomeada Filtrar matriz.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa De, insira a matriz ou a expressão a ser usada como o filtro.

    Para este exemplo, selecione dentro da caixa Entradas, que abre a lista de conteúdo dinâmico. Nessa lista, selecione a variável criada anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

  6. Para a condição, especifique os itens da matriz para comparar, selecione o operador de comparação e o valor de comparação.

    Este exemplo usa a função item() para acessar cada item na matriz, enquanto a ação Filtrar matriz procura por itens de matriz em que o valor for maior que um. A captura de tela a seguir mostra o exemplo concluído da ação Filtrar matriz:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

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

Testar seu fluxo de trabalho

Para confirmar se a ação Filtrar matriz cria os resultados esperados, envie uma notificação a você mesmo 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 nomeada Enviar um email.

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

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

    2. Nessa lista, selecione Expressão para abrir o editor de expressões.

    3. Para obter a saída de matriz da ação Filtrar matriz, insira a seguinte expressão, que usa a função actionBody() com o nome da ação Filtrar raiz e, em seguida, selecione OK.

      actionBody('Filter_array')

      Screenshot showing a Consumption workflow with the

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

      Screenshot showing a Consumption workflow with the finished

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

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

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 você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Unir e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do próprio aplicativo lógico: Exemplos de código de operação de dados – Unir. Para obter mais informações sobre a ação Unir na definição de fluxo de trabalho subjacente, consulte a ação Unir.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com o gatilho Recorrência seguido por uma ação Inicializar variável. Esta ação é configurada para criar uma variável em que o valor inicial é uma matriz que possui alguns valores inteiros de exemplo.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. No fluxo de trabalho em que você deseja criar a cadeia de caracteres a partir de uma matriz, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira unir.

  4. Na lista de ações, selecione a ação nomeada Unir.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa De, insira a matriz que contém os itens que você deseja unir como uma cadeia de caracteres.

    Para este exemplo, selecione dentro da caixa Entradas , que abre a lista de conteúdo dinâmico. Nessa lista, selecione a variável criada anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

  6. Na caixa Unir com, insira o caractere a ser usado para separar cada item de matriz.

    Este exemplo usa dois pontos (:) como o separador.

    Screenshot showing where to provide the separator character.

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

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 nomeada Enviar um email.

  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 Ingressar, selecione Saída.

    Screenshot showing a Consumption workflow with the finished

    Observação

    Se a lista dinâmica de conteúdo mostrar a mensagem Não foi possível encontrar saídas para corresponder a este formato de entrada, selecione Ver mais ao lado do rótulo Unir na lista.

    Screenshot showing a Consumption workflow and the dynamic content list with

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

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

Ação analisar JSON

Para referenciar ou acessar propriedades no conteúdo JSON (JavaScript Object Notation), é possível criar tokens ou campos amigáveis para essas propriedades usando a ação Analisar JSON. Dessa forma, você poderá selecionar essas propriedades na lista dinâmica de conteúdo ao especificar as entradas das ações subsequentes no 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 você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Analisar o JSON e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do próprio aplicativo lógico: Exemplos de código de operação de dados – Analisar o JSON. Para obter mais informações sobre essa ação na definição no fluxo de trabalho subjacente, consulte Ação analisar JSON.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com um gatilho Recorrência seguido por uma ação Inicializar variável. Esta ação é configurada para criar uma variável cujo valor inicial é o seguinte objeto JSON com propriedades e valores:

    {
    "Member": {
        "Email": "Sophia.Owen@fabrikam.com",
        "FirstName": "Sophia",
        "LastName": "Owen"
    }
}

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. No fluxo de trabalho em que deseja analisar o objeto JSON, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira analisar o json.

  4. Na lista de ações, selecione a ação chamada Analisar o JSON.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa Conteúdo, insira o objeto JSON que você quer analisar.

    Para este exemplo, selecione dentro da caixa Conteúdo, que abre a lista de conteúdo dinâmico. Nessa lista, selecione a variável criada anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

  6. Na caixa Esquema, insira o esquema JSON que descreve o objeto JSON ou a carga que você quer analisar.

    Para este exemplo, use o seguinte esquema para o objeto JSON de exemplo:

    {
    "type": "object",
    "properties": {
        "Member": {
            "type": "object",
            "properties": {
                "Email": {
                    "type": "string"
                },
                "FirstName": {
                    "type": "string"
                },
                "LastName": {
                    "type": "string"
                }
            }
        }
    }
}

    Screenshot showing the designer for a Consumption workflow, the

    Se não tiver um esquema, você poderá gerá-lo a partir do objeto JSON:

    1. Na ação Analisar o JSON, na caixa Esquema, selecione Usar a carga de exemplo para gerar o esquema.

    2. Na caixa Inserir ou colar uma carga JSON de exemplo, insira o objeto ou conteúdo JSON e, em seguida, selecione Concluído, por exemplo:

      {
    "Member": {
       "Email": "Sophia.Owen@fabrikam.com",
       "FirstName": "Sophia",
       "LastName": "Owen"
    }
}

      Screenshot showing the designer for a Consumption workflow, the

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

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 nomeada Enviar um email.

  2. Nesta ação, para cada caixa de edição em que você deseja que os resultados apareçam, selecione dentro de cada caixa, o que abre a lista de conteúdo dinâmico. Na lista dinâmica de conteúdo que abre, na ação Analisar o JSON, agora você poderá selecionar as propriedades do objeto JSON analisado.

    Este exemplo seleciona as seguintes propriedades: FirstName, LastName e Email

    Screenshot showing a Consumption workflow with JSON properties in the

    Observação

    Se a lista dinâmica de conteúdo mostrar a mensagem Não foi possível encontrar saídas para corresponder a este formato de entrada, selecione Ver mais ao lado do rótulo Analisar o JSON na lista.

    Screenshot showing a Standard workflow and the dynamic content list with

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

    Screenshot showing a Consumption workflow with the finished

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

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

Ação selecionar

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ê poderá criar um objeto JSON para cada valor em uma matriz de inteiros especificando as propriedades que cada objeto JSON deverá ter e mapeando os valores de matriz de origem para essas 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 você preferir trabalhar no editor de exibição de código, poderá copiar as definições da ação Selecionar e Inicializar variável de exemplo deste guia para a definição de fluxo de trabalho subjacente do 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 do fluxo de trabalho subjacente, consulte Ação selecionar.

Dica

Para obter um exemplo que cria uma matriz com cadeias de caracteres ou inteiros criados a partir dos valores em uma matriz de objeto JSON, consulte as definições de ação de variável Select e Initliaze em Exemplos de código de operação de dados - Select.

  1. No portal do Azure, Visual Studio ou Visual Studio Code, abra o fluxo de trabalho do aplicativo lógico no designer.

    Este exemplo usa o portal do Azure e um fluxo de trabalho de exemplo com o gatilho Recorrência seguido por uma ação Inicializar variável. A ação é configurada para criar uma variável em que o valor inicial é uma matriz que possui alguns inteiros de exemplo.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. No fluxo de trabalho em que deseja criar a matriz de objetos JSON, siga uma destas etapas:

    • Para adicionar uma ação na última etapa, selecione Nova etapa.

    • Para adicionar uma ação entre etapas, mova o mouse sobre a seta de conexão para que o sinal de adição ( + ) apareça. Escolha o sinal de adição e selecione Adicionar uma ação.

  3. Na caixa de pesquisa Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira selecionar.

  4. Na lista de ações, selecione a ação nomeada Selecionar.

    Screenshot showing the designer for a Consumption workflow, the

  5. Na caixa De, insira a matriz de origem que você quer usar.

    Para este exemplo, selecione dentro da caixa Entradas , que abre a lista de conteúdo dinâmico. Nessa lista, selecione a variável criada anteriormente:

    Screenshot showing the designer for a Consumption workflow, the

  6. Para a propriedade Mapa, na coluna esquerda, insira um nome da propriedade para descrever todos os valores na matriz de origem.

    Este exemplo usa Product_ID como o nome da propriedade para os valores inteiros na matriz de origem. Portanto, cada valor, por exemplo, 1, 2, 3 e 4, é uma identificação do produto (Product ID).

  7. Na coluna direita, insira uma expressão que especifique o valor na matriz de origem para o nome da propriedade na coluna esquerda.

    Este exemplo usa a função item() para iterar e acessar cada item na matriz.

    1. Selecione dentro da coluna à direita, que abre a lista de conteúdo dinâmico.

    2. Nessa lista, selecione Expressão para abrir o editor de expressões.

    3. No editor de expressões, insira a função nomeada item()e selecione OK.

    Screenshot showing the designer for a Consumption workflow, the

    A ação Selecionar agora é semelhante ao seguinte exemplo:

    Screenshot showing the

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

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.

    Este exemplo continua usando a ação do Outlook do Office 365 nomeada Enviar um email.

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

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

    2. Nessa lista, selecione Expressão para abrir o editor de expressões.

    3. Para obter a saída de matriz da ação Selecionar, insira a seguinte expressão, que usa a função actionBody() com o nome da ação Selecionar e, em seguida, selecione OK:

      actionBody('Select')

      Screenshot showing a Consumption workflow with the

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

      Screenshot showing a Consumption workflow with the finished

    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, escolha Executar gatilho>Executar.

Se você usou a ação do Outlook do Office 365, obterá um resultado semelhante à captura de tela a seguir:

Screenshot showing an email with the

Solução de problemas

Formatar dados da tabela

Se a tabela CSV ou a tabela HTML retornar com a formatação incorreta, verifique se os dados de entrada têm quebras de linha entre as 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'),'','<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"
			}
		}
	}
}

Próximas etapas