Agendamento de tarefas (Scheduler)

Índice

Agendamento de tarefas

SCHEDU.CAD_JOB

Descrição

Manutenção do agendamento de rotinas do sistema (jobs).

Esta interface pode ser acessada pelo menu:


Campos:

Chave de identificação interna
Descrição ou título da rotina ou processo.
Identificação da operação do sistema. É formado por um nome global único (não existem duas operações com mesmo nome global). Para interfaces, por exemplo, é composta por um padrão SISTEMA.BLOCO_INTERFACE.OPERACAO.
Exemplos: "PROJET.CAD_ATIVIDADES.INSERT", "PEDIDOS.CAD_PEDIDOS.UPDATE", etc.
Título original dado para a operação no idioma de desenvolvimento. Normalmente equivale ao nome de um botão ou de um label.
Exemplos: Insert, Delete, Update, Cancelar pedido, etc.
OBSOLETO - Título dado para documentar o job.
Indica o dia do mês em que a tarefa deve ser executada.
Um "*" (asterisco), indica que deve ser executado todos os dias.
Uma lista de inteiros separados por "," indica que será executado em todos esses dias.
Uma "/" seguida de um inteiro, significa que deve executar a cada X dias.
Um "-" entre dois inteiros, significa que deve executar em todos as dias dentro da faixa.

Exemplos:
  • "1" - Executar no dia 1º
  • "*" - Todas os dias
  • "10,20,30" - Executar nos dias 10, 20 e 30
  • "/7" - Executar a cada 7 dias - Equivale a 7, 14, 21, 28
  • "1-5" - Equivale a 1,2,3,4,5
Indica o mês em que a tarefa deve ser executada.
Um "*" (asterisco), indica que deve ser executado todos os meses.
Uma lista de inteiros separados por "," indica que será executado em todos esses meses.
Uma "/" seguida de um inteiro, significa que deve executar a cada X meses.
Um "-" entre dois inteiros, significa que deve executar em todos as meses dentro da faixa.

Exemplos:
  • "1" - Executar em janeiro
  • "*" - Todas os meses
  • "3,7,11" - Executar em março, julho e novembro
  • "/3" - Executar a cada 3 meses - Equivale a 3, 6, 12
  • "1-3" - Equivale a 1,2,3
Ex:
  • 3,6,9,12
Indica em quais dias da semana a tarefa deverá ser executada.
Para executar a tarefa no primeiro domingo de um mês, basta marcar domingo neste campo e incluir 1,2,3,4,5,6,7 nos dias do mês. Da mesma forma, para executar a tarefa na última sexta-feira de um mês, basta marcar sexta e -1,-2,-3,-4,-5,-6,-7 nos dias do mês.
Indica a hora em que a tarefa deve ser executada.
Um "*" (asterisco), indica que deve ser executado todas as horas.
Uma lista de inteiros separados por "," indica que será executado em todas essas horas.
Uma "/" seguida de um inteiro, significa que deve executar a cada X horas.
Um "-" entre dois inteiros, significa que deve executar em todas as horas dentro da faixa.

Exemplos:
  • "11" - Executar às 11 horas
  • "*" - Todas as horas
  • "10,16,20" - Executar às 10, 16 e 20 horas
  • "/6" - É o mesmo que 0, 6, 12, 18
  • "8-12" - Equivale a 8,9,10,11,12
Indica o minuto em que a tarefa deve ser executada.
Um "*" (asterisco), indica que deve ser executado todos os minutos.
Uma lista de inteiros separados por "," indica que será executado em todos esses minutos.
Uma "/" seguida de um inteiro, significa que deve executar a cada X minutos.
Um "-" entre dois inteiros, significa que deve executar em todos as minutos dentro da faixa.

Exemplos:
  • "0" - Executar no minuto 00 (hora cheia)
  • "*" - Todas os minutos
  • "0,30" - Executar no minuto 00 e no minuto 30
  • "/20" - Executar a cada 20 minutos - Equivale a 0,20,40
  • "5-10" - Equivale a 5,6,7,8,9,10
Caso marcado, define que o JOB deve ser executado apenas uma vez no servidor. Neste caso, a primeira execução com sucesso inativa automaticamente o JOB e, em caso de erro na sua execução, o JOB permanece ativo e será repetido até que a sua execução complete com sucesso.
Nome do nodo. Este nome deve ser o mais curto possível pois ele fará parte de todos os DML-LOGs e serve como parâmetro para gerar o nome global do nodo.
Ex:
  • M
  • 1
  • 2
  • 3
