08/11/2016 Atualizador de dicionrio e base de dados - UPDDISTR - Frameworksp - TDN

Frameworksp / / Artigos

Atualizador de dicionrio e base de dados - UPDDISTR

Created by Sergio Luis de Alcantara Silveira, last modified on 02 mar, 2016

Concludo
Um dicionrio de dados diferencial um dicionrio parcial que utilizado para atualizar o
dicionrio de dados (metadado) do Protheus em uso.
O dicionrio de dados diferencial pode ser utilizado para diversos fins, a saber:
13/01/2015
Atualizar o dicionrio de dados do Protheus para uma verso atualizada dentro de um
mesmo release. 1.0
Inserir o dicionrio de um novo produto, mdulo ou funcionalidade.
Efetuar atualizaes pontuais devido a um novo requisito legal. 1.0

Para aplicar o dicionrio de dados diferencial, utilizamos uma ferramenta especial chamada @ Sergio Luis de Al
UPDDISTR. O UPDDISTR atualiza o dicionrio de dados do Protheus usando as mesmas
regras e funcionalidades do atualizador de verso do Protheus.
De fato, o "core" (ncleo) do UPDDISTR e o do atualizador de verso so exatamente iguais,
garantindo que no haja disparidade de regras entre as duas ferramentas. A maior diferena
reside no fato do UPDDISTR poder utilizar um dicionrio parcial, enquanto o atualizador de
verso sempre exigir um dicionrio completo.
Alm do dicionrio de dados, as alteraes na base de dados decorrentes do novo dicionrio
(como por exemplo tamanho de campos) tambm so efetuadas, da mesma maneira que no
atualizador de verso padro.

Procedimento para Implementao

O sistema atualizado logo aps a aplicao do pacote de atualizaes ( ) de Lib,
contendo os fontes abaixo cuja data seja igual ou superior s datas informadas.
UPDDISTR.PRW 01/07/2013
APUPD030.PRW 16/10/2013
APUPDATE.PRW 18/09/2013

Procedimentos para Utilizao

Recomendamos fortemente que:
Qualquer processo que envolva atualizao do dicionrio e base de dados do sistema
seja efetuado inicialmente em ambiente de homologao e que os processos mais
importantes para a operao da empresa sejam validados.

Seja efetuada uma CPIA FRIA (todos os servios parados) e CONSISTENTE (das
pastas adequadas e banco de dados) da base de produo antes da aplicao dessa
atualizao.

Seja efetuada uma CPIA FRIA (todos os servios parados) e CONSISTENTE das
pastas de dicionrio de dados ("startpath" - pasta "system" e similares) antes da
aplicao da atualizao.

Estas recomendaes tornam-se obrigatrias no caso de sistemas de misso crtica, quando

a operao da empresa depende totalmente ou quase que totalmente do sistema Protheus.

Para utilizar este procedimento preciso dispor de um dicionrio diferencial.

O dicionrio diferencial um arquivo texto que possui o seguinte formato:

http://tdn.totvs.com/pages/viewpage.action?pageId=181965468 1/4
08/11/2016 Atualizador de dicionrio e base de dados - UPDDISTR - Frameworksp - TDN
SDFppp.txt, onde ppp o cdigo do pas (localizao).

Dessa forma, um dicionrio diferencial para o Brasil deve possuir o nome SDFBRA.TXT. Um
dicionrio diferencial para a Argentina deve possuir o nome SDFARG.TXT.
Cada processo de atualizao (atualizao do Protheus, novo mdulo, nova legislao) vai
disponibilizar um arquivo com contedo diferente.
Ao mesmo tempo, poder ser disponibilizado um arquivo diferencial de helps de campo e
alertas, com o seguinte formato:
HLPDFiii.TXT, onde iii o cdigo do idioma.

Dessa forma, um help de campo para o idioma portugus deve possuir o nome
HLPDFPOR.TXT. Diferentemente do arquivo de dicionrio, no Help a diferenciao por pas
encontra-se no prprio arquivo (interna).
O(s) arquivo(s) de atualizao deve(m) ser posicionado(s) na pasta de carga "\systemload"
(pasta criada a partir da pasta "root" (raiz) do Protheus).

Este arquivo apenas necessrio caso o processo tenha sido interrompido antes de sua
concluso, e guarda quais tarefas foram concludas e quais ainda esto pendentes.
Para atualizar, efetuar a chamada do programa de atualizao UPDDISTR, na tela inicial do
Protheus, ou seja, digitar UPDDISTR como se fosse o nome de um mdulo do Protheus (os
demais dados da janela, como conexo e ambiente, so apenas exemplos).

A partir do pacote de LIB disponibilizado em 07/04/2016 ser possvel escolher quais grupos
de empresas sero considerados na atualizao. Ser exibida uma janela onde possvel
marcar os grupos de empresas desejados. Por padro, todos os grupos j vem selecionados.
Se desejar utilizar todos os grupos, basta clicar no boto OK.

Caso uma dada migrao seja reiniciada, deve-se escolher exatamente os mesmos
grupos de empresas para retomar o processo

http://tdn.totvs.com/pages/viewpage.action?pageId=181965468 2/4
08/11/2016 Atualizador de dicionrio e base de dados - UPDDISTR - Frameworksp - TDN

Algumas tabelas no possuem grupo de empresas em seu nome, logo essa

configurao no ter efeito sobre elas. Os arquivos de help, por exemplo, so
compartilhados por todos os grupos de empresas de dado STARTPATH. Dessa
forma, o arquivo compartilhado ser atualizado.

Aps a chamada, ser exibido um assistente de atualizao. A primeira janela faz uma breve
explicao da funcionalidade.
Deve-se avanar para a segunda janela.
Na segunda janela deve-se informar:

O usurio e senha do administrador do Protheus.

Se uma simulao.
Se o dicionrio de ndices exclusivo por grupo de empresas (SIX) ou se utilizado o
dicionrio SINDEX.

http://tdn.totvs.com/pages/viewpage.action?pageId=181965468 3/4
08/11/2016 Atualizador de dicionrio e base de dados - UPDDISTR - Frameworksp - TDN
Deve-se avanar para a terceira janela.
Na terceira janela deve-se informar:
O diretrio de dados (X2_PATH) para cada grupo de empresas para as novas tabelas a serem
inseridas pela atualizao. No caso de bases de dados SQL (Top Connect) no necessrio
informar o diretrio.
Deve-se avanar para a quarta janela.
Na quarta janela so definidas informaes quanto ao LOG de processamento.
Quanto configurao de LOG, sugerimos manter as opes padro.

Quanto ao arquivo de LOG, sugerimos desmarcar as opes "Corrigir os erros

automaticamente" e "Manter o arquivo de LOG existente"

Ao confirmar, ser exibida uma janela confirmando quais grupos de empresas sero
processados e quais operaes sero executadas.
Em seguida ser efetuada uma anlise da base de dados existente. A anlise verificar
diversos fatores, como por exemplo a consistncia da base de dados em relao ao dicionrio
existente. Se forem encontrados problemas, os mesmos devero ser corrigidos antes que a
atualizao possa prosseguir.
Deve-se notar que nesta fase analisado apenas o contedo da base de dados e do dicionrio
j existente. Nesse momento no efetuada nenhuma consulta ao dicionrio de dados
diferencial que se pretende aplicar.
Caso no existam erros ou os mesmos j tenham sido corrigidos a atualizao iniciar logo
aps o processo de verificao.
Deve-se aguardar o final da atualizao e encerrar.

Informaes Tcnicas

Windows/Linux

10 people like this

2 Comentrios

Existe documentao para regras de atualizao da SX7?

Ol Evandro,
A documentao no estava publicada, acabei de colocar: Regras para atualizao do dicionrio SX7 - UPDDISTR e
migrador de verso
Abraos

http://tdn.totvs.com/pages/viewpage.action?pageId=181965468 4/4