Início rápido: Crie fluxos de trabalho de integração em aplicações Azure Logic multitenant usando Visual Studio Code

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Este guia de início rápido mostra como criar fluxos de trabalho de lógica de aplicações em Azure Logic Apps multicliente que automatizam tarefas e integram processos entre serviços, sistemas, aplicações e dados dentro de organizações e empresas, utilizando o Visual Studio Code. Pode criar e editar as definições de workflow subjacentes, que utilizam JavaScript Object Notation (JSON), para fluxos de trabalho através de uma experiência baseada em código. Também podes trabalhar em fluxos de trabalho de Logic App já existentes que já estão implementados no Azure. Para mais informações sobre o modelo multitenant versus single-tenant, consulte Single-tenant versus multitenant no Azure Logic Apps.

Embora você possa executar essas mesmas tarefas no portal do Azure, você pode começar mais rapidamente no Visual Studio Code quando já estiver familiarizado com as definições de aplicativo lógico e quiser trabalhar diretamente no código. Por exemplo, pode desativar, ativar, eliminar e atualizar fluxos de trabalho de aplicações lógicas já criados. Além disso, você pode trabalhar em aplicativos lógicos e contas de integração de qualquer plataforma de desenvolvimento em que o Visual Studio Code seja executado, como Linux, Windows e Mac.

Neste artigo, pode criar o mesmo fluxo de trabalho da aplicação lógica a partir deste quickstart, que se foca mais nos conceitos básicos. Você também pode aprender a criar e gerenciar aplicativos por meio da CLI do Azure. No Visual Studio Code, o fluxo de trabalho da aplicação lógica é o seguinte exemplo:

Pré-requisitos

Antes de começar, certifique-se de que dispõe destes itens:

• Se não tiver uma conta e subscrição do Azure, inscreva-se numa conta gratuita do Azure.

• Conhecimento básico sobre definições de fluxo de trabalho de aplicativo lógico e sua estrutura, conforme descrito com JSON

  Se você é novo nos Aplicativos Lógicos do Azure, experimente este início rápido, que cria seu primeiro fluxo de trabalho de aplicativo lógico no portal do Azure e se concentra mais nos conceitos básicos.

• Acesso à Web para iniciar sessão no Azure e na sua subscrição do Azure

• Transfira e instale estas ferramentas, se ainda não as tiver:

  • Visual Studio Code versão 1.25.1 ou posterior, que é gratuito

  • Extensão de código do Visual Studio para Aplicativos Lógicos do Azure

    Você pode baixar e instalar essa extensão do Visual Studio Marketplace ou diretamente de dentro do Visual Studio Code. Certifique-se de recarregar o Visual Studio Code após a instalação.

    

    Para verificar se a extensão foi instalada corretamente, selecione o ícone do Azure que aparece na barra de ferramentas do Visual Studio Code.

    

    Para obter mais informações, consulte Extension Marketplace. Para contribuir para a versão de código aberto desta extensão, visite a extensão de Aplicativos Lógicos do Azure para Visual Studio Code no GitHub.

• Se o seu fluxo de trabalho da Logic App precisa de comunicar através de um firewall que limita o tráfego a endereços IP específicos, esse firewall tem de permitir o acesso tanto aos endereços IP de entrada como de saída usados pelo Azure Logic Apps ou ao runtime na região Azure onde existe o seu fluxo de trabalho de Logic App. Se o seu fluxo de trabalho da Logic App também usa conectores geridos, como o conector Office 365 Outlook ou SQL, ou utiliza conectores personalizados, o firewall também precisa de permitir o acesso a todos os endereços IP de saída dos conectores geridos na região Azure da sua Logic App.

Acessar o Azure a partir do Visual Studio Code

1. Abra o Visual Studio Code. Na barra de ferramentas Código do Visual Studio, selecione o ícone do Azure.

   

