Guia de início rápido: crie fluxos de trabalho de integração automatizados com aplicativos lógicos do Azure multilocatários e Visual Studio

Artigo
03/01/2024

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

Este guia de início rápido mostra como projetar, desenvolver e implantar fluxos de trabalho automatizados que integram aplicativos, dados, sistemas e serviços em empresas e organizações usando 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 adicionar seus aplicativos lógicos ao controle do código-fonte, publicar versões diferentes e criar modelos do Azure Resource Manager para diferentes ambientes de implantação. 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.

Se você é novo nos Aplicativos Lógicos do Azure e deseja apenas 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 que 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 o feed RSS de um site e envia e-mails para cada novo item nesse feed. Seu 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, lógica do fluxo de trabalho do aplicativo.

Pré-requisitos

Uma conta e subscrição do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita. Se você tiver uma assinatura do Azure Government, siga estas etapas adicionais para configurar o Visual Studio for Azure Government Cloud.
Transfira e instale estas ferramentas, se ainda não as tiver:
- Visual Studio 2019 - Community edition, que é gratuito. Este guia de início rápido usa o Visual Studio Community 2017.
  
  Importante
  
  Se você usar o Visual Studio 2019 ou 2017, certifique-se de selecionar a carga de trabalho de desenvolvimento do Azure.
  
  A extensão Azure Logic Apps não está disponível para o Visual Studio 2022.
- SDK do Microsoft Azure para .NET (2.9.1 ou posterior). Saiba mais sobre o SDK do Azure para .NET.
- Azure PowerShell
- As Ferramentas de Aplicativos Lógicos do Azure correspondentes para a extensão do Visual Studio, que não está disponível para o Visual Studio 2022:
  - Visual Studio 2019
  - Visual Studio 2017
  Você pode baixar e instalar as Ferramentas de Aplicativos Lógicos do Azure diretamente do Visual Studio Marketplace ou aprender a instalar essa extensão de dentro do Visual Studio. Certifique-se de que reinicia o Visual Studio depois de concluir a instalação.
Acesso à Web ao usar o designer de fluxo de trabalho incorporado

O designer precisa de uma conexão com a Internet para criar recursos no Azure e ler propriedades e dados de conectores em seu fluxo de trabalho de aplicativo lógico.
Uma conta de email suportada pelos Aplicativos Lógicos do Azure, como o Outlook para Microsoft 365, Outlook.com ou Gmail. Para outros fornecedores, consulte a lista de conectores aqui. Este exemplo usa o Office 365 Outlook. Se utilizar outro fornecedor, os passos gerais são os mesmos, mas a IU poderá ser ligeiramente diferente.

Importante

Se você quiser usar o conector do Gmail, somente as contas comerciais do G-Suite poderão usar esse conector sem restrições nos fluxos de trabalho lógicos do aplicativo. 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.
Se o fluxo de trabalho do 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 pelo serviço ou tempo de execução dos Aplicativos Lógicos do Azure na região do Azure onde o recurso do aplicativo lógico existe. Se o fluxo de trabalho do aplicativo lógico também usar conectores gerenciados, como o conector do Outlook do Office 365 ou o conector SQL, ou usar conectores personalizados, o firewall também precisará permitir o acesso a todos os endereços IP de saída do conector gerenciado na região do Azure do recurso do aplicativo lógico.

Configurar o Visual Studio para o Azure Government

Visual Studio 2019

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

Feche o Visual Studio.
Encontre o arquivo JSON gerado nomeado Azure U.S. Government-A3EC617673C6C70CC6B9472656832A26.Configuration neste local:

%localappdata%\.IdentityService\AadConfigurations
Renomeie o arquivo JSON para AadProvider.Configuration.json.
Reinicie o Visual Studio.
Continue com as etapas para entrar com sua conta do Azure Government.

Para reverter essa instalaçã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 Visual Studio do Seletor de Ambiente do Azure, que pode ser baixada e instalada do Visual Studio Marketplace.

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

Inicie o Visual Studio. Inicie sessão com a sua conta do Azure.
No menu Ficheiro, selecione Novo>Projeto. (Teclado: Ctrl + Shift + N)
Em Instalado, selecione Visual C# ou Visual Basic. Selecione Cloud>Grupo de Recursos do Azure. Atribua um nome ao projeto, por exemplo:

Nota

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

Se a Nuvem ou o Grupo de Recursos do Azure não aparecer, certifique-se de instalar o SDK do Azure para Visual Studio.

Se estiver a utilizar o Visual Studio 2019, siga estes passos:
1. Na caixa Criar um novo projeto, selecione o projeto do Grupo de Recursos do Azure para Visual C# ou Visual Basic. Selecione Seguinte.
2. Forneça um nome para o grupo de recursos do Azure que você deseja usar e outras informações do projeto. Selecione Criar.
Na lista de modelos, selecione o modelo Aplicativo Lógico. Selecione OK.

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

Criar fluxo de trabalho de aplicativo lógico em branco

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

No Gerenciador de Soluções, abra o menu de atalho do arquivo LogicApp.json . Selecione Abrir com o Estruturador da Aplicação Lógica. (Teclado: Ctrl + L)

Gorjeta

Se você não tiver esse comando no Visual Studio 2019, verifique se você tem as atualizações mais recentes para o Visual Studio.

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

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

Selecionar a subscrição do Azure, o grupo de recursos e a localização dos recursos

Definição	Valor de exemplo	Description
Conta de utilizador	Fabrikam sophia-owen@fabrikam.com	A conta que você usou quando entrou no Visual Studio
Subscrição	Pré-pago conforme o uso (sophia-owen@fabrikam.com)	O nome da sua subscrição do Azure e a conta associada
Grupo de Recursos	MyLogicApp-RG (E.U.A. Oeste)	O grupo de recursos do Azure e o local para armazenar e implantar os recursos do seu aplicativo lógico
Location	O mesmo que o Grupo de Recursos	O tipo de local e o local específico para implantar seu recurso de aplicativo lógico. O tipo de local é uma região do Azure ou um ISE (ambiente de serviço de integração) existente. Para este início rápido, mantenha o tipo de local definido como Região e o local definido como Mesmo que Grupo de Recursos. Observação: depois de criar seu projeto de grupo de recursos, você pode alterar o tipo de local e o local, mas diferentes tipos de local afetam seu aplicativo lógico de várias maneiras.

O designer de fluxo de trabalho abre uma página que mostra um vídeo de introdução e gatilhos comumente usados. Role para baixo após o vídeo e aciona até Modelos e selecione Aplicativo lógico em branco.

Crie o seu fluxo de trabalho

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

No designer de fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho RSS chamado Quando um item de feed é publicado.
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 retorne a este artigo.

Quando terminar, seu fluxo de trabalho será semelhante a este exemplo:
Salve sua solução do Visual Studio. (Teclado: Ctrl+S)

Implementar a aplicação lógica no Azure

Antes de executar e testar seu fluxo de trabalho, implante o aplicativo no Azure a partir do Visual Studio.

No Explorador de Soluções, no menu de atalho do projeto, selecione Implementar>Novo.... Se lhe for pedido, inicie sessão com a sua conta do Azure.
Para essa implantação, mantenha a assinatura padrão do Azure, o grupo de recursos e outras configurações. Selecione Implementar.
Se a caixa Editar parâmetros for exibida, forneça um nome de recurso para seu aplicativo lógico. Guarde as definições.

Quando a implementação é iniciada, o estado de implementação da sua aplicação é apresentado na janela Saída do Visual Studio. Se o estado não for apresentado, abra a lista Mostrar saída de e selecione o seu grupo de recursos do Azure.

Se os conectores selecionados precisarem de sua entrada, uma janela do PowerShell será aberta em segundo plano e solicitará as senhas ou chaves secretas necessárias. Após introduzir estas informações, a implementação continua.

Após a conclusão da implantação, seu aplicativo lógico fica ativo no portal do Azure e é executado em sua agenda especificada (a cada minuto). Se o gatilho encontrar novos itens de feed, o gatilho será acionado e criará uma instância de fluxo de trabalho que executará as ações do fluxo de trabalho. Seu fluxo de trabalho envia e-mails para cada novo item. Caso contrário, se o gatilho não encontrar novos itens, o gatilho não será acionado e "ignorará" instanciando o fluxo de trabalho. Seu fluxo de trabalho aguarda até o próximo intervalo antes de verificar.

Aqui estão exemplos de e-mails que este fluxo de trabalho envia. Se não receber nenhum e-mail, veja a pasta de e-mail de lixo.

Parabéns, você criou e implantou com sucesso seu fluxo de trabalho de aplicativo lógico com o Visual Studio. Para gerenciar seu fluxo de trabalho de aplicativo lógico e revisar o histórico de execução, consulte Gerenciar aplicativos lógicos com o Visual Studio.

Adicionar novo aplicativo lógico

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

No Gerenciador de Soluções, abra o <logic-app-name>.json arquivo.
No menu Exibir, selecione Outra estrutura de tópicos JSON do Windows>.
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 de recursos e selecione Adicionar Novo Recurso.
Na caixa de diálogo Adicionar Recurso, na caixa de pesquisa, localize o aplicativo lógico e selecione Aplicativo lógico. Nomeie seu recurso de aplicativo lógico e selecione Adicionar.

Clean up resources (Limpar recursos)

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

Inicie sessão no portal do Azure com a mesma conta utilizada para criar a aplicação lógica.
No menu do portal do Azure, selecione Grupos de recursos ou procure e selecione Grupos de recursos em qualquer página. Selecione o grupo de recursos do seu aplicativo lógico.
Na página Visão geral, selecione Excluir grupo de recursos. Insira o nome do grupo de recursos como confirmação e selecione Excluir.
Elimine a solução do Visual Studio do seu computador local.

Próximos passos

Neste artigo, você criou, implantou e executou seu 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, consulte o seguinte artigo:

Gerir aplicações lógicas com o Visual Studio

Partilhar via