Páginas filhas
  • Regras para atualização do dicionário SX3 - UPDDISTR e migrador de versão.

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

A tabela abaixo descreve quais as regras para atualização das colunas do dicionário de dados SX3 (dicionário de campos), quando executada atualização via ferramenta 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. (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


ColunaDescrição 

...

Regra padrãoRegra com dicionário de referência processadoRegra para pacotes gerados pelo Gestão de Ambientes
X3_GRPSXGGrupo de campos Sempre atualiza

X3_AGRUP Agrupamento Atualiza caso destino vazio ou código destino TOTVS (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_CBOXCombobox 

Atualiza se o valor do 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.  

  


Sempre atualiza, mesmo que em branco.
X3_CBOXENGCombobox Inglês

Atualiza se o valor do 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.  

  


Sempre atualiza, mesmo que em branco.
X3_CBOXSPACombobox espanhol

Atualiza se o valor do 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.  



Sempre atualiza, mesmo que em branco.
X3_DECIMAL Decimais 

Atualiza se: 

  • Caso diferente de numérico grava sempre 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_F3Consulta padrão 

Atualiza se o valor do 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_FOLDERPasta 

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_IDXSRVIndex Server Sempre atualiza

X3_IDXFLDIndica se é utilizado no Protheus SearchNão atualiza
Sempre atualiza, mesmo que em branco.
X3_INIBRWInicializador do browse

Atualiza se o valor do 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 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 Não atualiza. Campo exclusivo do cliente*
Sempre atualiza, mesmo que em branco.
X3_NOME Nome do campo Não atualiza*

X3_ORDEMOrdem do campo 

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_ORTOGRACorretor ortográficoSempre atualiza

X3_PICTUREMáscara de edição 

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_PICTVARPicture variável

Atualiza se o valor do 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_PICBRVPicture de browse

Atualiza se o valor do 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_PROPRIPropriedade 

Sempre atualiza.



X3_PYMEExiste no

...

Série 3Sempre atualiza

X3_RELACAOInicializador padrão 

Atualiza se o valor 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_RESERVReserva (controles de acesso)Sempre atualiza, exceto campo B1_DESC

X3_TAMANHOTamanho do campo Atualiza se:
  • Houver grupo de campos vinculado (SXG) ou
  • NÃO permite alterar o tamanho pelo configurador ou
  • Permite alterar o tamanho pelo

...

  • Configurador mas a nova

...

  • opção “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 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_TELATelaSempre atualiza

X3_TIPO Tipo de campo Sempre atualiza

X3_TITENGTítulo em InglêsSempre 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 Título em espanholSempre 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_TITULOTí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.
X3_TRIGGERIndica uso de gatilho 

Atualiza caso o novo valor seja "S", ou seja, não limpa gatilho que já é

...

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
Atualiza se: 
  • Não permitir alteração de uso no destino (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_VLDUSERValidação do usuárioAtualiza se o valor no dicionário destino estiver vazio. Ou seja, não sobrepõe valores

...

já 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_WHENWhen

Atualiza se o valor do 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_POSLGT

...

Flag para exportação ferramenta "TOTVS PDV"Sempre atualiza

X3_MODALIndica

...

se é usado em janelas estilo "modal"

...

Sempre atualiza 

X3_BROWSEExibido 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 sistemaSempre atualiza  

X3_VISUALIndica se o campo é apenas para visualizaçãoNã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_DESCRICDescrição do campoNã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_DESCSPADescrição do campo em espanholSempre 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_DESCENGDescrição do campo em inglêsSempre 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_OBRIGATIndica campo obrigatório alterável via

...

ConfiguradorNão atualiza*
Sempre atualiza, mesmo que em branco.
X3_CONTEXTContexto 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.

...