--- sourceDocument: Capacidades da Now Platform da Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Capacidades da Now Platform da Yokohama ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Atividade de fluxo de trabalho Temporizador # Atividade de fluxo de trabalho Temporizador {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura A atividade Temporizador pausa o fluxo de trabalho por um período de tempo especificado.{#r_Timer__wf-timer-activity-shortdesc} Esta duração pode ser um valor de tempo absoluto ou um valor relativo com base em [Como criar e usar cronogramas](https://www.servicenow.com/docs/access?context=c_UseSchedules&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US) 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](https://servicenow-prod.fluidtopics.net/J7qgvbQH~qyz343GX4ttIQ "A atividade Aguardar condição faz com que o fluxo de trabalho aguarde nesta atividade até que o registro atual corresponda à condição especificada."). 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 {#r_Timer__table_b1r_fgd_lq__entry__2} | 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. | [Tabela 1. Resultados da atividade temporizador] {#r_Timer__table_b1r_fgd_lq} ## Variáveis de entrada As variáveis de entrada determinam o comportamento inicial da atividade. {#r_Timer__table_dl4_ngd_lq__entry__2} | 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. {#r_Timer__ul_ebm_sgd_lq} | | 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. {#r_Timer__ul_q3v_chd_lq} | | 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. {#r_Timer__ul_wys_qhd_lq} | | 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. {#r_Timer__ul_hmv_vhd_lq} | | 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. | [Tabela 2. Variáveis de entrada da atividade Temporizador] {#r_Timer__table_dl4_ngd_lq} ## Estados O estado da atividade informa ao mecanismo de fluxo de trabalho o que fazer com a atividade. {#r_Timer__table_qts_d3d_lq__entry__2} | 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. | [Tabela 3. Estados da atividade temporizador] {#r_Timer__table_qts_d3d_lq} ## 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');