Gerenciar aplicativos lógicos com o Visual Studio (preterido)
Aplica-se a: Aplicativos Lógicos do Azure (Consumo)
Importante
A extensão Ferramentas de Aplicativos Lógicos do Azure para Visual Studio foi preterida e não recebe mais atualizações. Para criar e gerenciar fluxos de trabalho de aplicativos lógicos usando um ambiente de desenvolvimento local, consulte a seguinte documentação:
Você pode criar, editar, gerenciar e implantar fluxos de trabalho automatizados que integram serviços, sistemas, aplicativos e dados entre empresas e organizações usando os Aplicativos Lógicos do Azure. Embora você possa executar essas tarefas no portal do Azure, também pode usar um ambiente de desenvolvimento local para criar projetos de aplicativo lógico que você pode adicionar ao controle do código-fonte, publicar versões diferentes e criar modelos do Azure Resource Manager para diferentes ambientes de implantação.
Pré-requisitos
Uma subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.
Transfira e instale estas ferramentas, se ainda não as tiver:
Visual Studio 2019 - Community edition ou superior. A extensão Aplicativos Lógicos do Azure está atualmente indisponível para o Visual Studio 2022. Este guia usa o Visual Studio Community 2017, que é gratuito.
Importante
Ao instalar o Visual Studio 2019, certifique-se de selecionar a carga de trabalho de desenvolvimento do Azure. Para obter mais informações, consulte Gerenciar recursos associados às suas contas do Azure no Visual Studio Cloud Explorer.
As mais recentes Ferramentas de Aplicativos Lógicos do Azure para a extensão do Visual Studio para Visual Studio 2019
Pode transferir e instalar as Ferramentas do Azure Logic Apps diretamente a partir do Visual Studio Marketplace ou saiba como instalar esta extensão a partir do Visual Studio. Certifique-se de que reinicia o Visual Studio depois de concluir a instalação.
Para usar assinaturas do Azure Government com o Visual Studio, consulte Guia de início rápido: conectar-se ao Azure Government com o Visual Studio para obter configuração adicional.
Acesso à Web ao usar o designer de fluxo de trabalho incorporado para Aplicativos Lógicos do Azure
O estruturador precisa de uma ligação à Internet para criar recursos no Azure e ler as propriedades e os dados a partir de conectores na sua aplicação lógica.
Encontrar aplicativos lógicos
No Visual Studio, você pode encontrar todos os aplicativos lógicos associados à sua assinatura do Azure e implantados no portal do Azure usando o Cloud Explorer.
Abra o Visual Studio. No menu Exibir, selecione Cloud Explorer.
No Cloud Explorer, selecione o ícone Gerenciamento de contas. Selecione a assinatura do Azure associada aos seus aplicativos lógicos e selecione Aplicar. Por exemplo:
Ao lado do ícone Gerenciamento de conta, selecione Tipos de recursos. Em sua assinatura do Azure, expanda Aplicativos Lógicos para que você possa exibir todos os aplicativos lógicos implantados associados à sua assinatura.
Em seguida, abra seu aplicativo lógico no Editor do Aplicativo Lógico.
Abrir aplicativos lógicos no Visual Studio
No Visual Studio, você pode abrir aplicativos lógicos criados e implantados anteriormente diretamente por meio do portal do Azure ou como projetos do Grupo de Recursos do Azure com o Visual Studio.
No menu de atalho do aplicativo lógico, selecione Abrir com o Editor do Aplicativo Lógico.
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.
Depois que o aplicativo lógico for aberto no Designer de Aplicativos Lógicos, na parte inferior do designer, você poderá selecionar Visualização de Código para poder revisar a estrutura de definição do aplicativo lógico subjacente. Se você quiser criar um modelo de implantação para o aplicativo lógico, saiba como baixar um modelo do Azure Resource Manager para esse aplicativo lógico. Saiba mais sobre os modelos do Resource Manager.
Transferir a partir do Azure
Você pode baixar aplicativos lógicos do portal do Azure e salvá-los como modelos do Azure Resource Manager. Em seguida, você pode editar localmente os modelos com o Visual Studio e personalizar aplicativos lógicos para diferentes ambientes de implantação. O download de aplicativos lógicos parametriza automaticamente suas definições dentro dos modelos do Gerenciador de Recursos, que também usam JavaScript Object Notation (JSON).
No Visual Studio, usando o Cloud Explorer, abra o aplicativo lógico que você deseja baixar do Azure.
No menu de atalho do aplicativo lógico, selecione Abrir com o Editor do Aplicativo Lógico.
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 aplicativo lógico é aberto no designer de fluxo de trabalho.
Na barra de ferramentas do designer, selecione Download.
Quando for solicitado um local, navegue até esse local e salve o modelo do Gerenciador de Recursos para a definição de aplicativo lógico no formato de arquivo JSON (.json).
Sua definição de
resourcesaplicativo lógico aparece na subseção dentro do modelo do Gerenciador de Recursos. Agora você pode editar a definição de aplicativo lógico e o modelo do Gerenciador de Recursos com o Visual Studio. Você também pode adicionar o modelo como um projeto do Grupo de Recursos do Azure a uma solução do Visual Studio. Saiba mais sobre projetos do Grupo de Recursos do Azure para aplicativos lógicos no Visual Studio.
Link para a conta de integração
Para criar aplicativos lógicos para cenários de integração empresarial B2B (business-to-business), você pode vincular seu aplicativo lógico a uma conta de integração criada anteriormente que existe na mesma região que seu aplicativo lógico. Uma conta de integração contém artefatos B2B, como parceiros comerciais, contratos, esquemas e mapas, e permite que seu aplicativo lógico use conectores B2B para validação XML e codificação ou decodificação de arquivos simples. Embora você possa criar esse link usando o portal do Azure, você também pode usar o Visual Studio depois de atender aos pré-requisitos, e seu aplicativo lógico existe como um arquivo JSON (.json) dentro de um projeto do Grupo de Recursos do Azure.
No Visual Studio, abra o projeto do Grupo de Recursos do Azure que contém seu aplicativo lógico.
No Gerenciador de Soluções, abra o menu de atalho do <arquivo logic-app-name>.json e selecione Abrir com o Logic App Designer. (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 e a extensão Ferramentas de Aplicativos Lógicos do Azure.
Certifique-se de que o designer de fluxo de trabalho tenha foco selecionando a guia ou superfície do designer para que a janela Propriedades mostre a propriedade Conta de integração para seu aplicativo lógico.
Gorjeta
Se a janela Propriedades ainda não estiver aberta, no menu Exibir , selecione Janela Propriedades. (Teclado: pressione F4)
Abra a lista de propriedades Conta de integração e selecione a conta de integração que você deseja vincular ao seu aplicativo lógico, por exemplo:
Quando terminar, lembre-se de salvar sua solução do Visual Studio.
Quando você define a propriedade Conta de Integração no Visual Studio e salva seu aplicativo lógico como um modelo do Azure Resource Manager, esse modelo também inclui uma declaração de parâmetro para a conta de integração selecionada. Para obter mais informações sobre parâmetros de modelo e aplicativos lógicos, consulte Visão geral: automatizar a implantação de aplicativos lógicos.
Alterar local de implantação
No Visual Studio, se seu aplicativo lógico existir como um arquivo JSON (.json) dentro de um projeto do Grupo de Recursos do Azure que você usa para automatizar a implantação, esse aplicativo lógico será definido como um tipo de local e um local específico, que é uma região do Azure.
Para alterar o tipo de local ou o local do aplicativo lógico, você precisa abrir o arquivo de definição de fluxo de trabalho (.json) do aplicativo lógico no Gerenciador de Soluções usando o designer de fluxo de trabalho. Não é possível alterar essas propriedades usando o Cloud Explorer.
No Visual Studio, abra o projeto do Grupo de Recursos do Azure que contém seu aplicativo lógico.
No Gerenciador de Soluções, abra o
<logic-app-name>.jsonmenu de atalho do arquivo e selecione Abrir com o Logic App Designer. (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 e a extensão Ferramentas de Aplicativos Lógicos do Azure.
Certifique-se de que o designer de fluxo de trabalho tenha foco selecionando a guia ou superfície do designer para que a janela Propriedades mostre as propriedades Escolher Tipo de Local e Localização para seu aplicativo lógico.
O tipo de local do projeto é definido como Região.
Gorjeta
Se a janela Propriedades ainda não estiver aberta, no menu Exibir , selecione Janela Propriedades. (Teclado: pressione F4)
Para alterar o local específico, abra a lista de propriedades Local . Com base no tipo de local, selecione o local desejado, por exemplo:
Quando terminar, lembre-se de salvar sua solução do Visual Studio.
Quando você altera o tipo de local ou local no Visual Studio e salva seu aplicativo lógico como um modelo do Azure Resource Manager, esse modelo também inclui declarações de parâmetro para esse tipo de local e local. Para obter mais informações sobre parâmetros de modelo e aplicativos lógicos, consulte Visão geral: automatizar a implantação de aplicativos lógicos.
Atualizar a partir do Azure
Se você editar seu aplicativo lógico no portal do Azure e quiser manter essas alterações, atualize a versão desse aplicativo no Visual Studio com essas alterações.
No Visual Studio, na barra de ferramentas do designer de fluxo de trabalho, selecione Atualizar.
-or-
No Visual Studio Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Atualizar.
Publicar atualizações de aplicação lógica
Quando estiver pronto para implantar suas atualizações de aplicativo lógico do Visual Studio para o Azure, na barra de ferramentas do designer de fluxo de trabalho, selecione Publicar.
Executar manualmente a aplicação lógica
Você pode acionar manualmente um aplicativo lógico implantado no Azure a partir do Visual Studio. Na barra de ferramentas do designer de fluxo de trabalho, selecione Executar gatilho.
Rever o histórico de execuções
Para verificar o status e diagnosticar problemas com execuções de aplicativos lógicos, você pode revisar os detalhes, como entradas e saídas, para essas execuções no Visual Studio.
No Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Abrir histórico de execução.
Para exibir os detalhes de uma execução específica, clique duas vezes em uma execução. Por exemplo:
Gorjeta
Para classificar a tabela por propriedade, selecione o cabeçalho da coluna dessa propriedade.
Expanda as etapas cujas entradas e saídas você deseja revisar, por exemplo:
Desativar ou ativar aplicações lógicas
Para impedir que o gatilho dispare na próxima vez que a condição do gatilho for atendida, desative seu aplicativo lógico. A desativação de um aplicativo lógico afeta as instâncias de fluxo de trabalho das seguintes maneiras:
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:
No aplicativo lógico, edite qualquer parte do gatilho do fluxo de trabalho.
Guardar as suas alterações. Esta etapa redefine o estado atual do gatilho.
Reative seu aplicativo lógico.
Quando um fluxo de trabalho é desativado, você ainda pode reenviar execuções.
Desativar aplicativos lógicos
No Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Desativar.
Habilitar aplicativos lógicos
No Cloud Explorer, abra o menu de atalho 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 execuções podem ser pegas para execução enquanto o tempo de execução funciona através do 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
Unauthorizederro. 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.
Para excluir seu aplicativo lógico do portal do Azure, no Gerenciador de Nuvem, abra o menu de atalho do aplicativo lógico e selecione Excluir.
Resolução de Problemas
Quando você abre seu projeto de aplicativo lógico no Designer de Aplicativos Lógicos, talvez não obtenha a opção para selecionar sua assinatura do Azure. Em vez disso, seu aplicativo lógico é aberto com uma assinatura do Azure que não é a que você deseja usar. Esse comportamento acontece porque depois de abrir o arquivo .json de um aplicativo lógico, o Visual Studio armazena em cache a primeira assinatura selecionada para uso futuro. Para resolver esse problema, tente uma destas etapas:
Renomeie o arquivo .json do aplicativo lógico. O cache de assinatura depende do nome do arquivo.
Para remover assinaturas selecionadas anteriormente para todos os aplicativos lógicos em sua solução, exclua a pasta oculta de configurações do Visual Studio (.vs) no diretório da solução. Esta localização armazena as informações da sua subscrição.
Próximos passos
Neste artigo, você aprendeu como gerenciar aplicativos lógicos implantados com o Visual Studio. Em seguida, saiba mais sobre como personalizar definições de aplicativos lógicos para implantação: