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
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 | ||
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. 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 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_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.
| Sempre atualiza, mesmo que em branco. | |
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. |
...
Sempre atualiza, mesmo que em branco. | ||||
X3_DECIMAL | Decimais | Atualiza se:
| Atualiza se:
| |
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. |
...
Se o valor foi alterado pelo cliente, não 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:
| Se o valor foi alterado pelo cliente, não 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 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. 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_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
|
...
|
...
|
...
|
...
|
...
|
...
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 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. | Se o valor foi alterado pelo cliente, não 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 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. 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 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. | Se o valor foi alterado pelo cliente, não 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:
|
...
|
...
|
...
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:
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 | Se o valor foi alterado pelo cliente, não atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco. | Sempre atualiza, mesmo que em branco. |
X3_TITSPA | Título em espanhol | Sempre atualiza | Se o valor foi alterado pelo cliente, não atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco. | Sempre atualiza, mesmo que em branco. |
X3_TITULO | Título | Não atualiza* | Se o valor foi alterado pelo cliente, não atualiza. Obs.: A regra vale para qualquer novo valor, mesmo que em branco. | Sempre atualiza, mesmo que em branco. |
X3_TRIGGER | Indica 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:
| Atualiza se:
| ||
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 |
...
. | Se o valor foi alterado pelo cliente, não 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 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. 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. 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. 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. 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. |
...
. 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. 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.
|
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. |