SX3 Campos das Tabelas

Saiba o que é SX3 Campos das Tabelas Totvs Protheus e

entenda como ele pode auxiliar sua empresa

O que é SX3 Campos das Tabelas Totvs Protheus

A tabela SX3 Campos das Tabelas do Dicionário de Dados de�ne de uma forma
padronizada a estrutura de campos das tabelas disponíveis dentro do Ambiente
Microsiga Protheus.

Toda modi�cação que se deseje fazer na estrutura de tabelas do Microsiga

Protheus, no que se diz respeita a campos deverá ser feita nesta tabela. É
importante salientar e reforçar o uso da ferramenta disponível para manipulação
do SX3 Campos das Tabelas dentro do Microsiga Protheus, chamado de
Con�gurador, pois algumas modi�cações só serão replicadas ao banco de dados
caso efetuemos a alteração via ferramenta.

Qual o objetivo dos Campos das Tabelas Totvs

Protheus

O Objetivo SX3 Campos das Tabelas é permitir a Flexibilização da Base de Dados,

através da Inclusão de Novos Campos, sua Alteração, Inibir o seu Uso e até Criar
novas tabelas, que passam a ser parte integrante do sistema.
De�nir em que Pasta de Cadastro, os campos deverão se posicionar e até mesmo
modi�car o posicionamento de campos, que já faziam parte do sistema antes
das Customizações.
Cada registro do Dicionário de Dados, corresponde a um campo das mais de
(1600 Tabelas) do sistema.
Todos os Processamentos, em especial, as telas de Cadastramentos, Consultas e
Relatórios Genéricos, são baseados no seu conteúdo.
Tamanhos, Tipos, Pictures, Legendas, Validações, Níveis de Acessos,
Inicializações, Contextos Reais ou Virtuais, Usos ou Não Usos, Obrigatoriedades,
Ordens de Apresentações, Helps e Consultas via , são Propriedades de�nidas no
Dicionário de Dados e passíveis de alteração pelo próprio Administrador.
Diz-se que o Dicionário de Dados SX3 Campos das Tabelas é ativo, porque ao
alterá-lo, não é necessário recompilar nenhum programa, para que a modi�cação
entre imediatamente em funcionamento.

O SX3 Campos das Tabelas abre o um leque de inúmeras possibilidades para a

customização das tabelas do sistema.

Campos Tipo Descrição

 Nome da tabela de dados, ao qual o campo faz

X3_ARQUIVO Caracter parte, a Tabela deve ser de�nida na tabela SX2,
(X2_CHAVE)

Ordem de apresentação dos campos. A ordem é

importante pois alguns LookUPs(Consulta Padrão)
retornam mais do que 1 valor e alterar a ordem de
X3_ORDEM Caracter um campo pode fazer que o retorno de uma
consulta não preencha corretamente.

Obs.: campos com a legenda em vermelho não

permitem alteração de ordem.

O nome do campo deve ser único para a mesma

tabela, no Microsiga Protheus deve-se seguir o
padrão de se utilizar o nome do arquivo, seguido de
_ para formar o nome. Dessa forma �ca disponível
para o usuário 6 dígitos para formação do nome do
X3_CAMPO Caracter
campo.

Existe uma exceção a essa regra, a família de

tabelas começada com o pre�xo “S” são
representadas sem o S inicial, permitindo assim o
 uso de 7 dígitos para o nome do campo.

Por exemplo:

PA1_CLIENT / E1_CLIENTE

Tipo de dado armazenado pelo campo. Valores

possíveis:
X3_TIPO Caracter
C-Tipo Caracter; N – Numérico; D – Data ; M –
Memo; L – Lógico

Determina o tamanho do campo conforme o Tipo. O

tamanho máximo é 254 caracteres. A alteração do
X3_TAMANHO Inteiro
tamanho de campos deve ser realizada apenas via
Con�gurador.

Usado apenas quando o X3_TIPO for Numérico.

X3_DECIMAL Inteiro
Determina a quantidade de casas decimais.

Rótulo com a descrição resumida do campo no

X3_TITULO Caracter
idioma Português

Rótulo com a descrição resumida do campo no

X3_TITSPA Caracter
idioma Espanhol

Rótulo com a descrição resumida do campo no

X3_TITENG Caracter
idioma Inglês

Rótulo com a descrição do campo no idioma

X3_DESCRIC Caracter
Português

Rótulo com a descrição do campo no idioma

X3_DESCSPA Caracter
Espanhol

X3_DESCENG Caracter Rótulo com a descrição do campo no idioma Inglês

Picture do Campo. A picture de um campo é a

X3_PICTURE Caracter
mascara de entrada que o campo deve respeitar.

Função de validação geral do campo, enviada

como  default pelo sistema, a não ser que seja dado
X3_VALID Caracter
permissão para alteração deste campo, o mesmo
não é alterável para o cliente.
 Exemplo de conteúdo:

ExistCpo(“SX5”,”12″+M->A1_EST) .AND.
IE(M->A1_INSCR,M->A1_EST)

A função deverá ser Function(para GDPs) ou User

Function (Cliente) , Static Function não podem ser
utilizadas.

X3_USADO Caracter

 Inicializador Padrão do Campo. Normalmente

utilizamos o inicializador padrão para
preenchimento de campos virtuais, ou campos que
necessitam de valores padrões já na inclusão do
X3_RELACAO Caracter registro.

A função deverá ser Function(para GDPs) ou User

Function (Cliente) , Static Function não podem ser
utilizadas.

 Contem o código do LookUp do campo, esse é

X3_F3 Caracter
código relacionado ao dicionário  SXB.

 Nível de Campo. Na montagem das telas de

cadastro do Microsiga Protheus, é sempre
X3_NIVEL Caracter veri�cado o nível do usuário e dos campos, assim
podemos ter usuário que visualizam campos e
outros usuário que não.

 Campo de controle interno para permitir ou não

X3_RESERV Caracter
alterar características do campo.

X3_CHECK Caracter  ***Não Usado ***

Quando preenchido com S, ao se preencher o

X3_TRIGGER Caracter campo, irá executar os gatilhos(SX7) associados a
esse campo.

 Quando preenchido com U indica campo

X3_PROPRI Caracter
customizado.

 Indica se o campo será apresentado em browse de

X3_BROWSE Caracter
seleção de registros dessa tabela, valores aceitos
 são “S” , “N” e Branco, sendo considerando branco
com não.

 Determina se o campo será apresentado na tela, Se

ele estiver em Branco  ou com “A” ele é alterável na
X3_VISUAL Caracter
tela, se estiver com “V” será apresentado apenas
para visualização.

 Determina o contexto do campo, Existe dois tipos

de contextos, o primeiro é o Real (“R”  ou branco)
que signi�ca que o campo será gravado
�sicamente, ou seja ele existe na tabela de banco
de dados. Caso ele seja Virtual, ele é apenas criado
nas telas do sistema, não sendo gravado em lugar
X3_CONTEXT Caracter nenhum. Campos virtuais são útil para
normalização de tabelas.

Por exemplo se você quiser na sua tabela ter o

nome do Cliente, você cria um campo Virtual para
mostrar o nome do cliente. Porém o mesmo não
será gravado na base de dados, evitando assim
redundância de informação.

Campo de uso interno para determinar se o campo

X3_OBRIGAT Caracter
é obrigatório ou não.

Campo de validação do usuário. Esse campo pode

vir preenchido na instalação padrão do produto,
porém é permitido que o cliente o customize.
X3_VLDUSER Caracter
A função deverá ser Function(para GDPs) ou User
Function (Cliente) , Static Function não podem ser
utilizadas.

 String com os valores possível para um campo tipo

Combo Box em Português. Esses valores seguem
no formato:
X3_CBOX Caracter
(Letra) = Descrição da opção. Por
Exemplo:F=Cons.Final;L=Produtor
Rural;R=Revendedor;S=Solidario;X=Exportacao
  String com os valores possível para um campo tipo
X3_CBOXSPA Caracter
Combo Box em Espanhol.

  String com os valores possível para um campo

X3_CBOXENG Caracter
tipo Combo Box em Inglês.

 Função que determina a Picture do Campo e tempo

de execução. Exemplo de uso, no cadastro de
X3_PICTVAR Caracter Cliente, quando alteramos o tipo de pessoa (entre
jurídica e física), a picture do campo A1_CGC, é
alterado para validar CPF ou CNPJ.

 Função que determina se o campo pode ser

alterado em tempo de execução. O When de cada
campo e executado a cada mudança de foco no
sistema, ou seja, a cada vez que o usuário
preencher algum campo ou trocar de campo
X3_WHEN Caracter selecionado.  Portanto deve-se sempre se atentar
para não produzir funções que efetuam um grande
processamento.

A função deverá ser Function(para GDPs) ou User

Function (Cliente) , Static Function não podem ser
utilizadas.

 Função chamada na inicialização do Browse da

tabela, normalmente utilizada em campo de
contexto Virtual.
X3_INIBRW Caracter
A função deverá ser Function(para GDPs) ou User
Function (Cliente) , Static Function não podem ser
utilizadas.

 Código do grupo de campo(SXG) que o campo

pertence. Todos os campos que estão associados
a um grupo de campo, sofrem as alterações quando
alteramos ele.
X3_GRPSXG Caracter
Por exemplo, em uma tabela customizada,
colocamos o nosso campo PA1_PRODUT no grupo
de campo do produto padrão do sistema, ao se
alterar o tamanho do campo do B1_COD por
 exemplo, nosso campo também será atualizado.

 Número da Folder aonde o campo será

apresentado. A folder será avaliada apenas se a
X3_FOLDER Caracter
tabela não for apresentada num Grid. A descrição
das tabelas está no Dicionario SXA.

 Determina se a pergunta é utilizada pelo Microsiga

X3_PYME Caracter
Protheus Serie 3

X3_CONDSQL Caracter  ***Não usado***

X3_CHKSQL Caracter   ***Não usado***

X3_IDXSRV Caracter  Protheus Search?

X3_ORTOGRA Caracter Habilita o uso do Corretor ortográ�co.

X3_IDXFLD Caracter  Protheus Search?

Utilizado quando precisamos omitir o campo em

situação diversas  na mesma tabela.

Devemos utilizar números separados por | para

X3_TELA Caracter determinar quando o campo será apresentado. Ao
se utilizar a função Enchoice ou a Classe MSMGET.
Rotina que utilizam o novo modelo MVC não faz
uso desse campo. Devendo utilizar o per�l de
usuário para tratar situações assim.

Código do Agrupador (SXA). Disponível  para rotina

X3_AGRUP Caracter escritas na tecnologia MVC, podemos criar um
Agrupador dentro de cada folder.

Indica se o campo será exportado na ferramenta de

X3_POS Caracter
PDV.