Agendador de scripts

O processo “Administração do sistema > Scripts Agendados > Agendador de scripts” permite que o administrador do sistema crie, exporte ou importe agendamentos no Engine para a execução de scripts.

Ao acessar o processo é exibida a grade “Scripts Agendados” contendo a lista de todos os agendamentos configurados no Engine e duas grades de configuração. A grade “Parâmetros” permite selecionar o Engine onde as tarefas estão cadastradas para execução. A grade “Filtros” permite filtrar as tarefas exibidas na grade principal.

Criando um novo agendamento

Para acompanhar o manual aconselhamos a mudança de visão da grade para o modo formulário.

Considerando que o objetivo é criar um agendamento, nesse manual vamos explicar todos os campos da grade e como funcionam. Após isso basta criar um novo registro nesta grade configurado da maneira que atenda ao seu objetivo.

• Nome: Define o nome do agendamento. Ex. Atualização dos status dos clientes.

• Id: É um identificador único gerado automaticamente e usado internamente pelo sistema.

• Status: Mostra como o agendamento se encontra no momento. Existem 3 status possíveis:

  1. Executando: O script agendado está em execução.
  2. Abortando: Por algum motivo o script foi abortado no meio da execução. Esse status indica que o sistema está parando a execução do script.
  3. Parado: O script não está em execução.

• Prox Execução: Indica a data de quando será a próxima vez que o script será executado de acordo com esse agendamento.

• Hr Prox Exec: Indica o horário de quando será a próxima vez que o script será executado de acordo com esse agendamento.

• Período: Mostra a periodicidade em que esse agendamento irá entrar em ação.

  Hora, Data, Dia do mês, Dia da semana - Estas caixas são dependentes do Período, de acordo com o valor definido nele, elas serão habilitadas. Ex. Caso o Período seja definido como Diário apenas a caixa Hora será habilitada.

• Script VFS: Script que será executado quando o agendamento for ativado.

• Script URI: URI do script. Esta caixa deve ser ignorada caso o script já tenha sido definido em Script VFS.

• Parâmetros: Definição dos parâmetros que serão levados ao script. Eles devem ser declarados da seguinte forma: nome="valor”.
  Ex.:

  idade="14"
  nome="João"
  cidade="Fortaleza"
  

• Pré-requisito: Caso esse agendamento dependa de que um outro seja finalizado anteriormente, o campo Id desse outro agendamento deve ser inserido nesse campo.

• Usuário: O último usuário a alterar esse agendamento. Esse campo é de preenchimento automático.

• Habilitado: Define se o agendamento está ativo. Se esse campo não estiver marcado o agendamento não será executado.

• Progresso: Agrupamento que contém os campos que mostram as informações sobre o progresso do agendamento e sobre as últimas execuções.

• Última execução: Agrupamento que contém campos que mostram informações sobre a última execução do agendamento.

  1. Sucesso - Campo preenchido automaticamente demonstrando se a execução do script ocorreu com sucesso.
  2. Resultado - Caso o script possua algum valor de saída, esse será mostrado nesse campo. Assim como a exceção caso ocorra algum erro.

Exportando e importando agendamentos

O processo possui ainda dois botões para exportação e importação de agendamentos que podem ser utilizados para migrar agendamentos de um Engine para outro.

Ao selecionar os agendamentos desejados e clicar no botão “Exportar para arquivo”, localizado na grade “Scripts agendados”, o sistema pergunta se o arquivo contendo os agendamentos deve ser baixado via download ou se deve ser gravado numa pasta em disco no servidor do Engine. Se for escolhida a segunda opção, será apresentada uma grade com o campo “Nome do arquivo”. Depois de informar o nome do arquivo clique no botão “Gravar” e será gravado o arquivo contendo os agendamentos no caminho informado.

Importante: O caminho informado deve ser um caminho válido no servidor onde o Engine está executando.

Após exportar o arquivo com os agendamentos e fazer o download ou copiá-lo do servidor, acesse o mesmo processo no Engine de destino e utilize o botão “Importar do arquivo”. Da mesma forma o sistema dará a opção de ler o arquivo a partir de um upload ou a partir de um arquivo no servidor onde o Engine está executando.

As opções de download e upload do arquivo de agendamentos são as opções padrão por serem de uso mais prático. No entanto, podem ocorrer situações específicas em que os agendamentos ocupem um grande espaço em disco, o que resulta na geração de arquivos de tamanho elevado e que podem demorar muito para transferir via download e upload. Para esses casos é recomendado o uso das opções de exportação e importação via arquivo em disco.