Compartilhar via


Início Rápido: Criar fluxos de trabalho de integração automatizados com Aplicativos Lógicos do Azure multilocatários e Visual Studio

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

Este início rápido mostra como projetar, desenvolver e implantar fluxos de trabalho automatizados que integram aplicativos, dados, sistemas e serviços entre empresas e organizações usando os Aplicativos Lógicos do Azure multilocatários e o Visual Studio. Embora você possa executar essas tarefas no portal do Azure, o Visual Studio permite que você adicione aplicativos lógicos ao controle do código-fonte, publique diferentes versões e crie modelos do Azure Resource Manager para ambientes de implantação diferentes. Para obter mais informações sobre modelo multilocatário versus modelo de locatário único, examine Locatário único versus multilocatário nos Aplicativos Lógicos do Azure.

Se você for novato nos Aplicativos Lógicos do Azure e quiser apenas saber os conceitos básicos, experimente o início rápido para criar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo no portal do Azure. O designer de fluxo de trabalho funciona de forma semelhante no portal do Azure e no Visual Studio.

Neste início rápido, você cria o mesmo fluxo de trabalho de aplicativo lógico com o Visual Studio como o início rápido do portal do Azure. Você também pode aprender a criar um fluxo de trabalho de aplicativo lógico de exemplo no Visual Studio Code e criar e gerenciar fluxos de trabalho de aplicativo lógico usando a CLI do Azure. Esse fluxo de trabalho de aplicativo lógico monitora um feed RSS de site e envia um email para cada novo item nesse feed. O fluxo de trabalho de aplicativo lógico concluído se parece com o seguinte fluxo de trabalho de alto nível:

A captura de tela mostra a exibição de alto nível, por exemplo, o fluxo de trabalho do aplicativo lógico.

Pré-requisitos

Configurar o Visual Studio para o Azure Governamental

Visual Studio 2019

Para trabalhar com as assinaturas do Azure Government em Aplicativos Lógicos do Azure, você precisa adicionar um ponto de extremidade de descoberta para a Nuvem do Azure Government ao Visual Studio. No entanto, antes de entrar no Visual Studio com sua conta do Azure Government, você precisará renomear o arquivo JSON depois de adicionar o ponto de extremidade de descoberta seguindo estas etapas:

  1. Feche o Visual Studio.

  2. Localize o arquivo JSON gerado chamado Azure U.S. Government-A3EC617673C6C70CC6B9472656832A26.Configuration neste local:

    %localappdata%\.IdentityService\AadConfigurations

  3. Renomeie o arquivo JSON como AadProvider.Configuration.json.

  4. Reinicie o Visual Studio.

  5. Continue com as etapas para entrar com sua conta do Azure Government.

Para reverter essa configuração, exclua o arquivo JSON no seguinte local e reinicie o Visual Studio:

%localappdata%\.IdentityService\AadConfigurations\AadProvider.Configuration.json

Visual Studio 2017

Você pode usar a extensão do Visual Studio Seletor de Ambiente do Azure, que você pode baixar e instalar do Visual Studio Marketplace.

Criar um projeto do grupo de recursos do Azure

Para começar, crie um projeto do Grupo de Recursos do Azure. Saiba mais sobre Recursos e grupos de recursos do Azure.

  1. Inicie o Visual Studio. Faça logon usando sua conta do Azure.

  2. No menu Arquivo, selecione Novo>Projeto. (teclado: Ctrl + Shift + N)

    A captura de tela mostra o Visual Studio, menu Arquivo com opções selecionadas para Novo, Projeto.

  3. Em Instalado, selecione Visual C# ou Visual Basic. Selecione Nuvem>Grupo de Recursos do Azure. Nomeie o projeto , por exemplo:

    A captura de tela mostra como criar o projeto do Grupo de Recursos do Azure.

    Observação

    Os nomes dos grupos de recursos podem conter apenas letras, números, pontos (.), sublinhados (_), hifens (-) e parênteses ((, )), mas não podem terminar com pontos (.).

    Se Nuvem ou Grupo de Recursos do Azure não aparecer, instale o SDK do Azure para o Visual Studio.

    Se você estiver usando o Visual Studio 2019, siga estas etapas:

    1. Na caixa Criar um novo projeto, selecione o projeto Grupo de Recursos do Azure para Visual C# ou Visual Basic. Selecione Avançar.

    2. Forneça um nome para o grupo de recursos do Azure que você deseja usar e outras informações do projeto. Selecione Criar.

  4. Na lista de modelos, selecione o modelo Aplicativo Lógico. Selecione OK.

    A captura de tela mostra o modelo de Aplicativo Lógico selecionado.

    Depois que o Visual Studio cria seu projeto, o Gerenciador de Soluções é aberto e mostra sua solução. Em sua solução, o arquivo LogicApp.json não só armazena a definição de aplicativo lógico, mas também é um modelo do Azure Resource Manager que você pode usar para a implantação.

    A captura de tela mostra o Gerenciador de Soluções com a nova solução de aplicativo lógico e o arquivo de implantação.

