Crie um exemplo de fluxo de trabalho Standard nos Aplicativos Lógicos do Azure de locatário único com o portal do Azure

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

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

Observação

Para criar esse fluxo de trabalho de exemplo no Visual Studio Code, siga as etapas em Criar fluxos de trabalho Standard nos Aplicativos Lógicos do Azure de locatário único com o Visual Studio Code. As duas opções fornecem a capacidade de desenvolver, executar e implantar fluxos de trabalho de aplicativo lógico nos mesmos tipos de ambientes. No entanto, com o Visual Studio Code, você pode desenvolver, testar e executar fluxos de trabalho localmente no ambiente de desenvolvimento.

Embora esse exemplo de fluxo de trabalho seja baseado em nuvem e tenha apenas duas etapas, você pode criar fluxos de trabalho com centenas de operações que podem conectar uma ampla gama de aplicativos, dados, serviços e sistemas em ambientes de nuvem, locais e híbridos. O fluxo de trabalho de exemplo começa com o gatilho interno Solicitação, que é seguido por uma ação do Office 365 Outlook. O gatilho cria um ponto de extremidade que pode ser chamado para o fluxo de trabalho e aguarda uma solicitação HTTPS de entrada de qualquer chamador. Quando o gatilho recebe uma solicitação e é acionado, a próxima ação é executada enviando um email para o endereço de email especificado com as saídas selecionadas do gatilho.

Screenshot showing the Azure portal with the designer for Standard logic app workflow.

Durante o percurso, você concluirá estas tarefas de alto nível:

  • Crie um recurso de aplicativo lógico Standard e adicione um fluxo de trabalho com estado em branco.
  • Adicione um gatilho e uma ação.
  • Dispare a execução de um fluxo de trabalho.
  • Exiba o histórico de execuções e gatilhos do fluxo de trabalho.
  • Após a implantação, habilite ou abra o Application Insights.
  • Habilite o histórico de execuções para fluxos de trabalho sem estado.

Nos Aplicativos Lógicos do Azure de locatário único, os fluxos de trabalho no mesmo recurso do aplicativo lógico e no mesmo locatário são executados no mesmo processo do runtime, de modo que eles compartilham os mesmos recursos e fornecem um melhor desempenho. Para obter mais informações sobre os Aplicativos Lógicos do Azure de locatário único, consulte Ambiente de serviço de integração e locatário único versus multilocatário.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

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

    Observação

    O tipo de recurso de aplicativo lógico Standard é alimentado pelo Azure Functions e tem requisitos de armazenamento semelhantes aos aplicativo de funções. Os fluxos de trabalho com estado executam transações de armazenamento, como o uso de filas para agendamento e o armazenamento de estados de fluxo de trabalho em tabelas e blobs. Essas transações resultam em encargos de armazenamento. Para obter mais informações sobre como os fluxos de trabalho com estado armazenam dados no armazenamento externo, confira Fluxos de trabalho com estado e sem estado.

  • Para criar o mesmo exemplo de fluxo de trabalho neste guia, você precisa de uma conta de email do Office 365 Outlook que use uma conta corporativa ou de estudante da Microsoft para entrar.

    Se você não tiver uma conta do Office 365, poderá usar qualquer outro conector de email disponível que possa enviar mensagens da sua conta de email, por exemplo, Outlook.com. Se você usar um conector de email diferente, ainda poderá seguir o exemplo e as etapas gerais serão as mesmas. No entanto, suas opções poderão ser diferentes em alguns aspectos. Por exemplo, ao usar o conector do Outlook.com, use sua conta pessoal da Microsoft para entrar.

  • Para testar o exemplo de fluxo de trabalho neste guia, você precisa de uma ferramenta que possa enviar chamadas para o ponto de extremidade criado pelo gatilho Solicitação. Caso não tenha esta ferramenta, é possível baixar, instalar e usar o Postman.

  • Se você criar seu recurso de aplicativo lógico e habilitar o Application Insights, você poderá, opcionalmente, habilitar o log e o rastreamento de diagnósticos para seu aplicativo lógico. Isso pode ser feito ao criar o aplicativo lógico ou após a implantação. É necessário ter uma instância do Application Insights, mas esse recurso pode ser criado com antecedência ao criar seu aplicativo lógico, ou após a implantação.

  • Para implantar seu recurso de aplicativo lógico Standard em um Ambiente de Serviço de Aplicativo v3 (ASEv3), somente no plano do Windows, é necessário criar esse recurso de ambiente primeiro. Em seguida, é possível selecionar esse ambiente como o local de implantação ao criar o recurso de aplicativo lógico. Para saber mais, confira Tipos de recursos e ambientes e Criar um Ambiente do Serviço de Aplicativo.

  • A partir de meados de outubro de 2022, os novos fluxos de trabalho de aplicativo lógico Standard no portal do Azure passaram a usar automaticamente o Azure Functions v4. Durante o mês de novembro de 2022, os fluxos de trabalho Standard existentes no portal do Azure estão migrando automaticamente para o Azure Functions v4. A menos que você tenha implantado seus aplicativos lógicos Standard como projetos baseados em NuGet ou fixado seus aplicativos lógicos em uma versão específica do pacote, essa atualização foi projetada para não exigir nenhuma ação sua nem ter um impacto no runtime. No entanto, se as exceções se aplicarem a você ou se desejar obter mais informações sobre o suporte ao Azure Functions v4, confira Os Aplicativos Lógicos do Azure Standard agora dão suporte ao Azure Functions v4.

