Páginas filhas
  • Regras para atualização do dicionário SX3 - UPDDISTR e migrador de versão.
Ir para o final dos metadados
Ir para o início dos metadados


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) 

ColunaDescrição Regra 
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)
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.  

  

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.  

  

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.  


X3_DECIMAL Decimais 

Atualiza se: 

  • Caso diferente de numérico grava sempre 0 
  • NÃO permite alterar o tamanho pelo configurador 
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.  

  

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
X3_IDXSRVIndex Server Sempre atualiza
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.  


X3_NIVEL Nível do campo Não atualiza. Campo exclusivo do cliente*
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 )


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.  

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.

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.


X3_TELATelaSempre atualiza
X3_TIPO Tipo de campo Sempre atualiza
X3_TITENGTítulo em InglêsSempre atualiza
X3_TITSPA Título em espanholSempre atualiza
X3_TITULOTítulo Não atualiza*
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.   
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.  

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*
X3_VALID Validação do sistemaSempre atualiza  
X3_VISUALIndica se o campo é apenas para visualizaçãoNão atualiza*
X3_DESCRICDescrição do campoNão atualiza*
X3_DESCSPADescrição do campo em espanholSempre atualiza
X3_DESCENGDescrição do campo em inglêsSempre atualiza
X3_OBRIGATIndica campo obrigatório alterável via configuradorNão atualiza*
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.





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

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.




Status do documentoConcluído
Data12/01/2015
Versão1.0
Versão anterior1.0
Autores
  • Sem rótulos