A funcionalidade Agendador de tarefas do Cronapp permite que o servidor da aplicação execute funções em um momento específico ou em períodos determinado. Dessa forma, é possível criar jobs no sistema, por exemplo, gerar automaticamente um relatório semanal do sistema ou fechar a folha de pagamento ao final do mês.

Figura 1 - Agendador do Cronapp configurado para imprimir Data e hora atual a cada 5 segundos

Criar ou editar tarefa

Abrindo a janela do Agendador de tarefas (Figura 2.1) é possível visualizar uma lista com todas as tarefas agendadas, permitindo editar ou excluir uma tarefa existente, além de criar uma nova.

Figura 2.1 - Agendador de tarefas do Cronapp

Ao clicar no botão Nova Tarefa Agendada ou editar (Figura 2.2) a janela da tarefa é aberta, nela encontramos as abas de configurações: Geral, Disparadores e Ações.

Aba Geral

Define o identificador e a descrição para a tarefa, evitando alguma confusão em projetos que possuam diversos agendamentos. 

A caixa de seleção Executar em todas as instâncias da aplicação permite usar todo o recurso do servidor para executar tarefas pesadas. Habilitar essa opção para jobs complexos pode tornar o sistema lento para os usuários.

Figura 2.2 - Aba Geral

Aba Disparador

A aba Disparador permite configurar a execução da tarefa em determinada data e hora ou em ciclos, a cada período. Dessa forma, uma mesma tarefa pode possuir 2 ou mais agendas, por exemplo: disparar no dia 20 de outubro às 12h30 e em todas as quartas e quintas feiras às 14h00.

Ao acessar a aba Disparadores é possível visualizar uma lista com todos os agendamentos, permitindo editar ou excluir um item, além de criar.

Figura 2.3 - Configuração do disparador

Clique no botão Novo Disparador ou editar (Figura 2.3) para abrir a janela Disparador, ela contém o campo onde identificamos o agendamento e as abas Horas, Minutos, Segundos, Dias, Dias da Semana e Meses.

Em cada aba encontramos checkboxs com os valores fixos de cada período e o campo Repetir a cada, que define a cada quantos ciclos daquele período a ação será executada. No exemplo da figura 2.3, a ação será executada todos os meses.

Como podemos ver na tabela abaixo, em cada abas encontramos todos os possíveis períodos de tempo, com exceção dos minutos e segundos que estão listados em múltiplos de 5. Dessa forma é possível selecionar um ou mais momentos para cada período.

Tabela 1 - Período de tempo em cada aba da janela Disparador

Abaixo vemos alguns exemplos de configurações e seus resultados.

Tabela 2 - Tabela com as configurações dos disparadores e seus resultados

Aba Ações

A aba Ações permite selecionar um ou mais blocos de programação servidor (Java) para serem executados nos momentos configurados na aba Disparadores.

Ao clicar no botão Nova Ação ou editar, da lista de ações (Figura 2.4), a janela de seleção de Blocos de programação é aberta, basta informe um nome e selecione o bloco.

Figura 2.4 - Configuração da Aba Ações

Arquivos do Agendador

Quando criamos um agendamento, o diretório jobs é criado abaixo do pacote do projeto e nele contém as classes Java responsáveis por essas ações, além dele o arquivo scheduler.json, responsável pela configuração é criada no diretório META-INF.

Figura 2.5 - Arquivos gerados pelo Agendador de tarefas do Cronapp