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 dos campos 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) 

CampoColunaDescriçã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 "limpa" remove (deixa em branco) valores já cadastrados  
X3_CBOXENGCombobox InglêsAtualiza se o valor do novo dicionário NÃO estiver vazio. Ou seja, não "limpa" remove (deixa em branco) valores já cadastrados  
X3_CBOXSPACombobox espanholAtualiza se o valor do novo dicionário NÃO estiver vazio. Ou seja, não "limpa" remove (deixa em branco) valores já cadastrados  
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 "limpa" remove (deixa em branco) valores já   cadastrados  
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 browseAtualiza se o valor do novo dicionário NÃO estiver vazio. Ou seja, não "limpa" remove (deixa em branco) valores já cadastrados  
X3_NIVEL Nível do campo Nunca Não atualiza. Campo exclusivo do cliente cliente*
X3_NOME Nome do campo Nunca 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ávelAtualiza se o valor do novo dicionário NÃO estiver vazio. Ou seja, não "limpa" valores já cadastrados  
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 Nunca Não atualiza*
X3_TRIGGERIndica uso de gatilho Atualiza caso o novo valor seja "S", ou seja, não limpa gatilho que já é disparado 
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  
X3_WHENWhenAtualiza se o valor do novo   dicionário NÃO estiver vazio. Ou seja, não "limpa" valores já cadastrados  
 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 Nunca atualiza Não atualiza*
 X3_VALID Validação do sistemaSempre atualiza  
 X3_VISUALIndica se o campo é apenas para visualizaçãoNunca atualiza Não atualiza*
 X3_DESCRICDescrição do campoNunca Não atualiza*
 X3_DESCSPADescrição do campo em espanholSempre atualiza
 X3_DESCENGDescrição do campo em inglêsSempre atualiza

 

 

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 )

 

 

 

Status do documentoConcluído
Data12/01/2015
Versão1.0
Versão anterior1.0
Autores

Sergio Luis De Alcantara Silveira