Guia de início rápido: criar e gerenciar definições de fluxo de trabalho de aplicativo lógico com aplicativos lógicos do Azure multilocatários e Visual Studio Code

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

Este guia de início rápido mostra como criar e gerenciar fluxos de trabalho de aplicativos lógicos que ajudam a automatizar tarefas e processos que integram aplicativos, dados, sistemas e serviços entre organizações e empresas usando aplicativos lógicos do Azure multilocatários e o Visual Studio Code. Você pode criar e editar as definições de fluxo de trabalho subjacentes, que usam JavaScript Object Notation (JSON), para aplicativos lógicos por meio de uma experiência baseada em código. Você também pode trabalhar em aplicativos lógicos existentes que já estão implantados no Azure. Para obter mais informações sobre o modelo multilocatário versus locatário único, consulte Single-tenant versus multitenant e ambiente de serviço de integração.

Embora você possa executar essas mesmas tarefas no portal do Azure e no Visual Studio, 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, você pode desabilitar, habilitar, excluir e atualizar aplicativos lógicos 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.

Para este artigo, você pode criar o mesmo aplicativo lógico a partir deste início rápido, que se concentra mais nos conceitos básicos. Você também pode aprender a criar o aplicativo de exemplo no Visual Studio e aprender a criar e gerenciar aplicativos por meio da CLI do Azure. No Visual Studio Code, o aplicativo lógico se parece com este exemplo:

Example logic app workflow definition

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:

  • Se seu aplicativo lógico precisar se comunicar por meio de um firewall que limite o tráfego a endereços IP específicos, esse firewall precisará permitir o acesso para os endereços IP de entrada e saída usados pelos Aplicativos Lógicos do Azure ou pelo tempo de execução na região do Azure onde seu aplicativo lógico existe. Se seu aplicativo lógico também usa conectores gerenciados, como o conector do Outlook do Office 365 ou o conector SQL, ou usa conectores personalizados, o firewall também precisa permitir o acesso para todos os endereços IP de saída do conector gerenciado na região do Azure do seu aplicativo lógico.

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.

    Select Azure icon on Visual Studio Code toolbar

  2. Na janela do Azure, em Aplicativos Lógicos, selecione Entrar no Azure. Quando a página de entrada da Microsoft solicitar, entre com sua conta do Azure.

    Select

    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.

      Continue with device code instead

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

      Copy code for Azure sign in

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

      Confirm opening a browser and going to authentication website

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

      Enter authentication code for Azure sign in

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

      Find or filter Azure subscriptions

    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.

    Select your Azure subscription

    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 Aplicativos Lógicos, abra o menu de atalho da sua assinatura e selecione Criar Aplicativo Lógico.

    From subscription menu, select

    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.

    Create a new Azure resource group

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

    Provide name for your Azure resource group

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

    Select Azure location for saving logic app metadata

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

    Provide name for your logic app

    Na janela do Azure, sob sua assinatura do Azure, seu aplicativo lógico novo e em branco aparece. 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.

    Empty logic app workflow definition JSON file

    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 essa definição de aplicativo lógico de exemplo, você precisará 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": 1
             },
             "splitOn": "@triggerBody()?['value']",
             "type": "ApiConnection",
             "inputs": {
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['rss']['connectionId']"
                   }
                },
                "method": "get",
                "path": "/OnNewFeed",
                "queries": {
                   "feedUrl": "http://feeds.reuters.com/reuters/topNews"
                }
             }
          }
       },
       "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 for pedido para carregar a sua aplicação lógica para a sua subscrição do Azure, selecione Carregar.

    Esta etapa publica seu aplicativo lógico no portal do Azure, que torna sua lógica ativa e em execução no Azure.

    Upload new logic app to your Azure subscription

Exibir aplicativo lógico no designer

No Visual Studio Code, você pode abrir seu aplicativo lógico no modo de design somente leitura. Embora não seja possível editar seu aplicativo lógico no designer, você pode verificar visualmente o fluxo de trabalho do aplicativo lógico usando a visualização do 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 somente leitura é aberto em uma janela separada e mostra o fluxo de trabalho do seu aplicativo lógico, por exemplo:

View logic app in read-only designer

Ver no portal do Azure

Para rever a sua aplicação lógica no portal do 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 do Azure, insira o nome dos seus aplicativos lógicos. Na lista de resultados, selecione seu aplicativo lógico.

    Your new logic app in Azure portal

Editar aplicativo lógico implantado

No Visual Studio Code, você pode abrir e editar a definição de fluxo de trabalho para um aplicativo lógico já implantado no Azure.

Importante

Antes de editar um aplicativo lógico em execução ativa na produção, evite o risco de quebrar esse aplicativo lógico e minimize a interrupção desativando seu aplicativo lógico primeiro.

  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 e selecione o aplicativo lógico desejado.

  3. Abra o menu do aplicativo lógico e selecione Abrir no Editor. Ou, ao lado do nome do aplicativo lógico, selecione o ícone de edição.

    Open editor for existing logic app

    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.

    View workflow definition for published logic app

  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.

    Esta etapa publica suas atualizações para seu aplicativo lógico no portal do Azure.

    Upload edits to logic app definition in 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.

Importante

Antes de alterar um aplicativo lógico em execução ativa na produção, evite o risco de quebrar esse aplicativo lógico e minimize a interrupção desativando seu aplicativo lógico primeiro.

  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. Em sua assinatura, expanda seu aplicativo lógico e expanda Versões.

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

    Your logic app's previous versions

  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 no modo de exibição de designer somente 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.

      Promote earlier version

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

      Confirm promoting earlier version

      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 anterior atual agora aparece sob a versão promovida.

Desativar ou ativar aplicações lógicas

No Visual Studio Code, se você editar um aplicativo lógico publicado e salvar suas alterações, substituirá seu aplicativo já implantado. Para evitar quebrar seu aplicativo lógico em produção e minimizar interrupções, desative seu aplicativo lógico primeiro. 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. Assim, se você reativar o aplicativo lógico, 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. No aplicativo lógico, edite qualquer parte do gatilho do fluxo de trabalho.
    2. Guardar as suas alterações. Esta etapa redefine o estado atual do gatilho.
    3. Reative seu aplicativo lógico.
  • Quando um fluxo de trabalho é desativado, você ainda pode reenviar execuções.

  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.

      Disable your logic app

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

      Enable your logic app

Excluir aplicativos lógicos

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

  • Os Aplicativos Lógicos do Azure fazem o melhor esforço para cancelar quaisquer execuções em andamento e 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. Enquanto isso, algumas corridas podem ser retiradas para execução enquanto o serviço funciona durante 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.

    Delete your logic app

Próximos passos