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á a:

• Crie um aplicativo lógico e um 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

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

2. Na página inicial do Azure, selecione Criar um recurso.

3. No menu do Azure Marketplace, selecione Integração>Aplicativo Lógico.

   

4. 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 (.).

5. Antes de continuar fazendo seleções, vá para a seção Plano. Para Tipo de plano, selecione Consumo para mostrar apenas as configurações de um fluxo de trabalho de aplicativo lógico de consumo, que é executado em Aplicativos Lógicos do Azure multilocatários.

   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 usa o modelo de preços Standard.
   Consumo	Esse tipo de aplicativo lógico é executado em Aplicativos Lógicos do Azure globais e multilocatários e usa o modelo de preços de Consumo.

6. 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.
   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.

7. Quando terminar, selecione Review + create. Depois que o Azure validar as informações sobre o recurso do aplicativo lógico, selecione Criar.

8. Após o Azure implantar o aplicativo, selecione Ir para o recurso.

   No portal do Azure, abra o seu aplicativo lógico de Consumo no designer de fluxo de trabalho.

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. Para obter mais informações, confiraCriar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo nos Aplicativos Lógicos do Azure multilocatário.

Adicionar gatilho Recorrência

1. No designer do fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho Recorrência.

2. Renomeie o gatilho Recorrência com o seguinte título: Verificar o tempo de viagem todos os dias úteis pela manhã.

   

3. Na caixa de informações do gatilho, forneça as informações necessárias:

   Propriedade	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.

4. 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.

1. 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.

2. 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.

   Propriedade	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:

   

3. Renomeie a ação Obter rota com o seguinte título: Obter rota e tempo de viagem com tráfego.

4. Na ação, abra a lista Parâmetros avançados e adicione as seguintes propriedades:

   • Otimizar
   • Unidade de distância
   • Modo de viagem

5. Agora, insira os valores das propriedades da ação a seguir:

   Propriedade	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:

   

6. 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.

1. Na ação Obter rota, siga estas etapas gerais para adicionar uma ação de Variáveis chamada Inicializar variável.

2. Renomeie a ação Inicializar variável com o seguinte título: Criar variável para armazenar o tempo de viagem.

3. Forneça as seguintes informações sobre a ação:

   Propriedade	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:

   1. 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.

   2. No editor de expressões, insira a seguinte expressão: div(,60)

      

   3. Dentro da expressão, coloque o cursor entre o parêntese esquerdo ( ( ) e a vírgula ( , ) e selecione Conteúdo dinâmico.

      

   4. 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.

      

   5. 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:

      

4. 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

1. 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.

2. Renomeie a condição com o seguinte título: Se o tempo de viagem exceder o limite

3. Crie uma condição que verifica se o valor da saída travelTime excede o limite especificado, como descrito e mostrado aqui:

   1. 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).

   2. Em Variáveis, selecione a saída chamada travelTime.

      

   3. Na caixa de comparação intermediária, selecione o operador chamadoé maior que.

   4. No lado direito da condição, na caixa Escolher um valor, insira o seguinte valor: 15

      Ao terminar, a condição será semelhante ao seguinte exemplo:

      

4. 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.

1. No branch True da condição, selecione o sinal de mais (+) e, em seguida, selecione Adicionar uma ação.

2. 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.

   

3. 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.

4. Renomeie a ação com o seguinte título: Enviar email com o tempo de viagem

5. Na propriedade Para, insira o endereço de email do destinatário. Para fins de teste, você pode usar seu endereço de email.

6. Para a propriedade Assunto, especifique o assunto do email e inclua a variável travelTime seguindo estas etapas:

   1. 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).

   2. 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.

7. Na propriedade Corpo, especifique o conteúdo do corpo do email seguindo estas etapas:

   1. 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).

   2. No editor de expressão, insira sub(,15) para que você possa calcular o número de minutos que excedem o limite:

      

   3. Dentro da expressão, coloque o cursor entre o parêntese esquerdo ( ( ) e a vírgula ( , ) e selecione Conteúdo dinâmico.

      

8. Em Variáveis, selecione travelTime.

   

   1. Depois que a variável for resolvida dentro da expressão, selecione Adicionar.

      A propriedade Body agora é exibida conforme mostrado aqui:

      

9. 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 do fluxo de trabalho de exemplo, exclua o grupo de recursos que contém o recurso do aplicativo lógico e os recursos relacionados.

1. 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 criou 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.

2. 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.

   

3. No painel de confirmação 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).

Gerenciar solicitações da lista de correspondência