Agendamentos para disparadores recorrentes em fluxos de trabalho Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Os Aplicativos Lógicos do Azure ajudam você a criar e executar fluxos de trabalho recorrentes automatizados em um agendamento. Ao criar um fluxo de trabalho de aplicativo lógico que começa com um Gatilho de recorrência ou um Gatilho de janela deslizante internos, que são gatilhos de agendamento, você pode executar tarefas imediatamente, posteriormente ou em um intervalo recorrente. Você pode chamar serviços dentro e fora do Azure, como pontos de extremidade HTTP ou HTTPS, postar mensagens para serviços do Azure, como o Armazenamento do Azure e o Barramento de Serviço do Azure, ou obter arquivos carregados em um compartilhamento de arquivos. Com o Gatilho de recorrência, você também pode configurar agendas complexas e recorrências avançadas para executar tarefas. Para saber mais sobre os gatilhos e ações de agendamento internos, confira Gatilhos de agendamento e Ações de agendamento.

Esta lista mostra algumas tarefas de exemplo que você pode executar com os gatilhos de agendamento internos:

• Obter dados internos, por exemplo, executando um procedimento armazenado de SQL todos os dias.

• Obter dados externos, por exemplo, efetuando pull de relatórios de previsão do tempo do NOAA a cada 15 minutos.

• Enviar dados de relatório, por exemplo, enviando por email um resumo de todos os pedidos que sejam acima de uma quantidade específica na última semana.

• Processar dados, por exemplo, compactando as imagens carregadas do dia, todos os dias da semana, fora do horário de pico.

• Limpar dados, por exemplo, excluindo todos os tweets com mais de três meses.

• Arquivar dados, por exemplo, enviando faturas para um serviço de backup à 1:00 todos os dias durante os próximos nove meses.

Você também pode usar as ações de agendamento internas para pausar o fluxo de trabalho antes da execução da próxima ação, por exemplo:

• Aguardar até um dia útil para enviar uma atualização de status por email.

• Atrasar o fluxo de trabalho até que uma chamada HTTP tenha tempo para ser concluída antes da retomada e da recuperação do resultado.

Este artigo descreve os recursos para gatilhos e ações de agendamento internos.

Gatilho de agendamento

Você pode iniciar o fluxo de trabalho de aplicativo lógico usando o Gatilho de recorrência ou o Gatilho de janela deslizante, o qual não está associado a nenhum serviço ou sistema específico. Esses gatilhos iniciam e executam o fluxo de trabalho com base na recorrência especificada por você e na qual você seleciona o intervalo e a frequência, como o número de segundos, minutos, horas, dias, semanas ou meses. Você também pode definir a data e a hora de início, além do fuso horário. Cada vez que um gatilho é disparado, os Aplicativos Lógicos do Azure criam e executam uma nova instância de fluxo de trabalho para seu aplicativo lógico.

Estas são as diferenças entre esses gatilhos:

• Recorrência: executa o fluxo de trabalho em intervalos de tempo regulares e com base no agendamento especificado. Se o gatilho perder recorrências, por exemplo, devido a interrupções ou fluxos de trabalho desabilitados, o Gatilho de recorrência não processará as recorrências perdidas, mas reiniciará as recorrências com o próximo intervalo agendado.

  Se você selecionar Dia como a frequência, poderá especificar as horas do dia e os minutos da hora, por exemplo, todos os dias às 2:30. Se você selecionar Semana como a frequência, também poderá selecionar dias da semana, como quarta-feira e sábado. Também é possível especificar uma data e hora de início junto com um fuso horário para sua agenda de recorrência. Para obter mais informações sobre a formatação de fuso horário, confira Adicionar um gatilho de recorrência.

  Importante

  Caso você use a frequência Dia, Semana ou Mês e especifique uma data e uma hora no futuro, configure a recorrência com antecedência:

  • Dia: configure a recorrência diária com pelo menos 24 horas de antecedência.

  • Semana: configure a recorrência semanal com pelo menos sete dias de antecedência.

  • Mês: configure a recorrência mensal com pelo menos um mês de antecedência.

  Caso contrário, o fluxo de trabalho pode ignorar a primeira recorrência.

  Se uma recorrência não especificar a data e a hora de início, a primeira recorrência será executada imediatamente quando você salvar ou implantar o aplicativo lógico, apesar da configuração de recorrência do gatilho. Para evitar esse comportamento, forneça a data e hora de início para quando você deseja que a primeira recorrência seja executada.

  Se uma recorrência não especificar outras opções de agendamento avançado, como horários específicos para executar recorrências futuras, essas recorrências serão baseadas no último tempo de execução. Como resultado, os horários de início dessas recorrências podem variar devido a fatores como latência durante as chamadas de armazenamento. Para o seu fluxo de trabalho não perca nenhuma recorrência, especialmente quando a frequência está definida em dias ou mais, experimente as seguintes opções:

  • Forneça a data e hora de início para a recorrência, além dos horários específicos para o momento de executar recorrências subsequentes usando as propriedades chamadas Nessas horas e Nesses minutos, que estão disponíveis apenas para as frequências de Dia e Semana.

  • Use o Gatilho de janela deslizante em vez do Gatilho de recorrência.

  Para obter mais informações, confira Como criar, agendar e executar tarefas e fluxos de trabalho recorrentes com o Gatilho de recorrência.