2. Na janela do Azure, em Aplicativos Lógicos, selecione Entrar no Azure. Quando a página de início de sessão da Microsoft for apresentada, inicie sessão com a sua conta do Azure.

   

   1. Se a entrada demorar mais do que o normal, o Visual Studio Code solicitará que você entre por meio de um site de autenticação da Microsoft fornecendo um código de dispositivo. Para entrar com o código, selecione Usar código do dispositivo.

      

   2. Para copiar o código, selecione Copiar & Abrir.

      

   3. Para abrir uma nova janela do navegador e continuar para o site de autenticação, selecione Abrir link.

      

   4. Na página Iniciar sessão na sua conta, introduza o seu código de autenticação e selecione Seguinte.

      

3. Selecione sua conta do Azure. Depois de entrar, você pode fechar o navegador e retornar ao Visual Studio Code.

   No painel do Azure, as seções Aplicativos Lógicos e Contas de Integração agora mostram as assinaturas do Azure associadas à sua conta. No entanto, se não vir as subscrições esperadas ou se as secções mostrarem demasiadas subscrições, siga estes passos:

   1. Mova o ponteiro sobre o rótulo dos Aplicativos Lógicos. Quando a barra de ferramentas aparecer, selecione Selecionar assinaturas (ícone de filtro).

      

   2. Na lista apresentada, selecione as subscrições que pretende que apareçam.

4. Em Aplicativos Lógicos, selecione a assinatura desejada. O nó de assinatura expande e mostra todos os aplicativos lógicos existentes nessa assinatura.

   

   Gorjeta

   Em Contas de integração, selecionar sua assinatura mostra todas as contas de integração existentes nessa assinatura.

Criar novo aplicativo lógico

1. Se ainda não tiver iniciado sessão na sua conta e subscrição do Azure a partir do Visual Studio Code, siga os passos anteriores para iniciar sessão agora.

2. No Visual Studio Code, em Aplicações Lógicas, abra o menu de atalho da sua assinatura e selecione Criar Aplicação Lógica.

   

   Uma lista é exibida e mostra todos os grupos de recursos do Azure em sua assinatura.

3. Na lista de grupos de recursos, selecione Criar um novo grupo de recursos ou um grupo de recursos existente. Para este exemplo, crie um novo grupo de recursos.

   

4. Forneça um nome para seu grupo de recursos do Azure e pressione ENTER.

   

5. Selecione a região do Azure onde você deseja salvar os metadados do seu aplicativo lógico.

   

