Criar fluxos de trabalho de automação baseados em agendamento usando os Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo)
Este tutorial mostra como criar um exemplo de fluxo de trabalho que seja executado em um agendamento recorrente usando os Aplicativos Lógicos do Azure. Este exemplo cria especificamente um fluxo de trabalho de aplicativo lógico de Consumo que verifica o tempo de viagem, incluindo o tráfego, entre dois locais e é executado todas as manhãs dos dias da semana. Se o tempo excede um limite específico, o fluxo de trabalho envia um email que inclui o tempo de viagem e o tempo extra necessário para chegar ao seu destino. O fluxo de trabalho inclui várias etapas, que começam com um gatilho baseado em agendamento seguido por uma ação do Bing Mapas, uma ação de operações de dados, uma ação de fluxo de controle e uma ação de notificação por email.
Quando você terminar, seu fluxo de trabalho irá se parecer com o seguinte exemplo de alto nível:
Dica
Para saber mais, você pode fazer estas perguntas ao Copilot no Azure:
- O que são os Aplicativos Lógicos do Azure?
- O que é um fluxo de trabalho de aplicativo lógico de Consumo?
- Qual é o conector do Bing Mapas?
- O que é uma ação de Operações de Dados?
- O que é uma ação de fluxo de controle?
- O que é o conector do Outlook do Office 365?
Para localizar o Azure Copilot, na barra de ferramentas do portal do Azure, selecione Copilot.
Você pode criar um fluxo de trabalho semelhante com um recurso de aplicativo lógico Standard. No entanto, a experiência do usuário e as etapas do tutorial apresentam uma leve variação com relação à versão de Consumo.
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 de email de qualquer provedor de email compatível com os Aplicativos Lógicos do Azure, como o Outlook do Office 365 ou o Outlook.com. Para obter informações sobre outros provedores de email com suporte, confira Conectores para Aplicativos Lógicos do Azure.
Este tutorial usa o Outlook do Office 365 com uma conta corporativa ou de estudante. Se você usar uma conta de email diferente, as etapas de caráter geral permanecem as mesmas, mas a experiência do usuário talvez seja ligeiramente diferente. Se você usar Outlook.com, use sua conta pessoal Microsoft para se conectar.
Importante
Se você quiser usar o conector do Gmail, somente as contas comerciais do G Suite poderão usar esse conector sem restrição nos fluxos de trabalho dos aplicativos lógicos. Se você tiver uma conta de consumidor do Gmail, poderá usar esse conector somente com serviços específicos do Google aprovados ou poderá criar um aplicativo cliente do Google para usar para autenticação com o conector do Gmail. Para obter mais informações, confira Políticas de privacidade e segurança de dados para os conectores do Google nos Aplicativos Lógicos do Azure.
Para obter o tempo de viagem de uma rota, você precisará de uma chave de acesso para a API do Bing Mapas. Para obter essa chave, siga as etapas para saber como obter uma chave do Bing Mapas.
Se o fluxo de trabalho precisar se comunicar por um firewall que limita o tráfego a endereços IP específicos, esse firewall precisará permitir o acesso tanto para os endereços IP de entrada quanto para os de saída usados pelos Aplicativos Lógicos do Azure na região do Azure em que o recurso do aplicativo lógico existe. Se o fluxo de trabalho também usar conectores gerenciados, como o conector do Office 365 Outlook ou do SQL, ou usar conectores personalizados, o firewall também precisará permitir o acesso para todos os endereços IP de saída do conector gerenciado na região do Azure do recurso do aplicativo lógico.
Criar um recurso de aplicativo lógico de consumo
Entre no portal do Azure com sua conta do Azure.
Na caixa de pesquisa do portal do Azure, insira aplicativos lógicos e selecione Aplicativos lógicos.
Na barra de ferramentas da página Aplicativos lógicos, selecione Adicionar.
A página Criar Aplicativo Lógico é exibida e mostra as seguintes opções:
Planejar Descrição Consumo Cria um recurso de aplicativo lógico compatível com apenas um fluxo de trabalho, que é executado em Aplicativos Lógicos do Azure multilocatário e usa o modelo de Consumo para cobrança. Standard Cria um recurso de aplicativo lógico compatível com vários fluxos de trabalho. Você tem as seguintes opções:
- Plano de Serviço de Fluxo de Trabalho: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure com locatário único e usam o modelo Standard para cobrança.
- Ambiente do Serviço de Aplicativo V3: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure com locatário único e usam um plano de Ambiente do Serviço de Aplicativo para cobrança.
- Híbrido (Versão prévia): Fluxos de trabalho em execução no local e em várias nuvens usando o Dimensionamento Automático Controlado por Eventos do Kubernetes (KEDA). Para obter mais informações, confira Criar fluxos de trabalho Standard para implantação híbrida.Na página Criar Aplicativo Lógico, selecione Consumo (Multilocatário).
Na guia Noções Básicas, forneça as seguintes informações sobre o seu recurso de aplicativo lógico:
Propriedade Obrigatório Valor Descrição Assinatura Sim <Azure-subscription-name> Seu nome da assinatura do Azure.
Este exemplo usa Pagamento Conforme o Uso.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 LA-TravelTime-RG.Nome do Aplicativo Lógico Sim <logic-app-resource-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 (.).
Esse exemplo cria um recurso de aplicativo lógico chamado LA-TravelTime.Região Sim <Azure-region> A região do datacenter do Azure para seu aplicativo.
Este exemplo usa Oeste dos EUA.Habilitar a análise de logs Sim Não Altere essa opção somente quando desejar habilitar o log de diagnósticos. Para esse tutorial, mantenha a seleção padrão.
Observação: essa opção só está disponível com aplicativos lógicos de Consumo.Observação
As zonas de disponibilidade são habilitadas automaticamente para fluxos de trabalho de aplicativo lógico de consumo novos e existentes em regiões do Azure que dão suporte a zonas de disponibilidade. Para obter mais informações, consulte Confiabilidade no Azure Functions e Proteger aplicativos lógicos contra falhas de região com zonas de disponibilidade e redundância de zona.
Depois de concluir, suas configurações são semelhantes ao exemplo a seguir:
Quando você terminar, selecione Examinar + Criar. Depois que o Azure validar as informações sobre o recurso do aplicativo lógico, selecione Criar.
Após o Azure implantar seu aplicativo lógico, selecione Ir para o recurso. Ou encontre e selecione seu recurso de aplicativo lógico usando a caixa de pesquisa do Azure.
Em seguida, adicione o gatilho Agenda chamado Recorrência, que executa o fluxo de trabalho com base em um agenda especificada. Cada fluxo de trabalho deve começar com um gatilho, que é disparado quando um evento específico ocorre ou quando novos dados atendem a uma condição específica.
Adicionar gatilho Recorrência
No designer do fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho Agendar chamado Recorrência.
Renomeie o gatilho Recorrência com o seguinte título: Verificar o tempo de viagem todos os dias úteis pela manhã.
Na caixa de informações do gatilho, forneça as informações necessárias:
Parâmetro Valor Descrição Intervalo 1 O número de intervalos de espera entre as verificações Frequência Semana A unidade de tempo a ser usada para a recorrência Nestes dias segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira Essa configuração está disponível somente quando você define a Frequência como Semana. A estas horas 7, 8, 9 Essa configuração está disponível somente quando você define a Frequência como Semana ou Dia. Para essa recorrência, selecione as horas do dia. Este exemplo é executado nas marcas de 7, 8 e 9 horas. A estes minutos 0, 15, 30, 45 Essa configuração está disponível somente quando você define a Frequência como Semana ou Dia. Para essa recorrência, selecione os minutos do dia. Esse exemplo é executado a cada 15 minutos, começando na marca da hora zero. Quando terminar, a caixa de informações do gatilho será semelhante ao seguinte exemplo:
Esse gatilho é acionado todos os dias da semana, a cada 15 minutos, começando às 7h e terminando às 9h45. A caixa Visualização mostra a agenda de recorrência. Para saber mais, confira Agendar tarefas e fluxos de trabalho e Gatilhos e ações de fluxo de trabalho.
Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
Seu recurso de aplicativo lógico e o fluxo de trabalho atualizado agora estão ativos no portal do Azure. No entanto, o fluxo de trabalho só é disparado com base no agendamento especificado e não executa outras ações. Portanto, adicione uma ação que responde quando o gatilho é acionado.
Obter o tempo de viagem para uma rota
Agora que você tem um gatilho, adicione uma ação do Bing Mapas que obterá o tempo de viagem entre dois lugares. Os Aplicativos Lógicos do Azure fornecem um conector para a API do Bing Mapas para que você possa obter essas informações facilmente. Antes de começar essa tarefa, verifique se você tem uma chave de API do Bing Mapas conforme descrito nos pré-requisitos deste tutorial.
No designer de fluxo de trabalho, no gatilho Recorrência, siga estas etapas gerais para adicionar uma ação do Bing Mapas chamada Obter rota.
Se você não tiver uma conexão do Bing Mapas, a criação será solicitada. Forneça suas informações de conexão e selecione Criar.
Parâmetro Obrigatório Valor Descrição Nome da conexão Sim <Bing-Maps-connection-name> Forneça um nome para a conexão. Este exemplo usa BingMapsConnection. Chave de API Sim <Chave de API do Bing Mapas> Insira a chave de API do Bing Mapas que você recebeu anteriormente. Se você não tiver uma chave do Bing Mapas, saiba como obter uma chave. O exemplo a seguir mostra informações de conexão de exemplo:
Renomeie a ação Obter rota com o seguinte título: Obter rota e tempo de viagem com tráfego.
Na ação, abra a lista Parâmetros avançados e adicione as seguintes propriedades:
- Otimizar
- Unidade de distância
- Modo de viagem
Agora, insira os valores das propriedades da ação a seguir:
Parâmetro Valor Descrição Localizador 1 <start-location> Origem da sua rota. Esse exemplo especifica um endereço inicial de exemplo. Localizador 2 <end-location> Destino da sua rota. Esse exemplo especifica um endereço de destino de exemplo. Otimizar timeWithTraffic Um parâmetro para otimizar a rota, como distância, viagem de tempo com tráfego atual e assim por diante. Selecione o valor do parâmetro, timeWithTraffic. Unidade de distância <your-preference> A unidade de distância da rota. Esse exemplo usa Milha como a unidade. Modo de viagem Automóvel O modo de viagem da rota. Selecione o modo Automóvel. Para saber mais sobre esses parâmetros e valores, confira Calcular uma rota.
O exemplo a seguir mostra informações de ação de exemplo:
Selecione Salvar na barra de ferramentas do designer.
Em seguida, crie uma variável para que você possa converter e armazenar o tempo de viagem atual como minutos em vez de segundos. Dessa forma, você pode evitar repetir a conversão e usar o valor mais facilmente em etapas posteriores.
Criar uma variável para armazenar o tempo de viagem
Às vezes, convém executar operações em dados no fluxo de trabalho e, em seguida, usar os resultados em ações posteriores. Para salvar esses resultados e poder reutilizar ou fazer referência a eles facilmente, você pode criar variáveis que armazenam os resultados depois de processá-los. Você pode criar variáveis somente no nível superior no fluxo de trabalho.
Por padrão, a ação Obter rota retorna o tempo de viagem atual com tráfego em segundos da propriedade Tráfego de Duração da Viagem. Ao converter e armazenar esse valor como minutos, você facilita a reutilização do valor posteriormente sem convertê-lo novamente.
Na ação Obter rota, siga estas etapas gerais para adicionar uma ação de Variáveis chamada Inicializar variável.
Renomeie a ação Inicializar variável com o seguinte título: Criar variável para armazenar o tempo de viagem.
Forneça as seguintes informações sobre a ação:
Parâmetro Valor Descrição Nome travelTime O nome da sua variável. Este exemplo usa o travelTime.Tipo Inteiro O tipo de dados da variável Valor <initial-value> Uma expressão que converte o tempo de viagem atual de segundos em minutos (confira as etapas abaixo desta tabela). Para criar a expressão para a propriedade Valor, siga estas etapas:
Selecione dentro da caixa Valor, que mostra as opções para a lista de conteúdo dinâmico (ícone relâmpago) e o editor de expressões (ícone de fórmula) e, em seguida, selecione o editor de expressões.
O editor de expressões fornece funções que você pode usar para executar operações em sua expressão. A lista de conteúdo dinâmico fornece as saídas de ações anteriores que você pode selecionar como entradas para usar com ações seguintes no fluxo de trabalho.
No editor de expressões, insira a seguinte expressão: div(,60)
Dentro da expressão, coloque o cursor entre o parêntese esquerdo ( ( ) e a vírgula ( , ) e selecione Conteúdo dinâmico.
Na lista de conteúdo dinâmico, selecione o valor de saída, Tráfego de Duração da Viagem.
Se a saída não for exibida, na lista de conteúdo dinâmico, ao lado do nome da ação, selecione Veja mais.
Depois que o valor de saída for resolvido dentro da expressão, selecione Adicionar.
O exemplo a seguir mostra como a propriedade Valor aparece agora:
Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
Em seguida, adicione uma condição que verifica se o tempo de viagem atual é maior que um limite específico.
Comparar o tempo de viagem com o limite
Na ação Criar variável para armazenar o tempo de viagem, siga estas etapas gerais para adicionar uma ação de Controle chamada Condição.
Renomeie a condição com o seguinte título: Se o tempo de viagem exceder o limite
Crie uma condição que verifica se o valor da saída travelTime excede o limite especificado, como descrito e mostrado aqui:
Na condição, no lado esquerdo da condição, selecione dentro da caixa Escolher um valor e, em seguida, selecione a opção para a lista de conteúdo dinâmico (ícone relâmpago).
Em Variáveis, selecione a saída chamada travelTime.
Na caixa de comparação intermediária, selecione o operador chamadoé maior que.
No lado direito da condição, na caixa Escolher um valor, insira o seguinte valor: 15
Quando você terminar, a condição se parecerá com o seguinte exemplo:
Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
Em seguida, adicione a ação a ser executada quando o tempo de viagem excede seu limite.
Enviar email quando o limite é excedido
Agora, adicione uma ação que envie um email quando o tempo de viagem exceder seu limite. Este email inclui o tempo de viagem atual e o tempo extra necessário para concluir a rota especificada.
No branch True da condição, selecione o sinal de mais (+) e, em seguida, selecione Adicionar uma ação.
Siga estas etapas gerais para adicionar uma ação do Outlook do Office 365 chamada Enviar um email.
- Para as contas corporativas ou de estudante do Azure, selecione a versão do Outlook do Office 365.
- Para contas pessoais da Microsoft, selecione a versão do Outlook.com.
Este exemplo continua selecionando o Outlook do Office 365.
Se você ainda não tiver uma conexão, entre e autentique o acesso à sua conta de email quando solicitado.
Os Aplicativos Lógicos do Azure criam uma conexão à sua conta de email.
Renomeie a ação com o seguinte título: Enviar email com o tempo de viagem
Na propriedade Para, insira o endereço de email do destinatário. Para fins de teste, você pode usar seu endereço de email.
Para a propriedade Assunto, especifique o assunto do email e inclua a variável travelTime seguindo estas etapas:
Insira o texto Tempo de viagem atual (minutos): com um espaço à direita. Mantenha o cursor na caixa Assunto e selecione a opção para a lista de conteúdo dinâmico (ícone de raio).
Na lista de conteúdo dinâmico, na seção Variáveis, selecione a variável chamada travelTime.
Observação
Se a lista de conteúdo dinâmico não mostrar automaticamente a variável travelTime, ao lado do rótulo Variáveis, selecione Veja mais. A variável pode não aparecer porque a propriedade Assunto espera um valor de cadeia de caracteres, enquanto travelTime é um inteiro.
Na propriedade Corpo, especifique o conteúdo do corpo do email seguindo estas etapas:
Insira o texto Adicionar tempo extra de viagem (minutos): com um espaço à direita. Mantenha o cursor na caixa Corpo e selecione a opção para o editor de expressões (ícone de fórmula).
No editor de expressão, insira sub(,15) para que você possa calcular o número de minutos que excedem o limite:
Dentro da expressão, coloque o cursor entre o parêntese esquerdo ( ( ) e a vírgula ( , ) e selecione Conteúdo dinâmico.
Em Variáveis, selecione travelTime.
Depois que a variável for resolvida dentro da expressão, selecione Adicionar.
A propriedade Body agora é exibida conforme mostrado aqui:
Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
Em seguida, teste e execute o fluxo de trabalho, que agora se parece com o exemplo a seguir:
Executar o fluxo de trabalho
Para iniciar manualmente o fluxo de trabalho, na barra de ferramentas do designer, selecione Executar>Executar.
Se o tempo de viagem atual permanecer abaixo do limite, o fluxo de trabalho não fará nada e aguardará o próximo intervalo antes de verificar novamente.
Se o tempo de viagem atual exceder o limite, você receberá um email com o tempo de viagem atual e o número de minutos acima do limite. O exemplo a seguir mostra um email de exemplo que seu fluxo de trabalho envia:
Dica
Se você não receber nenhum email, verifique a pasta de Lixo eletrônico. O filtro de lixo de email pode redirecionar esses tipos de mensagens. Caso contrário, se você não tiver certeza de que o fluxo de trabalho foi executado corretamente, confira Solucionar problemas no fluxo de trabalho.
Parabéns, você agora criou e executou um fluxo de trabalho recorrente baseado em agendamento!
Limpar os recursos
O fluxo de trabalho continuará sendo executado até que você desabilite ou exclua o recurso do aplicativo lógico. Quando você não precisar mais deste exemplo, exclua o grupo de recursos que contém o aplicativo lógico e os recursos relacionados.
Na caixa de busca do portal do Azure, insira os grupos de recursos e selecione Grupos de recursos.
Na lista Grupos de recursos, selecione o grupo de recursos para este tutorial.
No menu do grupo de recursos, selecione Visão geral.
Na barra de ferramentas da página Visão Geral, selecione Excluir grupo de recursos.
Quando o painel de confirmação for exibido, insira o nome do grupo de recursos e selecione Excluir.
Próxima etapa
Neste tutorial, você criou um fluxo de trabalho do aplicativo lógico que verifica o tráfego com base em um agendamento especificado (nas manhãs dos dias da semana) e executa uma ação (envia um email) quando o tempo de viagem excede um limite especificado. Agora, saiba como criar um fluxo de trabalho que envia solicitações de lista de endereçamento para aprovação integrando serviços do Azure, serviços da Microsoft e outros aplicativos SaaS (Software como serviço).