O que são Schedulers e como configurá-los?
O Valuekeep Integrator – SDK disponibiliza um scheduler assistente (disponível na pasta de instalação) que permite definir a frequência de execução a aplicar a um pipeline. Este assistente, permite obter a “string” que deverá ser considerada para o efeito na solução (integration.config).
Contexto
A definição de um scheduler é obtida através dos seguintes parâmetros de configuração:
- Time: período de execução, especificada no formato hh:mm, permitindo inclusive a definição de diferentes intervalos;
- Days of Month: identifica os dias do mês em que é executado (intervalo compreendido entre 1 e 31);
- Days of Week: identifica os dias da semana em que é executado (intervalo compreendido entre 1 “domingo” e 7 “sábado”);
- Months: identifica os meses do ano em que é executado (intervalo compreendido entre 1 e 12);
- Years: identifica os anos considerados como válidos;
- Sleep Period: identifica o tempo (em segundos) que o pipeline pára entre cada execução;
- Execute After Inicialization: quando ativo, o pipeline executa mal o serviço arranca independentemente de estar num período válido.
Notas:
- A definição de intervalo é expressa através do caracter “-“. Time: 08h00-12h00;
- A definição de conjunto é expressa através do caracter “,”. Days of Weak: 1,2,3,4,5,6,7;
- A definição de vários intervalos é expressa através da conjunção dos dois itens anteriores. Time: 08h00-12h00,14h00-20h00;
- Os parâmetros omitidos, são considerados como incluídos na sua total amplitude, por exemplo: quando não especificado Days of Weak, significa que a execução ocorre todos os dias da semana;
- Schedulers cuja execução pode ser expressa em segundos, requerem apenas a identificação do número de segundos na sua definição (ver exemplos seguintes).<Schedulers>
<Scheduler Id=”Default” ConfigStr=”20? />
<Scheduler Id=”EverySecond” ConfigStr=”1? />
<Scheduler Id=”EveryTwoSeconds” ConfigStr=”2? />
<Scheduler Id=”EveryFiveSeconds” ConfigStr=”5? />
<Scheduler Id=”EveryTenSeconds” ConfigStr=”10? />
<Scheduler Id=”EveryTwentySeconds” ConfigStr=”20? />
<Scheduler Id=”EveryMinute” ConfigStr=”60? />
<Scheduler Id=”EveryFiveMinutes” ConfigStr=”300? />
<Scheduler Id=”NightWatch” ConfigStr=”QuickStart=True; SleepPeriod=60; Time=20:00-23:59;” />
</Schedulers>
Configurar Shedulers
A frequência de execução de um pipeline é definida através do scheduler expresso na configuração do pipeline. O catálogo de Schedulers presente na solução disponível como exemplo base, poderá ser customizado com a inclusão de novos itens, com recurso ao utilitário Valuekeep Integrator SDK.
A definição de um Scheduller é sintetizada na definição de dois atributos:
- Id: identificação ou designação do scheduler;
- ConfigStr: string de configuração que representa a frequência de execução, obtida com recurso ao utilitário ou expressa em segundos.
A Api da Valuekeep deverá apenas ser consultada com um mínimo de 5min (300 segundos). Qualquer scheduler identificado acima serve meramente como exemplo.