ER_Mudança_SX3_Reserv_Usado_Obrigat

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).

Objetivo

Atender as mudanças de estrutura das colunas do Metadado de Campos de Tabelas (SX3) que foram realizadas a partir da versão 12.1.7 do Protheus através do uso de APIs específicas para manipulação das colunas alteradas, mantendo o produto alinhado com as novas tecnologias disponibilizadas para melhora de performance e produto.

Definição da Regra de Negócio

A partir da versão 12.1.7 do Protheus algumas colunas do Metadado de Campos de Tabelas (SX3) tiveram sua estrutura alterada a fim de melhorar performance a atender melhorias do produto. 

Para realizar a manipulação das colunas afetadas é necessário fazer uso de algumas APIs específicas. A TOTVS não recomenda a manipulação direta desses campos (sem uso de API) e qualquer customização e rotina que realiza esse procedimento está fora do padrão de desenvolvimento, por esse motivo devem ser revisadas para evitar impactos em versões futuras.

Os campos que devem ser revisados são: X3_RESERV, X3_USADO, X3_OBRIGAT. 

Utilização das novas funções X3Uso(), X3Reserv() e X3Obrigat()

1. X3Uso()
   Função utilizada para avaliar se um determinado campo está em uso para um determinado módulo.
   Para isso, é necessário posicionar-se no SX3 no campo a ser avaliado e utilizar o comando abaixo:
          X3Uso(SX3->X3_USADO)
   
   
2. X3Reserv()
   Função utilizada para avaliar se um determinado campo deve permitir ou não alterar características do campo em questão.
   Para isso, é necessário posicionar-se no SX3 no campo a ser avaliado e utilizar o comando abaixo:
          X3_Reserv(SX3->X3_RESERV)
   
   
3. X3Obrigat()
   Função utilizada para avaliar se um determinado campo é de preenchimento obrigatório ou não.
   Para isso, basta informar o nome do campo, conforme demonstrado abaixo, e a função realizar o seek e posicionará na SX3 de acordo com o nome do campo recebido.
           X3Obrigat(NOME_DO_CAMPO)

Alteração de tratamento para análise de conteúdo dos campos X3_OBRIGAT e X3_USADO

Ao utilizar a função Bin2Str com qualquer um dos campos, como na seguinte instrução, resultará em erro a partir da versão 12.1.7 pois o conteúdo do campo X3_OBRIGAT será caractere:

(SubStr(Bin2Str(X3_OBRIGAT),1,1)=="x")

Utilizar a função X3TreatObrigat() quando necessitar analisar e/ou transformar o conteúdo do campo X3_OBRIGAT.

O seguinte comando para manipulação do campo X3_USADO também não será mais aceito na versão 12.1.7:

ALLTRIM(UPPER(SX3->X3_USADO)) <> "€€€€€€€€€€€€€€ "

Utilizar a função X3TreatUso() quando necessitar analisar e/ou transformar o conteúdo do campo X3_USADO.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>. 

Abaixo é listado as mudanças a serem feitas em cada fonte, lembrando sempre de analisar a mudança apresentada e adequando o fonte conforme necessário: