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: 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. |