Jobs

Os Jobs executam ações essenciais para o funcionamento da plataforma. Embora sejam pré-configurados, o usuário pode ajustá-los para otimizar o desempenho do sistema, além de ativá-los ou desativá-los sob demanda.

Acessando um job

Para acessar um job, basta seguir os passos:

1. Autentique-se no Admin console

2. Acione o menu Plataforma

3. No menu Plataforma, acione o item Jobs a partir do caminho, Jobs > Geral > Jobs, para ter acesso à listagem dos jobs

4. Na página de listagem de Jobs, pode-se filtrar os jobs selecionando uma Categoria e aplicando um filtro na barra de filtragem no topo da listagem

5. Escolha um job e clique nele para poder editá-lo, ou clique na caixa de seleção para ações em lote.

Reiniciando ativos

Na tela de listagem de jobs, há dois botões localizados na barra de ações na parte superior da tela. Na barra de ações o primeiro o botão é o botão da ação Reiniciar Ativos. Ao clicar nesse botão, todos os jobs ativos da plataforma são reiniciados.

Pausar todos

Ainda na barra de ações tem-se o botão Mais opções com duas ações, sendo a primeira a ação Pausar todos. Ao clicar no botão Pausar todos, todos os jobs da plataforma são imediatamente parados e inativados.

Iniciar todos

A segunda ação do botão Mais ações, é a ação Iniciar todos. Ao clicar no botão Iniciar todos, todos os jobs da plataforma são imediatamente iniciados e ativados.

Alterando configurações

Para alterar as configurações de um job específico, basta executar um clique em um job selecionado na listagem e acessar a aba Configurações.

Na tela da aba de Configurações tem-se os cards Informações gerais e Parâmetros.

Informações gerais

Os jobs do Blazon usam o motor do Quartz para sua execução. No card Informações gerais pode-se configurar a expressão cron do Quartz que define a periodicidade de execução do job.

Uma expressão cron é uma string usada para definir agendamentos de execução periódica de tarefas em sistemas Unix/Linux e em diversas ferramentas de automação, como o Spring Scheduler, Quartz Scheduler, Kubernetes CronJobs, entre outros.

Uma expressão de um job Quartz tem entre 6 ou 7 caracteres definindo o período de disparo em termos das unidades: segundos, minutos, horas, dia do mês, meses, dia da semana, ano. Apenas a configuração do ano não é obrigatória.

A seguir, tem-se o exemplo de uma expressão cron do Quartz comum nos jobs da plataforma:

*     *     *     *     *     *     *     
│     │     │     │     │     │     └───── Ano
│     │     │     │     │     └─────────── Dia da semana
│     │     │     │     └───────────────── Mês (1-12)
│     │     │     └─────────────────────── Dia do mês (1-31)
│     │     └───────────────────────────── Hora (0-23)
│     └─────────────────────────────────── Minuto (0-59)
└───────────────────────────────────────── Segundo (0-59)

A tabela a seguir define os possíveis valores de cada campo de uma expressão cron do Quartz.

Campo	Possíveis valores	Obrigatório
Segundo	0-59 ou * para todos	Sim
Minuto	0-59 ou * para todos	Sim
Hora	0-23 ou * para todas	Sim
Dia do mês	1-31 ou * para todos	Sim
Mês	1-12 ou * para todos	Sim
Dia da semana	(0-7) [0 e 7 = Domingo, 1 = Segunda, ..., 6 = Sábado]	Sim
Ano	[YYYY, ex: 2025]	Não

A expressão acima define que o job em questão irá disparar sua execução a cada 20 segundos todos os dias, ou seja:

Expressão	Descrição
*/20 * * * * ?	Execução a cada 20 segundos.
0 * * * * ?	A cada segundo.
0 0/5 * * * ?	A cada cinco minutos.
0 0 * * * ?	A cada hora.
0 30 17 1 1 ?	Todo primeiro de janeiro às 17:30.

Mais sobre as configurações de expressão cron do Quartz pode ser obtido na sua própria documentação nesse link.

Parâmetros

No card Parâmetros pode-se configurar os parâmetros que o job irá considerar nas execuções, como o número de elementos que o job irá buscar a cada execução, etc.

Cada job tem seus próprios parâmetros cujos nomes são auto explicativos sendo que alguns jobs não tem nenhum parâmetro.