Histórico da Página

A tabela abaixo descreve quais as regras para atualização dos campos das colunas do dicionário de dados SX3 (dicionário de campos), quando executada atualização via ferramenta Upddistr UPDDISTR ou migrador de versão.

O objetivo destas regras é efetuar as atualizações de dicionários e ao mesmo tempo respeitar as personalizações efetuadas por nossos clientes utilizando ferramentas como por exemplo o configurador.

As regras são válidas apenas para alteração de campos existentes no SX3. Campos novos são gravados integralmente.

Como regra geral, podemos dizer que características que o cliente pode modificar não podem ser sobrepostas. Existem exceções, que estão detalhadas abaixo.

Dicionário destino: dicionário do "cliente"

Novo dicionário: dicionário do pacote de atualização ou da nova versão. (SXSBRA ou SDFBRA)

SXSppp.TXT ou SDFppp,TXT onde ppp refere-se à sigla da localização)

Obs.: maiores informações sobre Dicionário de Referência, que será mencionado na tabela abaixo: https://tdn.totvs.com/pages/viewpage.action?pageId=359475013

Coluna	Descrição	Regra padrão	Regra com dicionário de referência processado	Regra para pacotes gerados pelo Gestão de Ambientes
X3_GRPSXG	Grupo de campos	Sempre atualiza

CampoDescrição Regra


X3_AGRUP	Agrupamento	Atualiza caso destino vazio ou código destino TOTVS (

primeiro dígito

primeiro dígito do código numérico)

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_CBOX

Combobox

Atualiza se o valor do

novo dicionário

novo dicionário NÃO estiver vazio. Ou seja, não

"limpa" valores já cadastrados

remove (deixa em branco) valores já cadastrados.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

Sempre atualiza, mesmo que em branco.

X3_CBOXENG

Combobox Inglês

Atualiza se o valor do

novo dicionário

novo dicionário NÃO estiver vazio. Ou seja, não

"limpa" valores já cadastrados

remove (deixa em branco) valores já cadastrados.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

Sempre atualiza, mesmo que em branco.

X3_CBOXSPA

Combobox espanhol

Atualiza se o valor do

novo dicionário

novo dicionário NÃO estiver vazio. Ou seja, não

"limpa" valores já cadastrados

remove (deixa em branco) valores já cadastrados.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

Sempre atualiza, mesmo que em branco.

X3_DECIMAL

Decimais

Atualiza se:

-Se diferente

Caso diferente de numérico grava sempre

0

0

-

NÃO permite alterar o tamanho pelo configurador

Atualiza se:

Permite alterar o tamanho pelo Configurador

Se o tipo for diferente de numérico grava sempre 0

X3_F3

Consulta padrão

Atualiza se o valor do novo

dicionário NÃO estiver vazio. Ou seja, não

"limpa" valores já cadastrados

remove (deixa em branco) valores já cadastrados. Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_FOLDER	Pasta	Sempre atualiza A partir do pacote de LIB liberado em 07/04/2016 a regra passará a ser: Atualização completa (MP710TO120 ou MP710TO110) - Sempre atualiza Atualização parcial/release (UPDDISTR) - Atualiza caso o conteúdo do dicionário destino esteja vazio	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_IDXSRV	Index Server	Sempre atualiza
X3_IDXFLD	Indica se é utilizado no Protheus Search	Não atualiza		Sempre atualiza, mesmo que em branco.
X3_INIBRW	Inicializador do browse	Atualiza se o valor do novo

dicionário NÃO estiver vazio. Ou seja, não

"limpa" valores já cadastrados

remove (deixa em branco) valores já cadastrados

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo será mantido.

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_NIVEL

Nível do campo

Nunca

Não atualiza. Campo exclusivo do

cliente

cliente*		Sempre atualiza, mesmo que em branco.
X3_NOME	Nome do campo

Nunca

Não atualiza*
X3_ORDEM	Ordem do campo

Nunca atualiza

O padrão do campo ordem é não ser atualizado. Isso significa que não será aplicado o valor do novo dicionário. No entanto, para evitar lacunas nas ordens de campo, ao final do processo de atualização o dicionário SX3 das tabelas que sofreram alteração será reordenado baseado no campo X3_ORDEM. Ou seja, o campo X3_ORDEM pode ser modificado, mas a ordem relativa entre os campos não.

Existem exceções, onde o campo X3_ORDEM será sobreposto baseado no valor do novo dicionário

Caso o campo do dicionário destino esteja com propriedade 'U' (usuário) mas estiver sendo atualizado pelo migrador (ou seja, na realidade é um campo padrão TOTVS)
Caso o tipo do campo tenha sido alterado entre o dicionário novo e dicionário destino
Caso o contexto do campo tenha sido alterado entre o dicionário novo e dicionário destino (o campo era virtual e passou a real e vice-versa)

Sempre atualiza, mesmo que em branco.

X3_ORTOGRA

Corretor ortográfico

Sempre atualiza

X3_PICTURE

Máscara de edição

Atualiza caso o tamanho ou decimais tenham sido atualizados

Atualiza caso:

O tamanho ou decimais tenham sido atualizados em campos de tipo numérico

ou

Caso o dicionário destino não permita a alteração de tamanho em qualquer tipo de campo

X3_PICTVAR

Picture variável

Atualiza se o valor do

novo dicionário

novo dicionário NÃO estiver vazio. Ou seja, não remove (deixa em branco) valores já cadastrados.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_PICBRV

Picture de browse

Atualiza se o valor do novo dicionário NÃO estiver vazio. Ou seja, não

"limpa" valores já cadastrados

remove (deixa em branco) valores já cadastrados.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_PROPRI

Propriedade

Sempre atualiza.

X3_PYME

Existe no

série