• Janela deslizante: executa o fluxo de trabalho em intervalos de tempo regulares e que manipulam dados em partes contínuas. Se o gatilho perder recorrências, por exemplo, devido a interrupções ou fluxos de trabalho desabilitados, o Gatilho de janela deslizante voltará e processará as recorrências perdidas.

  Você pode especificar uma data e hora de início, um fuso horário e uma duração para atrasar cada recorrência em seu fluxo de trabalho. Esse gatilho não dá suporte a agendamentos avançados, por exemplo, com especificação de horas do dia, minutos da hora e dias da semana. Para obter mais informações, confira Como criar, agendar e executar tarefas e fluxos de trabalho recorrentes com o Gatilho de janela deslizante.

Ações de agendamento

Depois de qualquer ação no fluxo de trabalho do aplicativo lógico, você pode usar as ações Atrasar e Atrasar Até para fazer seu fluxo de trabalho aguardar até a execução da próxima ação.

• Atrasar: aguarde para executar a próxima ação do número especificado de unidades de tempo, como segundos, minutos, horas, dias, semanas ou meses. Para obter mais informações, confira Atrasar a próxima ação em fluxos de trabalho.

• Atrasar até: aguarde para executar a próxima ação até a data e a hora especificadas. Para obter mais informações, confira Atrasar a próxima ação em fluxos de trabalho.

Padrões para data e hora de início

Veja a seguir alguns padrões que mostram como controlar a recorrência com a data e a hora de início e como o serviço dos Aplicativos Lógicos executa essas recorrências:

Exemplo de hora de início no passado com recorrência, mas sem agendamento

Suponha que a data e a hora atuais sejam 8 de setembro de 2017, às 13:00. Você especifica a data e a hora de início como 7 de setembro de 2017, às 14:00, que está no passado, e uma recorrência que é executada a cada dois dias.

Para o gatilho de recorrência, o mecanismo dos Aplicativos Lógicos do Azure calcula os tempos de execução com base na hora de início, descarta os tempos de execução anteriores, usa a próxima hora de início futura da primeira execução e calcula as execuções futuras com base no último tempo de execução.

Veja a aparência dessa recorrência:

Portanto, não importa o quanto no passado você especifique a hora de início, por exemplo, 2017-09-05 às 14:00 ou 2017-09-01 às 14:00, a primeira execução sempre usará a próxima hora de início futura.

Para o Gatilho de janela deslizante, o mecanismo de Aplicativos Lógicos calcula os tempos de execução com base na hora de início, honra os tempos de execução anteriores, usa a hora de início para a primeira execução e calcula as execuções futuras com base na hora de início.

Veja a aparência dessa recorrência:

Portanto, não importa o quanto no passado você especifique a hora de início, por exemplo, 2017-09-05 às 14:00 ou 2017-09-01 às 14:00, a primeira execução sempre usará a de início especificada.

Comportamento de recorrência

Gatilhos internos recorrentes, como o Gatilho de recorrência, são executados nativamente no runtime dos Aplicativos Lógicos do Azure. Esses gatilhos diferem dos gatilhos de conector gerenciado baseados em conexão recorrentes no sentido de que você precisa criar uma conexão primeiro, como o gatilho do conector gerenciado Office 365 Outlook.

Para os dois tipos de gatilhos, se uma recorrência não especificar uma data e uma hora de início específicas, a primeira recorrência será executada imediatamente quando você salvar ou implantar o recurso de aplicativo lógico, apesar da configuração de recorrência do gatilho. Para evitar esse comportamento, forneça a data e hora de início para quando você deseja que a primeira recorrência seja executada.

Recorrência para gatilhos internos

Os gatilhos internos recorrentes seguem o agendamento definido por você, incluindo qualquer fuso horário especificado. No entanto, se uma recorrência não especificar outras opções avançadas de agendamento, como horários específicos para executar recorrências futuras, essas recorrências serão baseadas na última execução do gatilho. Como resultado, os horários de início dessas recorrências podem variar devido a fatores como latência durante as chamadas de armazenamento.

Para obter mais informações, examine a seguinte documentação:

• Disparar recorrência para o horário de verão e o horário padrão
• Solucionar problemas de recorrência

Recorrência para gatilhos baseados em conexão

Para gatilhos baseados em conexão recorrentes, como o Office 365 Outlook, o agendamento não é o único fator que controla a execução. O fuso horário só determina a hora de início. As execuções subsequentes dependem do agendamento de recorrência, da última execução do gatilho e de outros fatores que podem causar variações nos runtimes ou gerar um comportamento inesperado, por exemplo:

• Se o gatilho acessar um servidor que tem mais dados, o que o gatilho tenta buscar imediatamente.
• Falhas ou repetições incorridas pelo gatilho.
• Latência durante as chamadas de armazenamento.
• Não manter o agendamento especificado quando o horário de verão começar e terminar.
• Outros fatores que podem afetar o momento em que ocorrerá o próximo runtime.

Para obter mais informações, examine a seguinte documentação:

• Disparar recorrência para o horário de verão e o horário padrão
• Disparar o deslocamento e o descompasso de recorrência durante o horário de verão e o horário padrão
• Solucionar problemas de recorrência

Disparar recorrência para o horário de verão e o horário padrão

Ao agendar trabalhos, os Aplicativos Lógicos do Azure colocam a mensagem para processamento na fila e especificam quando ela ficará disponível com base no horário UTC em que o último trabalho foi executado e no horário UTC em que o trabalho seguinte está agendado para ser executado. Se você especificar uma hora de início com sua recorrência, certifique-se de selecionar um fuso horário para que o fluxo de trabalho do aplicativo lógico seja executado na hora de início especificada. Dessa forma, o horário UTC do aplicativo lógico também mudará para compensar a mudança de horário sazonal. Os gatilhos de recorrência seguem o agendamento definido, incluindo o fuso horário especificado.

Se você não selecionar um fuso horário, os eventos de horário de verão poderão ser afetados quando os gatilhos forem executados. Por exemplo, a hora de início mudará uma hora para frente quando o horário de verão começar e uma hora para trás quando ele terminar.

Disparar o deslocamento e o descompasso de recorrência durante o horário de verão e o horário padrão

Para gatilhos baseados em conexão recorrentes, a agenda de recorrência não é o único fator que controla a execução. O fuso horário só determina a hora de início. As execuções subsequentes dependem do agendamento de recorrência, da última execução do gatilho e de outros fatores que podem causar variações nos runtimes ou gerar um comportamento inesperado, por exemplo:

• Não manter o agendamento especificado quando o horário de verão começar e terminar.
• Outros fatores que podem afetar o momento em que ocorrerá o próximo runtime.
• Latência durante as chamadas de armazenamento.
• Se o gatilho acessar um servidor que tem mais dados, o que o gatilho tenta buscar imediatamente.
• Falhas ou repetições incorridas pelo gatilho.

Para garantir que a hora da recorrência não mude quando o horário de verão entrar em vigor, ajuste manualmente a recorrência. Dessa forma, o fluxo de trabalho continua a ser executado no horário esperado ou especificado. Caso contrário, a hora de início mudará uma hora para frente quando o horário de verão começar e uma hora para trás quando o horário de verão terminar.

Por exemplo, suponha que você tenha dois aplicativos lógicos que sejam executados diariamente. Um aplicativo lógico é executado à 1:30, hora local, enquanto o outro é executado uma hora depois às 2:30, hora local. O que acontece com os horários de início desses aplicativos quando o horário de verão é iniciado e encerrado?

• Os gatilhos são executados quando o horário muda para uma hora à frente?

• Os gatilhos são executados duas vezes quando o horário muda para uma hora para trás?

Se esses aplicativos lógicos usarem a zona UTC-6:00 hora central (EUA e Canadá), essa simulação mostrará como as horas UTC mudaram em 2019 para combater as alterações de horário de verão, movendo uma hora para trás ou para frente, conforme necessário, para que os aplicativos continuem em execução nos horários locais esperados sem execuções ignoradas ou duplicadas.

