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.

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

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. Esse fluxo de trabalho já deve ter um gatilho como a primeira etapa do seu fluxo de trabalho. 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 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 e 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).

Ação Descrição
Compose Crie uma mensagem, ou cadeia de caracteres, a partir de várias entradas que podem ter vários tipos de dados. Em seguida, você pode 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 em conteúdo JSON para que você possa usar mais facilmente as propriedades em seus aplicativos lógicos.

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.
Matriz de filtros Crie um subconjunto de matriz a partir de uma matriz com base no filtro ou condição especificados.
Join Crie uma cadeia de caracteres de todos os itens em uma matriz e separe cada item com o caractere especificado.
Seleccionar Crie uma matriz a partir das propriedades especificadas para todos os itens em uma matriz diferente.

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.

  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 da variável Inicializar. Essas ações são configuradas para criar duas variáveis de cadeia de caracteres e uma variável inteira.

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

  2. No fluxo de trabalho onde você deseja criar a saída, siga uma destas etapas:

    • Para adicionar uma ação sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite compor.

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

    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 de ação Compor :

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

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

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.

  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 Compor , selecione Saídas.

    Neste exemplo, o resultado aparece no corpo do e-mail, portanto, adicione o campo Saídas à caixa Corpo .

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

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

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

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

  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 da variável Inicializar. A ação é configurada para criar uma variável onde o valor inicial é uma matriz que tem algumas propriedades e valores no formato JSON.

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

  2. No seu fluxo de trabalho onde pretende criar a tabela CSV, siga um destes passos:

    • Para adicionar uma ação sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite create csv table.

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

    Screenshot showing the designer for a Consumption workflow, the

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

    Para este exemplo, selecione dentro da caixa De, 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

    Nota

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

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

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

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

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 Columns não aparecer na caixa de informações da 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 com a item()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 desejada, na coluna Valor , selecione dentro da caixa de edição, 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ã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, sua ação será semelhante ao exemplo a seguir:

    Screenshot showing the

  5. Para resolver expressões em versões mais descritivas, alterne para a visualização de código e de volta para a visualização de designer e, em seguida, reabra a ação recolhida:

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

    Screenshot showing the

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 propriedade, cancele a referência de cada value propriedade de matriz desejada.

  1. No designer, alterne para a visualização de código.

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

  2. Nesta ação, para cada caixa onde você deseja que os resultados apareçam, selecione dentro da caixa, 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

    Nota

    Se a lista de conteúdo dinâmico mostrar a mensagem de que não é possível encontrar nenhuma saída que corresponda a esse 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 seu fluxo de trabalho e, em seguida, execute manualmente seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Executar execução de gatilho>.

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

Screenshot showing an email with the

Nota

Se a tabela for retornada com formatação incorreta, veja 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 dos objetos JSON (JavaScript Object Notation) em uma matriz, use 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 tentar 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.

  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 da variável Inicializar. A ação é configurada para criar uma variável onde o valor inicial é uma matriz que tem algumas propriedades e valores no formato JSON.

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

  2. No seu fluxo de trabalho onde pretende criar uma tabela HTML, siga um destes passos:

    • Para adicionar uma ação sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite create html table.

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

    Screenshot showing the designer for a Consumption workflow, the

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

    Para este exemplo, selecione dentro da caixa De, 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

    Nota

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

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

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

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

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. 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 com a item()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 desejada, na coluna Valor , selecione dentro da caixa de edição, 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ã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, sua ação será semelhante ao exemplo a seguir:

    Screenshot showing the

  5. Para resolver expressões em versões mais descritivas, alterne para a visualização de código e de volta para a visualização de designer e, em seguida, reabra a ação recolhida:

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

    Screenshot showing the

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 propriedade, cancele a referência de cada value propriedade de matriz desejada.

  1. No designer, alterne para a visualização de código.

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

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

    Screenshot showing a Consumption workflow with the

    Nota

    • Se a lista de conteúdo dinâmico mostrar a mensagem de que Não é possível encontrar nenhuma saída que corresponda a esse 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, certifique-se de definir a propriedade Is HTML como Yes 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 for retornada com formatação incorreta, veja como verificar a formatação dos dados da tabela.

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

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

Screenshot showing an email with the

Ação de matriz de filtro

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 Filtrar matriz na definição de fluxo de trabalho JSON subjacente, consulte a ação Consulta.

Nota

