Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão usando o portal do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Padrão)

Este guia de instruções mostra como criar um fluxo de trabalho automatizado de exemplo que aguarda uma solicitação da Web de entrada e, em seguida, envia uma mensagem para uma conta de email. Mais especificamente, você cria um recurso de aplicativo lógico Padrão, que pode incluir vários fluxos de trabalho com e sem monitoração de estado que são executados em Aplicativos Lógicos do Azure de locatário único.

• O gatilho Request , que cria um ponto de extremidade chamável que pode lidar com solicitações de entrada de qualquer chamador.
• O conector do Office 365 Outlook , que fornece uma ação para enviar email.

Quando terminar, o fluxo de trabalho terá a seguinte aparência do seguinte exemplo de alto nível:

Você pode ter vários fluxos de trabalho em um aplicativo lógico padrão. Os fluxos de trabalho no mesmo aplicativo lógico e no locatário são executados no mesmo processo que o tempo de execução dos Aplicativos Lógicos do Azure, portanto, eles compartilham os mesmos recursos e fornecem melhor desempenho.

As operações neste exemplo são de dois conectores entre 1000+ conectores que você pode usar em um fluxo de trabalho. Embora este exemplo seja baseado na nuvem, você pode criar fluxos de trabalho que integram uma vasta gama de aplicativos, dados, serviços e sistemas em ambientes de nuvem, locais e híbridos.

À medida que progride, você conclui estas tarefas de alto nível:

Para criar um fluxo de trabalho de aplicativo lógico padrão a partir de um modelo pré-criado que segue um padrão comumente usado, consulte Criar um fluxo de trabalho de aplicativo lógico padrão a partir de um modelo pré-criado.

Para criar e gerenciar um fluxo de trabalho de aplicativo lógico padrão usando outras ferramentas, consulte Criar fluxos de trabalho padrão com o Visual Studio Code. Com o Visual Studio Code, você pode desenvolver, testar e executar fluxos de trabalho em seu ambiente de desenvolvimento local .

Para obter mais informações, veja a seguinte documentação:

• Inquilino único versus multilocatário
• Criar e implantar em ambientes diferentes

Pré-requisitos

• Uma conta e subscrição do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.

• Uma conta de Armazenamento do Azure. Se você não tiver uma, poderá criar uma conta de armazenamento com antecedência ou durante a criação do aplicativo lógico.

  Nota

  O tipo de recurso de aplicativo lógico padrão é alimentado pelo Azure Functions e tem requisitos de armazenamento semelhantes aos aplicativos de função. Os fluxos de trabalho com monitoração de estado executam transações de armazenamento, como o uso de filas para agendar e armazenar estados do fluxo de trabalho em tabelas e blobs. Estas transações incorrem em encargos de armazenamento. Para obter mais informações sobre como fluxos de trabalho com monitoração de estado armazenam dados em armazenamento externo, consulte Fluxos de trabalho com e sem monitoração de estado.

• Uma conta de email de um provedor de email suportado pelos Aplicativos Lógicos do Azure, como o Office 365 Outlook, Outlook.com ou Gmail. Para outros provedores de email com suporte, consulte Conectores para Aplicativos Lógicos do Azure.

  Este exemplo usa o Office 365 Outlook com uma conta corporativa ou de estudante. Se você usar uma conta de e-mail diferente, as etapas gerais permanecerão as mesmas, mas a experiência do usuário pode ser ligeiramente diferente. Se utilizar Outlook.com, utilize a sua conta Microsoft pessoal para iniciar sessão.

  Nota

  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.

• Instale ou use uma ferramenta que possa enviar solicitações HTTP para testar sua solução, por exemplo:

  • Código do Visual Studio com uma extensão do Visual Studio Marketplace
  • PowerShell Invoke-RestMethod
  • Microsoft Edge - Ferramenta Network Console
  • Adriano
  • ondulação

  Atenção

  Para cenários em que você tem dados confidenciais, como credenciais, segredos, tokens de acesso, chaves de API e outras informações semelhantes, certifique-se de usar uma ferramenta que proteja seus dados com os recursos de segurança necessários, funcione offline ou localmente, não sincronize seus dados com a nuvem e não exija que você entre em uma conta online. Dessa forma, você reduz o risco de exposição de dados confidenciais ao público.

• Para implantar seu recurso de aplicativo lógico padrão em um ambiente do Serviço de Aplicativo v3 (ASEv3) - somente plano do Windows, você precisa criar esse recurso de ambiente primeiro. Em seguida, você pode selecionar esse ambiente como o local de implantação ao criar seu aplicativo lógico. Para obter mais informações, consulte Tipos e ambientes de recursos e Criar um ambiente do Serviço de Aplicativo.

• Para habilitar a comunicação de seus fluxos de trabalho de aplicativo lógico padrão para um ponto de extremidade privado em uma conta de integração Premium, você deve ter uma rede virtual do Azure existente. Seu aplicativo lógico, rede virtual e conta de integração devem usar a mesma região do Azure. Seu aplicativo lógico e sua conta de integração devem existir dentro da mesma rede virtual. Para obter mais informações, consulte Criar uma rede virtual.

• Se você habilitar o Application Insights em seu aplicativo lógico, poderá, opcionalmente, habilitar o registro e o rastreamento de diagnósticos. Você pode fazer isso ao criar seu aplicativo lógico ou após a implantação. Você precisa ter uma instância do Application Insights, mas pode criar esse recurso com antecedência, ao criar seu aplicativo lógico ou após a implantação.

Melhores práticas e recomendações

Para uma melhor capacidade de resposta e desempenho do designer, analise e siga estas diretrizes:

• Não use mais de 50 ações por fluxo de trabalho. Exceder esse número de ações aumenta a possibilidade de um desempenho mais lento do designer.

• Considere dividir a lógica de negócios em vários fluxos de trabalho, quando necessário.

• Não tenha mais de 10 a 15 fluxos de trabalho por recurso de aplicativo lógico.

Mais fluxos de trabalho em seu aplicativo lógico aumentam o risco de tempos de carregamento mais longos, o que afeta negativamente o desempenho. Se você tiver aplicativos lógicos de missão crítica que não exijam implantações de tempo de inatividade, considere configurar slots de implantação.

Criar um recurso de aplicativo lógico padrão

1. No portal do Azure, entre com sua conta do Azure.

2. Na caixa de pesquisa do portal do Azure, insira aplicativo lógico e selecione Aplicativos lógicos.

   

3. Na barra de ferramentas da página Aplicativos lógicos , selecione Adicionar.

   A página Criar Aplicativo Lógico é exibida e mostra as seguintes opções:

   Plano	Descrição
   Consumo	Cria um recurso de aplicativo lógico que dá suporte a apenas um fluxo de trabalho executado em Aplicativos Lógicos do Azure multilocatário e usa o modelo de Consumo para cobrança.
   Standard	Cria um recurso de aplicativo lógico que oferece suporte a vários fluxos de trabalho. Você tem as seguintes opções: - Plano de Serviço de Fluxo de Trabalho: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure de locatário único e usam o modelo Standard para cobrança. - Ambiente do Serviço de Aplicativo V3: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure de locatário único e usam um plano de Ambiente do Serviço de Aplicativo para cobrança. - Híbrido (visualização): os fluxos de trabalho são executados no local e em várias nuvens usando o Kubernetes Event-driven Autoscaling (KEDA). Para obter mais informações, consulte Criar fluxos de trabalho padrão para implantação híbrida.

4. Na página Criar Aplicativo Lógico, selecione Padrão (Plano de Serviço de Fluxo de Trabalho).

   Tipo de plano	Description
   Standard	Esse tipo de aplicativo lógico é a seleção padrão. Os fluxos de trabalho são executados em Aplicativos Lógicos do Azure de locatário único e usam o modelo de preços Padrão.
   Consumo	Esse tipo de aplicativo lógico e fluxo de trabalho é executado em Aplicativos Lógicos do Azure globais e multilocatários e usa o modelo de preços de Consumo.

5. Na página Criar Aplicativo Lógico, na guia Noções básicas, forneça as seguintes informações básicas sobre seu aplicativo lógico:

   Property	Necessário	Valor	Description
   Subscrição	Sim	<Azure-subscrição-nome>	Seu nome de assinatura do Azure. Este exemplo usa Pay-As-You-Go.
   Grupo de Recursos	Sim	<Azure-recurso-grupo-nome>	O grupo de recursos do Azure onde você cria seu aplicativo lógico e recursos relacionados. Esse nome deve ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses (()) e pontos (.). Este exemplo cria um grupo de recursos chamado Fabrikam-Workflows-RG.
   Nome da Aplicação Lógica	Sim	<logic-app-name>	O nome do recurso do aplicativo lógico, que deve ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses (()) e pontos (.). Observação: o nome do seu aplicativo lógico recebe automaticamente o sufixo, .azurewebsites.net, porque o recurso do aplicativo lógico padrão é alimentado pelo tempo de execução dos Aplicativos Lógicos do Azure de locatário único, que usa o modelo de extensibilidade do Azure Functions e é hospedado como uma extensão no tempo de execução do Azure Functions. O Azure Functions usa a mesma convenção de nomenclatura de aplicativo. Este exemplo cria um recurso de aplicativo lógico chamado Fabrikam-Workflows.
   Região	Sim	<Azure-region>	A região do datacenter do Azure para seu aplicativo lógico. Este exemplo usa West US.
   Plano do Windows	Sim	<nome-plano>	O nome do plano a ser usado. Selecione um nome de plano existente ou forneça um nome para um novo plano. Este exemplo usa o nome My-App-Service-Plan. Observação: não use um plano do Serviço de Aplicativo baseado em Linux. Apenas o plano do Serviço de Aplicativo baseado no Windows é suportado.
   Plano de preços	Sim	<Nível de preços>	A camada de preço a ser usada para seu aplicativo lógico e fluxos de trabalho. Sua seleção afeta os preços, a computação, a memória e o armazenamento que seu aplicativo lógico e fluxos de trabalho usam. Para obter mais informações, consulte Planos de hospedagem e níveis de preços.

   Nota

   Se você selecionar uma região do Azure que ofereça suporte à redundância da zona de disponibilidade, a seção Redundância de zona será habilitada. Esta seção oferece a opção de habilitar a redundância da zona de disponibilidade para seu aplicativo lógico. No entanto, as regiões do Azure atualmente suportadas não incluem West US, portanto, você pode ignorar esta seção para este exemplo. Para obter mais informações, consulte Proteger aplicativos lógicos contra falhas de região com redundância de zona e zonas de disponibilidade.

   Quando terminar, as suas definições serão semelhantes ao exemplo seguinte:

   

   Nota

   A configuração FUNCTIONS_WORKER_RUNTIME aplicativo é necessária para seu aplicativo lógico padrão e o valor foi definido anteriormente como nó. No entanto, o valor necessário agora é dotnet para todos os aplicativos lógicos Standard implantados novos e existentes. Essa alteração no valor não deve afetar o tempo de execução do fluxo de trabalho, portanto, tudo deve funcionar da mesma maneira que antes. Para obter mais informações, consulte a configuração do aplicativo FUNCTIONS_WORKER_RUNTIME.

   O valor APP_KIND configuração do aplicativo é necessário para seu aplicativo lógico padrão e o valor deve ser workflowApp. No entanto, em alguns cenários, essa configuração de aplicativo pode estar faltando, por exemplo, devido à automação usando modelos do Azure Resource Manager ou outros cenários em que a configuração não está incluída. Se determinadas ações não funcionarem, como a ação Executar código JavaScript, ou se o fluxo de trabalho parar de funcionar, verifique se a configuração APP_KIND aplicativo existe e está definida como workflowApp. Para obter mais informações, consulte a configuração do aplicativo APP_KIND.

