1) Quando o pacote a ser aplicado contiver apenas um arquivo de atualização do dicionário de dados - sdfbra, vá direto para a execução do UPDDISTR.Proceder com a atualização padrão do Protheus, mais detalhes no Atualizador de dicionário e base de dados - UPDDISTR 2) Quando o pacote a ser aplicado contiver dois arquivos de atualização do Dicionário de dados - sdfbra parte 1 e parte 2 - siga os procedimentos abaixo.Utilizar UPDTAF a partir da Release 12.1.7 e superiores. Para Releases inferiores a 12.1.7, utilizar somente UPDDISTR Na atualização do dicionário de dados do TAF deve ser utilizada a rotina UPDTAF, conforme demonstrado abaixo: 
Após executar a aplicação o sistema fará uma varredura no ambiente e, se necessário, antes de fornecer as opções disponíveis de atualização, deverão ser adotados procedimentos de atualização de dicionário de dados utilizando o UPDDISTR, conforme demonstrado abaixo: 
O UPDDISTR é a ferramenta padrão de compatibilização da TOTVS (entenda mais em Atualizador de dicionário e base de dados - UPDDISTR.) e a carga de informações básicas do sistema são realizadas através desta aplicação. | Aviso |
|---|
O procedimento abaixo deve ser feito para cada arquivo diferencial de dicionário disponibilizado no pacote do TAF.Ou seja, é possível que em determinados pacotes o procedimento de atualização do dicionário de dados deva ser executado mais de uma vez. Como saber se devo executa mais de uma vez? O pacote será dividido em "partes". A atualização deverá ser realizada impreterivelmente na ordem das "partes" disponíveis. Exemplo: 
Neste caso deve-se aplicar o procedimento de atualização com os arquivos da parte 1, em seguida aplicar o mesmo procedimento com os arquivos da parte 2. |
ATENÇÃO: É obrigatória a execução e verificação dos logs do UPDDISTR, procedimentos efetuados de forma incorreta podem comprometer o funcionamento do produto. Os procedimentos que devem ser adotados são: • Realizar cópia dos seguintes arquivos para a pasta Systemload: - sdfbra.txt: arquivo que possui o dicionário de dados completo do TAF.
- hlpdfpor/hlpdfeng/hlpdfspa.txt: arquivos que possuem o help de campos completo do TAF.
- sx2.unq: arquivo que valida duplicidade de registros no ambiente ( pode ser solicitado ou não ).
| Nota |
|---|
I. Verifique se o arquivo de trava do UPDDISTR ( mpupddistri.tsk ) está na pasta appserver. Caso esteja, precisa ser excluído para que o atualizador seja executado corretamente. II. Verifique se os arquivos de dicionário de todos os grupos de empresas existem na pasta \system ( ou correspondente ). |
Perguntas Frequentes sobre o UPDDISTR: - Por que devo executar o compatibilizador UPDDISTR?
O UPDDISTR é responsável por criar todo o dicionário de dados do TAF, incluindo tabelas, campos, gatilhos, etc.
- Devo executar o compatibilizador UPDDISTR em todo pacote do TAF que é disponibilizado?
Não. O UPDDISTR deve ser executado apenas uma vez a cada release.
- Como saber se ainda devo executar o UPDDISTR para poder acessar o TAF?
Na inicialização de algumas rotinas do TAF será exibido um alerta exigindo a execução do compatibilizador:
Exemplo de mensagem apresentada em novas rotinas:
"Inconsistência: O ambiente do TAF está com o dicionário de dados incompatível com a versão dos fontes existentes no repositório de dados, este problema ocorre devido a não execução dos compatibilizadores do produto. Será necessário executar o UPDDISTR com o último arquivo diferencial ( SDFBRA ) disponível no portal do cliente. Siga as instruções do link abaixo para realizar a atualização: http://tdn.totvs.com.br/pages/releaseview.action?pageId=198935223 Após seguir os passos acima o acesso ao TAF será liberado!"  
Exemplo de mensagem apresentada em rotinas já existentes que possuem criação de novos componentes:
"O sistema identificou a ausência de componentes neste ambiente que influenciam no resultado final do processo. Para mais informações sobre a atualização de ambiente acesse: http://tdn.totvs.com.br/pages/releaseview.action?pageId=198935223 Campos: C1H_RAMO(Cadastro de Participantes)" 
- Apliquei o UPDDISTR e está com as seguintes ocorrências de erros ( critical error ):
- O campo da chave de índice não existe no SX3 da empresa.
- Índice duplicado.
Como proceder?
Entre em contato com o suporte para entendimento das inconsistências do ambiente.
|
• Ao clicar em 'Continuar' você será automaticamente direcionado a rotina de atualização do UPDDISTR:
• Será solicitado a seleção dos Grupos de Empresa que devem ser atualizados:  Image Modified
• Nas telas iniciais serão exibidas as informações de ambiente e o propósito do compatibilizador, selecione o botão “Avançar”:  Image Modified
 Image Modified
 Image Modified
 Image Modified
 Image Modified
• Após o processamento do compatibilizador o dicionário do TAF estará atualizado:  Image Modified
 Image Modified
• Para verificar se houve alguma inconsistência durante a atualização do dicionário de dados, clique em "Consulta LOG":  Image Modified
• Então clique em "Filtrar" e selecione o campo "Tipo do evento" como "Critical Error".  Image Modified
 Image Modified
• Caso o filtro retorne algum evento de "Critical Error", significa que foram encontrados problema na base de dados e nenhuma atualização foi efetivada no ambiente. Neste caso o UPDDISTR não tem autonomia para corrigir e os ajustes devem ser realizados pelo Administrador do Sistema.  Image Modified
• Para maiores detalhes de utilização da ferramenta UPDDISTR acesse Atualizador de dicionário e base de dados - UPDDISTR. | Dica |
|---|
| Neste momento, ao concluir a execução desta atualização, deve ser avaliado a necessidade de nova execução do UPDTAF, conforme informado no início do tópico III. Atualizar o Dicionário de Dados ( UPDTAF ) |
VIII. Segunda etapa de atualização de dicionário de dados • Após finalizar a execução dos pacotes atualizados pelo UPDDISTR, deve-se executar novamente o UPDTAF para realizar demais ajustes de ambiente:
• Quando a varredura do sistema identificar que não há necessidade de execução do UPDDISTR, será apresentada uma lista de ajustes que devem ser realizados no ambiente, conforme demonstrado abaixo: 
• Selecione as atualizações, por release, que devem ser realizadas. | Informações |
|---|
| A coluna 'Status' informa quais atualizações ainda são necessárias. Caso todas estejam com o Status "Executado", este procedimento pode ser ignorado. |
• Após realizar a seleção, clique em 'Processar' e aguarde o término da execução. • No final do processamento serão apresentadas os ajustes realizados no ambiente, conforme demonstrado abaixo: 
| 