Atividade de fluxo de trabalho Temporizador

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • A atividade Temporizador pausa o fluxo de trabalho por um período de tempo especificado.

    Esta duração pode ser um valor de tempo absoluto ou um valor relativo com base em Como criar e usar cronogramas definido. É melhor ajustar a duração para que o fluxo de trabalho possa progredir em tempo hábil. Para pausar um fluxo de trabalho indefinidamente até que uma condição seja atendida, consulte aguardar condição.
    Nota:
    As atividades do temporizador são executadas como o usuário do sistema porque o programador do sistema avança o fluxo de trabalho.

    Resultados

    Tabela 1. Resultados da atividade temporizador
    Resultado Descrição
    Completo A atividade atingiu com sucesso a duração especificada.
    Cancelado A atividade ou o fluxo de trabalho foi cancelado antes que o temporizador atingisse a duração especificada.

    Variáveis de entrada

    As variáveis de entrada determinam o comportamento inicial da atividade.

    Tabela 2. Variáveis de entrada da atividade Temporizador
    Campo Descrição
    Informações do temporizador
    Temporizador baseado em Como a duração do temporizador é calculada. As opções são:
    • Uma duração especificada pelo usuário: a duração é baseada nos campos Duração, como dias e horas.
    • Uma duração relativa: a duração é baseada na duração relativa (como Fim do próximo dia útil) e nos campos Aguardar.
    • Um campo de data/hora ou duração: a duração é baseada no valor Campo e no campo Aguardar.
    • Script: a duração é baseada em um script que retorna o número de segundos.
    Duração

    Aparece somente quando o temporizador baseado em é uma duração especificada pelo usuário.

    O número específico de dias e horas de espera antes de prosseguir para a próxima atividade no fluxo de trabalho.
    Duração relativa

    Aparece somente quando o temporizador baseado em for uma duração relativa.

    O número geral e a duração de dias úteis de espera antes de avançar para a próxima atividade de fluxo de trabalho. .
    Espera

    Aparece somente quando o temporizador baseado em for uma duração relativa ou um campo de data/tempo ou duração.

    Um ajuste adicional do temporizador quando o temporizador baseado em for uma duração relativa ou um campo de data/tempo ou duração. As opções são:
    • A duração total: nenhuma modificação da duração calculada.
    • Um % da duração: a duração é ajustada multiplicando o número de segundos pelo (Porcentagem / 100).
    • Algum tempo antes: a duração é encurtada pela Tempo antes de dias e horas.
    • Algum tempo depois: a duração é prolongada pela Tempo depois de dias e horas.
    Percentual

    Aparece somente quando o temporizador baseado em for uma duração relativa ou um campo de data/tempo ou duração.

    O valor percentual de Aguardar quando o temporizador baseado em for uma duração relativa ou um campo de data/tempo ou duração.
    Tempo anterior

    Aparece somente quando o temporizador baseado em for uma duração relativa ou um campo de data/tempo ou duração e Aguardar for Algum tempo anterior.

    O valor de tempo do modificador quando Aguardar é Algum tempo anterior.
    Tempo posterior

    Aparece somente quando o temporizador baseado em for uma duração relativa ou um campo de data/tempo ou duração e Aguardar for Um tempo posterior.

    O valor de tempo do modificador quando Aguardar é Algum tempo posterior.
    Campo

    Aparece somente quando o temporizador baseado em for um campo de data/tempo ou duração.

    O campo de data/hora ou duração que contém o tempo de espera decorrido antes de passar para a próxima atividade de fluxo de trabalho.
    Script

    Aparece somente quando o temporizador baseado em for Script.

    O script que define “resposta” ao número de segundos para a duração.
    Programação do temporizador
    Programação baseada em A programação básica que o temporizador usa para contar as horas de trabalho. Se uma programação for especificada, a duração só será considerada para os horários especificados na programação. Por exemplo, se a duração for de 2 horas e o fluxo de trabalho começar às 16h em uma programação que vai das 8h às 17h, ele terminará às 9h do dia seguinte. As opções são:
    • Programação deste fluxo de trabalho: a programação usa data e hora do contexto do fluxo de trabalho e um valor opcional defuso horário com base em.
    • Uma programação específica: a programação usa uma programação predefinida e um valor opcional de fuso horário com base em.
    • Um campo programação: a programação usa um valor de uma tabela e um valor fuso horário opcional com base em.
    Programação

    Aparece somente quando Programação baseada em é uma programação específica.

    A Programação predefinida de uma lista.
    Campo de programação

    Aparece somente quando Programação baseada em é um campo de programação.

    Um campo de data e hora ou duração para a programação, que está associado à tabela. Os campos válidos aparecem em azul na caixa de diálogo Selecionar o elemento em uma árvore.
    Fuso horário do temporizador
    Fuso horário baseado em O fuso horário para o cálculo da duração. O fuso horário pode ser baseado em
    • Sem fuso horário: padrão. O fluxo de trabalho usa o fuso horário GMT.
    • Um fuso horário específico: um fuso horáriopredefinido.
    • Um campo de fuso horário: um campo de fuso horário para rastrear a duração de um campo no formulário.
    Fuso horário

    Aparece somente quando o Fuso horário baseado em é um fuso horário específico.

    O fuso horário predefinido.
    Campo de fuso horário

    Aparece somente quando o Fuso horário baseado em é um campo de fuso horário.

    Um campo de data e hora ou duração para a programação, que está associado à tabela. Os campos válidos aparecem em azul na caixa de diálogo Selecionar o elemento em uma árvore.

    Estados

    O estado da atividade informa ao mecanismo de fluxo de trabalho o que fazer com a atividade.

    Tabela 3. Estados da atividade temporizador
    Estado Descrição
    Executando A atividade Temporizador está neste estado por um breve período durante a inicialização, após o qual ela muda imediatamente para Aguardando.
    Aguardando O mecanismo de fluxo de trabalho espera até que o temporizador atinja a duração especificada. O mecanismo faz a transição do fluxo de trabalho para a próxima atividade.
    Terminado A execução da atividade foi concluída. Veja o valor do resultado para o resultado da atividade.
    Cancelado Esta atividade, ou o fluxo de trabalho que contém esta atividade, foi cancelada.
    Erro Ocorreu um erro de JavaScript. Revise os logs para obter detalhes do erro.

    Exemplo

    Você pode usar uma atividade de Temporizador para pausar o fluxo de trabalho até o final do dia útil.

    Figura 1. Exemplo de temporizador

    Neste exemplo, o script avalia o tempo entre a variável now e a variável eod. A variável eod é definida, no tempo de 24 horas, como 16:00. O script define a variável de resposta como a diferença entre essas variáveis, em segundos, e registra em log uma mensagem.

    // get now and calc end of day (4:00pm)
     
    var now =new Date();
     
    var eod =new Date();
    eod.setHours(16);
    eod.setMinutes(0);
    eod.setSeconds(0);
     
    answer =(eod.getTime()- now.getTime())/1000;
     
    workflow.debug('Timer will fire @: '+ eod +'  '+(answer/60)+' minutes from now');