Série 3	Sempre atualiza
X3_RELACAO	Inicializador padrão	Atualiza se o valor

no dicionário

no dicionário destino estiver vazio. Ou seja, não sobrepõe valores já

cadastrados

OU

Atualiza se a nova opção "Sobrepõe inicializador" do migrador MP710TO120 estiver marcada.

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_RESERV

Reserva (controles de acesso)

Sempre atualiza, exceto campo B1_DESC

X3_TAMANHO

Tamanho do campo

Atualiza se:

-

Houver grupo de campos vinculado (SXG) ou

-

NÃO permite alterar o tamanho pelo configurador ou

-permite

Permite alterar o tamanho pelo

configurador

Configurador mas a nova opção

"aumentar tamanho"

“Forçar tamanho do campo” esteja marcada e o novo tamanho seja MAIOR que o antigo

Se possuir grupo de campos (SXG) vinculado, será respeitado o tamanho definido pelo grupo do dicionário destino. Essa regra se sobrepõe a qualquer outra.

Atualiza se:

Houver grupo de campos vinculado (SXG) ou

Permite alterar o

antigo

tamanho pelo Configurador Se possuir grupo de campos (SXG) vinculado, será respeitado o tamanho definido pelo grupo do dicionário destino. Essa regra se sobrepõe a qualquer outra.
X3_TELA	Tela	Sempre atualiza
X3_TIPO	Tipo de campo	Sempre atualiza
X3_TITENG

Titulo

Título em Inglês

Sempre atualiza

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_TITSPA

Titulo

Título em espanhol

Sempre atualiza

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_TITULO

Titulo

Título

Não atualiza*

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

Sempre atualiza

X3_TRIGGER

indica

Indica uso de gatilho

Atualiza caso o novo valor seja "S", ou seja, não

limpa gatilho que já é

disparado X3_USO

disparado.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

X3_USADO

Usado.

Indica se o campo:

É usado nos módulos
Se é chave
Se é alterável

Usado

Atualiza se:

-

Não permitir alteração de uso no destino

-Se permitir

(se o cliente não pode alterar, o programa atualizador pode sobrepor) Se permitir a alteração e todos os módulos estiverem em uso, coloca automaticamente os novos módulos em uso
X3_VLDUSER

validação

Validação do usuário

Atualiza se o valor no

dicionário destino estiver vazio. Ou seja, não sobrepõe valores já

cadastrados

cadastrados. Nota: apesar deste campo ser destinado ao usuário, sugestões de uso poderão ser gravadas pelo atualizador, apenas caso a coluna do dicionário destino não possua conteúdo.

Se o valor foi alterado pelo cliente, não atualiza.
Se o valor não foi alterado pelo cliente, atualiza.

Obs.: A regra vale para qualquer novo valor, mesmo que em branco.

Sempre atualiza, mesmo que em branco.

X3_WHEN

When

Atualiza se o valor do

novo dicionário

novo dicionário NÃO estiver vazio. Ou seja, não remove (deixa em branco) valores já cadastrados.

Em resumo: se o dicionário padrão TOTVS possuir conteúdo, será sobreposto. Se o dicionário padrão TOTVS possuir conteúdo em branco, o conteúdo do destino será mantido.

Se o valor foi alterado pelo cliente, não

"limpa" valores já cadastrados

atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_POSLGT	Flag para exportação ferramenta "TOTVS PDV"	Sempre atualiza
X3_MODAL	Indica se é usado em janelas estilo "modal"	Sempre atualiza
X3_BROWSE	Exibido no browse	Não atualiza*	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_VALID	Validação do sistema	Sempre atualiza
X3_VISUAL	Indica se o campo é apenas para visualização	Não atualiza*	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_DESCRIC	Descrição do campo	Não atualiza*	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_DESCSPA	Descrição do campo em espanhol	Sempre atualiza	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_DESCENG	Descrição do campo em inglês	Sempre atualiza	Se o valor foi alterado pelo cliente, não atualiza. Se o valor não foi alterado pelo cliente, atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco.	Sempre atualiza, mesmo que em branco.
X3_OBRIGAT	Indica campo obrigatório alterável via Configurador	Não atualiza*		Sempre atualiza, mesmo que em branco.
X3_CONTEXT	Contexto do campo (real ou virtual)	Uma mudança de contexto (real para virtual ou vice-versa) força que a maior parte das colunas do SX3 seja sobreposta (ver observação abaixo). Logo, a mudança de contexto sempre é aplicada, É importante salientar que o conteúdo em branco é o mesmo que conteúdo "R" (real). Nesse caso a alteração não é classificada como mudança de contexto.

Aviso

*Em determinadas situações, descritas abaixo, as colunas que normalmente não são atualizados serão sobrepostas. Isso é devido a ter ocorrido uma alteração dramática na característica do campo.

Caso o campo do dicionário destino esteja com propriedade 'U' ( usuário ) mas estiver sendo atualizado pelo migrador ( ou seja, na realidade é um campo padrão TOTVS )
Caso o tipo do campo tenha sido alterado entre o dicionário novo e dicionário destino
Caso o contexto do campo tenha sido alterado entre o dicionário novo e dicionário destino ( o campo era virtual e passou a real e vice-versa )

Aviso

A partir da LIB a ser liberada em 07/08/2017 para a versão 12, algumas colunas serão preservadas mesmo no caso de alterações dramáticas de características de campos. São elas: X3_ORDEM (ordem), X3_NIVEL (nível), X3_FOLDER (pasta) e X3_AGRUP (agrupador). Foi considerado que a manutenção do conteúdo destas colunas possui pouco risco e as mesmas são bastante usadas em personalizações e customizações.

Essa implementação é válida apenas para o UPDDISTR (Migração de Release). A Migração de Versão com o MP710TO120 não segue esse novo comportamento.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave