Este recurso está disponível a partir do release 12.1.2310, e LIB versão 20240226.


As Preferências de Atualização permitem modificar algumas regras de atualização dos pacotes gerados pelo recurso Gestão de Ambientes. O recurso é especialmente útil para não sobrepor modificações já efetuadas pelo cliente final no ambiente destino do pacote.

Foram criadas preferências de atualização específicas para colunas do Dicionário de Campos (SX3) e gerais para o Dicionário de Tabelas (SX2).

Por exemplo: o campo Validação de Usuário pode ser modificado através do Configurador para inserir validações específicas do cliente, mesmo em campos padrões da TOTVS. O comportamento padrão do pacote gerado pelo Gestão de Ambientes é sobrepor o conteúdo do inicializador padrão, pois trata-se de uma atualização efetuada internamente.

Já no caso de um pacote com característica de template, pode ser desejável não sobrepor uma validação de usuário. Nesse caso, pode-se configurar essa propriedade para comportar-se de forma semelhante a um pacote gerado pela própria TOTVS, ou seja, nunca sobrepor o conteúdo da validação de usuário.


O campo Tamanho pode exemplificar outra necessidade: um template pode ser expedido com um campo que permita ao cliente alterar o tamanho. O cliente pode então aumentar o tamanho do campo. Numa atualização subsequente do mesmo template, o que é normalmente desejado é que o tamanho modificado pelo cliente seja mantido.

Numa atualização padrão do pacote do recurso Gestão de Ambientes, o tamanho seria sobreposto, mesmo que reduzido. Nesse caso, também é possível selecionar uma configuração semelhante ao pacote gerado pela TOTVS, onde o tamanho no ambiente destino não seria sobreposto, caso seja permitida a alteração no destino via Configurador.


Para configurar as Preferências de Atualização, deve-se selecionar um projeto e clicar na opção Detalhes do Projeto. No menu Outras Ações, selecionar a opção Preferências para atualização. Será exibida uma janela com as preferências para as colunas do dicionário SX3 e preferências gerais do dicionário SX2.


Pode-se alterar a configuração para item clicando no combo. Ao posicionar no item, será exibida uma breve explicação do comportamento no espaço Descrição da opção.


Se clicar em Confirmar, as configurações de preferências serão armazenadas no projeto e podem ser modificadas posteriormente.

Ao gerar um Pacote ou Arquivo Diferencial do Projeto, as preferências serão levadas juntamente com os artefatos de migração e serão consideradas durante o processo de atualização (UPDDISTR).

O Manifesto de Atualização, um arquivo texto explicativo criado no momento da geração de um Pacote ou Arquivo Diferencial (manifest_update.txt), também incluirá informações sobre as preferências utilizadas. Apenas as preferências informadas como Projeto do tipo template serão listadas, pois são as exceções ao processo habitual de atualização.


A incorporação de projetos transporta apenas os artefatos de dicionários e menus de um projeto para outro. Configurações como Controle de Acessos e Preferências para Atualização não são transportadas.