6. Quando terminar, selecione Avançar: Armazenamento.

7. Na guia Armazenamento, forneça as seguintes informações sobre a solução de armazenamento e o plano de hospedagem a serem usados para seu aplicativo lógico.

   Property	Necessário	Valor	Description
   Tipo de armazenamento	Sim	- Armazenamento do Azure - Armazenamento SQL e Azure	O tipo de armazenamento que você deseja usar para artefatos e dados relacionados ao fluxo de trabalho. - Para implantar somente no Azure, selecione Armazenamento do Azure. - Para usar o SQL como armazenamento primário e o Armazenamento do Azure como armazenamento secundário, selecione SQL e Armazenamento do Azure e revise Configurar o armazenamento do banco de dados SQL para aplicativos lógicos padrão em aplicativos lógicos do Azure de locatário único. Observação: se você estiver implantando em uma região do Azure, ainda precisará de uma conta de armazenamento do Azure, que é usada para concluir a hospedagem única da configuração do aplicativo lógico na plataforma de Aplicativos Lógicos do Azure. O estado do fluxo de trabalho, o histórico de execução e outros artefatos de tempo de execução são armazenados em seu banco de dados SQL. Para implantações em um local personalizado hospedado em um cluster do Azure Arc, você só precisa de SQL como seu provedor de armazenamento.
   Conta de armazenamento	Sim	<Azure-storage-account-name>	A conta de Armazenamento do Azure a ser usada para transações de armazenamento. Esse nome de recurso deve ser exclusivo entre regiões e ter de 3 a 24 caracteres com apenas números e letras minúsculas. Selecione uma conta existente ou crie uma nova conta. Este exemplo cria uma conta de armazenamento chamada mystorageacct.

