Criar um fluxo de trabalho Standard de exemplo no Azure Logic Apps de inquilino único com o portal do Azure
Aplica-se a: Azure Logic Apps (Standard)
Este guia de procedimentos mostra como criar um fluxo de trabalho automatizado de exemplo que aguarda um pedido Web de entrada e, em seguida, envia uma mensagem para uma conta de e-mail. Mais especificamente, irá criar um recurso de aplicação lógica Standard, que pode incluir vários fluxos de trabalho com estado e sem estado que são executados no Azure Logic Apps de inquilino único.
Nota
Para criar este fluxo de trabalho de exemplo no Visual Studio Code, siga os passos em Criar fluxos de trabalho Standard no Azure Logic Apps de inquilino único com o Visual Studio Code. Ambas as opções fornecem a capacidade de desenvolver, executar e implementar fluxos de trabalho de aplicações lógicas nos mesmos tipos de ambientes. No entanto, com o Visual Studio Code, pode desenvolver, testar e executar fluxos de trabalho localmente no seu ambiente de desenvolvimento.
Embora este fluxo de trabalho de exemplo seja baseado na cloud e tenha apenas dois passos, pode criar fluxos de trabalho a partir de centenas de operações que podem ligar uma vasta gama de aplicações, dados, serviços e sistemas na cloud, no local e em ambientes híbridos. O fluxo de trabalho de exemplo começa com o acionador incorporado Pedir, seguido de uma ação do Office 365 Outlook. O acionador cria um ponto final callable para o fluxo de trabalho e aguarda um pedido HTTPS de entrada de qualquer autor da chamada. Quando o acionador recebe um pedido e é acionado, a próxima ação é executada enviando e-mails para o endereço de e-mail especificado juntamente com as saídas selecionadas do acionador.
À medida que progride, irá concluir estas tarefas de alto nível:
- Crie um recurso de aplicação lógica Standard e adicione um fluxo de trabalho com estado em branco.
- Adicione um acionador e uma ação.
- Acionar uma execução de fluxo de trabalho.
- Veja o histórico de execuções e acionadores do fluxo de trabalho.
- Ative ou abra o Application Insights após a implementação.
- Ativar o histórico de execuções para fluxos de trabalho sem estado.
No Azure Logic Apps de inquilino único, os fluxos de trabalho no mesmo recurso de aplicação lógica e inquilino são executados no mesmo processo que o runtime, para que partilhem os mesmos recursos e proporcionem um melhor desempenho. Para obter mais informações sobre o Azure Logic Apps de inquilino único, veja Ambiente de serviço de inquilino único versus multi-inquilino e 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 não tiver uma, pode criar uma conta de armazenamento com antecedência ou durante a criação de aplicações lógicas.
Nota
O tipo de recurso da aplicação lógica Standard é alimentado por Funções do Azure e tem requisitos de armazenamento semelhantes às aplicações de funções. Os fluxos de trabalho com estado executam transações de armazenamento, como a utilização de filas para agendar e armazenar estados de fluxo de trabalho em tabelas e blobs. Estas transações incorrem em custos de armazenamento. Para obter mais informações sobre como os fluxos de trabalho com estado armazenam dados no armazenamento externo, veja Fluxos de trabalho com estado e sem estado.
Para criar o mesmo fluxo de trabalho de exemplo neste guia, precisa de um Office 365 conta de e-mail do Outlook que utilize uma conta escolar ou profissional da Microsoft para iniciar sessão.
Se não tiver uma conta 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 utilizar um conector de e-mail diferente, ainda pode seguir o exemplo e os passos gerais gerais são os mesmos. No entanto, as suas opções podem ser diferentes de algumas formas. 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, precisa de uma ferramenta que possa enviar chamadas para o ponto final criado pelo acionador Pedir. Se não tiver essa ferramenta, pode transferir, instalar e utilizar o Postman.
Se criar o recurso da aplicação lógica e ativar o Application Insights, opcionalmente, pode ativar o registo de diagnósticos e o rastreio para a sua aplicação lógica. Pode fazê-lo quando criar a sua aplicação lógica ou após a implementação. Tem de ter uma instância do Application Insights, mas pode criar este recurso com antecedência, quando criar a sua aplicação lógica ou após a implementação.
Para implementar o recurso da aplicação lógica Standard num Ambiente do Serviço de Aplicações v3 (ASEv3) – apenas no plano do Windows, primeiro tem de criar este recurso de ambiente. Em seguida, pode selecionar este ambiente como a localização de implementação quando criar o recurso da aplicação lógica. Para obter mais informações, veja Tipos de recursos e ambientes e Crie um Ambiente do Serviço de Aplicações.
A partir de meados de outubro de 2022, os novos fluxos de trabalho da aplicação lógica Standard no portal do Azure utilizam automaticamente Funções do Azure v4. Ao longo de novembro de 2022, os fluxos de trabalho Standard existentes no portal do Azure estão a migrar automaticamente para Funções do Azure v4. A menos que tenha implementado as suas aplicações lógicas Standard como projetos baseados em NuGet ou afixado as suas aplicações lógicas a uma versão específica do pacote, esta atualização foi concebida para não exigir qualquer ação por si nem ter um impacto no runtime. No entanto, se as exceções se aplicarem a si ou para obter mais informações sobre Funções do Azure suporte v4, veja O Azure Logic Apps Standard suporta agora Funções do Azure v4.
Criar um recurso de aplicação lógica Standard
No portal do Azure, inicie sessão com a sua conta do Azure.
Na caixa de pesquisa portal do Azure, introduza aplicações lógicas e selecione Aplicações lógicas.
Na página Aplicações lógicas , selecione Adicionar.
Na página Criar Aplicação Lógica , no separador Noções Básicas , forneça as seguintes informações básicas sobre a sua aplicação lógica:
Propriedade Necessário Valor Descrição Subscrição Yes <Azure-subscription-name> O nome da sua subscrição do Azure. Grupo de Recursos Yes <Azure-resource-group-name> O grupo de recursos do Azure onde cria a sua aplicação lógica e recursos relacionados. Este nome tem de ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), carateres de sublinhado (_), parênteses (()) e períodos (.).
Este exemplo cria um grupo de recursos com o nome Fabrikam-Workflows-RG.Nome da Aplicação Lógica Yes <logic-app-name> O nome do recurso da aplicação lógica, que tem de ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses (()) e períodos (.).
Nota: o nome da sua aplicação lógica obtém automaticamente o sufixo . azurewebsites.net, porque o recurso da aplicação lógica Standard é alimentado pelo runtime do Azure Logic Apps de inquilino único, que utiliza o modelo de extensibilidade Funções do Azure e está alojado como uma extensão no runtime Funções do Azure. Funções do Azure utiliza a mesma convenção de nomenclatura de aplicações.
Este exemplo cria uma aplicação lógica denominada Fabrikam-Workflows.Antes de continuar a fazer seleções, aceda à secção Plano . Em Tipo de plano, selecione Standard para ver apenas as definições que se aplicam ao tipo de aplicação lógica baseada em plano Standard.
A propriedade Tipo de plano especifica o plano de alojamento e o modelo de faturação a utilizar para a sua aplicação lógica. Para obter mais informações, veja Planos de alojamento e escalões de preço.
Tipo de plano Descrição Standard Este tipo de aplicação lógica é a seleção predefinida. Os fluxos de trabalho são executados no Azure Logic Apps de inquilino único e utilizam o modelo de faturação Standard. Consumo Este tipo de aplicação lógica e o fluxo de trabalho são executados no Azure Logic Apps global e multi-inquilino e utiliza o modelo de faturação Consumo. Propriedade Necessário Valor Descrição Plano do Windows Yes <nome do plano> O nome do plano a utilizar. Selecione um nome de plano existente ou forneça um nome para um novo plano.
Este exemplo utiliza o nome My-App-Service-Plan.
Nota: apenas o plano de Serviço de Aplicações baseado no Windows é suportado. Não utilize um plano de Serviço de Aplicações baseado em Linux.Plano de preços Yes <escalão de preço> O escalão de preço a utilizar para a sua aplicação lógica e fluxos de trabalho. A sua seleção afeta os preços, a computação, a memória e o armazenamento que a sua aplicação lógica e os fluxos de trabalho utilizam.
Para obter mais informações, veja Planos de alojamento e escalões de preço.Agora, continue a efetuar as seguintes seleções:
Propriedade Necessário Valor Descrição Publicar Yes Workflow Esta opção é apresentada e aplica-se apenas quando o Tipo de plano está definido como o tipo de aplicação lógica Standard . Por predefinição, esta opção está definida como Fluxo de Trabalho e cria um recurso de aplicação lógica vazio onde adiciona o seu primeiro fluxo de trabalho.
Nota: atualmente, a opção Contentor do Docker requer uma localização personalizada num cluster do Kubernetes compatível com o Azure Arc, que pode utilizar com o Logic Apps (Standard) compatível com o Azure Arc. As localizações de recursos para a sua aplicação lógica, localização personalizada e cluster têm de ser todas iguais.Região Yes <Azure-region> A região do datacenter do Azure a utilizar para armazenar as informações da sua aplicação. Este exemplo implementa a aplicação lógica de exemplo na região E.U.A. Oeste no Azure.
- Se tiver escolhido anteriormente Contentor do Docker, selecione a sua localização personalizada na lista Região .
- Se quiser implementar a sua aplicação num recurso Ambiente do Serviço de Aplicações v3 existente, pode selecionar esse ambiente na lista Região.Nota
Se selecionar uma região do Azure que suporte a redundância da zona de disponibilidade, a secção Redundância entre zonas está ativada. Esta secção oferece a opção de ativar a redundância da zona de disponibilidade para a sua aplicação lógica. No entanto, as regiões do Azure atualmente suportadas não incluem E.U.A. Oeste, pelo que pode ignorar esta secção para este exemplo. Para obter mais informações, veja Protect logic apps from region failures with zone redundancy and availability zones (Proteger as aplicações lógicas contra falhas de região com zonas de redundância de zona e de disponibilidade).
Quando terminar, as suas definições têm um aspeto semelhante ao seguinte exemplo:
No separador Alojamento , forneça as seguintes informações sobre a solução de armazenamento e o plano de alojamento a utilizar para a sua aplicação lógica.
Propriedade Necessário Valor Descrição Tipo de armazenamento Yes - Armazenamento do Azure
- SQL e Armazenamento do AzureO tipo de armazenamento que pretende utilizar para os artefactos e dados relacionados com o fluxo de trabalho.
- Para implementar apenas no Azure, selecione Armazenamento do Azure.
- Para utilizar o SQL como armazenamento primário e o Armazenamento do Azure como armazenamento secundário, selecione SQL e Armazenamento do Azure e veja Configurar o armazenamento da base de dados SQL para aplicações lógicas Standard no Azure Logic Apps de inquilino único.
Nota: se estiver a implementar numa região do Azure, ainda precisa de uma conta de armazenamento do Azure, que é utilizada para concluir o alojamento único da configuração da aplicação lógica na plataforma do Azure Logic Apps. O estado do fluxo de trabalho em curso, o histórico de execuções e outros artefactos de runtime são armazenados na base de dados SQL.
Para implementações numa localização personalizada alojada num cluster do Azure Arc, só precisa do SQL como fornecedor de armazenamento.Conta de armazenamento Yes <Azure-storage-account-name> A conta de Armazenamento do Azure a utilizar para transações de armazenamento.
Este nome de recurso tem de ser exclusivo entre regiões e ter entre 3 e 24 carateres com apenas números e letras minúsculas. Selecione uma conta existente ou crie uma nova conta.
Este exemplo cria uma conta de armazenamento com o nome mystorageacct.No separador Rede , pode deixar as opções predefinidas para este exemplo.
Para os seus cenários específicos do mundo real, certifique-se de que revê e seleciona as opções adequadas. Também pode alterar esta configuração depois de implementar o recurso da aplicação lógica. Para obter mais informações, veja Proteger o tráfego entre aplicações lógicas Standard e redes virtuais do Azure com pontos finais privados.
Ativar o acesso público Comportamento Ativado A sua aplicação lógica tem um ponto final público com um endereço de entrada aberto na Internet e não consegue aceder a uma rede virtual do Azure. Desligado A aplicação lógica não tem um ponto final público, mas tem um ponto final privado para comunicação numa rede virtual do Azure e está isolada dessa rede virtual. O ponto final privado pode comunicar com pontos finais na rede virtual, mas apenas a partir de clientes nessa rede. Esta configuração também significa que o tráfego da aplicação lógica pode ser regido por grupos de segurança de rede ou afetado por rotas de rede virtual. Para permitir que a sua aplicação lógica aceda a pontos finais numa rede virtual, certifique-se de que seleciona a opção adequada:
Ativar injeção de rede Comportamento Ativado Os fluxos de trabalho da aplicação lógica podem comunicar de forma privada e segura com pontos finais na rede virtual. Desligado Os fluxos de trabalho da aplicação lógica não conseguem comunicar com pontos finais na rede virtual. Se as definições de criação e implementação suportarem a utilização do Application Insights, opcionalmente, pode ativar o registo de diagnósticos e o rastreio para os fluxos de trabalho da aplicação lógica.
No separador Monitorização , em Application Insights, defina Ativar o Application Insights como Sim se ainda não estiver selecionado.
Para a definição do Application Insights , selecione uma instância do Application Insights existente ou, se quiser criar uma nova instância, selecione Criar nova e forneça o nome que pretende utilizar.
Depois de o Azure validar as definições da sua aplicação lógica, no separador Rever + criar , selecione Criar, por exemplo:
Nota
Se receber um erro de validação durante este passo, abra e reveja os detalhes do erro. Por exemplo, se a região selecionada atingir uma quota para os recursos que está a tentar criar, poderá ter de experimentar uma região diferente.
Após a conclusão da implementação do Azure, o recurso da aplicação lógica fica automaticamente ativo, mas ainda não faz nada porque o recurso está vazio e ainda não adicionou fluxos de trabalho.
Na página de conclusão da implementação, selecione Ir para recurso para que possa adicionar um fluxo de trabalho em branco.
Adicionar um fluxo de trabalho em branco
Depois de criar o recurso vazio da aplicação lógica, tem de adicionar o primeiro fluxo de trabalho.
Depois de o Azure abrir o recurso, no menu de recursos da aplicação lógica, selecione Fluxos de trabalho. Na barra de ferramentas Fluxos de Trabalho , selecione Adicionar.
Depois de o painel Novo fluxo de trabalho abrir, forneça um nome para o seu fluxo de trabalho e selecione o tipo de estado, Com Monitorização de Estado ou Sem Estado. Quando concluir, selecione Criar.
Este exemplo adiciona um fluxo de trabalho com estado em branco com o nome Stateful-Workflow. Por predefinição, o fluxo de trabalho está ativado, mas não faz nada até adicionar um acionador e ações.
Na lista de fluxos de trabalho, selecione o fluxo de trabalho com estado em branco.
No menu de fluxo de trabalho, em Programador, selecione Designer.
A superfície do estruturador mostra um pedido para selecionar uma operação de acionador. Por predefinição, o pedido já está selecionado para que um painel com acionadores disponíveis já seja apresentado aberto.
Agora, vai adicionar um acionador que inicia o fluxo de trabalho.
Adicionar um acionador
Este fluxo de trabalho de exemplo começa com o acionador pedido incorporado denominado Quando é recebido um pedido HTTP. Este acionador cria um ponto final que outros serviços ou fluxos de trabalho de aplicações lógicas podem chamar e aguardar pela chegada dessas chamadas ou pedidos de entrada. As operações incorporadas são executadas de forma nativa e direta no runtime do Azure Logic Apps.
No estruturador do fluxo de trabalho, certifique-se de que o fluxo de trabalho em branco está aberto e que a opção Adicionar um acionador está selecionada na superfície do estruturador.
Ao utilizar o pedido como termo de pesquisa, siga estes passos para adicionar o acionador de Pedido incorporado com o nome Quando um pedido HTTP é recebido no fluxo de trabalho.
Quando o acionador é apresentado no estruturador, o painel de informações do acionador é aberto para mostrar as propriedades, definições e outras ações do acionador.
Guarde o fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.
Quando guarda um fluxo de trabalho pela primeira vez e esse fluxo de trabalho começa com um Acionador de pedidos, o Azure Logic Apps gera automaticamente um URL para um ponto final criado pelo acionador Pedido. Mais tarde, quando testar o fluxo de trabalho, envia um pedido para este URL, que aciona o acionador e inicia a execução do fluxo de trabalho.
Adicionar uma ação
Este fluxo de trabalho de exemplo continua com a ação Office 365 conector gerido do Outlook com o nome Enviar um e-mail. As operações do conector gerido são executadas no Azure versus de forma nativa e direta no runtime do Azure Logic Apps.
No estruturador, no acionador que adicionou, selecione o sinal de adição (+) >Adicionar uma ação.
O painel Adicionar uma ação é aberto para que possa selecionar a ação seguinte.
Ao utilizar o office para enviar um e-mail como termo de pesquisa, siga estes passos para adicionar o Office 365 ação do Outlook com o nome Enviar um e-mail (V2) ao seu fluxo de trabalho.
No painel de informações da ação, no separador Criar Ligação , selecione Iniciar sessão para que possa criar uma ligação à sua conta de e-mail.
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 "Falha com o erro: "O browser está fechado". Inicie sessão novamente". Verifique se o browser bloqueia cookies de terceiros. Se estes cookies estiverem bloqueados, tente adicionar https://portal.azure.com à lista de sites que podem utilizar cookies. Se estiver a utilizar o modo incógnito, 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 novamente a ação de e-mail e tente criar a ligação.
Depois de o Azure criar a ligação, a ação Enviar um e-mail é apresentada no estruturador e está selecionada por predefinição. Se a ação não estiver selecionada, selecione a ação para que o respetivo painel de informações também esteja aberto.
No painel de informações de ação, no separador Parâmetros , forneça as informações necessárias para a ação, por exemplo:
Propriedade Necessário Valor Descrição Para Yes <endereço de e-mail> O destinatário do e-mail, que pode ser o seu endereço de e-mail para fins de teste. Este exemplo utiliza o e-mail fictício , sophiaowen@fabrikam.com. Assunto Yes Um e-mail do fluxo de trabalho de exemplo O assunto do e-mail Corpo Yes Olá a partir 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 nos separadores Definições, Resultado Estático ou Executar Depois , certifique-se de que seleciona Concluído para consolidar essas alterações antes de mudar de separador ou alterar o foco para o estruturador. Caso contrário, o estruturador não irá manter as suas alterações.
Guarde o seu trabalho. Na barra de ferramentas do estruturador, selecione Guardar.
Se o seu ambiente tiver requisitos de rede ou firewalls rigorosos que limitam o tráfego, terá de configurar permissões para quaisquer ligações de acionador ou ação existentes no fluxo de trabalho. Para localizar os nomes de domínio completamente qualificados, veja Localizar nomes de domínio para acesso à firewall.
Caso contrário, para testar o fluxo de trabalho, acione manualmente uma execução.
Localizar nomes de domínio para acesso à firewall
Antes de implementar a sua aplicação lógica e executar o fluxo de trabalho no portal do Azure, se o seu ambiente tiver requisitos de rede ou firewalls rigorosos que limitem o tráfego, tem de configurar permissões de rede ou firewall para quaisquer ligações de acionador ou ação nos fluxos de trabalho existentes na sua aplicação lógica.
Para encontrar os endereços IP de entrada e saída utilizados pela sua aplicação lógica e fluxos de trabalho, siga estes passos:
No menu da aplicação lógica, em Definições, selecione Rede (pré-visualização).
Na página de rede, localize e reveja as secções Tráfego de Entrada e Tráfego de Saída .
Para encontrar os nomes de domínio completamente qualificados (FQDNs) para ligações, siga estes passos:
No menu da aplicação lógica, em Fluxos de trabalho, selecione Ligações. No separador Ligações da API , selecione o nome do recurso da ligação, por exemplo:
Expanda o browser suficientemente largo para que, quando a Vista JSON aparecer no canto superior direito do browser, selecione Vista JSON.
Copie e guarde o valor da propriedade connectionRuntimeUrl num local seguro para que possa configurar a firewall com estas informações.
Para cada ligação, repita os passos relevantes.
Acionar o fluxo de trabalho
Neste exemplo, o fluxo de trabalho é executado quando o acionador Pedir recebe um pedido de entrada, que é enviado para o URL do ponto final que é criado pelo acionador. Quando guardou o fluxo de trabalho pela primeira vez, o Azure Logic Apps gerou automaticamente este URL. Por isso, antes de poder enviar este pedido para acionar o fluxo de trabalho, tem de encontrar este URL.
No estruturador do fluxo de trabalho, selecione o acionador Pedir com o nome Quando é recebido um pedido HTTP.
Depois de o painel de informações abrir, no separador Parâmetros , localize a propriedade URL HTTP POST . Para copiar o URL gerado, selecione o Url de Cópia (ícone copiar ficheiro) e guarde o URL noutro local 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*>
Para este exemplo, o URL tem o seguinte aspeto:
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=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXXDica
Também pode encontrar o URL do ponto final no painel Descrição Geral da sua aplicação lógica na propriedade URL do Fluxo de Trabalho .
- No menu de recursos, selecione Descrição geral.
- No painel Descrição Geral , localize a propriedade URL do Fluxo de Trabalho .
- Para copiar o URL do ponto final, mova o ponteiro sobre o final do texto do URL do ponto final e selecione Copiar para a área de transferência (ícone copiar ficheiro).
Para testar o URL ao enviar um pedido, abra o Postman ou a sua ferramenta preferida para criar e enviar pedidos.
Este exemplo continua com o Postman. Para obter mais informações, consulte Postman Introdução.
Na barra de ferramentas do Postman, selecione Novo.
No painel Criar Novo , em Blocos Modulares, selecione Pedir.
Na janela Guardar Pedido , em Nome do pedido, indique um nome para o pedido, por exemplo, Acionador de fluxo de trabalho de teste.
Em Selecionar uma coleção ou pasta para guardar, selecione Criar Coleção.
Em Todas as Coleções, forneça um nome para a coleção criar para organizar os seus pedidos, prima Enter e selecione Guardar no < nome >da coleção. Este exemplo utiliza pedidos do Logic Apps como o nome da coleção.
Na aplicação Postman, o painel de pedidos é aberto para que possa enviar um pedido para o URL do ponto final do Acionador de pedido.
No painel de pedidos, na caixa de endereço junto à lista de métodos, que atualmente mostra GET como o método de pedido predefinido, cole o URL que copiou anteriormente e selecione Enviar.
Quando o acionador é acionado, o fluxo de trabalho de exemplo é executado e envia um e-mail semelhante a este exemplo:
Rever o histórico de execuções
Para um fluxo de trabalho com monitorização de estado, após cada execução de fluxo de trabalho, pode ver o histórico de execuções, incluindo o estado da execução geral, para o acionador e para cada ação, juntamente com as entradas e saídas. Na portal do Azure, os históricos de execuções e históricos de acionadores aparecem ao nível do fluxo de trabalho e não ao nível da aplicação lógica. Para rever os históricos de acionadores fora do contexto do histórico de execuções, veja Rever históricos de acionadores.
Na portal do Azure, no menu de fluxo de trabalho, selecione Descrição geral.
No painel Descrição Geral , selecione Histórico de Execuções, que mostra o histórico de execuções desse fluxo de trabalho.
Dica
Se o estado de execução mais recente não for apresentado, na barra de ferramentas do painel Descrição Geral , selecione Atualizar. Não ocorre nenhuma execução para um acionador ignorado devido a critérios não cumpridos ou não encontrar dados.
A tabela seguinte mostra os possíveis estados finais que cada execução de fluxo de trabalho pode ter e mostrar no portal:
Estado da execução Descrição Abortada A execução parou ou não foi concluída devido a problemas externos, por exemplo, uma falha do sistema ou uma subscrição do Azure caducada. Cancelado A execução foi acionada e iniciada, mas recebeu um pedido de cancelamento. Com falhas Pelo menos uma ação na execução falhou. Não foram configuradas ações subsequentes no fluxo de trabalho para lidar com a falha. Em execução A execução foi acionada e está em curso, mas este estado também pode aparecer para uma execução que está limitada devido aos limites de ação ou ao plano de preços atual.
Sugestão: se configurar o registo de diagnósticos, pode obter informações sobre quaisquer eventos de limitação que ocorram.Com êxito A execução foi concluída com êxito. Se alguma ação tiver falhado, uma ação subsequente no fluxo de trabalho lidou com essa falha. Tempo limite excedido A execução excedeu o tempo limite porque a duração atual excedeu o limite de duração da execução, que é controlado pela definição Retenção do histórico de execuções em dias. A duração de uma execução é calculada com a hora de início da execução e o limite de duração da execução nessa hora de início.
Nota: se a duração da execução também exceder o limite de retenção do histórico de execuções atual, que também é controlado pela definição Retenção do histórico de execuções em dias, a execução é limpa do histórico de execuções por uma tarefa de limpeza diária. Quer a execução exceda ou termine, o período de retenção é sempre calculado com a hora de início da execução e o limite de retenção atual . Por isso, se reduzir o limite de duração de uma execução em voo, a execução excede o tempo limite. No entanto, a execução permanece ou é limpa do histórico de execuções com base no facto de a duração da execução ter excedido o limite de retenção.Em espera A execução não foi iniciada ou está em pausa, por exemplo, devido a uma instância de fluxo de trabalho anterior que ainda está em execução. Para rever o estado de cada passo numa execução, selecione a execução que pretende rever.
A vista de detalhes da execução é aberta e mostra o estado de cada passo na execução.
A tabela seguinte mostra os estados possíveis que cada ação de fluxo de trabalho pode ter e mostrar no portal:
Estado da ação Descrição Abortada A ação parou ou não foi concluída devido a problemas externos, por exemplo, uma falha do sistema ou uma subscrição do Azure caducada. Cancelado A ação estava em execução, mas recebeu um pedido de cancelamento. Com falhas A ação falhou. Em execução A ação está atualmente em execução. Ignorado A ação foi ignorada porque as condições runAfter não foram cumpridas, por exemplo, uma ação anterior falhou. Cada ação tem um runAfterobjeto onde pode configurar condições que têm de ser cumpridas antes de a ação atual poder ser executada.Com êxito A ação foi efetuada com êxito. Com êxito com as repetições A ação foi bem-sucedida, mas apenas após uma ou várias repetições. Para rever o histórico de repetições, na vista de detalhes do histórico de execuções, selecione essa ação para que possa ver as entradas e saídas. Tempo limite excedido A ação parou devido ao limite de tempo limite especificado pelas definições dessa ação. Em espera Aplica-se a uma ação de webhook que está à espera de um pedido de entrada de um autor da chamada. Para rever as entradas e saídas de um passo específico, selecione esse passo.
Para rever ainda mais as entradas e saídas não processadas desse passo, selecione Mostrar entradas não processadas ou Mostrar saídas não processadas.
Rever o histórico de acionadores
Para um fluxo de trabalho com estado, pode rever o histórico de acionadores de cada execução, incluindo o estado do acionador juntamente com entradas e saídas, separadamente do contexto do histórico de execuções. No portal do Azure, o histórico de acionadores e o histórico de execuções aparecem ao nível do fluxo de trabalho e não ao nível da aplicação lógica. Para encontrar estes dados históricos, siga estes passos:
Na portal do Azure, no menu de fluxo de trabalho, selecione Descrição geral.
Na página Descrição geral , selecione Históricos de Acionadores.
O painel Históricos de Acionadores mostra os históricos do acionador para as execuções do fluxo de trabalho.
Para rever um histórico de acionadores específico, selecione o ID dessa execução.
Melhores práticas e recomendações
Para melhorar a capacidade de resposta e o desempenho do estruturador, reveja e siga estas diretrizes:
Não utilize mais de 50 ações por fluxo de trabalho. Exceder este número de ações aumenta a possibilidade de um desempenho mais lento do estruturador.
Considere dividir a lógica de negócio em vários fluxos de trabalho, sempre que necessário.
Não tem mais de 10 a 15 fluxos de trabalho por recurso de aplicação lógica.
Ativar ou abrir o Application Insights após a implementação
Durante a execução do fluxo de trabalho, a aplicação lógica emite telemetria juntamente com outros eventos. Pode utilizar esta telemetria para obter uma melhor visibilidade sobre como o seu fluxo de trabalho é executado e como o runtime do Logic Apps funciona de várias formas. Pode monitorizar o fluxo de trabalho com o Application Insights, que fornece telemetria quase em tempo real (métricas em direto). Esta capacidade pode ajudá-lo a investigar falhas e problemas de desempenho mais facilmente quando utiliza estes dados para diagnosticar problemas, configurar alertas e criar gráficos.
Se as definições de criação e implementação da sua aplicação lógica suportarem a utilização do Application Insights, opcionalmente, pode ativar o registo de diagnósticos e o rastreio para a sua aplicação lógica. Pode fazê-lo quando criar a aplicação lógica no portal do Azure ou após a implementação. Tem de ter uma instância do Application Insights, mas pode criar este recurso com antecedência, quando criar a aplicação lógica ou após a implementação.
Para ativar o Application Insights numa aplicação lógica implementada ou abrir o dashboard do Application Insights, se já estiver ativado, siga estes passos:
Na portal do Azure, localize a aplicação lógica implementada.
No menu da aplicação lógica, em Definições, selecione Application Insights.
Se o Application Insights não estiver ativado, no painel Application Insights , selecione Ativar o Application Insights. Após a atualização do painel, na parte inferior, selecione Aplicar>Sim.
Se o Application Insights estiver ativado, no painel Application Insights , selecione Ver dados do Application Insights.
Após a abertura do Application Insights, pode rever várias métricas para a sua aplicação lógica. Para obter mais informações, veja estes tópicos:
- Azure Logic Apps Em Execução em Qualquer Lugar – Monitorizar com o Application Insights – parte 1
- Azure Logic Apps Em Execução em Qualquer Lugar – Monitorizar com o Application Insights – parte 2
Ativar o histórico de execuções para fluxos de trabalho sem estado
Para depurar um fluxo de trabalho sem estado mais facilmente, pode ativar o histórico de execuções desse fluxo de trabalho e, em seguida, desativar o histórico de execuções quando terminar. Siga estes passos para a portal do Azure ou, se estiver a trabalhar no Visual Studio Code, veja Criar fluxos de trabalho com monitorização de estado e sem estado no Visual Studio Code.
Na portal do Azure, abra o recurso da aplicação lógica Standard.
No menu da aplicação lógica, em Definições, selecione Configuração.
No separador Definições da aplicação, selecione Nova definição da aplicação.
No painel de definições Adicionar/Editar aplicação , na caixa Nome , introduza o nome desta opção de operação:
Fluxos de trabalho. {yourWorkflowName}. OperationOptions
Na caixa Valor , introduza o seguinte valor: WithStatelessRunHistory
Para concluir esta tarefa, selecione OK. Na barra de ferramentas do painel Configuração , selecione Guardar.
Para desativar o histórico de execuções quando terminar, defina a propriedade com o nome Fluxos de Trabalho.{ your-workflow-name}. OperationOptions to None ou elimine a propriedade e o respetivo valor.
Ver ligações
Quando cria ligações num fluxo de trabalho com conectores geridos ou conectores incorporados baseados no fornecedor de serviços, estas ligações são, na verdade, recursos do Azure separados com as suas próprias definições de recursos.
No menu da aplicação lógica, em Fluxos de trabalho, selecione Ligações.
Com base no tipo de ligação que pretende ver, selecione uma das seguintes opções:
Opção Descrição Ligações de API Ligações criadas por conectores geridos Ligações do Fornecedor de Serviços Ligações criadas por conectores incorporados com base na implementação da interface do fornecedor de serviços. uma instância de ligação específica, que mostra mais informações sobre essa ligação. Para ver a definição de recurso subjacente da ligação selecionada, selecione Vista JSON. Vista JSON As definições de recursos subjacentes para todas as ligações na aplicação lógica
Eliminar itens do estruturador
Para eliminar um item no fluxo de trabalho do estruturador, siga qualquer um destes passos:
Selecione o item, abra o menu de atalho do item (Shift+F10) e selecione Eliminar. Para confirmar, selecione OK.
Selecione o item e prima 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 Eliminar. Para confirmar, selecione OK.
Dica
Se o menu de reticências não estiver visível, expanda a janela do browser com largura suficiente para que o painel de informações mostre o botão de reticências (...) no canto superior direito.
Reiniciar, parar ou iniciar aplicações lógicas
Pode parar ou iniciar uma única aplicação lógica ou várias aplicações lógicas ao mesmo tempo. Também pode reiniciar uma única aplicação lógica sem parar primeiro. A sua aplicação lógica baseada no inquilino único pode incluir vários fluxos de trabalho, pelo que pode parar toda a aplicação lógica ou desativar apenas fluxos de trabalho.
Nota
As operações parar a aplicação lógica e desativar o fluxo de trabalho têm efeitos diferentes. Para obter mais informações, veja Considerações para parar aplicações lógicas e considerações para desativar fluxos de trabalho.
Considerações para parar aplicações lógicas
Parar uma aplicação lógica afeta as instâncias de fluxo de trabalho das seguintes formas:
O Azure Logic Apps cancela todas as execuções em curso e pendentes imediatamente.
O Azure Logic Apps não cria nem executa novas instâncias de fluxo de trabalho.
Os acionadores não serão acionados da próxima vez que as condições forem cumpridas. No entanto, os estados do acionador memorizam os pontos em que a aplicação lógica foi parada. Por isso, se reiniciar a aplicação lógica, os acionadores serão acionados para todos os itens não processados desde a última execução.
Para impedir que cada fluxo de trabalho seja acionado em itens não processados desde a última execução, limpe o estado do acionador antes de reiniciar a aplicação lógica ao seguir estes passos:
- Na portal do Azure, abra a aplicação lógica.
- No menu da aplicação lógica, em Fluxos de Trabalho, selecione Fluxos de trabalho.
- Abra um fluxo de trabalho e edite qualquer parte do acionador desse fluxo de trabalho.
- Guarde as alterações. Este passo repõe o estado atual do acionador.
- Repita para cada fluxo de trabalho.
- Quando terminar, reinicie a aplicação lógica.
Reiniciar, parar ou iniciar uma única aplicação lógica
Na portal do Azure, abra a aplicação lógica.
No menu da aplicação lógica, selecione Descrição geral.
- Para reiniciar uma aplicação lógica sem parar, na barra de ferramentas Descrição geral, selecione Reiniciar.
- Para parar uma aplicação lógica em execução, na barra de ferramentas Do painel Descrição Geral, selecione Parar. Confirme a sua seleção.
- Para iniciar uma aplicação lógica parada, na barra de ferramentas do painel Descrição geral, selecione Iniciar.
Nota
Se a aplicação lógica já estiver parada, só verá a opção Iniciar . Se a sua aplicação lógica já estiver em execução, só verá a opção Parar . Pode reiniciar a aplicação lógica em qualquer altura.
Para confirmar se a operação foi bem-sucedida ou falhou, na barra de ferramentas principal do Azure, abra a lista Notificações (ícone de sino).
Parar ou iniciar várias aplicações lógicas
Pode parar ou iniciar múltiplas aplicações lógicas ao mesmo tempo, mas não pode reiniciar várias aplicações lógicas sem as parar primeiro.
Na caixa de pesquisa principal do portal do Azure, introduza logic apps e selecione Logic Apps.
Na página Aplicações lógicas , reveja a coluna Estado da aplicação lógica.
Na coluna da caixa de verificação, selecione as aplicações lógicas que pretende parar ou iniciar.
- Para parar a execução de aplicações lógicas selecionadas, na barra de ferramentas Do painel Descrição Geral, selecione Desativar/Parar. Confirme a sua seleção.
- Para iniciar as aplicações lógicas paradas selecionadas, na barra de ferramentas Do painel Descrição Geral, selecione Ativar/Iniciar.
Para confirmar se a operação foi bem-sucedida ou falhou, na barra de ferramentas principal do Azure, abra a lista Notificações (ícone de sino).
Desativar ou ativar fluxos de trabalho
Para impedir que o acionador seja acionado da próxima vez que a condição do acionador for cumprida, desative o fluxo de trabalho. Pode desativar ou ativar um único fluxo de trabalho, mas não pode desativar ou ativar vários fluxos de trabalho ao mesmo tempo. Desativar um fluxo de trabalho afeta as instâncias do fluxo de trabalho das seguintes formas:
O Azure Logic Apps continua em curso e com execuções pendentes até serem concluídas. Com base no volume ou no atraso, este processo pode demorar algum tempo a concluir.
O Azure Logic Apps não cria nem executa novas instâncias de fluxo de trabalho.
O acionador não será acionado da próxima vez que as condições forem cumpridas. No entanto, o estado do acionador lembra-se do ponto em que o fluxo de trabalho foi desativado. Por isso, se reativar o fluxo de trabalho, o acionador é acionado para todos os itens não processados desde a última execução.
Para impedir que o acionador seja acionado em itens não processados desde a última execução, limpe o estado do acionador antes de reativar o fluxo de trabalho:
- No fluxo de trabalho, edite qualquer parte do acionador do fluxo de trabalho.
- Guarde as alterações. Este passo repõe o estado atual do acionador.
- Reative o fluxo de trabalho.
Quando um fluxo de trabalho é desativado, ainda pode submeter novamente as execuções.
Nota
As operações de desativar fluxo de trabalho e parar a aplicação lógica têm efeitos diferentes. Para obter mais informações, veja Considerações para parar aplicações lógicas.
Desativar fluxo de trabalho
No menu da aplicação lógica, em Fluxos de Trabalho, selecione Fluxos de trabalho. Na coluna da caixa de verificação, selecione o fluxo de trabalho a desativar.
Na barra de ferramentas do painel Fluxos de Trabalho , selecione Desativar.
Para confirmar se a operação foi bem-sucedida ou falhou, na barra de ferramentas principal do Azure, abra a lista Notificações (ícone de sino).
Ativar fluxo de trabalho
No menu da aplicação lógica, em Fluxos de Trabalho, selecione Fluxos de trabalho. Na coluna da caixa de verificação, selecione o fluxo de trabalho a ativar.
Na barra de ferramentas do painel Fluxos de Trabalho , selecione Ativar.
Para confirmar se a operação foi bem-sucedida ou falhou, na barra de ferramentas principal do Azure, abra a lista Notificações (ícone de sino).
Eliminar aplicações lógicas ou fluxos de trabalho
Pode eliminar uma única ou várias aplicações lógicas ao mesmo tempo. A sua aplicação lógica baseada no inquilino único pode incluir vários fluxos de trabalho, pelo que pode eliminar toda a aplicação lógica ou eliminar apenas fluxos de trabalho.
Eliminar aplicações lógicas
Eliminar uma aplicação lógica cancela imediatamente as execuções em curso e pendentes, mas não executa tarefas de limpeza no armazenamento utilizado pela aplicação.
Na caixa de pesquisa principal do portal do Azure, introduza logic apps e selecione Logic Apps.
Na lista Aplicações lógicas , na coluna da caixa de verificação, selecione uma única ou múltiplas aplicações lógicas para eliminar. Na barra de ferramentas, selecione Eliminar.
Quando a caixa de confirmação for apresentada, introduza sim e selecione Eliminar.
Para confirmar se a operação foi bem-sucedida ou falhou, na barra de ferramentas principal do Azure, abra a lista Notificações (ícone de sino).
Eliminar fluxos de trabalho
A eliminação de um fluxo de trabalho afeta as instâncias do fluxo de trabalho das seguintes formas:
O Azure Logic Apps cancela imediatamente as execuções em curso e pendentes, mas executa tarefas de limpeza no armazenamento utilizado pelo fluxo de trabalho.
O Azure Logic Apps não cria nem executa novas instâncias de fluxo de trabalho.
Se eliminar um fluxo de trabalho e, em seguida, recriar o mesmo fluxo de trabalho, o fluxo de trabalho recriado não terá os mesmos metadados que o fluxo de trabalho eliminado. Para atualizar os metadados, tem de guardar novamente qualquer fluxo de trabalho chamado fluxo de trabalho eliminado. Dessa forma, o autor da chamada obtém as informações corretas para o fluxo de trabalho recriado. Caso contrário, as chamadas para o fluxo de trabalho recriado falham com um erro Não autorizado . Este comportamento também se aplica a fluxos de trabalho que utilizam artefactos em contas de integração e fluxos de trabalho que chamam funções do Azure.
Na portal do Azure, abra a aplicação lógica.
No menu da aplicação lógica, em Fluxos de Trabalho, selecione Fluxos de trabalho. Na coluna da caixa de verificação, selecione um único ou vários fluxos de trabalho a eliminar.
Na barra de ferramentas, selecione Eliminar.
Para confirmar se a operação foi bem-sucedida ou falhou, na barra de ferramentas principal do Azure, abra a lista Notificações (ícone de sino).
Recuperar aplicações lógicas eliminadas
Se utilizar o controlo de origem, pode reimplementar de forma totalmente integrada um recurso de aplicação lógica Standard eliminado no Azure Logic Apps de inquilino único. No entanto, se não estiver a utilizar o controlo de origem, experimente os seguintes passos para recuperar a aplicação lógica eliminada.
Nota
Antes de tentar recuperar a aplicação lógica eliminada, reveja estas considerações:
Só pode recuperar recursos de aplicações lógicas Standard eliminados que utilizem o plano de alojamento Padrão do Fluxo de Trabalho . Não pode recuperar os recursos da aplicação lógica consumo eliminado.
Se o fluxo de trabalho começar com o acionador Pedido, o URL de chamada de retorno da aplicação lógica recuperada difere do URL da aplicação lógica eliminada.
O histórico de execuções da aplicação lógica eliminada não está disponível na aplicação lógica recuperada.>
Confirme que a conta de armazenamento da aplicação lógica ainda existe. Se a conta de armazenamento tiver sido eliminada, primeiro tem de recuperar a conta de armazenamento eliminada.
No menu da conta de armazenamento, em Segurança + rede, selecione Chaves de acesso.
Na página Chaves de acesso , copie a cadeia de ligação primária da conta e guarde para utilização posterior, por exemplo:
DefaultEndpointsProtocol=https; AccountName=<storage-account-name>; AccountKey=<access-key>; EndpointSuffix=core.windows.net
No menu da conta de armazenamento, em Armazenamento de dados, selecione Partilhas de ficheiros, copie o nome da partilha de ficheiros associada à sua aplicação lógica e guarde para utilização posterior.
Crie um novo recurso de aplicação lógica Standard com o mesmo plano de alojamento e escalão de preço. Pode utilizar um novo nome ou reutilizar o nome a partir da aplicação lógica eliminada.
Antes de continuar, pare a aplicação lógica. No menu da aplicação lógica, selecione Descrição geral. Na barra de ferramentas da página Descrição geral , selecione Parar.
No menu da aplicação lógica, em Definições, selecione Configuração.
Na página Configuração , atualize os seguintes valores de definição de aplicação e lembre-se de guardar as alterações quando terminar.
Definição da aplicação Valor de substituição AzureWebJobsStorage Substitua o valor existente pela cadeia de ligação copiada anteriormente da sua conta de armazenamento. WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Substitua o valor existente pela cadeia copiada anteriormente da sua conta de armazenamento. WEBSITE_CONTENTSHARE Substitua o valor existente pelo nome da partilha de ficheiros copiada anteriormente. No menu da aplicação lógica, em Fluxos de trabalho, selecione Ligações.
Abra cada ligação e, em Definições, selecione Políticas de acesso.
Elimine a política de acesso da aplicação lógica eliminada e, em seguida, adicione uma nova política de acesso para a aplicação lógica de substituição.
Regresse à página Configuração da aplicação lógica e adicione quaisquer definições personalizadas existentes na aplicação lógica eliminada.
Quando terminar, reinicie a aplicação lógica.
Resolver problemas e erros
Faltam novos acionadores e ações no seletor de estruturador para fluxos de trabalho criados anteriormente
O Azure Logic Apps de inquilino único suporta ações incorporadas para Operações de Funções do Azure, Operações Líquidas e Operações XML, como Validação XML e XML de Transformação. No entanto, para aplicações lógicas criadas anteriormente, estas ações poderão não aparecer no estruturador para selecionar se a sua aplicação lógica utiliza uma versão desatualizada do pacote de extensões , Microsoft.Azure.Functions.ExtensionBundle.Workflows.
Para corrigir este problema, siga estes passos para eliminar a versão desatualizada para que o pacote de extensões possa atualizar automaticamente para a versão mais recente.
Nota
Esta solução específica aplica-se apenas aos recursos da aplicação lógica Standard que criar com o portal do Azure e não às aplicações lógicas que cria e implementa com o Visual Studio Code e a extensão Azure Logic Apps (Standard). Veja Os acionadores suportados e as ações estão em falta no estruturador no Visual Studio Code.
Na portal do Azure, pare a aplicação lógica.
No menu da aplicação lógica, selecione Descrição geral.
Na barra de ferramentas do painel Descrição Geral , selecione Parar.
No menu da aplicação lógica, em Ferramentas de Desenvolvimento, selecione Ferramentas Avançadas.
No painel Ferramentas Avançadas , selecione Ir, que abre o ambiente kudu da sua aplicação lógica.
Na barra de ferramentas do Kudu, abra o menu Consola de depuração e selecione CMD.
É aberta uma janela da consola para que possa navegar para a pasta do pacote com a linha de comandos. Em alternativa, pode procurar a estrutura do diretório que aparece acima da janela da consola.
Navegue para a seguinte pasta, que contém pastas com versões para o pacote existente:
...\home\data\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows
Elimine a pasta de versões do pacote existente. Na janela da consola, pode executar este comando onde substitui {bundle-version} pela versão existente:
rm -rf {bundle-version}Por exemplo:
rm -rf 1.1.3Dica
Se receber um erro como "permissão negada" ou "ficheiro em utilização", atualize a página no browser e tente os passos anteriores novamente até a pasta ser eliminada.
Na portal do Azure, regresse à página Descrição Geral da sua aplicação lógica e selecione Reiniciar.
O portal obtém e utiliza automaticamente o pacote mais recente.
Passos seguintes
Gostaríamos de saber a sua opinião sobre as suas experiências com este cenário!
- Para erros ou problemas, crie os problemas no GitHub.
- Para perguntas, pedidos, comentários e outros comentários, utilize este formulário de comentários.