Árvore de páginas

La tabla SX2 del diccionario de datos define de una manera estándar la estructura de campos de las tablas disponibles dentro del entorno del Microsiga Protheus.

 

Toda modificación que se quiera hacer en la estructura de tablas del Microsiga Protheus, referente a campos debe hacerse en esta tabla. Es importante resaltar y reforzar el uso de la herramienta disponible para el manejo del SX3 dentro del Microsiga Protheus, conocido como Configurador, puesto que algunas modificaciones sólo se replicarán a la base de datos si efectuamos la modificación por medio de dicha herramienta.

 

El SX3 abre una gama de posibilidades para la personalización de las tablas del sistema.

 

Campos

Tipo

Descripción

X3_ARQUIVO

Carácter

 Nombre de la tabla de datos al que pertenece el campo, la tabla se debe definir en la tabla SX2, (X2_CHAVE).

X3_ORDEM

Carácter

 Orden de presentación de los campos. El orden es importante porque algunos LookUp (consulta estándar) vuelven con más de un valor y modifican el orden de un campo, lo que puede hacer que al devolver una consulta no se complete correctamente.

X3_CAMPO

Carácter

El nombre del campo debe ser único para la misma tabla, en el Microsiga Protheus se debe seguir el estándar que utiliza el nombre del archivo, seguido de _ para formar el nombre. De este modo queda disponible para el usuario 6 dígitos que permiten formar el nombre del campo.

Existe una excepción a esta regla, la familia de tablas que comienza con el prefijo "S" se representan sin la S inicial, lo que permite el uso de 7 dígitos para el nombre del campo.

Por ejemplo:

PA1_CLIENT / E1_CLIENTE

X3_TIPO

Carácter

Tipo de dato almacenado por el campo. Posibles valores:

C-Tipo Carácter; N - Numérico; F - Fecha ; M - Memo; L - Lógico

X3_TAMANHO

Entero

Determina el tamaño del campo según el tipo.

X3_DECIMAL

Entero

Utilizado solamente cuando el X3_TIPO es numérico. Determina la cantidad de dígitos decimales.

X3_TITULO

Carácter

Título con la descripción resumida del campo en el idioma portugués.

X3_TITSPA

Carácter

Título con la descripción resumida del campo en el idioma español.

X3_TITENG

Carácter

Título con la descripción resumida del campo en el idioma inglés.

X3_DESCRIC

Carácter

Título con la descripción del campo en el idioma portugués.

X3_DESCSPA

Carácter

Título con la descripción del campo en el idioma español.

X3_DESCENG

Carácter

Título con la descripción del campo en el idioma inglés.

X3_PICTURE

Carácter

Picture del Campo La picture de un campo es la mascara de entrada que el campo debe respetar.

X3_VALID

Carácter

Función de validación general del campo, enviada como estándar  (default) por el sistema, a no ser que se autorice modificar este campo porque el cliente no puede hacerlo. 

Ejemplo del contenido:

 ExistCpo("SX5","12"+M->A1_EST) .AND. IE(M->A1_INSCR,M->A1_EST)

X3_USADO

Carácter

 

X3_RELACAO

Carácter

Iniciador estándar del campo. Por lo general utilizamos el iniciador estándar para completar campos virtuales, o campos que necesitan de valores estándar ya na inclusión del registro.

X3_F3

Carácter

Contiene el código del LookUp del campo, este es el código vinculado al diccionario SXB.

X3_NIVEL

Carácter

Nivel del campo. En el montaje de las pantallas de registro del Microsiga Protheus, siempre se verifica el nivel del usuario y de los campos, así podemos tener usuarios que visualizan campos y otros no.

X3_RESERV

Carácter

 Campo de control interno para permitir o no modificar características del campo.

X3_CHECK

Carácter

 *** No utilizado ***

X3_TRIGGER

Carácter

Cuando se completa el campo con S, se ejecutarán los disparadores (SX7) vinculados a dicho campo.

X3_PROPRI

Carácter

 Cuando se completa con U indica campo personalizado.

X3_BROWSE

Carácter

 Indica si el campo se presentará en browse de selección de registros de dicha tabla, los valores aceptados son "S", "N" y Blanco, considerando Blanco como "No".