8. Na guia Rede, você pode deixar as opções padrão para seguir o exemplo. No entanto, para cenários específicos do mundo real, certifique-se de revisar e selecionar as seguintes opções apropriadas. Você também pode alterar essa configuração depois de implantar seu recurso de aplicativo lógico. Para obter mais informações, consulte Proteger o tráfego entre aplicativos lógicos padrão e redes virtuais do Azure usando pontos de extremidade privados.

   A seguinte configuração Habilitar acesso público se aplica a pontos de extremidade em seu aplicativo lógico e não afeta se seu aplicativo lógico pode se comunicar com recursos do Azure na mesma rede virtual, por exemplo, uma conta de integração Premium com um ponto de extremidade privado. Para acessar esses recursos do Azure, seu aplicativo lógico deve existir na mesma rede virtual que esses recursos.

   Habilitar acesso público	Comportamento
   Em	Seu aplicativo lógico tem um ponto de extremidade público com um endereço de entrada aberto à Internet. Para clientes que estão fora de uma rede virtual do Azure, eles podem usar esse ponto de extremidade para acessar seu aplicativo lógico, mas não a rede virtual.
   Desativado	Seu aplicativo lógico não tem ponto de extremidade público, mas tem um ponto de extremidade privado para comunicação dentro de uma rede virtual do Azure e está isolado dentro dessa rede virtual. O ponto de extremidade privado pode se comunicar com pontos de extremidade na rede virtual, mas somente de clientes dentro dessa rede. Essa configuração também significa que o tráfego do aplicativo lógico pode ser controlado por grupos de segurança de rede ou afetado por rotas de rede virtual.

   As configurações a seguir controlam o acesso do aplicativo lógico padrão aos pontos de extremidade em uma rede virtual:

   Ativar injeção de rede	Comportamento
   Em	Os fluxos de trabalho do seu aplicativo lógico podem se comunicar de forma privada e segura com pontos de extremidade na rede virtual. Para habilitar a comunicação entre seu aplicativo lógico e um ponto de extremidade privado em uma conta de integração Premium, selecione esta opção, que também disponibiliza a seção Rede Virtual. Em Rede Virtual, selecione a rede virtual do Azure a ser usada. Essa opção disponibiliza as seções Acesso de entrada e Acesso de saída.
   Desativado	Os fluxos de trabalho do aplicativo lógico não podem se comunicar com pontos de extremidade na rede virtual.

   As seções a seguir aparecem depois que você seleciona uma rede virtual quando Habilitar injeção de rede está definido como Ativado.

   Acesso de entrada

   • Habilitar pontos de extremidade privados: Aplica-se a pontos de extremidade privados em seu aplicativo lógico padrão e está disponível somente quando Habilitar acesso público está definido como Desativado.

   Acesso de saída

   • Habilitar a integração de VNet: para habilitar a comunicação entre um aplicativo lógico padrão e um ponto de extremidade privado em uma conta de integração Premium, selecione Ativado e a sub-rede a ser usada.

9. Se suas configurações de criação e implantação oferecerem suporte ao uso do Application Insights, você poderá, opcionalmente, habilitar o registro e o rastreamento de diagnósticos para seus fluxos de trabalho de aplicativos lógicos seguindo estas etapas:

   1. Na guia Monitoramento, em Application Insights, defina Habilitar Application Insights como Sim.

   2. Para a configuração do Application Insights, selecione uma instância existente do Application Insights ou, se quiser criar uma nova instância, selecione Criar nova e forneça o nome que deseja usar.

10. Depois que o Azure validar as configurações do seu aplicativo lógico, na guia Revisar + criar , selecione Criar, por exemplo:

    

    Nota

    Se você receber um erro de validação durante esta etapa, abra e revise os detalhes do erro. Por exemplo, se a região selecionada atingir uma cota para recursos que você está tentando criar, talvez seja necessário tentar uma região diferente.

    Depois que o Azure concluir a implantação, seu recurso de aplicativo lógico estará automaticamente ativo, mas ainda não fará nada porque o recurso está vazio e você ainda não adicionou nenhum fluxo de trabalho.

11. Na página de conclusão da implantação, selecione Ir para recurso para adicionar um fluxo de trabalho em branco.

    

Adicionar um fluxo de trabalho em branco

Depois de criar seu recurso de aplicativo lógico vazio, você precisa adicionar seu primeiro fluxo de trabalho.

1. Depois que o Azure abrir o recurso, no menu do aplicativo lógico, em Fluxos de trabalho, selecione Fluxos de trabalho. Na barra de ferramentas Fluxos de trabalho, selecione Adicionar.

   

2. Depois que o painel Novo fluxo de trabalho for aberto, forneça um nome para o fluxo de trabalho e selecione o tipo de estado, Stateful ou Stateless. Quando terminar, selecione Criar.

   Este exemplo adiciona um fluxo de trabalho com monitoração de estado em branco chamado Stateful-Workflow. Por padrão, o fluxo de trabalho está habilitado, mas não faz nada até que você adicione um gatilho e ações.

   

3. Na lista de fluxo de trabalho, selecione o fluxo de trabalho com monitoração de estado em branco.

4. No menu de fluxo de trabalho, em Desenvolvedor, selecione Designer.

   A superfície do designer mostra um prompt para selecionar uma operação de gatilho. Por padrão, o prompt já está selecionado para que um painel com gatilhos disponíveis já apareça aberto.

Agora, adicione um gatilho que inicie seu fluxo de trabalho.

Adicionar um acionador

Este fluxo de trabalho de exemplo começa com o gatilho Request interno chamado When a HTTP request is received. Esse gatilho cria um ponto de extremidade que outros serviços ou fluxos de trabalho de aplicativos lógicos podem chamar e aguarda a chegada dessas chamadas ou solicitações de entrada. As operações internas são executadas nativamente e diretamente no tempo de execução dos Aplicativos Lógicos do Azure.

1. No designer de fluxo de trabalho, verifique se o fluxo de trabalho em branco está aberto e se o prompt Adicionar um gatilho está selecionado na superfície do designer.

2. Usando solicitação como o termo de pesquisa, siga estas etapas para adicionar o gatilho de solicitação interno chamado Quando uma solicitação HTTP é recebida ao seu fluxo de trabalho.

   Quando o gatilho aparece no designer, o painel de informações do gatilho é aberto para mostrar as propriedades, configurações e outras ações do gatilho.

   

3. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

   Quando você salva um fluxo de trabalho pela primeira vez e esse fluxo de trabalho começa com um gatilho de Solicitação , os Aplicativos Lógicos do Azure geram automaticamente uma URL para um ponto de extremidade criado pelo gatilho de Solicitação . Mais tarde, ao testar seu fluxo de trabalho, você envia uma solicitação para essa URL, que dispara o gatilho e inicia a execução do fluxo de trabalho.

Adicionar uma ação

Este fluxo de trabalho de exemplo continua com a ação do conector gerenciado do Outlook do Office 365 chamada Enviar um email. As operações de conector gerenciado são executadas no Azure versus nativa e diretamente no tempo de execução dos Aplicativos Lógicos do Azure.

1. No designer, sob o gatilho que você adicionou, selecione o sinal de adição (+) >Adicionar uma ação.

   O painel Adicionar uma ação é aberto para que você possa selecionar a próxima ação.

2. Ao usar o Office Send an email como o termo de pesquisa, siga estas etapas para adicionar a ação do Office 365 Outlook chamada Enviar um email (V2) ao seu fluxo de trabalho.

3. No painel de informações da ação, no separador Criar Ligação , selecione Iniciar sessão para poder criar uma ligação à sua conta de e-mail.

   

4. Quando lhe for pedido para aceder à sua conta de e-mail, inicie sessão com as credenciais da sua conta.

   Nota

   Se receber a mensagem de erro, "Falhou com erro: 'O navegador está fechado.'. Inicie sessão novamente", verifique se o seu navegador bloqueia cookies de terceiros. Se esses cookies estiverem bloqueados, tente adicionar https://portal.azure.com à lista de sites que podem usar cookies. Se estiver a utilizar o modo de navegação anónima, certifique-se de que os cookies de terceiros não são bloqueados enquanto trabalha nesse modo.

   Se necessário, recarregue a página, abra o fluxo de trabalho, adicione a ação de e-mail novamente e tente criar a conexão.

   Depois que o Azure cria a conexão, a ação Enviar um email aparece no designer e é selecionada por padrão. Se a ação não estiver selecionada, selecione-a para que seu painel de informações também esteja aberto.

5. No painel de informações da ação, na guia Parâmetros , forneça as informações necessárias para a ação, por exemplo:

   

   Property	Necessário	Valor	Description
   De	Sim	<your-email-address>	O destinatário do e-mail, que pode ser o seu endereço de e-mail para fins de teste. Este exemplo usa o e-mail fictício, sophiaowen@fabrikam.com.
   Assunto	Sim	Um e-mail do seu fluxo de trabalho de exemplo	O assunto do e-mail
   Corpo	Sim	Olá do seu fluxo de trabalho de exemplo!	O conteúdo do corpo do e-mail

   Nota

   Ao fazer alterações no painel de informações nas guias Configurações, Resultado estático ou Executar após , certifique-se de selecionar Concluído para confirmar essas alterações antes de alternar entre guias ou mudar o foco para o designer. Caso contrário, o designer não manterá suas alterações.

6. Salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

7. Se o seu ambiente tiver requisitos de rede rigorosos ou firewalls que limitem o tráfego, você precisará configurar permissões para quaisquer conexões de gatilho ou ação existentes em seu fluxo de trabalho. Para encontrar os nomes de domínio totalmente qualificados, consulte Localizar nomes de domínio para acesso ao firewall.

   Caso contrário, para testar seu fluxo de trabalho, acione manualmente uma execução.

Excluir itens do designer

Para excluir um item do designer no fluxo de trabalho, siga uma destas etapas:

• Selecione o item, abra o menu de atalho do item (Shift+F10) e selecione Excluir. Para confirmar, selecione OK.

• Selecione o item e pressione a tecla delete. Para confirmar, selecione OK.

• Selecione o item para que o painel de informações seja aberto para esse item. No canto superior direito do painel, abra o menu de reticências (...) e selecione Excluir. Para confirmar, selecione OK.

  

  Gorjeta

  Se o menu de reticências não estiver visível, expanda a janela do navegador o suficiente para que o painel de informações mostre o botão de reticências (...) no canto superior direito.

Encontrar nomes de domínio para acesso por firewall

Antes de implantar seu aplicativo lógico e executar seu fluxo de trabalho no portal do Azure, se seu ambiente tiver requisitos de rede rigorosos ou firewalls que limitem o tráfego, você precisará configurar permissões de rede ou firewall para quaisquer conexões de gatilho ou ação nos fluxos de trabalho existentes em seu aplicativo lógico.

Para localizar os endereços IP de entrada e saída usados pelo seu aplicativo lógico e fluxos de trabalho, siga estas etapas:

1. No menu do aplicativo lógico, em Configurações, selecione Rede.

2. Na página de rede, localize e revise as seções Tráfego de entrada e Tráfego de saída .

Para localizar os FQDNs (nomes de domínio totalmente qualificados) para conexões, siga estas etapas:

1. No menu do aplicativo lógico, em Fluxos de trabalho, selecione Conexões. Na guia Conexões de API, selecione o nome do recurso da conexão, por exemplo:

   

2. Expanda o navegador o suficiente para que, quando a Visualização JSON aparecer no canto superior direito do navegador, selecione Visualização JSON.

   

3. Copie e salve o valor da propriedade connectionRuntimeUrl em algum lugar seguro para que você possa configurar seu firewall com essas informações.

   

4. Para cada ligação, repita os passos relevantes.

Acionar o fluxo de trabalho

Neste exemplo, o fluxo de trabalho é executado quando o gatilho Request recebe uma solicitação de entrada, que é enviada para a URL do ponto de extremidade criado pelo gatilho. Quando você salvou o fluxo de trabalho pela primeira vez, os Aplicativos Lógicos do Azure geraram automaticamente essa URL. Portanto, antes de enviar essa solicitação para acionar o fluxo de trabalho, você precisa encontrar essa URL.

1. No designer de fluxo de trabalho, selecione o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida.

2. Depois que o painel de informações for aberto, na guia Parâmetros , localize a propriedade HTTP POST URL . Para copiar o URL gerado, selecione o URL de cópia (ícone de cópia do arquivo) e salve-o em outro lugar por enquanto. O URL segue este formato:

   https://<*logic-app-name*>.azurewebsites.net:443/api/<*workflow-name*>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*shared-access-signature*>

   

   Neste exemplo, o URL tem esta aparência:

   https://fabrikam-workflows.azurewebsites.net:443/api/Fabrikam-Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXX

   Gorjeta

   Você também pode encontrar a URL do ponto de extremidade na página Visão geral do aplicativo lógico na propriedade URL do fluxo de trabalho.

   1. No menu de recursos, selecione Visão geral.
   2. No painel Visão geral, localize a propriedade URL do fluxo de trabalho.
   3. Para copiar o URL do ponto de extremidade, mova o ponteiro sobre o final do texto do URL do ponto de extremidade e selecione Copiar para a área de transferência (ícone de cópia do arquivo).

3. Para testar a URL do ponto de extremidade e acionar o fluxo de trabalho, envie uma solicitação HTTP para a URL, incluindo o método que o gatilho de solicitação espera, usando sua ferramenta de solicitação HTTP e suas instruções.

   Este exemplo usa o método GET com a URL copiada, que se parece com o exemplo a seguir:

   GET https://fabrikam-workflows.azurewebsites.net:443/api/Fabrikam-Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXX

   Quando o gatilho é acionado, o fluxo de trabalho de exemplo é executado e envia um e-mail semelhante a este exemplo:

   

Revisar o histórico de execução do fluxo de trabalho

Depois que um fluxo de trabalho com monitoração de estado terminar a execução, você poderá exibir o histórico de execução do fluxo de trabalho, incluindo o status da execução geral, do gatilho e de cada ação, juntamente com suas entradas e saídas. No portal do Azure, o histórico de execução do fluxo de trabalho e o histórico de gatilhos aparecem no nível do fluxo de trabalho, não no nível de recursos do aplicativo lógico. Para obter mais informações, consulte Revisar histórico de execução do fluxo de trabalho e Revisar histórico de disparos.

Para este fluxo de trabalho de exemplo, o histórico de execução do fluxo de trabalho é semelhante ao exemplo a seguir:

Rever o histórico de acionadores

Para um fluxo de trabalho com monitoração de estado, você pode revisar o histórico de gatilho para cada execução, incluindo o status do gatilho juntamente com entradas e saídas, separadamente do histórico de execução do fluxo de trabalho. No portal do Azure, o histórico de gatilhos e o histórico de execução aparecem no nível do fluxo de trabalho, não no nível do aplicativo lógico. Para obter mais informações, consulte Revisar o histórico de acionamentos.

Reenviar fluxo de trabalho executado com as mesmas entradas

Para uma execução de fluxo de trabalho com monitoração de estado existente, você pode executar novamente todo o fluxo de trabalho com as mesmas entradas que foram usadas anteriormente para essa execução. Para obter mais informações, consulte Executar novamente um fluxo de trabalho com as mesmas entradas.

Configurar o acesso de identidade gerenciada à sua conta de armazenamento

Por padrão, seu aplicativo lógico padrão autentica o acesso à sua conta de Armazenamento do Azure usando uma cadeia de conexão. No entanto, você pode configurar uma identidade gerenciada atribuída pelo usuário para autenticar o acesso.

1. No portal do Azure, siga estas etapas para criar uma identidade gerenciada atribuída pelo usuário.

2. A partir da sua identidade atribuída pelo utilizador, obtenha o ID do recurso:

   1. No menu de identidade gerenciada atribuída pelo usuário, em Configurações, selecione Propriedades.

   2. Na propriedade Id, copie e salve a ID do recurso.

3. Na sua conta de armazenamento, obtenha os URIs para os serviços Blob, Fila e Tabela:

   1. No menu da conta de armazenamento, em Configurações, selecione Pontos de extremidade.

   2. Copie e salve os URIs para serviço de Blob, serviço de fila e serviço de tabela.