Criar fluxo de trabalho de aplicativo lógico em branco

Quando tiver seu projeto do Grupo de Recursos do Azure, crie seu aplicativo lógico com o modelo Aplicativo Lógico em Branco.

  1. No Gerenciador de Soluções, abra o menu de atalho do arquivo LogicApp.json. Selecione Abrir com o Designer de Aplicativo Lógico. (teclado: Ctrl + L)

    A captura de tela mostra o designer de fluxo de trabalho com o arquivo .json do aplicativo lógico.

    Dica

    Caso não tenha esse comando no Visual Studio 2019, verifique se você tem as atualizações mais recentes do Visual Studio.

    O Visual Studio solicitará sua assinatura do Azure e um grupo de recursos do Azure para criar e implantar recursos para conexões e fluxo de trabalho do aplicativo lógico.

  2. Para Assinatura, selecione sua assinatura do Azure. Para Grupo de recursos, selecione Criar Novo para criar outro grupo de recursos do Azure.

    Selecione assinatura do Azure, grupo de recursos e local do recurso

    Configuração Valor de exemplo Descrição
    Conta de usuário Fabrikam
    sophia-owen@fabrikam.com
    A conta que você usou quando entrou no Visual Studio
    Assinatura Pré-paga
    (sophia-owen@fabrikam.com)
    O nome para sua assinatura do Azure e a conta associada
    Grupo de Recursos MyLogicApp-RG
    (Oeste dos EUA)
    O grupo de recursos do Azure e a localização para armazenar e implantar recursos do aplicativo lógico
    Localidade Igual ao Grupo de Recursos O tipo de local e o local para implantar o recurso de aplicativo lógico.

    Para este guia de início rápido, mantenha o tipo de local definido como Região e o local definido como Igual ao Grupo de Recursos.

    Observação: depois de criar seu projeto de grupo de recursos, é possível alterar o tipo de local e o local, mas o tipo de local diferente afeta seu aplicativo lógico de várias maneiras.
  3. O designer de fluxo de trabalho abre uma página que mostra um vídeo de introdução e gatilhos normalmente usados. Role para baixo após o vídeo e os gatilhos para Modelos e selecione Aplicativo Lógico em Branco.

    A captura de tela mostra o modelo selecionado chamado Aplicativo Lógico em Branco.

Criar seu fluxo de trabalho

Em seguida, adicione um gatilho RSS que é acionado quando um novo item de feed é exibido. Cada fluxo de trabalho começa com um gatilho, que é disparado quando critérios específicos são atendidos. Cada vez que o gatilho é disparado, o mecanismo dos Aplicativos Lógicos do Azure cria uma instância de fluxo de trabalho de aplicativo lógico que execute o fluxo de trabalho.

  1. No designer do fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho de RSS chamado Quando um item de feed é publicado.

  2. Conclua a criação do fluxo de trabalho seguindo estas etapas gerais para adicionar a ação do Office 365 Outlook chamada Enviar um email e, em seguida, retorne a este artigo.

    Quando terminar, o fluxo de trabalho ficará parecido com este exemplo:

    A captura de tela mostra o fluxo de trabalho do aplicativo lógico concluído.

  3. Salve sua solução do Visual Studio. (teclado: Ctrl + S)

Implante o aplicativo lógico para o Azure

