Partilhar via

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

  • Artigo

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

Embora você possa criar, editar, gerenciar e implantar aplicativos lógicos no portal do Azure, também pode usar o Visual Studio quando quiser adicionar seus aplicativos lógicos ao controle do código-fonte, publicar versões diferentes e criar modelos do Azure Resource Manager para vários ambientes de implantação. Com o Visual Studio Cloud Explorer, você pode localizar e gerenciar seus aplicativos lógicos junto com outros recursos do Azure. Por exemplo, você pode abrir, baixar, editar, executar, exibir o histórico de execução, desabilitar e habilitar aplicativos lógicos que já estão implantados no portal do Azure. Se você é novo em trabalhar com Aplicativos Lógicos do Azure no Visual Studio, saiba como criar aplicativos lógicos com o Visual Studio.

Você também pode gerenciar seus aplicativos lógicos no portal do Azure.

Importante

Implantar ou publicar um aplicativo lógico do Visual Studio substitui a versão desse aplicativo no portal do Azure. Portanto, se você fizer alterações no portal do Azure que deseja manter, atualize o aplicativo lógico no Visual Studio a partir do portal do Azure antes da próxima vez que implantar ou publicar do Visual Studio .

Pré-requisitos

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.

  1. Abra o Visual Studio. No menu Exibir, selecione Cloud Explorer.

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

    Select

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

  1. Abra o Cloud Explorer e encontre seu aplicativo lógico.

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

    Open deployed logic app from Azure portal

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

  1. No Visual Studio, usando o Cloud Explorer, abra o aplicativo lógico que você deseja baixar do Azure.

  2. 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 Logic App Designer.

  3. Na barra de ferramentas do designer, selecione Download.

    Download logic app from Azure portal

  4. 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 resources aplicativo 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.

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. Saiba mais sobre projetos do Grupo de Recursos do Azure para aplicativos lógicos no Visual Studio.

  1. No Visual Studio, abra o projeto do Grupo de Recursos do Azure que contém seu aplicativo lógico.

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

    Open logic app's .json file with Logic App Designer

    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.

  3. Certifique-se de que o Designer de Aplicativo Lógico 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.

    Properties window -

    Gorjeta

    Se a janela Propriedades ainda não estiver aberta, no menu Exibir , selecione Janela Propriedades. (Teclado: pressione F4)

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

    Open

  5. 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) em 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. Esse local é uma região do Azure ou um ISE (ambiente de serviço de integração) existente.

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 Aplicativo Lógico. Não é possível alterar essas propriedades usando o Cloud Explorer.

Importante

Alterar o tipo de local de Região para Ambiente de Serviço de Integração afeta o modelo de preços do seu aplicativo lógico que é usado para cobrança, limites, suporte à conta de integração e assim por diante. Antes de selecionar um tipo de local diferente, certifique-se de entender o impacto resultante em seu aplicativo lógico.

  1. No Visual Studio, abra o projeto do Grupo de Recursos do Azure que contém seu aplicativo lógico.

  2. No Gerenciador de Soluções, abra o menu de atalho do arquivo e selecione Abrir com o <logic-app-name>.json Logic App Designer. (Teclado: Ctrl + L)

    Open logic app's .json file with Logic App Designer

    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.

  3. Certifique-se de que o Designer de Aplicativo Lógico 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 ou Ambiente do Serviço de Integração.

    Properties window -

    Gorjeta

    Se a janela Propriedades ainda não estiver aberta, no menu Exibir , selecione Janela Propriedades. (Teclado: pressione F4)

  4. Para alterar o tipo de local, abra a lista de propriedades Escolher Tipo de Local e selecione o tipo de local desejado.

    Por exemplo, se o tipo de local for Ambiente do Serviço de Integração, você poderá selecionar Região.

  5. Para alterar o local específico, abra a lista de propriedades Local . Com base no tipo de local, selecione o local desejado, por exemplo:

    • Selecione uma região diferente do Azure:

      Open

    • Selecione um ISE diferente:

      Open

  6. 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 Logic App Designer, selecione Atualizar.

    - ou -

  • No Visual Studio Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Atualizar.

Refresh logic app with updates

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 Logic App Designer, selecione Publicar.

Publish updated logic app to Azure portal

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 Logic App Designer, selecione Run Trigger.

Manually run trigger for your logic app

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.

  1. No Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Abrir histórico de execução.

    Open run history for your logic app

  2. Para exibir os detalhes de uma execução específica, clique duas vezes em uma execução. Por exemplo:

    View information about specific run

    Gorjeta

    Para classificar a tabela por propriedade, selecione o cabeçalho da coluna dessa propriedade.

  3. Expanda as etapas cujas entradas e saídas você deseja revisar, por exemplo:

    View inputs and outputs for each step

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:

    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.

Desativar aplicativos lógicos

No Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Desativar.

Disable your logic app in Cloud Explorer

Habilitar aplicativos lógicos

No Cloud Explorer, abra o menu de atalho do aplicativo lógico e selecione Ativar.

Enable logic app in Cloud Explorer

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

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.

Delete your logic app from Azure portal

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:

Criar definições de aplicativo lógico em JSON