Parâmetros (opcionais) a serem passados para a rotina que será executada pelo agendamento de tarefas.
Cada parâmetro deve ser informado em uma linha separada no formato PARAMETRO=VALOR. Datas deverão ser informadas no padrão ISO (AAAA-MM-DD). Caso o valor seja um texto que deva conter quebras de linhas, o local das quebras deverá ser indicado pelo texto "\n".

Exemplo:
DATA_EMISSAO=[SYSDATE]
DATA_CADASTRO=2016-01-10
EMPRESA=9382
DESCRICAO=Primeira linha do texto.\nSegunda linha do texto.
Relação de destinatários que devem ser notificados com o resultado da execução (com sucesso) do Job.
E-mails (ou outros content-senders) que devem ser notificados quando a tarefa for executada.
Deve-se informar um email por linha.
Pode-se informar para quem deve ser enviado(mailto), para quem deve ser respondido(reply-to), qual o assunto (subject) e de de quem foi enviado (from). Só poderá informar "reply-to", "subject" e "from" somente se a linha começar com "mailto".

Exemplo de como ficaria uma linha com todas as formatações aceitas:
mailto:teste@teste.com.br?from=primeiro@teste.com.br&reply-to=segundo@teste.com.br&subject=email de teste

No caso acima, caso não informado um assunto (subject) os e-mails serão enviados sem assunto. Se em uma linha for informado um e-mail apenas, será enviado o título da job como assunto.

O campo aceita informar linhas com somente um e-mail e linhas formatada com mailto.

Para mais informações, consulte a FAQ Como informar dados para envio de e-mails?.
Por padrão, o JOB será executado com o usuário que está fazendo o cadastro.
Caso necessário, informar um usuário diferente com a sua respectiva senha.
Por padrão, o sistema executará o Job com o mesmo usuário que está cadastrando ele.
Para executar com um usuário diferente, deverá ser informado um usuário e senha nos respectivos campos.
Data e hora da última vez que esta tarefa foi executada (independente da execução ter sida realizada com sucesso ou não).
Data e hora da última execução realizada com sucesso. Este atributo é atualizado sempre que a tarefa for executada sem retornar nenhum erro.
Resultado da última execução desta tarefa. Apresenta a mensagem OK quando a tarefa foi executada com sucesso ou a mensagem de erro gerada pela mesma.
Indica se a tarefa está ativa para execução automática no sistema.
Campo texto livre para incluir informações a respeito da tarefa (job), como por exemplo quando a tarefa é executada, qual o resultado que se espera, etc.

Operações

Topo

Pesquisar

Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação [b:Listar].
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Comportamento:Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
Topo

Novo

Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Comportamento:Topo

Consultar

A consulta de um registro é realizada quando o usuário clica no primeiro link de um dos registros resultantes a operação [b:Listar]. A tela apresenta as informações detalhadas do registro, bem como as ações que o usuário pode disparar a partir dele (alterar, excluir, cancelar, etc.).
Topo

Excluir

Exclui o registro selecionado. A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo.
O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida.
Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Comportamento:Topo

Migrar procedimentos

Migrar os procedimentos antigos que faziam referencia a um método de uma classe para o modelo que existe um cadastramento de uma operação customizada.
Topo

Exportar

Funcionalidade que permite exportar os dados de um bloco.
Topo

Importar

Funcionalidade que permite importar dados para o bloco desejado.
Topo

Iniciar scheduler

Permite iniciar/reiniciar o agendador de tarefas (scheduler). Esta ação é utilizada apenas de forma administrativa, uma vez que o agendador é automaticamente iniciado junto com o sistema ou em casos específicos onde o agendador tenha sido parado para a execução de alguma rotina de manutenção do sistema.
Topo

Parar o scheduler

Esta ação pára o agendador de tarefas. Isso é realizado apenas em casos raros onde se deseja parar o agendador para a execução de alguma rotina de manutenção do sistema em que a execução de uma rotina agendadada pudesse atrapalhar.
Topo

Executar job

Dispara a execução do JOB imediatamente.
Normalmente utilizado para testes.

Dúvidas frequentes

  • Como criar um JOB para capturar os recorrentes de um integrador eletrônico?
  • Regras

    Verificar migração dos procedimentos

    Verifica se existem jobs cadastrados no formado antigo.
    Caso afirmativo, apresenta uma mensagem de advertência com um link para fazer a migração.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Pesquisar"

    Verificar senha

    Solicita e valida obrigatoriamente a senha do usuário informado para a execução do job caso este seja diferente do usuário da sessão (logado).
    Eventos que disparam esta regra:
    • Antes de alterar formulário "Alterar"
    • Antes de inserir formulário "Novo"

    Veja também