Criar um recurso de aplicativo lógico Padrão

  1. Entre no portal do Azure com sua conta do Azure.

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

    Screenshot showing Azure portal search box with logic apps entered and logic apps group selected.

  3. Na página Aplicativos Lógicos, selecione Adicionar.

  4. Na página Criar Aplicativo Lógico, na guia Básico, forneça as seguintes informações sobre seu recurso de aplicativo lógico:

    Propriedade Obrigatório Valor Descrição
    Assinatura Sim <Azure-subscription-name> Seu nome da assinatura do Azure.
    Grupo de Recursos Sim <Azure-resource-group-name> O grupo de recursos do Azure em que o seu aplicativo lógico e os recursos relacionados são criados. O nome desse recurso precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hífens (-), sublinhados (_), parênteses (()) e pontos (.).

    Este exemplo cria um grupo de recursos chamado Fabrikam-Workflows-RG.
    Nome do Aplicativo Lógico Sim <logic-app-name> O nome do recurso do seu aplicativo lógico, que deve ser exclusivo em todas as regiões e pode conter apenas letras, números, hifens (-), 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 Standard é alimentado pelo runtime 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 runtime do Azure Functions. O Azure Functions usa a mesma convenção de nomenclatura de aplicativo.

    Este exemplo cria um aplicativo lógico chamado Fabrikam-Workflows.
  5. Antes de continuar fazendo seleções, vá para a seção Plano. Em Tipo de plano, selecione Standard para exibir apenas as configurações que se aplicam ao tipo de aplicativo lógico baseado em Standard.

    A propriedade Tipo de plano especifica o plano de hospedagem e o modelo de cobrança a ser usado para seu aplicativo lógico. Para saber mais, confira Planos de hospedagem e tipos de preço.

    Tipo de plano Descrição
    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 cobrança Standard.
    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 cobrança de Consumo.
    Propriedade Obrigatório Valor Descrição
    Plano do Windows Yes <plan-name> O nome do plano a ser usado. Selecione o nome de um plano existente ou forneça o nome para um novo plano.

    Este exemplo usa o nome My-App-Service-Plan.

    Observação: há suporte apenas para o Plano do Serviço de Aplicativo baseado no Windows. Não use um Plano de Serviço de Aplicativo baseado em Linux.
    Plano de preços Yes <pricing-tier> A nível de preço a ser usado no seu aplicativo lógico e fluxos de trabalho. Sua seleção afeta o preço, a computação, a memória e o armazenamento que o aplicativo lógico e os fluxos de trabalho usam.

    Para saber mais, confira Planos de hospedagem e tipos de preço.
  6. Agora, continue fazendo as seguintes seleções:

    Propriedade Obrigatório Valor Descrição
    Publicar Yes Fluxo de trabalho Essa opção é exibida e se aplica somente quando oTipo de plano está definido como o tipo de aplicativo lógicoStandard. Por padrão, essa opção é definida como Workflow e cria um recurso de aplicativo lógico vazio onde você adiciona seu primeiro fluxo de trabalho.

    Observação: no momento, a opção de Contêiner do Docker requer um local personalizado em um cluster do Kubernetes habilitado para Azure Arc, que pode ser usado com Aplicativos Lógicos (Standard) habilitados para Azure Arc. Os locais de recurso do seu aplicativo lógico, do local personalizado e do cluster devem ser todos iguais.
    Região Sim <Azure-region> A região do datacenter do Azure usadas para armazenar as informações sobre o aplicativo. Esse exemplo implanta o aplicativo lógico de amostra na região Oeste dos EUA no Azure.

    - Se você já escolheu Contêiner do Docker, selecione seu local personalizado na lista Região.

    - Se você quiser implantar seu aplicativo em um recurso Ambiente do Serviço de Aplicativo v3 existente, poderá selecionar esse ambiente na lista Região.

    Observação

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

    Quando terminar, as configurações serão semelhante à imagem a seguir:

    Screenshot showing Azure portal and page named Create Logic App.

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

    Propriedade Obrigatório Valor Descrição
    Tipo de armazenamento Sim - Armazenamento do Microsoft Azure
    - Armazenamento do Microsoft Azure e SQL
    O tipo de armazenamento que você deseja usar para dados e artefatos relacionados ao fluxo de trabalho.

    - Para implantar somente no Azure, selecione Armazenamento do Microsoft Azure.

    - Para usar SQL como armazenamento primário e o Armazenamento do Microsoft Azure como armazenamento secundário, selecione Armazenamento do Microsoft Azure e SQL, e examine Configurar o armazenamento de dados do SQL para aplicativos lógicos Standard 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 Microsoft Azure, que é usada para concluir a hospedagem única da configuração do aplicativo lógico na plataforma 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 no banco de dados SQL.

    Para implantações em um local personalizado hospedado em um cluster de Azure Arc, você só precisa SQL como seu provedor de armazenamento.
    Conta de armazenamento Sim <Azure-storage-account-name> A conta de Armazenamento do Microsoft 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.

    Este exemplo cria uma conta de armazenamento chamada mystorageacct.
  8. Na guia Rede, você pode deixar as opções padrão para esse exemplo.

    Para seus cenários específicos do mundo real, certifique-se de revisar e selecionar as opções apropriadas. Você também pode alterar essa configuração depois de implantar seu recurso de aplicativo lógico. Para saber mais, confira Proteger o tráfego entre aplicativos lógicos Standard e redes virtuais do Azure usando pontos de extremidade privados.

    Permitir o acesso público Comportamento
    Ativado Seu aplicativo lógico tem um ponto de extremidade público com um endereço de entrada aberto à Internet e não pode acessar uma rede virtual do Azure.
    Desativado Seu aplicativo lógico não tem um 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 nessa rede virtual. O ponto de extremidade privado pode se comunicar com pontos de extremidade na rede virtual, mas apenas 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.

    Para permitir que seu aplicativo lógico acesse pontos de extremidade em uma rede virtual, verifique se você a opção apropriada está selecionada:

    Habilitar a injeção de rede Comportamento
    Ativado Seus fluxos de trabalho de aplicativo lógico podem se comunicar de forma privada e segura com pontos de extremidade na rede virtual.
    Desativado Seus fluxos de trabalho de aplicativo lógico não podem se comunicar com pontos de extremidade na rede virtual.
  9. Se suas configurações de criação e implantação suportarem o uso do Application Insights, você poderá, opcionalmente, habilitar o log e o rastreamento de diagnósticos para seus fluxos de trabalho do aplicativo lógico.

    1. Na guia de Monitoramento, em Application insights, defina Habilitar o Application Insights para Sim, caso ainda não esteja.

    2. Para a configuração do Application Insights, escolha uma instância do Application insights ou, se desejar criar uma nova, selecione Criar nova e especifique o nome que deseja usar.

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

    Screenshot showing Azure portal and new logic app resource settings.

    Observação

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

    Após o Azure concluir a implantação, seu recurso de aplicativo lógico é automaticamente publicado, mas ainda não faz nada porque o recurso está vazio e você ainda não adicionou nenhum os fluxos de trabalho.

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

    Screenshot showing Azure portal and finished deployment.

