Criação de Rotinas para Execução Automática Pós-Upgrade

Introdução

Passa a ser possível criar rotinas para que o upgrade completo execute automaticamente. O próprio upgrade irá controlar a execução das rotinas criadas pelos times, sendo possível acompanhar posteriormente o resultado da execução de cada script desenvolvido.

Desenvolvimento das rotinas

1- Os scripts devem ser inseridos a partir da classe /Dados/Arquivos/Upgrade/Scripts Pos-Upgrade/. Os arquivos devem ser do tipo JavaScript com a extensão ".ijs".

2- Eles devem possuir necessariamente a seguinte estrutura:

includeOnce -1898141821; /* /products/INTEQengine/library/util/UpgradeScript.ijs */

var upgradeScript = new UpgradeScript();

try {

var updateVersion = null;

var result = "";

// ----------------------------------------------------------------

// Desenvolva aqui a lógica do seu script pós-upgrade

// utilizando as conexões de origem (source) e destino (target)

// Lembre-se de alimentar os valores das variáveis updateVersion e result

// que serão passadas ao método finish

// ----------------------------------------------------------------

upgradeScript.finish(result, updateVersion);

} catch (e) {

upgradeScript.fail(e);

}

upgradeScript.result;

# Atenção:

* Os métodos finish e fail são responsáveis pela gravação de registros na tabela de Eventos do Sistema (iSysEvent) e devem ser invocados de acordo com a estrutura acima.

* Seu script deve retornar sempre na última linha o valor existente na propriedade result do objeto UpgradeScript. Ela contém as informações que serão listadas pelo processo de upgrade ao seu final.

* O método finish deve receber uma única versão referente às alterações realizadas no banco de dados.

* As rotinas criadas para essa funcionalidade NÃO devem executar alterações diretamente no banco de dados: database.executeSQL(sql).

* Rotinas potencialmente lentas não devem ser incorporadas automaticamente ao upgrade.

Consultando o Histórico de Execução das Rotinas de Upgrade

Utilize a consulta disponível no caminho abaixo para verificar os status da execução das rotinas do upgrade:

Ir para > Desenvolvimento > Atualizacao > Historico de Execucao de Rotinas de Upgrade

Documentação

A documentação completa da classe UpgradeScript encontra-se em:

l.unum.com.br/jsdoc/symbols/UpgradeScript.html