Instruções para o Upgrade
Objectivos e Âmbito
Esta funcionalidade irá permitir criar instruções para o upgrade (de versões ou patches), que serão executadas quer no inicio quer no fim do upgrade.
Existem três tipos de instrução de upgrade: Statements SQL, Geração de Sources e Comandos de Sistema Operativo.
- Nos statements SQL só é validado se o statement está bem escrito, não é validado o seu resultado final, em instalações com base de dados mysql só é possível validar statements SELECT
- Na geração de sources é validado se o objecto método existe na base de dados.
- Nos comandos do sistema operativo não é feita qualquer validação
Criar instruções de Upgrade ( ponto de vista do utilizador)
Seguindo o seguinte caminho iremos entrar no ecrã de selecção das instruções do upgrade.
Instalação -> Administração -> Lista De Instruções Para O Upgrade [IA019]

Neste ecrã deveremos colocar o patch/versão que vamos instalar no nosso sistema. Se já existirem instruções estas aparecerão no ecrã seguinte. A nomenclatura a usar será de acordo com o existente na transacção SD040 para patches e na SD033 para versões.
Exemplo : Patch = P_2.0004_100640 / Versão = 2.0010
Para criar uma nova instrução deveremos aceder ao botão . Irá ser mostrado o seguinte ecrã.

Aqui primeiro vamos escolher o patch, onde estas alterações irão ser executadas antes ou depois de o patch ser instalado. Depois de inserir o patch deve ser colocada a sequencia em que a instrução será executada.
No campo “Quando Inserir”, iremos escolher quando executamos as instruções, se no inicio ou fim da instalação do patch.

Depois temos que escolher qual o tipo de comando que vamos executar na instalação.

Por fim devemos escrever o Statement que iremos executar no Upgrade.
No caso de gerar ficheiro deve ser colocado no Statement o nome do ficheiro que se encontra no sistemas de ficheiros da nossa máquina, poderemos colocar com ou sem extensão. Voltamos a relembrar que este vai ser validado com a nossa base de dados, para verificar a sua existência e o mesmo será gerado.
Quanto ao caso do Statement SQL voltamos a relembrar que só será verificado se o statement está de acordo com a sua base de dados, não é validado o resultado, em instalações com base de dados mysql só é possível validar statements SELECT.
Por fim o Comando do Sistema Operativo não é feita qualquer validação poderá ser escrito qualquer comando que seja válido no nosso sistema operativo.
No fim para criar a instrução basta clicar no botão e teremos as nossas instruções criadas e poderemos ver a listagem das mesmas.
Para aceder a listagem das instruções teremos que no ecrã de selecção clicar no botão , e o seguinte ecrã irá aparecer.

Aqui vemos todos os campos que inserimos quando criamos no criar instrução e ainda quem criou a mesma.
Temos ainda a opção de exportar os dados para depois importar para outro ambiente onde queremos efectuar a mesma instalação para isso basta clicar no botão , e será gerado um ficheiro pronto para ser importado para outra instalação onde o patch desta modificação já estará instalada nesse mesma instalação.

Por motivos de segurança basta ser seleccionado uma linha que todas as instruções do patch seleccionado serão exportadas para o ficheiro, se desejar exportar a tabela toda deverá carregar no botão, apenas no ecrã de selecção.
A importação no sistema destino deverá ser efetuada através da transacção ID003-Importação.
Exemplos
Segue-se um exemplo de como usar esta funcionalidade relativamente á geração de local sources.
Tabelas envolvidas:
- I0066 – Definições de chamadas a src locais da instalação
- I0106 – Listagem de Instruções para o Upgrade
- W0030 – Sources com src local
- Garantir que o sistema onde vamos fazer o upgrade de versão está “alinhado” com o sistema de Produção;
Efectuar o upgrade nesse sistema e corrigir os pontos de chamada dos “local sources” nesse sistema preenchendo um ficheiro excel do tipo:

Criar instruções de upgrade (IA019) com os registos para alteração da linha de chamada do local source na tabela D0066.
Criar instrução para apagar os registo desse método da tabela W0030.
Criar instrução para gerar o método em causa.

Depois de criadas as instruções, exportar os registos tal como indicado anteriormente neste documento.
Salvaguardar o ficheiro com extensão .isr criado.
Importar (ID003) no sistema de Produção para que quando o upgrade correr nesse sistema corra estas instruções.
Depois do upgrade correr no sistema de Produção, fazer as mesmas verificações IG011/IG020 e:
select distinct oggetto,metodo metodo from W0030 (para perceber se ainda existem na W0030 situações por resolver – código antigo vs código novo).