Adicione um fluxo de trabalho em branco

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

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

    Screenshot showing logic app resource menu with Workflows selected, and on the toolbar, Add is selected.

  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, Com estado ou Sem estado. Quando terminar, selecione Criar.

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

    Screenshot showing new blank stateful workflow named Stateful-Workflow.

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

  4. No menu 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 os gatilhos disponíveis já apareça aberto.

Agora você adicionará um gatilho que inicia o fluxo de trabalho.

Adicionar um gatilho

Este exemplo de fluxo de trabalho começa com o gatilho de solicitação integrado chamado Quando uma solicitação HTTP é recebida. Esse gatilho cria um ponto de extremidade que outros serviços ou fluxos de trabalho de aplicativo lógico podem chamar e aguarda a chegada dessas chamadas ou solicitações de entrada. As operações internas são executadas nativamente e diretamente no runtime 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 a solicitação como termo de pesquisa, siga estas etapas para adicionar o gatilho de solicitação integrado chamado Quando uma solicitação HTTP é recebida ao 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.

    Screenshot showing the workflow designer and trigger information pane.

  3. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

    Ao salvar um fluxo de trabalho pela primeira vez e esse fluxo de trabalho começar com um gatilho de solicitação, os Aplicativos Lógicos do Azure geram automaticamente um URL para um ponto de extremidade criado pelo gatilho de solicitação. Posteriormente, ao testar o 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 exemplo de fluxo de trabalho continua com a ação do conector gerenciado do Office 365 Outlook chamada Enviar um email. As operações do conector gerenciado são executadas no Azure, em vez de serem executadas nativamente e diretamente no runtime dos Aplicativos Lógicos do Azure.

  1. No designer, no 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. Usando office 365 enviar um email como termo de pesquisa, siga estas etapas para adicionar a ação do Office 365 Outlook chamada Enviar um email (V2) ao fluxo de trabalho.

  3. No painel de informações da ação, na guia Criar Conexão, selecione Entrar para que você possa criar uma conexão com sua conta de email.

    Screenshot showing the designer, the pane named Send an email (V2) with Sign in button.

  4. Quando for solicitado o acesso à sua conta de email, entre com as credenciais da sua conta.

    Observação

    Se você receber a mensagem de erro, "Falha com o erro: 'O navegador está fechado.'. Entre novamente", verifique se o navegador está bloqueando cookies de terceiros. Se esses cookies estiverem bloqueados, tente adicionar https://portal.azure.com à lista de sites que podem usar cookies. Se estiver usando a janela anônima, verifique se os cookies de terceiros não estão bloqueados enquanto trabalha nesse modo.

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

    Depois que o Azure criar 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 o 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:

    Screenshot that shows the designer and the

    Propriedade Obrigatório Valor Descrição
    Para Sim <your-email-address> O destinatário do email, que pode ser seu endereço de email para fins de teste. Este exemplo usa o endereço de email fictício sophiaowen@fabrikam.com.
    Assunto Sim Um email do seu fluxo de trabalho de exemplo O assunto do email
    Corpo Sim Olá do seu exemplo de fluxo de trabalho! O conteúdo do corpo do email

    Observação

    Ao fazer qualquer alteração no painel de informações nas guias Configurações, Resultado estático ou Executar após, selecione Concluído para confirmar essas alterações antes de alternar as guias ou alterar o foco para o designer. Caso contrário, o Designer não manterá suas alterações.

  6. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

  7. Se o ambiente tiver requisitos rigorosos de rede, ou firewalls que limitam o tráfego, será preciso configurar permissões para qualquer conexão de gatilho ou ação do seu fluxo de trabalho. Para encontrar os nomes de domínio totalmente qualificados, confira Localizar nomes de domínio para acesso ao firewall.

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

Exclua os itens do Designer

Para excluir um item no fluxo de trabalho do Designer, siga qualquer uma dessas 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 Excluir. 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.

    Screenshot that shows a selected item on designer with the opened information pane plus the selected ellipses button and

    Dica

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

Localize os nomes de domínio para acesso ao firewall

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

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

  1. No menu do aplicativo lógico, em Configurações, selecione Rede (versão prévia) .

  2. Na página de rede, encontre 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) das 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:

    Screenshot that shows the Azure portal and logic app menu with the

  2. Amplie o navegador de forma que, quando a Exibição JSON aparecer no canto superior direito do navegador, seja possível selecionar a Exibição JSON.

    Screenshot that shows the Azure portal and API Connection pane with

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

    Screenshot showing the selected property value named connectionRuntimeUrl.

  4. Para cada conexão, repita as etapas relevantes.

Disparar um fluxo de trabalho

Neste exemplo, o fluxo de trabalho é executado quando o Gatilho de solicitação recebe uma solicitação de entrada, que é enviada para o URL do ponto de extremidade criado pelo gatilho. Ao salvar o fluxo de trabalho pela primeira vez, os Aplicativos Lógicos do Azure geram automaticamente esse URL. Portanto, antes de enviar essa solicitação para disparar o fluxo de trabalho, é preciso encontrar esse URL.

  1. No Designer de fluxo de trabalho, selecione o Gatilho de solicitação que é nomeado quando uma solicitação HTTP é recebida.

  2. Depois que o painel de informações for aberto, na guia Parâmetros, encontre a propriedade HTTP POST URL. Para copiar o URL gerado, selecione o Copiar URL (ícone Copiar arquivo) e salve o URL 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*>

    Screenshot that shows the designer with the Request trigger and endpoint URL in the

    Nesse 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

    Dica

    Você também pode encontrar o URL do ponto de extremidade no painel de 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, passe o ponteiro do mouse por cima do final do texto do URL do ponto de extremidade e selecione Copiar para a área de transferência (ícone Copiar arquivo).
  3. Para testar o URL enviando uma solicitação, abra o Postman, ou sua ferramenta preferida para criar e enviar solicitações.

    Este exemplo continua usando o Postman. Para obter mais informações, consulte a Introdução do Postman.

    1. Na barra de ferramentas do Postman, selecione Novo.

      Screenshot that shows Postman with New button selected

    2. No painel Criar novo, em Blocos de construção, selecione Solicitação.

    3. Na janela Salvar Solicitação, em Nome da Solicitação, forneça um nome para a solicitação, por exemplo, Gatilho de fluxo de trabalho de teste.

    4. Em Selecionar uma coleção ou pasta para salvar, selecione Criar coleção.

    5. Em Todas as Coleções, dê um nome para a coleção a ser criada para organizar suas solicitações, pressione Enter e selecione Salvar em <nome-da-coleção>. Esse exemplo usa solicitações de Aplicativos Lógicos como o nome da coleção.

      No aplicativo Postman, o painel de solicitação é aberto para que você possa enviar uma solicitação à URL do ponto de extremidade do gatilho de solicitação.

      Screenshot that shows Postman with the opened request pane

    6. No painel de solicitação, na caixa de endereço que está ao lado da lista de métodos, que atualmente mostra GET como o método de solicitação padrão, Cole o URL que você copiou anteriormente e selecione Enviar.

      Screenshot that shows Postman and endpoint URL in the address box with Send button selected

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

      Screenshot that shows Outlook email as described in the example

Melhores práticas e recomendações

Para obter a capacidade de resposta e o desempenho ideais do designer, examine e siga estas diretrizes:

  • Use no máximo 50 ações por fluxo de trabalho. Exceder esse número de ações gera a possibilidade de 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.

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

Depois que um fluxo de trabalho com monitoração de estado terminar de ser executado, 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 recurso 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 gatilhos.

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

Screenshot shows run details view with the status for each step in the workflow.

Screenshot shows inputs and outputs in the selected action named Send an email.

Examinar histórico de gatilho

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

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.

Habilite o histórico de execuções para fluxos de trabalho sem estado

Para depurar um fluxo de trabalho sem estado com mais facilidade, habilite o histórico de execução para esse fluxo de trabalho e desabilite o histórico de execução quando terminar. Siga essas etapas para o portal do Azure ou, se estiver trabalhando no Visual Studio Code, consulte Criar fluxos de trabalho com e sem 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, acesse Configurações e selecione Configuração.

  3. Na guia Configurações de aplicativo, selecione Novas configurações de aplicativo.

  4. No painel Adicionar/Editar configurações do aplicativo, acesse a caixa Nome e digite este nome de opção de operação:

    Fluxos de trabalho.{yourWorkflowName }.OperationOptions

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

    Screenshot showing Standard logic app and pane named Add/Edit application setting with Workflows.{yourWorkflowName}.OperationOptions set to WithStatelessRunHistory.

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

  7. Para desabilitar o histórico de execução quando terminar, defina a propriedade nomeada Fluxos de trabalho.{ your-workflow-name }.OperationOptions como Nenhum ou exclua a propriedade e seu valor.