Qualquer texto de filtro que você usar em sua 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 usem a saída da 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 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 da carga JSON útil.

  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 da variável Inicializar. A ação é configurada para criar onde o valor inicial é uma matriz que tem alguns valores inteiros de exemplo.

    Nota

    Embora este exemplo use uma matriz inteira simples, essa ação é especialmente útil para matrizes de objeto JSON onde você pode filtrar com base nas 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ê deseja criar a matriz filtrada, siga uma destas etapas:

    • Para adicionar uma ação sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, insira a matriz de filtros.

  4. Na lista de ações, selecione a ação chamada Matriz de filtro.

    Screenshot showing the designer for a Consumption workflow, the

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

    Para este exemplo, selecione a caixa De, 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 de matriz a serem comparados, selecione o operador de comparação e especifique 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 itens de matriz em que o valor é maior que um. A captura de tela a seguir mostra o exemplo concluído de ação de matriz de filtro:

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

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

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

  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, 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 da matriz da ação Filtrar matriz, digite a expressão a seguir, que usa a função actionBody() com o nome da ação Filtrar matriz e 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 e-mail quando enviada:

      Screenshot showing a Consumption workflow with the finished

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

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

Screenshot showing an email with the

Ação Participar

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

Para tentar a ação Ingressar , 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 Unir 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 - Ingressar. Para obter mais informações sobre a ação Ingressar em sua definição de fluxo de trabalho subjacente, consulte a ação Ingressar.

  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 da variável Inicializar. Esta ação é configurada para criar uma variável onde o valor inicial é uma matriz que tem 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 sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, introduza aderir.

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

    Screenshot showing the designer for a Consumption workflow, the

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

    Para este exemplo, selecione dentro da caixa De, 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 Ingressar com, insira o caractere a ser usado para separar cada item de matriz.

    Este exemplo usa dois pontos (:) como separador.

    Screenshot showing where to provide the separator character.

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

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

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

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

    Screenshot showing a Consumption workflow with the finished

    Nota

    Se a lista de conteúdo dinâmico mostrar a mensagem de que não é possível encontrar nenhuma saída que corresponda a esse formato de entrada, selecione Ver mais ao lado do rótulo Ingressar na lista.

    Screenshot showing a Consumption workflow and the dynamic content list with

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

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

Screenshot showing an email with the

Analisar ação 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 do seu conteúdo JSON de exemplo ou carga útil.

Para tentar a ação Analisar JSON , 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 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 essa ação em sua definição de fluxo de trabalho subjacente, consulte Analisar ação 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 de Recorrência seguido por uma ação de variável Inicializar. 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 você deseja analisar o objeto JSON, siga uma destas etapas:

    • Para adicionar uma ação sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite parse json.

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

    Screenshot showing the designer for a Consumption workflow, the

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

    Neste 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 carga útil, que você deseja 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 você não tiver um esquema, poderá gerá-lo a partir do objeto JSON:

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

    2. Na caixa Inserir ou colar uma carga JSON de exemplo, insira o conteúdo ou objeto JSON e 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. Na barra de ferramentas do estruturador, selecione Guardar.

Testar o fluxo de trabalho

Para confirmar se a ação Analisar JSON cria os resultados esperados, envie uma notificação que inclua a saída da ação 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.

  2. Nesta ação, para cada caixa de edição 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 Analisar JSON , agora você pode 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

    Nota

    Se a lista de conteúdo dinâmico mostrar a mensagem de que não é possível encontrar nenhuma saída que corresponda a esse formato de entrada, selecione Ver mais ao lado do rótulo Analisar JSON na lista.

    Screenshot showing a Standard workflow and the dynamic content list with

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

    Screenshot showing a Consumption workflow with the finished

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

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

Screenshot showing an email with the

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 especificando as propriedades que cada objeto JSON deve ter e mapeando os valores da matriz de origem para essas 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.

Gorjeta

Para obter um exemplo que cria criar 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 da 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 da variável Inicializar. A ação é configurada para criar uma variável onde o valor inicial é uma matriz que tem 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 você deseja criar a matriz de objetos JSON, siga uma destas etapas:

    • Para adicionar uma ação sob o último passo, selecione Novo passo.

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

  3. Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, digite selecionar.

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

    Screenshot showing the designer for a Consumption workflow, the

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

    Para este exemplo, selecione dentro da caixa De, 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 Map , na coluna da esquerda, insira um nome de 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. Assim, cada valor, por exemplo, 1, 2, 3 e 4, é um ID de produto.

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

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

    1. Selecione dentro da coluna da 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ão, digite a função chamada item() e selecione OK.

    Screenshot showing the designer for a Consumption workflow, the

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

    Screenshot showing the

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

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 .

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

  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, 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 da matriz da ação Selecionar, digite a seguinte expressão, que usa a função actionBody() com o nome da ação Selecionar, e 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 e-mail quando enviada:

      Screenshot showing a Consumption workflow with the finished

    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 execução de gatilho>.

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

Screenshot showing an email with the

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

Próximos passos