6. Forneça um nome para seu aplicativo lógico e pressione Enter.

   

   Na janela do Azure, na sua subscrição Azure, aparece o novo fluxo de trabalho da aplicação lógica, que está em branco. O Visual Studio Code também abre um arquivo JSON (.logicapp.json), que inclui uma definição de fluxo de trabalho esqueleto para seu aplicativo lógico. Agora você pode começar a criar manualmente a definição de fluxo de trabalho do seu aplicativo lógico neste arquivo JSON. Para obter referência técnica sobre a estrutura e a sintaxe de uma definição de fluxo de trabalho, consulte o esquema da Linguagem de Definição de Fluxo de Trabalho para Aplicativos Lógicos do Azure.

   

   Por exemplo, aqui está uma definição de fluxo de trabalho de aplicativo lógico de exemplo, que começa com um gatilho RSS e uma ação do Office 365 Outlook. Normalmente, os elementos JSON aparecem alfabeticamente em cada seção. No entanto, este exemplo mostra esses elementos aproximadamente na ordem em que as etapas do aplicativo lógico aparecem no designer.

   Importante

   Se quiser reutilizar esta definição de fluxo de trabalho de aplicação lógica de exemplo, precisa de uma conta organizacional, por exemplo, @fabrikam.com. Certifique-se de substituir o endereço de e-mail fictício pelo seu próprio endereço de e-mail. Para usar um conector de email diferente, como o Outlook.com ou o Gmail, substitua a ação por uma ação semelhante disponível em um conector de email compatível com os Send_an_email_action Aplicativos Lógicos do Azure.

   Se você quiser usar o conector do Gmail, apenas as contas comerciais do G-Suite poderão usar esse conector sem restrições em aplicativos lógicos. Se tiver uma conta de consumidor do Gmail, pode utilizar este conector apenas com serviços específicos aprovados pela Google ou pode criar uma aplicação cliente Google para utilizar na autenticação com o conector do Gmail. Para obter mais informações, consulte Políticas de segurança e privacidade de dados para conectores do Google em Aplicativos Lógicos do Azure.

   {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
         "$connections": {
            "defaultValue": {},
            "type": "Object"
         }
      },
      "triggers": {
         "When_a_feed_item_is_published": {
            "recurrence": {
               "frequency": "Minute",
               "interval": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

7. Quando terminar, salve a definição de fluxo de trabalho do seu aplicativo lógico. (Menu > Arquivo Salvar ou pressione Ctrl+S)

8. Quando lhe pedirem para carregar a definição do seu fluxo de trabalho da Logic App para a sua subscrição Azure, selecione Carregar.

   Esta etapa publica a definição do seu fluxo de trabalho da aplicação lógica no portal Azure, o que torna o fluxo de trabalho ativo e a correr no Azure.

   

Ver definição de workflow de aplicação lógica no designer

No Visual Studio Code, pode abrir a definição do fluxo de trabalho da sua logic app no modo de design apenas para leitura. Embora não possas editar a definição do fluxo de trabalho da tua app lógica no designer, podes verificar visualmente o fluxo de trabalho da tua app lógica usando a vista designer.

Na janela do Azure, em Aplicativos Lógicos, abra o menu de atalho do aplicativo lógico e selecione Abrir no Designer.

O designer de leitura apenas é aberto numa janela separada e mostra o fluxo de trabalho da sua aplicação lógica, por exemplo:

Ver no portal do Azure

Para rever a definição do seu fluxo de trabalho de Logic App no portal Azure, siga estes passos:

1. Entre no portal do Azure usando a mesma conta e assinatura do Azure associada ao seu aplicativo lógico.

2. Na caixa de pesquisa do portal Azure, introduza o nome da definição do fluxo de trabalho da aplicação lógica. Na lista de resultados, selecione a aplicação Logic.

   

Editar aplicativo lógico implantado

No Visual Studio Code, pode abrir e editar a definição do fluxo de trabalho de um recurso de lógica já implementado no Azure.

1. Se ainda não tiver iniciado sessão na sua conta e subscrição do Azure a partir do Visual Studio Code, siga os passos anteriores para iniciar sessão agora.

2. Na janela do Azure, em Logic Apps, expande a tua subscrição Azure e seleciona o recurso de Logic App que queres.

3. Abre o menu de contexto da app Logic e seleciona Abrir no Editor. Ou, ao lado do nome do aplicativo lógico, selecione o ícone de edição.

   

   O Visual Studio Code abre o arquivo .logicapp.json em sua pasta temporária local para que você possa exibir a definição de fluxo de trabalho do aplicativo lógico.

   

4. Faça suas alterações na definição de fluxo de trabalho do aplicativo lógico.

5. Quando tiver terminado, guarde as alterações. (Menu > Arquivo Salvar ou pressione Ctrl+S)

6. Quando lhe for pedido para carregar as alterações e substituir a aplicação lógica existente no portal do Azure, selecione Carregar.

   Este passo publica as tuas atualizações ao recurso da tua aplicação lógica no portal Azure.

   

Ver ou promover outras versões

No Visual Studio Code, você pode abrir e revisar as versões anteriores do seu aplicativo lógico. Você também pode promover uma versão anterior para a versão atual.

1. Na janela do Azure, em Aplicativos Lógicos, expanda sua assinatura do Azure para que você possa exibir todos os aplicativos lógicos nessa assinatura.

2. Na sua assinatura, expanda a sua aplicação lógica e expanda Versões.

   A lista Versões mostra as versões anteriores do seu aplicativo lógico, se existirem.

   

3. Para exibir uma versão anterior, selecione uma das etapas:

   • Para exibir a definição JSON, em Versões, selecione o número da versão dessa definição. Ou abra o menu de atalho dessa versão e selecione Abrir no Editor.

     Um novo arquivo é aberto no computador local e mostra a definição JSON dessa versão.

   • Para exibir a versão na vista de designer em modo só de leitura, abra o menu de atalho dessa versão e selecione Abrir no Designer.

4. Para promover uma versão anterior para a versão atual, siga estes passos:

   1. Em Versões, abra o menu de atalho da versão anterior e selecione Promover.

      

   2. Para continuar depois que o Visual Studio Code solicitar a confirmação, selecione Sim.

      

      O Visual Studio Code promove a versão selecionada para a versão atual e atribui um novo número à versão promovida. A versão que antes era a atual agora aparece debaixo da versão promovida.

Desativar ou ativar aplicações lógicas

No Visual Studio Code, se editares um fluxo de trabalho de uma app lógica publicada e guardares as tuas alterações, sobreescreves a aplicação já implementada. Para evitar quebrar o fluxo de trabalho da tua app Logic em produção e minimizar interrupções, desativa primeiro o recurso da tua app Logic. Em seguida, você pode reativar seu aplicativo lógico depois de confirmar que seu aplicativo lógico ainda funciona.

• Os Aplicativos Lógicos do Azure continuam todas as execuções em andamento e pendentes até que sejam concluídas. Com base no volume ou na lista de pendências, esse processo pode levar tempo para ser concluído.

• Os Aplicativos Lógicos do Azure não criam nem executam novas instâncias de fluxo de trabalho.

• O gatilho não será acionado na próxima vez que suas condições forem atendidas.

• O estado de gatilho lembra o ponto em que o aplicativo lógico foi interrompido. Portanto, se reativar a aplicação lógica, o gatilho será acionado para todos os itens não processados desde a última execução.

  Para impedir que o gatilho dispare em itens não processados desde a última execução, limpe o estado do gatilho antes de reativar o aplicativo lógico:

  1. Na aplicação lógica, edite qualquer parte do disparador do fluxo de trabalho.
  2. Guardar as suas alterações. Esta etapa redefine o estado atual do gatilho.
  3. Reative a sua aplicação de lógica.

• Quando um fluxo de trabalho é desativado, ainda é possível reenviar processamentos.

1. Se ainda não tiver iniciado sessão na sua conta e subscrição do Azure a partir do Visual Studio Code, siga os passos anteriores para iniciar sessão agora.

2. Na janela do Azure, em Aplicativos Lógicos, expanda sua assinatura do Azure para que você possa exibir todos os aplicativos lógicos nessa assinatura.

   1. Para desativar o aplicativo lógico desejado, abra o menu do aplicativo lógico e selecione Desativar.

      

   2. Quando estiver pronto para reativar seu aplicativo lógico, abra o menu do aplicativo lógico e selecione Ativar.

      

Excluir aplicativos lógicos

A exclusão de um aplicativo lógico afeta as instâncias de fluxo de trabalho das seguintes maneiras:

• Os Azure Logic Apps empenham-se ao máximo para cancelar quaisquer execuções que estejam em progresso ou pendentes.

  Mesmo com um grande volume ou lista de pendências, a maioria das execuções são canceladas antes de terminarem ou começarem. No entanto, o processo de cancelamento pode levar tempo para ser concluído. Entretanto, alguns processos podem ser selecionados para serem executados enquanto o serviço lida com o processo de cancelamento.

• Os Aplicativos Lógicos do Azure não criam nem executam novas instâncias de fluxo de trabalho.

• Se você excluir um fluxo de trabalho e, em seguida, recriar o mesmo fluxo de trabalho, o fluxo de trabalho recriado não terá os mesmos metadados que o fluxo de trabalho excluído. Você precisa salvar novamente qualquer fluxo de trabalho chamado fluxo de trabalho excluído. Dessa forma, o chamador obtém as informações corretas para o fluxo de trabalho recriado. Caso contrário, as chamadas para o fluxo de trabalho recriado falharão com um Unauthorized erro. Esse comportamento também se aplica a fluxos de trabalho que usam artefatos em contas de integração e fluxos de trabalho que chamam funções do Azure.

1. Se ainda não tiver iniciado sessão na sua conta e subscrição do Azure a partir do Visual Studio Code, siga os passos anteriores para iniciar sessão agora.

2. Na janela do Azure, em Aplicativos Lógicos, expanda sua assinatura do Azure para que você possa exibir todos os aplicativos lógicos nessa assinatura.

3. Encontre o aplicativo lógico que você deseja excluir, abra o menu do aplicativo lógico e selecione Excluir.

   

Próximos passos