• 03/10/2019: o horário de verão começa às 2:00, passando o horário para uma hora à frente

  Para compensar o início do horário de verão, o horário UTC muda uma hora para trás para que seu aplicativo lógico continue em execução na mesma hora local:

  • Aplicativo lógico nº 1

    Data	Hora (local)	Hora (UTC)	Observações
    03/09/2019	1:30:00	7:30:00	UTC antes do dia em que o horário de verão entra em vigor.
    03/10/2019	1:30:00	7:30:00	O UTC é o mesmo porque o horário de verão não entrou em vigor.
    03/11/2019	1:30:00	6:30:00 AM	O UTC mudou uma hora para trás depois que o horário de verão entrou em vigor.

  • Aplicativo lógico nº 2

    Data	Hora (local)	Hora (UTC)	Observações
    03/09/2019	2:30:00	8:30:00	UTC antes do dia em que o horário de verão entra em vigor.
    03/10/2019	3:30:00*	8:30:00	O horário de verão já está em vigor, portanto, a hora local mudou uma hora para frente porque o fuso horário UTC-6:00 muda para UTC-5:00. Para obter mais informações, confira Gatilhos que começam entre 2:00 e 3:00.
    03/11/2019	2:30:00	7:30:00	O UTC mudou uma hora para trás depois que o horário de verão entrou em vigor.

• 11/03/2019: o horário de verão termina às 2:00 e muda o horário uma hora para trás

  Para compensar, o horário UTC muda uma hora à frente para que seu aplicativo lógico continue em execução na mesma hora local:

  • Aplicativo lógico nº 1

    Data	Hora (local)	Hora (UTC)	Observações
    11/02/2019	1:30:00	6:30:00 AM
    11/03/2019	1:30:00	6:30:00 AM
    11/04/2019	1:30:00	7:30:00

  • Aplicativo lógico nº 2

    Data	Hora (local)	Hora (UTC)	Observações
    11/02/2019	2:30:00	7:30:00
    11/03/2019	2:30:00	8:30:00
    11/04/2019	2:30:00	8:30:00

Solucionar problemas de recorrência

Para garantir que o fluxo de trabalho seja executado na hora de início especificada e não perca uma recorrência, especialmente quando a frequência estiver em dias ou mais, experimente as seguintes soluções:

• Quando o horário de verão entrar em vigor, ajuste manualmente a recorrência para que o fluxo de trabalho continue sendo executado no horário esperado. Caso contrário, a hora de início mudará uma hora para frente quando o horário de verão começar e uma hora para trás quando o horário de verão terminar. Para obter mais informações e exemplos, examine Recorrência de horário de verão e horário padrão.

• Se você estiver usando um gatilho de recorrência, especifique um fuso horário, bem como uma data de início e uma hora de início. Além disso, configure horários específicos para executar recorrências posteriores nas propriedades Nestas horas e Nestes minutos, que estão disponíveis apenas para as frequências Dia e Semana. No entanto, algumas janelas de tempo ainda podem causar problemas quando o horário mudar.

• Considere o uso de um gatilho de janela deslizante em vez de um gatilho de recorrência para evitar perder as recorrências.

Executar apenas uma vez

Caso queira executar seu aplicativo lógico apenas uma vez no futuro, você poderá usar o modelo Agendador: executar trabalhos apenas uma vez. Depois de criar um novo aplicativo lógico, mas antes de abrir o designer de fluxo de trabalho, na seção Modelos, na lista Categoria, selecione Agendar e, em seguida, clique neste modelo:

Ou, se você puder iniciar seu aplicativo lógico com o gatilho Quando uma solicitação HTTP é recebida – Solicitação e passar a hora de início como um parâmetro para o gatilho. Para a primeira ação, use a ação Atrasar até – Agendamento e informe a hora de quando a próxima ação começará a ser executada.

Executar uma vez no último dia do mês

Para executar o gatilho Recorrência apenas uma vez no último dia do mês, você precisa editar o gatilho na definição JSON subjacente do fluxo de trabalho usando a exibição de código, e não o designer. No entanto, você pode usar o exemplo a seguir:

"triggers": {
    "Recurrence": {
        "recurrence": {
            "frequency": "Month",
            "interval": 1,
            "schedule": {
                "monthDays": [-1]
            }
        },
        "type": "Recurrence"
    }
}

Exemplos de recorrências

Eis várias recorrências de exemplo que você pode configurar para os gatilhos que dão suporte às opções:

Próximas etapas

• Criar, agendar e executar tarefas e fluxos de trabalho recorrentes com o Gatilho de recorrência
• Criar, agendar e executar tarefas e fluxos de trabalho recorrentes com o Gatilho de janela deslizante
• Pausar fluxos de trabalho com ações de atraso