Integração de patchs
Os softwares utilizando a tecnologia SAFE X3 integram uma função permitindo de integrar os correctivos ou das evoluções funcionais entregues sob forma de ficheiros arquivo nomeados "patches". Está assim que um desenvolvimento terceiro pode ser integrado, que os dados suplementares podem estar carregados numa tabela, que corretivos podem ser contribuidos.
Um patch pode conter um ou vários elementos tais que ecrãs, definições das tabelas, códigos atividades, tipos de dados, objectos, menus locais, capítulos de mensagens, tratamentos, pedidos de execução de tratamentos, dados...
A integração de um patch modifica o dicionário e a base de dados dos dossiers sobre os quais foi aplicado. Uma única exceção a este princípio : os tratamentos entregues por patch não são instalados que o dossier supervisor (excepto casos particulares explicitados mais longe).
Caso particular : Integração de uma tabela
A integração de uma tabela se faz em duas etapas :
1. Atualização da descrição da tabela em SAFE X3.
2. Validação desta tabela (execução do valfil) : durante esta última etapa, se estatísticas Bdd (base de dados) existem sobre esta tabela, elas podem ser suprimidas.
Isto depende dos tipo de modificação da tabela.
Exemplos:
- Acréscimo de um campo em fim de descrição da tabela : as estatísticas bdd são conservadas.
- Inserção de um campo entre dois outros : as estatísticas bdd estão perdidas sobre toda a tabela.
Com efeito a tabela foi suprimida depois recriada.
Ficheiros
Um ficheiro patch se caracteriza por um nome integrando em princípio uma sequência de números, afim de permitir de controlar, quando vários ficheiros existem, que as patches são bem integradas na ordem.
O caso das patches corretivas entregues em standard foi gerado da maneira seguinte :
- Os ficheiros são definidos com o nome P_nnnn_vvv.dat, nnnn sendo um número cronológico, e vvv a versão maior sobre a qual o patch pode-se aplicar (justo ao presente, vvv pode ser igual a 110, 120, 130, 140, 150) Um ficheiro deste tipo contém um conjunto de objectos ou de elementos constituitivos de um correctivo ou de uma avaliação funcional (por exemplo, a entrega de um novo ponto de entrada).
- vários ficheiros de patches (em geral pelo menos uma dezena, mas podem ser mais) são organizados sob a forma de uma lista que está disponível junto dos parceiros de Sage.
- A colocação em lugar de uma ou várias listas se faz por função, que integra os ficheiros na ordem sequêncial dos números cronológicos, um certo número de controlos de coerência estando realizados (número de versão sobre a qual o patch se aplica, sequencialmente depois a última atualização de patches).
É aconselhado aos parceiros Sage desejando entregar as funcionalidades sob a forma de patches de adoptar a mesma política de nomeação dos ficheiros, em utilizando uma primeira letra diferente (por exemplo X, Y, ou Z). Com efeito, um controlo sequêncial está feito desde logo que o nome do ficheiro integra os caracteres _(underscore) em posição 2 e 7 do nome do ficheiro : os caracteres 3 a 6 são então um número sequêncial sobre o qual (a raíz igual) vai se fazer um controlo de sequencialidade e os carateres para além do oitavo (extenção excluida) são controlados por relação ao número de versão maior.
Pré-requisitos
Consulte a docuemntação de Implementação
Gestão do ecrã
Ecrã de registo
Apresentação
Regista-se, na janela que se abre, as informações relativas na integração de patch desejada, depois valida-se o ecrã.
A integração se faz então; ela pode ser longa se numerosos ficheiros patches estão presentes, mas uma barra de progressão permite seguir o processo de integração.
No fim de integração dos patches, obtem-se um ficheiro rasto que se situa fisicamente no directório do rasto do dossier de onde se está lançada a integração. Uma visualização atenta deste ficheiro está aconselhado para assinalar os erros eventuais.
Fechar
Campos
Os seguintes campos estão presentes neste separador :
Ficheiro
|
|
|
|
|
|
Bloco número 2
| Se este campo não está assinalado, a integração será simulada. Neste caso, a integração está restreada mas as transferência não são realizadas. |
| Esta check box é útil se integra as patches num ambiente estrangeiro. Se está assinalada, o ficheiro rasto do resultado da integração será em inglês |
| Cette option désactive la validation directe des fenêtres et des écrans pour optimiser la durée de validation de ces objets. Lorsque cette case est sélectionnée, les fenêtres et écrans sont validés à leur première utilisation. |
|
|
|
|
Quadro Dossiers
| Permite dar a lista dos Dossiers sobre a qual a integração das patches vai ser feita; por defeito o conjunto dos dossiers se encontrando no ambiente está proposto para a integração das patches, mas é possivel de suprimir a lista. Exceto casos particulares, é necessário que pelo menos o dossier supervisor seja colocado em patch. |
|
|
|
|
|
|
Fechar
Tarefa batch
Esta função pode ser lançada em batch. A tarefa standard PATCH está prevista p/esse efeito.
A integração das listas de patch pode se efectar em batch sobre 50 dossiers máximo.
Esta opção é muito interessante porque a integração das patches pode se efetuar na noite após a salvaguarda então que a exploração não foi retomada. Com efeito, a integração das patches pode estar uma operação longa. A consulta do ficheiro rasto poderá então se fazer directamente depois o gestor dos pedidos da tarefa batch.
Atenção, um patch standard já integrada ou que não está em sequência não poderá ser integrado em batch : o que não é que uma mensagem de advertência que pode ser forçada quando o patch está integrado directamente torna-se uma causa de paragem automática em caso de execução batch.
Patch de documentação
A instalação de um patch de documentação segundo o memo procedimemento que aquele explicado aqui e se aplica aos dossiers selecionados.
Os ficheiros são definidos com o nome Dy_nnnnn_vvv_ppp.dat, "y" sendo o abreviado do produto, "nnnnn" sendo o número cronológico, "wv" a versão maior sobre o qual o patch pode-se aplicar, e "ppp" o código legislação.
Existe um único ficheiro por legislação que contêm o conjunto das documentações criadas ou modificadas depois o patch precedente.
Os patchs de documentações são entregues ao mesmo tempo que as patches aplicativas. Podem ser integrados antes ou após o patch aplicativo. O sistema verifica a cronologia dos números.
A integração de um patch de documentação atualiza o dicionário dos documentos mas não toca aos documentos colocados sobre o servidor de documentação. Para que estes últimos sejam atualizados, falta lançar uma geração da documentação.
Geração da documentação.
Se utiliza o modo de acesso ao formato compreendido (CHM), você deve antes de lançar a actualização dos documentos automatizados, executar uma descompressão do seu ficheiro de documentação (cf servidor documentação).
Se utiliza o modo de acesso ao formato separado (HTML), você pode diretamente lançar a actualização.
Atualização dos documentos automáticos
Na função de documentação, clicar sobre o botão Geração e registar os dados seguintes segundo o seu código língua :
N.B : o directório está emitido do parâmetro utilizador DIRDOC.
Relançar em seguida 3 outros géneros com os memos parâmetros excepto o tipo de dados ou você indica sucessivamente AML depois ATB depois ATY.
Geração dos documentos sobre o servidor de documentação
Para fazer a actualização das documentações sobre o servidor de documentação, lançar a geração seguinte, segundo o código língua :
Se utiliza o acesso à documentação em modo comprimido, você deve recompressar os ficheiros (cf servidor de documentação).
Se utilizar o acesso em modo separado, a atualização está terminada.
Mensagens de erro
Mensagens de erro ao lançamento da função
Para além das mensagens genéricas, as seguintes mensagens de erro podem aparecer durante o reg. :
Sem patch no directório
Indicou-se um diretório vazio.
Mensagens de erro no rasto
As outras mensagens de erro são todas afixadas no ficheiro rasto. Por entre este, encontramos as mensagens seguintes :
O dossier deve ser ao menos na versão nnn
O patch não pode ser aplicado, porque a versão mínima requere os dossiers não está respeitado.
xxxxx : módulo não implantado no dossier
O patch não foi aplicado sobre o dossier, porque o módulo funcional não está utilizado.
Fim de ficheiro anormal
Estrutura ficheiro incorrecto
O ficheiro de patch está provavelmente corrompido, o processo de integração não pode reler até ao máximo os dados correspondentes, onde está tomado sobre uma estrutura não conforme.
Gestão de ficheiro XXX : <<mensagem de error>>
Um erro de tipo transacional está produzido durante a atualização do dicionário
Erro em linha NNN: <<mensagem de error>>
Um erro se produz na execução de um tratamento acompanhando a patch
Patch mais recente integrada
Falta as patches, a última integrada está ###
Patch normalmente incluida na versão NNN
Estas três mensagens afetando a verificação de sequêncialidade de passagem de patches. Normalmente, se o patch standard número N é o último a ter passado, espera-se a não passar um pach mais antigo (mensagem número 1), nem de patch de número estritamente superior a N+1 (mensagem número 2). Por outro lado, a instalação de uma versão intermédia incluida de facto das patches standard que não falta integrar (mensagem número 3). Em todo o estado de causa, em modo interativo, estas mensagens não são bloqueantes, e é possível de continuar mesmo, em respondendo Sim à questão Pretende continuar apesar os erros?.