Antes de executar e testar o fluxo de trabalho, implante o aplicativo no Azure pelo Visual Studio.

  1. No Gerenciador de Soluções, no menu de atalho do projeto, selecione Implantar>Novo. Se solicitado, entre com sua conta do Azure.

    A captura de tela mostra o menu projeto com opções selecionadas para Implantar, Novo.

  2. Para essa implantação, mantenha a assinatura do Azure, o grupo de recursos e outras configurações padrão. Selecione Implantar.

    A captura de tela mostra a caixa de implantação do projeto com a opção selecionada chamada Implantar.

  3. Se a caixa Editar parâmetros for exibida, forneça um nome de recurso para seu aplicativo lógico. Salve suas configurações.

    A captura de tela mostra a caixa Editar Parâmetros com o nome do recurso para o aplicativo lógico.

    Ao iniciar a implantação, o status da implantação do aplicativo é exibido na janela Saída do Visual Studio. Se o status não aparecer, abra a lista Mostrar saída de e selecione o grupo de recursos do Azure.

    A captura de tela mostra a janela Saída com saída de status de implantação.

    Se os conectores selecionados precisarem de alguma inserção sua, uma janela do PowerShell abrirá em segundo plano e solicitará as senhas ou chaves secretas necessárias. Depois de inserir essas informações, a implantação continuará.

    A captura de tela mostra a janela do PowerShell com prompt para fornecer credenciais de conexão.

    Após a implantação ser concluída, seu aplicativo lógico estará ativo no portal do Azure e será executado em seu agendamento especificado (a cada minuto). Se o gatilho encontrar novos itens de feed, ele será disparado e criará uma instância de fluxo de trabalho que executará as ações do fluxo de trabalho. O fluxo de trabalho enviará um email para cada novo item. Caso contrário, se o gatilho não localizar novos itens, ele não será disparado e ignorará o instanciamento do fluxo de trabalho. O fluxo de trabalho aguarda até o próximo intervalo antes de verificar.

    Aqui estão emails de exemplo que esse fluxo de trabalho envia. Se você não receber nenhum email, verifique a sua pasta de Lixo eletrônico.

    A captura de tela mostra o exemplo de email do Outlook enviado para cada novo item do RSS

Parabéns, você criou e implantou o fluxo de trabalho de aplicativo lógico com o Visual Studio com sucesso. Para gerenciar o fluxo de trabalho do aplicativo lógico e examinar o histórico de execuções, confira Gerenciar aplicativos lógicos com o Visual Studio.

Adicionar novo aplicativo lógico

Quando há um projeto existente do Grupo de Recursos do Azure, você pode adicionar um novo aplicativo lógico em branco a esse projeto usando a janela Estrutura de tópicos JSON.

  1. No Gerenciador de Soluções, abra o arquivo <logic-app-name>.json.

  2. No menu Exibir, selecione Outras janelas>Estrutura de tópicos JSON.

  3. Para adicionar um recurso ao arquivo de modelo, selecione Adicionar Recurso, na parte superior da janela Estrutura de tópicos JSON. Ou, na janela Estrutura de Tópicos JSON, abra o menu de atalho recursos e selecione Adicionar Novo Recurso.

    A captura de tela mostra a janela chamada Estrutura de Tópicos JSON.

  4. Na caixa de diálogo Adicionar Recurso, na caixa de pesquisa, localize aplicativo lógico e selecione Aplicativo Lógico. Nomeie o recurso de aplicativo lógico e selecione Adicionar.

    A captura de tela mostra as etapas para adicionar recursos.

Limpar os recursos

Quando terminar com seu aplicativo lógico, exclua o grupo de recursos que contém seu aplicativo lógico e os recursos relacionados.

  1. Entre no portal do Azure com a mesma conta usada para criar seu aplicativo lógico.

  2. No menu do portal do Azure, selecione Grupos de recursos ou pesquise e selecione Grupos de recursos em qualquer página. Selecione o grupo de recursos do aplicativo lógico.

  3. Na página Visão geral, selecione Excluir grupo de recursos. Insira o nome do grupo de recursos como confirmação e selecione Excluir.

    A captura de tela mostra as opções selecionadas para grupos de recursos, visão geral, excluir grupo de recursos.

  4. Exclua a solução do Visual Studio do computador local.

Próximas etapas

Neste artigo, você criou, implantou e executou o fluxo de trabalho de aplicativo lógico com o Visual Studio. Para saber mais sobre como gerenciar e executar a implantação avançada para aplicativos lógicos com o Visual Studio, confira o seguinte artigo: