Criar um exemplo de fluxo de trabalho padrão em Aplicativos Lógicos do Azure de locatário único com 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ê criará um recurso de aplicativo lógico Padrão, que pode incluir vários fluxos de trabalho com e sem monitoração de estado executados em Aplicativos Lógicos do Azure de locatário único.

Nota

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

Embora este fluxo de trabalho de exemplo seja baseado em nuvem e tenha apenas duas etapas, você pode criar fluxos de trabalho a partir de centenas de operações que podem conectar uma ampla variedade 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 chamável 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 e-mail para o endereço de e-mail especificado junto com as saídas selecionadas do gatilho.

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

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

  • Crie um recurso de aplicativo lógico padrão e adicione um fluxo de trabalho com monitoração de estado em branco.
  • Adicione um gatilho e uma ação.
  • Acionar uma execução de fluxo de trabalho.
  • Exiba o histórico de execução e gatilho do fluxo de trabalho.
  • Habilite ou abra o Application Insights após a implantação.
  • Habilite o histórico de execução para fluxos de trabalho sem monitoração de estado.

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

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 os fluxos de trabalho com monitoração de estado armazenam dados no armazenamento externo, consulte Fluxos de trabalho com e sem monitoração de estado.

  • Para criar o mesmo fluxo de trabalho de exemplo 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 não tiver uma conta do Office 365, pode utilizar qualquer outro conector de e-mail disponível que possa enviar mensagens a partir da sua conta de e-mail, por exemplo, Outlook.com. Se você usar um conector de e-mail diferente, ainda poderá seguir o exemplo, e as etapas gerais gerais serão as mesmas. No entanto, suas opções podem diferir em alguns aspetos. Por exemplo, se utilizar o conector Outlook.com, utilize a sua conta Microsoft pessoal para iniciar sessão.

  • Para testar o fluxo de trabalho de exemplo neste guia, você precisa de uma ferramenta que possa enviar chamadas para o ponto de extremidade criado pelo gatilho Request. Se você não tiver essa ferramenta, você pode baixar, instalar e usar o Postman.

  • Se você criar seu recurso de aplicativo lógico e habilitar o Application Insights, poderá opcionalmente habilitar o registro e o rastreamento de diagnósticos para seu aplicativo lógico. 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.

  • 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 recurso de aplicativo lógico. Para obter mais informações, consulte Tipos e ambientes de recursos e Criar um ambiente do Serviço de Aplicativo.

  • A partir de meados de outubro de 2022, os novos fluxos de trabalho do aplicativo lógico padrão no portal do Azure usam automaticamente o Azure Functions v4. Ao longo de novembro de 2022, os fluxos de trabalho Standard existentes no portal do Azure migram automaticamente para o Azure Functions v4. A menos que você implantou seus aplicativos lógicos padrão como projetos baseados em NuGet ou fixou 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 tempo de execução. No entanto, se as exceções se aplicarem a você, ou para obter mais informações sobre o suporte do Azure Functions v4, consulte Azure Logic Apps Standard agora dá suporte ao Azure Functions v4.

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 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 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.
    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 aplicativo lógico chamado Fabrikam-Workflows.
  5. Antes de continuar a fazer seleções, vá para a seção Plano. Em Tipo de plano, selecione Padrão para exibir apenas as configurações que se aplicam ao tipo de aplicativo lógico baseado em plano Padrão .

    A propriedade Plan type especifica o plano de hospedagem e o modelo de cobrança a serem usados para seu aplicativo lógico. Para obter mais informações, consulte Planos de hospedagem e níveis de preços.

    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 cobrança 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 cobrança de Consumo.
    Property Necessário Valor Description
    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: somente o plano do Serviço de Aplicativo baseado no Windows é suportado. Não use um plano do Serviço de Aplicativo baseado em Linux.
    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.
  6. Agora continue fazendo as seguintes seleções:

    Property Necessário Valor Description
    Publicar Sim Workflow Essa opção aparece e se aplica somente quando Tipo de plano é definido como o tipo de aplicativo lógico Padrão . Por padrão, essa opção é definida como Fluxo de trabalho e cria um recurso de aplicativo lógico vazio onde você adiciona seu primeiro fluxo de trabalho .

    Observação: atualmente, a opção Contêiner do Docker requer um local personalizado em um cluster Kubernetes habilitado para Azure Arc, que você pode usar com os Aplicativos Lógicos habilitados para Azure Arc (Padrão). Os locais de recursos para seu aplicativo lógico, local personalizado e cluster devem ser os mesmos.
    Região Sim <Azure-region> A região do datacenter do Azure a ser usada para armazenar as informações do seu aplicativo. Este exemplo implanta o aplicativo lógico de exemplo na região Oeste dos EUA no Azure.

    - Se você escolheu anteriormente Docker Container, selecione seu local personalizado na lista Região .

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

    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, suas configurações serão semelhantes ao exemplo a seguir:

    Screenshot showing Azure portal and page named Create Logic App.

  7. Na guia Hospedagem, 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 este 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 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.

    Habilitar acesso público Comportamento
    Em Seu aplicativo lógico tem um ponto de extremidade público com um endereço de entrada que está aberto para a Internet e não pode acessar uma rede virtual do Azure.
    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 é isolado nessa 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.

    Para permitir que seu aplicativo lógico acesse pontos de extremidade em uma rede virtual, selecione a opção apropriada:

    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.
    Desativado Os fluxos de trabalho do 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 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.

    1. Na guia Monitoramento, em Application Insights, defina Habilitar Application Insights como Sim, se ainda não estiver selecionado.

    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:

    Screenshot showing Azure portal and new logic app resource settings.

    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.

    Screenshot showing Azure portal and finished deployment.

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 de recursos do 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, Stateful ou Stateless. Quando tiver terminado, 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.

    Screenshot showing new blank stateful workflow named Stateful-Workflow.

  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.

Então, agora você adicionará um gatilho que inicia 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.

    Screenshot showing the workflow designer and trigger information pane.

  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.

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

  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:

    Screenshot that shows the designer and the

    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.

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

    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 (visualização).

  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:

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

  2. Expanda o navegador o suficiente para que, quando a Visualização JSON aparecer no canto superior direito do navegador, selecione Visualizaçã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 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*>

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

    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 no painel Visão geral do seu 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 o URL enviando um pedido, abra o Postman ou a sua ferramenta preferida para criar e enviar pedidos.

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

    1. Na barra de ferramentas 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 Selecione uma coleção ou pasta para salvar, selecione Criar coleção.

    5. Em Todas as coleções, forneça um nome para a coleção a ser criada para organizar suas solicitações, pressione Enter e selecione Salvar no <nome> da coleção. Este 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 para a URL do ponto de extremidade para o gatilho Solicitação.

      Screenshot that shows Postman with the opened request pane

    6. No painel de solicitação, na caixa de endereço ao lado da lista de métodos, que atualmente mostra GET como o método de solicitação padrão, cole a URL copiada 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 e-mail semelhante a este exemplo:

      Screenshot that shows Outlook email as described in the example

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.

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:

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.

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.

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

    Screenshot showing Standard logic app and pane named Add/Edit application setting with Workflows.{yourWorkflowName}.OperationOptions set to 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, na verdade, 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.

Nota

Essa solução específica se aplica somente aos recursos do aplicativo lógico padrão 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 Azure Logic Apps (Standard). Consulte Gatilhos e ações suportados estão faltando no designer no Visual Studio Code.

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

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

Próximos passos