Um dicionário de dados diferencial é um dicionário parcial que é utilizado para atualizar o dicionário de dados (metadado) do Protheus em uso.
O dicionário de dados diferencial pode ser utilizado para diversos fins, a saber:
Para aplicar o dicionário de dados diferencial, utilizamos uma ferramenta especial chamada UPDDISTR. O UPDDISTR atualiza o dicionário de dados do Protheus usando as mesmas regras e funcionalidades do atualizador de versão do Protheus.
De fato, o "core" (núcleo) do UPDDISTR e o do atualizador de versão são exatamente iguais, garantindo que não haja disparidade de regras entre as duas ferramentas. A maior diferença reside no fato do UPDDISTR poder utilizar um dicionário parcial, enquanto o atualizador de versão sempre exigir um dicionário completo.
Além do dicionário de dados, as alterações na base de dados decorrentes do novo dicionário (como por exemplo tamanho de campos) também são efetuadas, da mesma maneira que no atualizador de versão padrão.
É importante salientar que a ferramenta UPDDISTR apenas atualiza o dicionário de dados (metadado), os helps de campo e a base de dados. As alterações no repositório do sistema (sejam elas substituição do repositório, aplicação de "patchs", "updates" e pacotes) e atualizações de menus devem continuar sendo efetuadas conforme instruído em cada processo específico.
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) de Lib, contendo os fontes abaixo cuja data seja igual ou superior às datas informadas.
Recomendamos fortemente que:
Estas recomendações tornam-se obrigatórias no caso de sistemas de missão crítica, quando a operação da empresa depende totalmente ou quase que totalmente do sistema Protheus.
Para utilizar este procedimento é preciso dispor de um dicionário diferencial.
O dicionário diferencial é um arquivo texto que possui o seguinte formato:
Dessa forma, um dicionário diferencial para o Brasil deve possuir o nome SDFBRA.TXT. Um dicionário diferencial para a Argentina deve possuir o nome SDFARG.TXT.
Cada processo de atualização (atualização do Protheus, novo módulo, nova legislação) vai disponibilizar um arquivo com conteúdo diferente.
Ao mesmo tempo, poderá ser disponibilizado um arquivo diferencial de helps de campo e alertas, com o seguinte formato:
Dessa forma, um help de campo para o idioma português deve possuir o nome HLPDFPOR.TXT. Diferentemente do arquivo de dicionário, no Help a diferenciação por país encontra-se no próprio arquivo (interna).
O(s) arquivo(s) de atualização deve(m) ser posicionado(s) na pasta de carga "\systemload" (pasta criada a partir da pasta "root" (raiz) do Protheus).
Solicitamos que ao executar uma dada atualização pela primeira vez seja excluído (se existir) o arquivo mpupddistri.tsk do diretório APPSERVER da instalação do Protheus em uso. Este arquivo apenas é necessário caso o processo tenha sido interrompido antes de sua conclusão, e guarda quais tarefas foram concluídas e quais ainda estão pendentes.
Para atualizar, efetuar a chamada do programa de atualização UPDDISTR, na tela inicial do Protheus, ou seja, digitar UPDDISTR como se fosse o nome de um módulo do Protheus (os demais dados da janela, como conexão e ambiente, são apenas exemplos).
Após a chamada, será exibido um assistente de atualização. A primeira janela faz uma breve explicação da funcionalidade.
Deve-se avançar para a segunda janela.
Na segunda janela deve-se informar:
Deve-se avançar para a terceira janela.
Na terceira janela deve-se informar:
O diretório de dados (X2_PATH) para cada grupo de empresas para as novas tabelas a serem inseridas pela atualização. No caso de bases de dados SQL (Top Connect) não é necessário informar o diretório.
Deve-se avançar para a quarta janela.
Na quarta janela são definidas informações quanto ao LOG de processamento.
Ao confirmar, será exibida uma janela confirmando quais grupos de empresas serão processados e quais operações serão executadas.
Em seguida será efetuada uma análise da base de dados existente. A análise verificará diversos fatores, como por exemplo a consistência da base de dados em relação ao dicionário existente. Se forem encontrados problemas, os mesmos deverão ser corrigidos antes que a atualização possa prosseguir.
Deve-se notar que nesta fase é analisado apenas o conteúdo da base de dados e do dicionário já existente. Nesse momento não é efetuada nenhuma consulta ao dicionário de dados diferencial que se pretende aplicar.
Caso não existam erros ou os mesmos já tenham sido corrigidos a atualização iniciará logo após o processo de verificação.
Deve-se aguardar o final da atualização e encerrar.
Sistemas Operacionais | Windows/Linux |
Status do documento | Concluído |
---|---|
Data | 13/01/2015 |
Versão | 1.0 |
Versão anterior | 1.0 |
Autores |