Histórico da Página

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)

Coluna	Descrição	Regra
X3_GRPSXG	Grupo 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_CBOX	Combobox	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_CBOXENG	Combobox 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_CBOXSPA	Combobox 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_F3	Consulta 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_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
X3_IDXSRV	Index Server	Sempre atualiza
X3_INIBRW	Inicializador 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_ORDEM	Ordem 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_ORTOGRA	Corretor ortográfico	Sempre atualiza
X3_PICTURE	Má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_PICTVAR	Picture 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_PROPRI	Propriedade	Sempre atualiza.
X3_PYME	Existe no série 3	Sempre atualiza
X3_RELACAO	Inicializador 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_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 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_TELA	Tela	Sempre atualiza
X3_TIPO	Tipo de campo	Sempre atualiza
X3_TITENG	Título em Inglês	Sempre atualiza
X3_TITSPA	Título em espanhol	Sempre atualiza
X3_TITULO	Título	Não atualiza*
X3_TRIGGER	Indica uso de gatilho	Atualiza caso o novo valor seja "S", ou seja, não limpa gatilho que já é disparado 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_VLDUSER	Validação do usuário	Atualiza 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_WHEN	When	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_MODAL	Indica se é usado em janelas estilo "modal"	Sempre atualiza
X3_BROWSE	Exibido no browse	Não atualiza*
X3_VALID	Validação do sistema	Sempre atualiza
X3_VISUAL	Indica se o campo é apenas para visualização	Não atualiza*
X3_DESCRIC	Descrição do campo	Não atualiza*
X3_DESCSPA	Descrição do campo em espanhol	Sempre atualiza
X3_DESCENG	Descrição do campo em inglês	Sempre atualiza
X3_OBRIGAT	Indica campo obrigatório alterável via configurador	Não atualiza*
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.

Status do documento	Concluído
Data	12/01/2015
Versão	1.0
Versão anterior	1.0
Autores	Sergio Luis De Alcantara Silveira

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 46

Nova versão 47

Chave