...

• Atualizar o Dicionário de Dados do Protheus para uma versão atualizada dentro de um mesmo release.
• Inserir o dicionário de um novo produto, módulo ou funcionalidade.
• Efetuar atualizações pontuais devido a um novo requisito legal.

...

Foi incluído um bloqueio para impedir que o sistema retroceda para releases anteriores. Se existir no ambiente alguma empresa com Release posterior a que está sendo aplicada, a atualização não será permitida.

Exemplo: Migração para Release 23, mas existe empresa já na Release 27.

Image Removed

Preparando o ambiente

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.

...

Procedimento para Implementação

...

• UPDDISTR.PRW – 01/07/2013
• APUPD030.PRW – 16/10/2013
• APUPDATE.PRW – 18/09/2013

...

Procedimentos para Utilização

...

• Qualquer processo que envolva atualização do dicionário e base de dados do sistema seja efetuado inicialmente em ambiente de homologação e que os processos mais importantes para a operação da empresa sejam validados.

• Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE (das pastas adequadas e banco de dados) da base de produção antes da aplicação dessa atualização.

• Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE das pastas de dicionário de dados ("startpath" - pasta "system" e similares) antes da aplicação da atualização.

...

• SDFppp.txt, onde ppp é o código do país (localização).

...

• HLPDFiii.TXT, onde iii é o código do idioma.

...

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).

Image Removed

...

A partir do pacote de LIB disponibilizado em 07/04/2016 será possível escolher quais Grupos de Empresas serão considerados na atualização. Será exibida uma janela onde é possível marcar os Grupos de Empresas desejados. Por padrão, todos os grupos já vem selecionados. Se desejar utilizar todos os grupos, basta clicar no botão OK.

Image Removed

Após a chamada, será exibido um assistente de atualização. A primeira tela traz um informativo dos requisitos para iniciar a atualização. As telas seguintes possuem um Termo de Aceite, que deve ser lido com atenção e marcadas as devidas caixinhas de confirmação. Atente-se também em selecionar a localização correta (país) que será utilizada na atualização.

Image Removed

Após o Termo de Aceite confirmado, será aberta a janela de login para confirmação de autorização a executar o UPDDISTR. A autorização só é concedida para o usuário Administrador do Protheus, ou para usuários do Grupo Administradores¹ que possuam o acesso 194 habilitado. O usuário e senha serão validados ao clicar no botão Avançar.

¹ Grupo Administradores com acesso 194 permitido a partir da LIB versão 20210517

Também é possível nesta tela:

• Configurar se a execução será apenas uma Simulação, onde nenhuma alteração será efetivada na base
• Determinar se o dicionário de índices é exclusivo por grupo de empresas (SIX) ou se é utilizado o dicionário SINDEX

...

Image Removed

Clique em Avançar. Na próxima tela 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.

Image Removed

Avance novamente. Na tela de Configuração de execução do Update, deve-se marcar/desmarcar as configurações e arquivos de log que deseja utilizar durante o processo. Indicamos manter apenas as opções Log de Atualização,  Log de Critical Error e Corrigir erros automaticamente habilitadas, lembrando que a opção de corrigir os erros automaticamente executará as alterações de base pelo próprio sistema. NÃO marque a opção Manter o arquivo de log existente.

...

Ao avançar, 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. 

...

...