Tutorial: 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 do aplicativo lógico que seja executado em um agendamento recorrente. Especificamente, esse fluxo de trabalho de exemplo 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.
Neste tutorial, você aprenderá como:
- Crie um aplicativo lógico e fluxo de trabalho em branco.
- Adicionar um gatilho Recorrência que especifica o agendamento para executar o fluxo de trabalho.
- Adicionar uma ação de Mapas do Bing que obtém o tempo de viagem para uma rota.
- Adicionar uma ação que cria uma variável, converte o tempo de viagem de segundos a minutos e armazena o resultado na variável.
- Adicionar uma condição que compara o tempo de viagem em relação a um limite especificado.
- Adicione uma ação que envie um email se o tempo de viagem exceder o limite.
Quando você terminar, o fluxo de trabalho será semelhante ao seguinte exemplo de alto nível:
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, o Outlook.com ou o Gmail. Para outros provedores, revise a lista de conectores aqui. Este início rápido usa o Outlook do Office 365 com uma conta corporativa ou de estudante. Se você usar uma conta de email diferente, as etapas gerais serão as mesmas, mas a interface do usuário será ligeiramente diferente.
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 fluxo de trabalho do aplicativo lógico de Consumo
Entre no portal do Azure com sua conta do Azure.
Na página inicial do Azure, selecione Criar um recurso.
No menu do Azure Marketplace, selecione Integração>Aplicativo Lógico.
No painel Criar Aplicativo Lógico, na guia Básico, forneça as seguintes informações sobre seu recurso de aplicativo lógico.
Propriedade Obrigatório Valor Descrição Assinatura Sim <Azure-subscription-name> Seu nome da assinatura do Azure. Este exemplo usa Pagamento Conforme o Uso. Grupo de Recursos Sim LA-TravelTime-RG O grupo de recursos do Azure em que o recurso do 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, hifens ( -
), sublinhados (_
), parênteses ((
,)
) e pontos (.
).Nome Sim LA-TravelTime O nome do recurso do aplicativo lógico, que precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hifens ( -
), sublinhados (_
), parênteses ((
,)
) e pontos (.
).Antes de continuar fazendo seleções, vá para a seção Plano. Em Tipo de plano, selecione Consumo, para mostrar apenas as configurações de um fluxo de trabalho do aplicativo lógico de Consumo, que é executado nos Aplicativos Lógicos do Azure multilocatário.
A propriedade Tipo de plano também especifica o modelo de cobrança a ser usado.
Tipo de plano Descrição Standard Esse tipo de aplicativo lógico é a seleção padrão e é executado em Aplicativos Lógicos do Azure de locatário único e utiliza o modelo de cobrança Standard. Consumo Esse tipo de aplicativo lógico é executado nos Aplicativos Lógicos do Azure globais e multilocatários, e utiliza o Modelo de cobrança de consumo. Agora, continue com as seguintes seleções:
Propriedade Obrigatório Valor Descrição Região Sim Oeste dos EUA A região do datacenter do Azure na qual as informações sobre o aplicativo são armazenadas. Esse exemplo implanta o aplicativo lógico de amostra na região Oeste dos EUA no Azure.
Observação: se a assinatura estiver associada a um ambiente de serviço de integração, essa lista incluirá esses ambientes.Habilitar a análise de logs Sim Não Essa opção aparece e se aplica somente quando você seleciona o tipo de aplicativo lógico de Consumo. Altere essa opção somente quando desejar habilitar o log de diagnósticos. Para esse tutorial, mantenha a seleção padrão. Quando terminar, selecione Review + create. Depois que o Azure validar as informações sobre o recurso do aplicativo lógico, selecione Criar.
Após o Azure implantar o aplicativo, selecione Ir para o recurso.
O Azure abre o painel de seleção de modelo do fluxo de trabalho, que mostra um vídeo de introdução, gatilhos comumente usados e padrões de modelo do fluxo de trabalho.
Role para baixo após o vídeo e as seções de gatilhos comuns até a seção Modelos e selecione Aplicativo Lógico em Branco.
Em seguida, adicione o gatilho Recorrência, que executa o fluxo de trabalho com base em um agendamento especificado. 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. Para obter mais informações, consulte o artigoCriar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo nos Aplicativos Lógicos do Azure multilocatário.
Adicionar gatilho Recorrência
No designer de fluxo de trabalho, na caixa de pesquisa, selecione Interno.
Na caixa de pesquisa, insira recorrência e selecione o gatilho chamado Recorrência.
Na forma Recorrência, selecione o botão de reticências ( ... ) e, em seguida, Renomear. Renomeie o gatilho com esta descrição:
Check travel time every weekday morning
Dentro do gatilho, altere estas propriedades conforme descrito e mostrado aqui.
Propriedade Obrigatório Valor Descrição Intervalo Sim 1 O número de intervalos de espera entre as verificações Frequência Sim Semana A unidade de tempo a ser usada para a recorrência Em Intervalo e frequência, abra a lista Adicionar novo parâmetro e selecione essas propriedades para adicionar ao gatilho.
- Nestes dias
- A estas horas
- A estes minutos
Agora defina os valores das propriedades adicionais, conforme mostrado e descrito aqui.
Propriedade Valor Descrição 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. Esse exemplo é executado nas marcas de horas 7
,8
e9
.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. 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.
Por enquanto, para ocultar os detalhes do gatilho, recolha a forma clicando na barra de título dela.
Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
O fluxo de trabalho do aplicativo lógico agora está ativo no portal do Azure, mas não faz nada além de ser executado com base no agendamento especificado. 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 que obtém 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, selecione Nova etapa.
Em Escolher uma operação, selecione Padrão. Na caixa de pesquisa, insira Bing Mapas e selecione a ação chamada Obter rota.
Se você não tiver uma conexão do Bing Mapas, a criação será solicitada. Forneça os detalhes da conexão conforme mostrado e descrito, depois selecione Criar.
Propriedade Obrigatório Valor Descrição Nome da conexão Sim BingMapsConnection Forneça um nome para a conexão. Este exemplo usa o 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. Renomeie a ação com esta descrição:
Get route and travel time with traffic
.Nessa ação, abra a lista Adicionar novo parâmetro e selecione estas propriedades.
- Otimizar
- Unidades de distância
- Modo de navegação
Agora, insira os valores para as propriedades, conforme mostrado e descrito aqui.
Propriedade Obrigatório Valor Descrição Localizador 1 Sim <start-location> Origem da sua rota. Esse exemplo especifica um endereço inicial de exemplo. Localizador 2 Sim <end-location> Destino da sua rota. Esse exemplo especifica um endereço de destino de exemplo. Otimizar Não 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. Unidades de distância Não <your-preference> A unidade de distância da rota. Esse exemplo usa Milha como a unidade. Modo de navegação Não 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.
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.
No designer, na ação Obter rota, selecione Nova etapa.
Em Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira variáveis e selecione a ação chamada Inicializar variável.
Renomear a ação com esta descrição:
Create variable to store travel time
Forneça estas informações para sua variável, conforme mostrado nesta tabela e nas etapas abaixo dela:
Propriedade Obrigatório Valor Descrição Nome Sim travelTime O nome da sua variável. Este exemplo usa o travelTime
.Tipo Sim Integer O tipo de dados da variável Valor Não Uma expressão que converte o tempo de viagem atual de segundos em minutos (confira as etapas abaixo desta tabela). O valor inicial da variável Para criar a expressão da propriedade Valor, clique na caixa para que seja exibida a lista de conteúdo dinâmico. Se necessário, amplie o navegador até que seja exibida a lista dinâmica. Na lista de conteúdo dinâmico, selecione Expressão, que mostra o editor de expressão.
A lista de conteúdo dinâmico mostra as saídas de ações anteriores que estão disponíveis para você selecionar como entradas de ações subsequentes no fluxo de trabalho. A lista de conteúdo dinâmico inclui um editor de expressão que você pode usar para selecionar funções que executam operações em sua expressão. Esse editor de expressão está disponível apenas na lista de conteúdo dinâmico.
No editor de expressão, digite esta 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 da propriedade, Tráfego de Duração da Viagem.
Depois que o valor da propriedade for resolvido dentro da expressão, selecione OK.
A propriedade Valor agora é exibida conforme mostrado aqui:
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, selecione Nova etapa.
Em Escolher uma operação, selecione Interno. Na caixa de pesquisa, insira condição. E, na lista de ações, selecione a ação chamada Condição.
Renomeie a condição com esta descrição:
If travel time exceeds limit
Crie uma condição que verifica se o valor da propriedade travelTime excede o limite especificado, como descrito e mostrado aqui:
Clique dentro da caixa Escolher um valor no lado esquerdo da condição.
Na lista de conteúdo dinâmico exibida, em Variáveis, selecione a propriedade chamada travelTime.
Na caixa de comparação intermediária, selecione o operador chamadoé maior que.
Na caixa Escolher um valor à direita da condição, insira este limite:
15
Quando terminar, a condição será semelhante a este 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 envia emails quando o tempo de viagem excede seu limite. Este email inclui o tempo de viagem atual e o tempo extra necessário para concluir a rota especificada.
No branch Verdadeiro da condição, selecione Adicionar uma ação.
Em Escolher uma operação, selecione Padrão. Na caixa de pesquisa, insira enviar email. A lista retorna muitos resultados, portanto, para ajudar a filtrar a lista, primeiro selecione o conector de email desejado.
Por exemplo, se você tiver uma conta de email do Outlook, selecione o conector para seu tipo de conta:
- Para as contas corporativas ou de estudante do Azure, selecione o Outlook do Office 365.
- Para contas pessoais da Microsoft, selecione Outlook.com.
Este exemplo continua selecionando o Outlook do Office 365.
Quando as ações do conector forem exibidas, selecione a ação que envia emails, por exemplo:
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 esta descrição:
Send email with travel time
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
Current travel time (minutes):
com um espaço à direita. Mantenha o cursor na caixa Assunto para que a lista de conteúdo dinâmico permaneça aberta.Na lista de conteúdo dinâmico, no título Variáveis, selecione Ver mais para que a variável chamada travelTime seja exibida.
Observação
A lista de conteúdo dinâmico não mostra automaticamente a variável travelTime porque a propriedade Assunto espera um valor de cadeia de caracteres, enquanto travelTime é um valor inteiro.
Na propriedade Corpo, especifique o conteúdo do corpo do email seguindo estas etapas:
Insira o texto
Add extra travel time (minutes):
com um espaço à direita. Mantenha o cursor na caixa Corpo para que a lista de conteúdo dinâmico permaneça aberta.Na lista de conteúdo dinâmico, selecione Expressão, que mostra o editor de expressão.
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 propriedade for resolvida dentro da expressão, selecione OK.
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 este exemplo:
Executar o fluxo de trabalho
Para iniciar manualmente o fluxo de trabalho, na barra de ferramentas do designer, selecione Executar Gatilho>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. Este é um email de exemplo que o 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.
Para criar outros fluxos de trabalho que usam o gatilho Recorrência, confira estes modelos, que ficam disponíveis depois que você cria um novo recurso do aplicativo lógico:
- Receba lembretes diários.
- Exclua blobs do Azure mais antigos.
- Adicione uma mensagem a uma fila do Armazenamento do Azure.
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 do fluxo de trabalho de exemplo, exclua o grupo de recursos que contém o recurso do aplicativo lógico e os recursos relacionados.
Na caixa de pesquisa do portal do Azure, digite o nome do grupo de recursos que você criou. Nos resultados, em Grupos de Recursos, selecione o grupo de recursos.
Este exemplo cria o grupo de recursos chamado
LA-TravelTime-RG
.Dica
Se a página inicial do Azure mostrar o grupo de recursos em Recursos recentes, você poderá selecionar o grupo na página inicial.
No menu do grupo de recursos, verifique se a Visão Geral está selecionada. Na barra de ferramentas do painel Visão Geral, selecione Excluir grupo de recursos.
No painel de confirmação exibido, insira o nome do grupo de recursos e selecione Excluir.
Próximas etapas
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).