Agendar Execução / Schedule Execution

Agendar Execução / Schedule Execution

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

 

image-20250922-181033.png
Figura 1 - Bloco Agendar Execução

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

Tempo inicial necessário até que a função execute pela primeira vez o(s) comando(s) definido(s). 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

Tempo de espera entre as execuções do(s) comandos(s). Caso tempo seja igual a zero(0), a função irá executar o(s) comando(s) uma única vez com o tempo inicial definido.

  • 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-20250922-181123.png
Figura 2 - Função que imprime os minutos da hora atual console do depurador a cada 2 minutos