Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2108

Agendar Execução

Agenda

Esse bloco agenda comandos a serem executados após um determinado atraso ou de forma periódica.


Image Added

Figura 1 - Bloco Agendar Execução

Parâmetros de Entrada

NomeTipoDocParâmetro 1ComandosComandos as serem executados

Compatibilidade

  • Bloco servidor: cronapi.util.Operations.scheduleExecution()

Retorno

Este bloco não possui retorno.

Parâmetros

Comando

É possível utilizar qualquer bloco de programação sem retorno para realizar uma ação em um certo intervalo de tempo.

  • Posição: 1
  • Inglês: Command
  • Tipo: Comando sem retorno / Not return command
  • Exemplo: utilização do retorno do bloco Chamar Bloco.

Tempo Inicial

Parâmetro 2Inteiro

Tempo inicial necessário até que a função execute pela primeira vez o(s) comando(s) definido(s)

Parâmetro 3

. Caso esse tempo seja zero(0), o conteúdo do parâmetro Comando será executado no momento em que a função for chamada.

  • Posição: 2
  • Inglês: Initial time
  • Tipo: Inteiro / Integer
  • Exemplo: 3

Tempo de Atualização

Inteiro

Tempo de espera entre as execuções do(s) comandos(s)

Parâmetro 4ObjetoUnidade de medida do tempo passado como parâmetro NotatitleObs

.

:

Caso

o Parâmetro 3

tempo seja igual a zero(0), a função irá executar o(s) comando(s) uma única vez com o tempo

atraso

inicial definido.

Compatibilidade

Image Removed Servidor

Exemplo 1

A função abaixo em destaque executa os comandos contidos na função BlocoComandos com um atraso incial para a primeira execução de 3 horas, repetindo a execução dos comandos a cada 24 horas.

Image Removed

 

  • Posição: 3
  • Inglês: Time to upgrade
  • Tipo: Inteiro / Integer
  • Exemplo: 24

Unidade de Tempo

Unidade de medida do tempo passado como parâmetro.

  • Posição: 4
  • Inglês:  Time unit
  • Tipo: Objeto / Object 
  • Exemplo: Horas
  • Opções:
    • Segundos: define o intervalo de tempo em segundos.
    • Milissegundos: define o intervalo de tempo em milissegundos.
    • Minutos: define o intervalo de tempo em minutos.
    • Horas: define o intervalo de tempo em horas.

Exemplo

Com o tempo inicial configurado para um minuto a partir da chamada da função Agendar Execução, estamos obtendo a data e hora atual do sistema e logo em seguida, obtemos os minutos da data. A cada dois minutos essa instrução da entrada Comando é realizada e o resultado é exibido no console do depurador.


Image Added

Figura 2 - Função que imprime os minutos da hora atual console do depurador a cada 2 minutos

Nesta Página

Índice

Sobre o Bloco

A função permite a utilização de 4 tipos de unidades de tempo para o agendamento de comandos a serem executados, são eles: Segundos, Milissegundos, Minutos, Horas.

Image Removed