Após a implantação, habilite ou abra o Application Insights

Durante a execução do fluxo de trabalho, o aplicativo lógico emite telemetria junto com outros eventos. Use a telemetria para visualizar o desempenho do fluxo de trabalho e como o tempo de execução dos Aplicativos Lógicos do Azure funciona de várias maneiras. É possível monitorar o fluxo de trabalho usando o Application insights, que fornece telemetria quase em tempo real (métricas ao vivo). Esse recurso pode ajudar a investigar falhas e problemas de desempenho mais facilmente ao usar esses dados para diagnosticar problemas, configurar alertas e criar gráficos.

Se as configurações de criação e implantação do aplicativo lógico forem compatíveis com o uso do Application Insights, será possível habilitar o log de diagnóstico e o rastreamento para o fluxo de trabalho do seu aplicativo lógico. Isso pode ser feito ao criar o recurso de aplicativo lógico no portal do Azure ou após a implantação. É necessário ter uma instância do Application Insights, mas esse recurso pode ser criado com antecedência ao criar seu aplicativo lógico, ou após a implantação. Opcionalmente, também poderá habilitar a telemetria melhorada no Application Insights para fluxos de trabalho Standard.

Habilitar o Application Insights em um aplicativo lógico implantado

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

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

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

  4. Depois que o painel for atualizado, na parte inferior, selecione Aplicar>Sim.

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

    Após o painel do Application Insights ser aberto, examine as métricas ou os logs do fluxo de trabalho do aplicativo lógico. Por exemplo, para mapear 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 o aplicativo lógico implantado.

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

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

    Após o painel do Application Insights ser aberto, examine as métricas ou os logs do fluxo de trabalho do aplicativo lógico. Por exemplo, para mapear ou consultar dados, no menu de recursos do Application Insights, em Monitoramento, selecione Métricas ou Logs.

Exibir conexões

Quando você cria conexões em um fluxo de trabalho usando conectores gerenciados pela Microsoft, essas conexões são, na verdade, recursos separados do Azure com suas próprias definições de recursos e são hospedadas no Azure global e multilocatário. Os fluxos de trabalho de aplicativo lógico padrão também podem usar conectores internos de 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 de aplicativos lógicos

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

Solucionar problemas e erros

Novos gatilhos e ações ausentes no seletor do Designer para fluxos de trabalho criados anteriormente

Os Aplicativos Lógicos do Azure com locatário único dão suporte a ações internas para operações do Azure Functions, do Liquid e de XML, como Validação de XML e Transformação XML. No entanto, para aplicativos lógicos criados anteriormente, essas ações podem não aparecer no designer para que você selecione 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 as etapas para excluir a versão desatualizada. Assim, o pacote de extensão poderá ser atualizado automaticamente para a versão mais recente.

Observação

Essa solução específica se aplica apenas aos recursos do aplicativo lógico Standard que você cria usando o portal do Azure, não aos aplicativos lógicos que você cria e implanta usando o Visual Studio Code e a extensão Aplicativos Lógicos do Azure (Standard). Consulte Gatilhos e ações compatíveis não estão presentes no Designer no Visual Studio Code.

  1. No portal do Azure, interrompa o 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 Interromper.

  2. No menu do aplicativo lógico, acesse Ferramentas de desenvolvimento e selecione Ferramentas avançadas.

  3. No painel Ferramentas avançadas, selecione Ir. O ambiente Kudu será aberto no seu aplicativo lógico.

  4. Na barra de ferramentas do Kudu, abra o menu do Console de depuração e selecione CMD.

    A janela do console será aberta. Navegue até a pasta do pacote usando o prompt de comando. Se preferir, procure a estrutura de diretório exibida acima da janela do console.

  5. Navegue até a seguinte pasta, que contém pastas de versão 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 esse comando substituindo {bundle-version} pela versão existente:

    rm -rf {bundle-version}

    Por exemplo: rm -rf 1.1.3

    Dica

    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 à página de Visão geral do aplicativo lógico e selecione Reiniciar.

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

Próximas etapas