4. Na sua conta de armazenamento, adicione as atribuições de função necessárias para sua identidade atribuída pelo usuário:

   1. No menu da conta de armazenamento, selecione Controle de acesso (IAM).

   2. Na barra de ferramentas da página Controle de acesso (IAM), no menu Adicionar, selecione Adicionar atribuição de função.

   3. Na guia Funções da função de trabalho, adicione cada uma das seguintes funções à identidade atribuída pelo usuário:

      • Contribuidor de Conta de Armazenamento
      • Proprietário dos Dados do Armazenamento de Blobs
      • Contribuidor de dados da fila de armazenamento
      • Contribuidor de dados da tabela de armazenamento

   Para obter mais informações, consulte Atribuir funções do Azure usando o portal do Azure e Compreender atribuições de função.

5. Siga estas etapas para adicionar a identidade gerenciada atribuída pelo usuário ao recurso do aplicativo lógico padrão.

6. Se seu aplicativo lógico padrão usa a opção de hospedagem chamada Plano de Serviço de Fluxo de Trabalho, habilite o monitoramento da escala de tempo de execução:

   Nota

   Se seu aplicativo lógico usa a opção de hospedagem ASE (Ambiente do Serviço de Aplicativo) v3, ignore as etapas para monitoramento de escala de tempo de execução porque o ASE não oferece suporte a esse recurso.

   1. No menu do aplicativo lógico, em Configurações, selecione Configuração.

   2. Na guia Configurações de tempo de execução do fluxo de trabalho , para Monitoramento de escala de tempo de execução, selecione Ativado.

   3. Na barra de ferramentas Configuração, selecione Salvar.

7. No seu aplicativo lógico padrão, configure a ID do recurso e os URIs de serviço:

   1. No menu do aplicativo lógico, selecione Visão geral.

   2. Na barra de ferramentas da página Visão geral , selecione Parar.

   3. No menu do aplicativo lógico, em Configurações, selecione Variáveis de ambiente.

   4. Na guia Configurações do aplicativo , selecione Adicionar para adicionar as seguintes configurações e valores do aplicativo:

      Definição da aplicação	Value
      AzureWebJobsStorage__managedIdentityResourceId	O ID do recurso para sua identidade gerenciada atribuída pelo usuário
      AzureWebJobsStorage__blobServiceUri	O URI do serviço Blob para sua conta de armazenamento
      AzureWebJobsStorage__queueServiceUri	O URI do serviço de fila para sua conta de armazenamento
      AzureWebJobsStorage__tableServiceUri	O URI do serviço Tabela para sua conta de armazenamento
      AzureWebJobsStorage__credential	managedIdentity

   5. Na guia Configurações do aplicativo , exclua a configuração do aplicativo chamada AzureWebJobsStorage, que é definida como a cadeia de conexão associada à sua conta de armazenamento.

   6. Quando terminar, selecione Aplicar, que salva as alterações e reinicia o aplicativo lógico.

      Suas alterações podem levar vários momentos para entrar em vigor. Se necessário, no menu do aplicativo lógico, selecione Visão geral e, na barra de ferramentas, selecione Atualizar.

      A seguinte mensagem pode aparecer, mas não é um erro e não afeta seu aplicativo lógico:

      A configuração do aplicativo "AzureWebjobsStorage" não está presente.

Habilitar o histórico de execução para fluxos de trabalho sem monitoração de estado

Para depurar um fluxo de trabalho sem estado mais facilmente, você pode habilitar o histórico de execução para esse fluxo de trabalho e, em seguida, desabilitar o histórico de execução quando terminar. Siga estas etapas para o portal do Azure ou, se estiver trabalhando no Visual Studio Code, consulte Criar fluxos de trabalho com e sem monitoração de estado no Visual Studio Code.

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu do aplicativo lógico, em Configurações, selecione Configuração.

3. Na guia Configurações do aplicativo, selecione Nova configuração do aplicativo.

4. No painel de configurações Adicionar/Editar aplicativo, na caixa Nome, digite o nome desta opção de operação:

   Fluxos de trabalho. {seuWorkflowName}. Opções de Operação

5. Na caixa Valor, insira o seguinte valor: WithStatelessRunHistory

   

6. Para concluir esta tarefa, selecione OK. Na barra de ferramentas do painel Configuração, selecione Salvar.

7. Para desativar o histórico de execução quando terminar, defina a propriedade chamada Workflows.{seu-nome-do-fluxo de trabalho}. OperationOptions to None, ou exclua a propriedade e seu valor.

Habilitar ou abrir o Application Insights após a implantação

Durante a execução do fluxo de trabalho, seu aplicativo lógico emite telemetria junto com outros eventos. Você pode usar essa telemetria para obter melhor visibilidade sobre como seu fluxo de trabalho é executado e como o tempo de execução dos Aplicativos Lógicos funciona de várias maneiras. Você pode monitorar seu fluxo de trabalho usando o Application Insights, que fornece telemetria quase em tempo real (métricas ao vivo). Esse recurso pode ajudá-lo a investigar falhas e problemas de desempenho mais facilmente quando você usa esses dados para diagnosticar problemas, configurar alertas e criar gráficos.

Se as configurações de criação e implantação do seu aplicativo lógico oferecerem suporte ao uso do Application Insights, você poderá, opcionalmente, habilitar o registro e o rastreamento de diagnósticos para o fluxo de trabalho do aplicativo lógico. Você pode fazer isso ao criar seu recurso de aplicativo lógico no portal do Azure ou após a implantação. Você precisa ter uma instância do Application Insights, mas pode criar esse recurso com antecedência, ao criar seu aplicativo lógico ou após a implantação. Você também pode, opcionalmente, habilitar a telemetria aprimorada em fluxos de trabalho do Application Insights for Standard.

Habilitar o Application Insights em um aplicativo lógico implantado

1. No portal do Azure, localize seu aplicativo lógico implantado.

2. No menu do aplicativo lógico, em Configurações, selecione Application Insights.

3. No painel Application Insights, selecione Ativar Application Insights.

4. Após as atualizações do painel, na parte inferior, selecione Aplicar>Sim.

5. No painel Application Insights, selecione Exibir dados do Application Insights.

   Depois que o painel do Application Insights for aberto, você poderá revisar métricas ou logs para o fluxo de trabalho do aplicativo lógico. Por exemplo, para criar um gráfico ou consultar dados, no menu de recursos do Application Insights, em Monitoramento, selecione Métricas ou Logs.

Abrir o Application Insights

1. No portal do Azure, localize seu aplicativo lógico implantado.

2. No menu do aplicativo lógico, em Configurações, selecione Application Insights.

3. No painel Application Insights, selecione Exibir dados do Application Insights.

   Depois que o painel do Application Insights for aberto, você poderá revisar métricas ou logs para o fluxo de trabalho do aplicativo lógico. Por exemplo, para criar um gráfico ou consultar dados, no menu de recursos do Application Insights, em Monitoramento, selecione Métricas ou Logs.

Ver conexões

Quando você cria conexões em um fluxo de trabalho usando conectores gerenciados pela Microsoft, essas conexões são recursos do Azure separados com suas próprias definições de recursos e são hospedadas no Azure global e multilocatário. Os fluxos de trabalho de aplicativos lógicos padrão também podem usar conectores internos do provedor de serviços que são executados nativamente e são alimentados pelo tempo de execução dos Aplicativos Lógicos do Azure de locatário único. Para exibir e gerenciar essas conexões, consulte Exibir conexões.

Parar ou iniciar recursos do aplicativo lógico

Siga as etapas em Desabilitar ou habilitar aplicativos lógicos.

Solucionar problemas e erros

Novos gatilhos e ações estão faltando no seletor de designer para fluxos de trabalho criados anteriormente

Os Aplicativos Lógicos do Azure de locatário único dão suporte a ações internas para Operações de Função do Azure, Operações Líquidas e Operações XML, como Validação XML e Transformação XML. No entanto, para aplicativos lógicos criados anteriormente, essas ações podem não aparecer no designer para você selecionar se seu aplicativo lógico usa uma versão desatualizada do pacote de extensão, Microsoft.Azure.Functions.ExtensionBundle.Workflows.

Para corrigir esse problema, siga estas etapas para excluir a versão desatualizada para que o pacote de extensão possa atualizar automaticamente para a versão mais recente.

1. No portal do Azure, pare seu aplicativo lógico.

   1. No menu do aplicativo lógico, selecione Visão geral.

   2. Na barra de ferramentas do painel Visão geral , selecione Parar.

2. No menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione Ferramentas Avançadas.

3. No painel Ferramentas Avançadas, selecione Ir, que abre o ambiente Kudu para seu aplicativo lógico.

4. Na barra de ferramentas Kudu, abra o menu Depurar console e selecione CMD.

   Uma janela do console é aberta para que você possa navegar até a pasta bundle usando o prompt de comando. Ou, você pode procurar a estrutura de diretórios que aparece acima da janela do console.

5. Navegue até a seguinte pasta, que contém pastas versionadas para o pacote existente:

   ...\home\data\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

6. Exclua a pasta de versão do pacote existente. Na janela do console, você pode executar este comando onde substitui {bundle-version} pela versão existente:

   rm -rf {bundle-version}

   Por exemplo: rm -rf 1.1.3

   Gorjeta

   Se você receber um erro como "permissão negada" ou "arquivo em uso", atualize a página no navegador e tente as etapas anteriores novamente até que a pasta seja excluída.

7. No portal do Azure, retorne ao seu aplicativo lógico e à página Visão geral e selecione Reiniciar.

   O portal obtém e utiliza automaticamente o pacote mais recente.

Próximos passos

• Monitore o status de execução do fluxo de trabalho, revise o disparador e o histórico de execução do fluxo de trabalho e configure alertas nos Aplicativos Lógicos do Azure