X3_VISUAL

Carácter

 Determina si el campo se mostrará en la pantalla, si está en blanco o con "A" éste se puede modificar en la pantalla, si está con "V" se mostrará sólo como visualización.

X3_CONTEXT

Carácter

 Determina el contexto del campo, existen dos tipos de contextos, el primero es el Real ("R"  o blanco) y significa que el campo se grabará físicamente, es decir, éste existe en la tabla de la base de datos. Si es virtual, es porque éste se creó tan sólo en las pantallas del sistema y no se grabó en ningún lugar. Campos virtuales son útiles para la normalización de tablas.

Por ejemplo, si Ud. quiere tener en su tabla el nombre del cliente, debe crear un campo virtual para mostrar el nombre del cliente. Sin embargo, éste no se grabará en la base de datos para evitar la redundancia de información.

X3_OBRIGAT

Carácter

Campo de uso interno para determinar si el campo es obligatorio o no.

X3_VLDUSER

Carácter

Campo de validación del usuario. Este campo puede venir completado en la instalación estándar del producto, no obstante se permite que el cliente lo personalice.

X3_CBOX

Carácter

 String con los posibles valores para un campo tipo Combo Box en portugués. Estos valores siguen en el formato:
(Letra) = Descripción de la opción. Por ejemplo:

F=Cons.Final;L=Productor Rural;R=Revendedor;S=Solidario;X=Exportación

X3_CBOXSPA

Carácter

 String con los posibles valores para un campo tipo Combo Box en español. 

X3_CBOXENG

Carácter

  String con los posibles valores para un campo tipo Combo Box en inglés.

X3_PICTVAR

Carácter

 Función que determina la Picture del Campo y tiempo de ejecución. Ejemplo de uso, en el registro del Cliente, cuando modificamos el tipo de persona (entre jurídica y física), la picture del campo A1_CGC, se modifica para validar los registros CPF o CNPJ.

X3_WHEN

Carácter

 Función que determina si el campo se puede modificar en plena ejecución. El When de cada campo se ejecuta cada vez que se cambia el objetivo en el sistema, es decir, cada vez que el usuario complete algún campo o cambie un campo seleccionado.  Por lo tanto, siempre hay que prestar atención para no generar funciones que efectúan un gran procesamiento.

X3_INIBRW

Carácter

 Función llamada al iniciar el Browse de la tabla, generalmente utilizada en un campo de contexto virtual.

X3_GRPSXG

Carácter

 Código del grupo de campo(SXG) al que pertenece el campo. Todos los campos que están vinculados a un grupo de campo, sufren los cambios cuando lo modificamos.

Por ejemplo, en una tabla personalizada, colocamos nuestro campo PA1_PRODUT en el grupo de campo del producto estándar del sistema, al modificar el tamaño del campo del B1_COD nuestro campo también se actualizará.

X3_FOLDER

Carácter

 Número de la carpeta donde se presentará el campo. La carpeta se evaluará sólo si la tabla no se presenta en un Grid. La descripción de las tablas está en el diccionario SXA.

X3_PYME

Carácter

 Determina si el Microsiga Protheus serie 3 utiliza la pregunta.

X3_CONDSQL

Carácter

 *** No utilizado***

X3_CHKSQL

Carácter

  *** No utilizado***

X3_IDXSRV

Carácter

 ¿Protheus Search?

X3_ORTOGRA

Carácter

Activa el uso del corrector ortográfico.

X3_IDXFLD

Carácter

 ¿Protheus Search?

X3_TELA

Carácter

Se utiliza cuando es necesario omitir el campo en diversas situaciones en la misma tabla.

Debemos utilizar números separados por | para determinar cuando se mostrará el campo. Al utilizar la función Enchoice o la clase MSMGET. Rutinas que utilizan el nuevo modelo MVC no utilizan este campo. Lo que se debe utilizar es el perfil de usuario para tratar este tipo de situaciones.

X3_AGRUP

Carácter

Código del agrupador (SXA). Disponible para rutinas escritas en la tecnología MVC, podemos crear un agrupador dentro de cada carpeta.

X3_POS

Carácter

Indica si el campo se exportará en la herramienta de PDV.

  • Sem rótulos