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

Artigo
01/10/2024

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 Locatário único versus multilocatário nos Aplicativos Lógicos do Azure.

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, 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 e gerenciar aplicativos por meio da CLI do Azure. No Visual Studio Code, o aplicativo lógico se parece com o exemplo a seguir:

Exemplo de definição de fluxo de trabalho de aplicativo lógico

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

Abra o Visual Studio Code. Na barra de ferramentas Código do Visual Studio, selecione o ícone do Azure.
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.
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.
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.
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

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

Uma lista é exibida e mostra todos os grupos de recursos do Azure em sua assinatura.
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.
Forneça um nome para seu grupo de recursos do Azure e pressione ENTER.
Selecione a região do Azure onde você deseja salvar os metadados do seu aplicativo lógico.
Forneça um nome para seu aplicativo lógico e pressione Enter.

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.

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": "Title: @{triggerBody()?['title']} \n \nDate published: @{triggerBody()?['updatedOn']} \n \nLink: @{triggerBody()?['primaryLink']}",
 "Subject": "RSS item: @{triggerBody()?['title']}",
 "To": "sophia-owen@fabrikam.com"
 },
 "host": {
 "connection": {
 "name": "@parameters('$connections')['office365']['connectionId']"
 }
 },
 "method": "post",
 "path": "/v2/Mail"
 }
 }
 },
 "outputs": {}
}
```
Quando terminar, salve a definição de fluxo de trabalho do seu aplicativo lógico. (Menu > Arquivo Salvar ou pressione Ctrl+S)
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.

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:

Exibir aplicativo lógico no designer somente leitura

Ver no portal do Azure

Para rever a sua aplicação lógica no portal do Azure, siga estes passos:

Entre no portal do Azure usando a mesma conta e assinatura do Azure associada ao seu aplicativo lógico.
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.

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.

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.
Na janela do Azure, em Aplicativos Lógicos, expanda sua assinatura do Azure e selecione o aplicativo lógico desejado.
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.

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.
Faça suas alterações na definição de fluxo de trabalho do aplicativo lógico.
Quando tiver terminado, guarde as alterações. (Menu > Arquivo Salvar ou pressione Ctrl+S)
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.

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.

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

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

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.
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.
Encontre o aplicativo lógico que você deseja excluir, abra o menu do aplicativo lógico e selecione Excluir.

Próximos passos

Criar fluxos de trabalho de aplicativo lógico baseado em locatário único no Visual Studio Code

Partilhar via