Desarrollo > Diccionario datos > Tablas > Tablas 

Esta función permite crear y modificar las tablas de la base de datos describiendo sus características en el diccionario de datos del dossier. La validación de esta descripción permite crear la tabla en la base de datos o modificar sus características.

La gestión de las tablas permite definir la lista potencial de las tablas de la base. Los códigos de actividad permiten desactivar algunas tablas y/o índices.

Además de la estructura de la tabla, en el diccionario se definen:

  • Los vínculos a otras tablas (vínculos de integridad referencial). Estos vínculos se utilizan en las herramientas de cancelación, en la importación-exportación y en otras herramientas de este tipo.
  • La información que se propone por defecto en las pantallas creadas a partir de estas tablas (palabras clave de ayuda, información de formato, etc.).

Una tabla se identifica por su nombre (alfanumérico en mayúscula que empieza por una letra) y tiene una abreviatura. La creación de nuevas tablas en la fase de personalización supone que el nombre empiece por la letra X, Y o Z. El nombre y la abreviatura deben ser únicos en toda la base (no puede haber dos tablas con el mismo nombre ni con la misma abreviatura; esta última restricción no se aplica a las pantallas).

Una tabla puede gestionarse con la ayuda de un objeto siempre y cuando se creen las pantallas necesarias.

Aviso:
No se pueden añadir campos o particularidades específicas o verticales a las tablas de tipo "sistema" o "diccionario". El específico no se mantiene en caso de validación del dossier o de migración.

Requisitos previos

SEEREFERTTO Consulta la documentación de Puesta en marcha

Gestión de la pantalla

Una tabla se define con tres pestañas: una general, una de definición de campos y otra de definición de índices.

Cabecera

Campos

Los campos siguientes están presentes en esta pestaña :

El código de la tabla debe estar compuesto por entre 1 y 10 caracteres (letras o cifras que comiencen obligatoriamente por una letra). Es un indicador único para el conjunto de abreviatura de las tablas del diccionario de datos. Las palabras reservadas de Adonix están prohibidas.

  • Abreviatura (campo ABRFIC)

La abreviatura de la tabla debe estar compuesta por entre 1 y 3 caracteres (letras o cifras que comiencen obligatoriamente por una letra). Es un indicador único para el conjunto de abreviatura de las tablas del diccionario de datos. Las palabras reservadas de Adonix están prohibidas.

  • Descripción (campo ZINTITFIC)

 

Cerrar

 

Pestaña General

Presentación

Contiene la información general sobre la tabla y su gestión.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Características

El código de actividad y el módulo permiten saber si la tabla descrita en el diccionario debe crearse en la base de datos del dossier. Se creará si se dan las siguientes condiciones de forma simultánea:

 El campo Código actividad está en blanco o el código de actividad (definido en la tabla correspondiente) está activado.

 El módulo al que está asociada la tabla se ha declarado como activo en el dossier.

Una tabla con un código de actividad asignado que empieza por X, Y o Z se considera específica y no se verá afectada en ningún caso por un cambio de versión (estos códigos de actividad se pueden situar a nivel de las líneas).

Asimismo, los módulos son dependientes entre sí:

  • Supervisor y Tronco común: son los módulos mínimos que hay que instalar. A continuación, se pueden instalar los módulos de Stocks, Desarrollo y Contabilidad general.
  • Stocks: se pueden instalar los módulos de Ventas, Compras y Producción.
  • Ventas:se pueden instalar los módulos de CRM y Acción comercial.
  • Contabilidad general: se pueden instalar los módulos de Inmovilizados y Contabilidad tercero.
  • Módulo (campo MODULE)

 

Gestión tabla

  • Tipo de base (campo TYPDBA)

Tipo de base para el que hay que generar la tabla. El tipo de base "Dossier" permite indicar al programa de gestión de dossieres que genere la tabla en el tipo de base seleccionado en la ficha dossier para el conjunto de ficheros del dossier. En algunos casos excepcionales (sobre todo si es una tabla externa), se puede introducir otro parámetro.

  • Compatible versiones anteriores (campo FLG130)

Marque esta casilla para acceder a una tabla de un dossier 140 desde un dossier 130. En ese caso, la estructura de la tabla debe respetar los límites de la versión 130 (ni clob ni blob…). Nota: Se puede realizar la operación inversa sin necesidad de completar el diccionario (acceder a una tabla 130 desde un dossier 140).

Si esta casilla está marcada en la V7, los campos de tipo "datetime",  "uuident" y "updtick" no se generan para poder utilizar la tabla en una V6 o anterior.

  • N.º fichas (campo NBENREG)

El campo Número de registros permite definir un dimensionamiento de la tabla en la base. Este campo se utiliza para dimensionar la tabla que se va a crear o modificar. En la creación del dossier, este valor se introduce en cada tabla creada a partir del resultado de la evaluación de la fórmula de dimensionamiento. Esta fórmula, a su vez, utiliza variables cuyos valores se introducen en los parámetros del dossier.

En la revalidación del dossier, se vuelve a evaluar el número de registros, pero el resultado del cálculo solo se reescribe en este campo si es superior al valor encontrado en la tabla. De esta forma, si modifica este valor, puede aumentar el tamaño de la tabla y este valor se tendrá en cuenta en la revalidación del dossier. Si se disminuye, se tendrá en cuenta inmediatamente al validar la tabla de forma manual mediante el botón correspondiente. No obstante, en cuanto se revalide el dossier, se utilizará el valor calculado, que es superior, en lugar del valor introducido. Este comportamiento se ha definido por motivos de seguridad. Por motivos de rendimiento y de facilidad de uso, es preferible sobredimensionar una tabla que subdimensionarla. No es necesario proteger la modificación de este campo con un código de actividad.

  • Generación textos traducibles (campo GENTRA)

Esta casilla permite definir el método utilizado en Crystal Reports para los textos traducidos de la tabla.

  • Marcada - Método de la versión 140. Los textos se generan en los ficheros secuenciales textrafra, textraeng, etc. utilizados en el informe Crystal por la función X3TranslatedText.
  • No marcada - Método creado en la V5. No se genera ningún fichero. El informe Crystal vinculado a la tabla utiliza una vista.

Es un campo de parametrización que no requiere un código de actividad como protección. Debe ser coherente con la técnica utilizada en el informe Crystal vinculado a la tabla. En los nuevos textos traducidos, se recomienda marcar esta casilla para utilizar el método de vistas y no sobrecargar los ficheros secuenciales.   

  • Reinicializar (campo ZERO)

La utilidad de reinicio de los movimientos, que permite reinicializar los movimientos de un dossier, utiliza esta casilla. De esta forma, se mantienen los datos "fijos" (artículos, terceros, cuentas, estructuras,etc.) procedentes de una entrada suprimiendo los movimientos (asientos, facturas, movimientos de stock, OF, etc.) vinculados, por ejemplo, a una prueba de arranque real. Cuando se marca esta casilla, la utilidad de reinicio suprime todas las líneas de la tabla. Todos los campos tienen un indicador de este tipo (cuando hay que reinicializar el campo sin vaciar la tabla).

  • Acceso no seguro (campo SECURE)

Esta casilla permite restringir el acceso a la tabla de datos al dossier propietario de la tabla y a ciertos dossieres autorizados. Esta noción es idéntica en la vista. Para que las modificaciones de este campo se tengan en cuenta en la base de datos, hay que revalidar la tabla.

  • No seguro - Todos los dossieres de la solución pueden acceder a la tabla para leer o escribir los datos. Es el caso de:
    • Las tablas de sistema.
    • Las tablas de diccionario.
    • Algunas tablas supervisor.
  • Seguro - El acceso a la tabla depende de los derechos del dossier de llamada. Un dossier puede estar:
    • Inhabilitado.
    • Habilitado para lectura.
    • Habilitado para lectura y escritura. Es el caso de las tablas funcionales y de la mayoría de las tablas supervisor.

Los dossieres habilitados son:

  • El dossier en el que está definida la tabla (las tablas de sistema se encuentran en el dossier de referencia de la solución; en Sage X3, este dossier se llama X3).
  • Los dossieres principales del dossier.
  • Un dossier autorizado (mediante la función Dossieres, pestaña "Vínculos", bloque "Dossieres de la solución").
  • Los dossieres de otras soluciones con acceso por vínculo (mediante la misma función).

SEEINFOLa política de seguridad de la tabla se considera parte de la parametrización, de modo que esta casilla no se actualiza por parche. Si esta casilla está marcada, en la validación de la tabla se crea un fichero de configuración (de extensión .cfg) con el siguiente código:

$SECURITY
{  "LEVEL0" }
End

Si el fichero de configuración tiene otras directivas manuales, también se respetan. Puede añadir directivas actualizando el bloque "Fichero de configuración"en la pestaña correspondiente de la Gestión de tablas.

Gestión dossier

  • Tipo de tabla (campo TYPFIC)

Este campo permite clasificar las tablas siguiendo una tipología que se utiliza en la gestión de dossieres. Puede tomar los siguientes valores:

 Aplicación - Es el caso por defecto (tablas estándar de un dossier). Estas tablas pueden mostrarse o no según la gestión de códigos de actividad y de módulos.

 Supervisor - La tabla forma parte de los datos supervisor gestionados en cada dossier fuera del diccionario (usuarios, traza de operaciones, archivos adjuntos, etc.). Siempre se muestra.

 Sistema - La tabla forma parte de los datos generales no vinculados a un dossier determinado (tablas vinculadas a la gestión de dossieres, al servidor batch, etc.). Estas tablas solo se muestran en el dossier supervisor, que puede tener un nombre diferente en función del producto instalado: X3, PAYE o GX, por ejemplo. Son comunes para todos los dossieres. Por lo tanto, no se ven afectadas por los tipos y opciones de copia, puesto que nunca se copian. No se pueden añadir campos específicos a este tipo de tabla.

 Diccionario - La tabla, que siempre se muestra, forma parte del diccionario de cada dossier (informes, acciones, pantallas, tipo de datos, etc.). La gestión del dossier tiene en cuenta especialmente las tablas del diccionario en la gestión de actualizaciones (procedimiento de fusióndel diccionario).  En este caso, los campos Tipo de copia y Opción de copia tampoco afectan al tipo de tabla. No se pueden añadir campos específicos a este tipo de tabla.

 Interno - No se entrega ninguna tabla de este tipo, que solo se utiliza en el proceso de desarrollo del software y, por lo tanto, no debe utilizarse.

  • Tipo de copia (campo CRE)

Determina si la creación de la tabla implica la transferencia de datos entre el dossier de referencia y el dossier que se va a crear en la creación del dossier. Este parámetro puede tomar los siguientes valores:

 Sin copiaLa tabla se crea sin datos.

 Copia automática - Los datos de la tabla se recuperan de los datos existentes en el dossier de copia (el dossier de referencia por defecto).

 Copia condicional - Los datos de la tabla se copian por grupos lógicos. Los grupos se crean a partir de una elección del menú local número 26, introducido en el campo Opción de copia. A cada grupo se le asocia una lista de tablas. Entre los grupos, encontramos Usuarios y perfiles, Tablas varias, Contadores, Parámetros, Plan general contable, etc. En la creación de la tabla, se responde o No a cada opción para saber las tablas que hay que copiar.

  • Opción de copia (campo OPT)

En una copia condicional, la opción de copia está vinculada al tipo de copia.

Puede elegir los datos de varios subgrupos de tablas que se van a copiar del dossier de origen al dossier de destino.

  • Copia legislación (campo FLGLEG)

Esta casilla permite definir el método de copia en la validación del diccionario.

  • Marcada - Se aplicará un filtro al campo Legislación de esta tabla o de la tabla maestra.
  • No marcada - No se aplicará ningún filtro adicional.

En la validación del dossier, el dossier validado solo recuperará los datos correspondientes a las legislaciones gestionadas o en blanco.

Esta opción también se utiliza en la función Copia legislación.

  • Tipo entrega (campo TYPDLV)

Uso interno para la industrialización de una versión. Este parámetro puede tomar los siguientes valores:

  • No entregado - Estas tablas no se generan en el dossier X3.
  • Sin datos - La tabla se entrega sin datos.
  • Datos de industrialización - La tabla se entrega con los datos del dossier de industrialización (parametrización: estilos, modelos de importación, etc.).
  • Datos comunes - La tabla se entrega desde el dossier de referencia X3REFFRA.
  • Datos por país - La tabla se entrega desde el dossier X3REFxxx (xxx es el idioma elegido en la instalación del cliente).

Columnas particulares

  • Descripción (campo INTIT)

Estos campos permiten introducir el nombre de dos campos de la tabla. Permiten identificar los títulos de campo presentes en la tabla. Esta información se utiliza para visualizar automáticamente el título de un registro del que se conoce la clave (gestión de pantallas, cancelaciones, cambios de código, etc.).

  • Descrip. corta (campo INTITC)

 

  • Símbolo (campo SYMBOL)

 

  • Formato (campo COLFMT)

 

  • Longitud (campo COLLNG)

 

  • Decimales (campo COLDEC)

 

Cerrar

 

Pestaña Columnas

Presentación

Esta pestaña permite definir todos los campos de la tabla en un cuadro desplegable.

En cada tabla, se pueden utilizar campos con un nombre normalizado que se actualizan automáticamente si existen por gestión de objeto. Estos campos son los siguientes:

 CREDAT y UPDDAT son, respectivamente, las fechas de creación y de última actualización.

 CRETIM y UPDTIM son, respectivamente, las horas de creación y de actualización.

 CREUSR y UPDUSR son los códigos de los usuarios que han creado, respectivamente, el registro y la última actualización.

 EXPNUM es un número secuencial que permite fechar los registros con respecto al módulo de importación/exportación (lo que permite exportar únicamente lo que se ha actualizado desde la última exportación).

También se puede añadir un sexto campo a cada tabla. Este campo se llama ENAFLG y corresponde a un indicador activo/inactivo. Si la tabla se gestiona con un objeto y este campo tiene un tipo de datos asociado, se realizan los siguientes controles en los campos de este tipo:

 La ventana de selección estándar del objeto llamado mediante la tecla de selección filtra automáticamente los registros inactivos.

 Un mensaje de error impide introducir directamente una clave inactiva con su código.

Esto no es, evidentemente, aplicable a la gestión del propio objeto (de lo contrario, no se podrían reactivar los registros declarados temporalmente inactivos).

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Tabla

  • N.º (campo NUMLI)

 

  • Columna (campo CODZONE)

Indica el nombre del campo en la tabla utilizando la sintaxis que reconoce el software; por ejemplo, se podrá acceder al nombre del campo FIELDNAME, definido en la tabla de las abreviaciones ABV, mediante la sintaxis [F:ABV]FIELDNAME.

El nombre de los campos personalizados comienza por X_, Y_ o Z_.

En la base de datos, cada campo corresponde a uno o varios campos según si el campo tiene dimensiones o no. Los campos correspondientes son FIELDNAME_0, FIELDNAME_1 y FIELDNAME_2.

Para introducir y consultar el campo correspondiente a la pantalla, su nombre debe ser el mismo en el diccionario de pantallas. La pantalla y la tabla se utilizarán de forma simultánea en la gestión de objetos.

Define el tipo de campo, que caracteriza el formato de entrada (numérico, cualquier carácter, fecha...) y los controles de coherencia (referencia a una tabla, por ejemplo).

Los principales tipos genéricos existentes son:

A: Alfanumérico
C: Entero corto
L: Entero largo
DCB: Decimal
D: Fecha
M: Menú local
MM: Menú local con filtro
ACB: clob
ABB: blob

No obstante, hay muchos otros tipos predefinidos. A menudo hacen referencia a una tabla anexa (divisa, país...). Un diccionario dedicado permite describirlos, y se pueden seleccionar mediante la tecla F12, que abre la lista correspondiente.

  • Menú (campo NOLIB)

Define el número de menú local asociado al campo definido en la línea.

Cuando un campo es de tipo menú local, se almacena bajo un valor numérico (del 1 al 255) que corresponde al rango de un título en una tabla llamada menú local, almacenada en la tabla de mensajes APLSTD.

En captura o en visualización, se presentan, según las elecciones hechas en la interfaz del usuario:

  • bien un título que puede ser elegido de una lista desplegable llamada combo box STOP
  • bien una lista de botones de opción.

El interés de este tipo de captura es que la lista de elecciones se presenta en la lengua de conexión del usuario.

Cada número de menú local caracteriza la lista de los títulos posibles. Por ejemplo, el menú local 1 corresponde a la opción No / en este orden. En este caso, la interfaz del usuario puede ser también la casilla a marcar.

  • Long. (campo LONG)

Permite definir la longitud de un campo cuando este campo utiliza un tipo de datos genérico sin longitud fija. Es el caso de los tipos A y DCB.

Para los blob, al igual que para los clob, hay que introducir la longitud que será una longitud máxima de almacenamiento. La codificación es la siguiente:

Longitud

Tamaño memoria

Caracteres máximo

 0

 1020

 510

 1

 2044

 1022

 2

 4092

 2046

 3

 8188

 4094

n

1024*(2^n) - 4

512*(2^n) - 2

Un código de actividad permite:

  • definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;
  • identificar elementos específicos si se marcan con un código que comienza por X, Y o Z;
  • asignar un número máximo de líneas cuando el código de actividad marca elementos desde una tabla.

Si el código de actividad está desactivado:

  • el elemento marcado no se puede utilizar;
  • el código asociado no se puede gestionar ni activar.
  • Dim. (campo DIME)

Dimensión del campo en la tabla. La dimensión también puede asignarse en función del código de actividad.

  • Título normal (campo INTITCOURT)

Título del campo con tres longitudes: título abreviado con un límite de 12 caracteres, título normal con 20 caracteres y título largo con 35 caracteres.

Estos títulos son textos traducibles, se almacenan en la tabla dedicada ATEXTE. Cuando se introduce un nuevo texto, después de crear un campo, aparece una ventana con el título Texto. Existen tres opciones:

         Considerar que el texto introducido es un nuevo texto e integrarlo en la base de datos asignándole un nuevo número. Este número debe ser superior a 50 000 (es un texto específico).

         Buscar un texto parecido para seleccionar el mismo. Para ello, se abre una ventana de selección.

         Abandonar la entrada del texto.

Cuando se modifica un texto introducido anteriormente, hay otra opción que se muestra en la ventana Texto nnn (nnn es su número). Se puede modificar el texto del número proporcionado para adecuarlo al texto que se acaba de introducir (esta modificación se realiza en todos los lugares en los que se utiliza el texto una vez que se revalidan las pantallas correspondientes).

Por otra parte, puede hacer clic en la función Abrev. desde el icono Acciones para seleccionar una de las abreviaturas normalizadas definidas cuando un título es demasiado largo (por motivos de legibilidad de las pantallas, hay que evitar cuando sea posible el uso de abreviaturas).

  • Título abreviado (campo INTITABREG)

Título del campo con tres longitudes: título abreviado con un límite de 12 caracteres, título normal con 20 caracteres y título largo con 35 caracteres.

Estos títulos son textos traducibles, se almacenan en la tabla dedicada ATEXTE. Cuando se introduce un nuevo texto, después de crear un campo, aparece una ventana con el título Texto. Existen tres opciones:

         Considerar que el texto introducido es un nuevo texto e integrarlo en la base de datos asignándole un nuevo número. Este número debe ser superior a 50 000 (es un texto específico).

         Buscar un texto parecido para seleccionar el mismo. Para ello, se abre una ventana de selección.

         Abandonar la entrada del texto.

Cuando se modifica un texto introducido anteriormente, hay otra opción que se muestra en la ventana Texto nnn (nnn es su número). Se puede modificar el texto del número proporcionado para adecuarlo al texto que se acaba de introducir (esta modificación se realiza en todos los lugares en los que se utiliza el texto una vez que se revalidan las pantallas correspondientes).

Por otra parte, puede hacer clic en la función Abrev. desde el icono Acciones para seleccionar una de las abreviaturas normalizadas definidas cuando un título es demasiado largo (por motivos de legibilidad de las pantallas, hay que evitar cuando sea posible el uso de abreviaturas).

  • Título largo (campo INTITLONG)

Título del campo con tres longitudes: título abreviado con un límite de 12 caracteres, título normal con 20 caracteres y título largo con 35 caracteres.

Estos títulos son textos traducibles, se almacenan en la tabla dedicada ATEXTE. Cuando se introduce un nuevo texto, después de crear un campo, aparece una ventana con el título Texto. Existen tres opciones:

         Considerar que el texto introducido es un nuevo texto e integrarlo en la base de datos asignándole un nuevo número. Este número debe ser superior a 50 000 (es un texto específico).

         Buscar un texto parecido para seleccionar el mismo. Para ello, se abre una ventana de selección.

         Abandonar la entrada del texto.

Cuando se modifica un texto introducido anteriormente, hay otra opción que se muestra en la ventana Texto nnn (nnn es su número). Se puede modificar el texto del número proporcionado para adecuarlo al texto que se acaba de introducir (esta modificación se realiza en todos los lugares en los que se utiliza el texto una vez que se revalidan las pantallas correspondientes).

Por otra parte, puede hacer clic en la función Abrev. desde el icono Acciones para seleccionar una de las abreviaturas normalizadas definidas cuando un título es demasiado largo (por motivos de legibilidad de las pantallas, hay que evitar cuando sea posible el uso de abreviaturas).

  • Opciones (campo OPTION)

Estas opciones se materializan en caracteres que pueden concatenarse cuando se requieren varias opciones. Estas opciones se pueden elegir mediante una ventana de selección. Hay disponible una descripción detallada de todas las opciones posibles.

Código de una tabla vinculada a la que está modificando con el campo en curso. En los tipos de datos que hacen referencia a un objeto, este campo se completa automáticamente.

 

  • Expresión de vínculo (campo EXPLIEN)

Este campo solo se completa si se ha indicado una tabla vinculada. Si este campo no se completa, el vínculo se realiza directamente a partir del campo de la línea en curso (lo que supone que la clave primaria de la tabla vinculada solo tenga un componente). Si la clave primaria contiene varios componentes, la expresión del vínculo debe indicarse con comp1;comp2;comp..., o comp1,comp2, comp3... (los distintos componentes de la clave).
Estos son algunos ejemplos de posibles expresiones:

 Si el campo MICAMPO se controla en una de las tablas varias (la tabla número 43, por ejemplo), introduciremos el valor ATABDIV en la columna Tabla vinculada, y el valor 43 ;MICAMPO en la columna Expresión de vínculo.

 Si se indexa el campo MICAMPO, la expresión puede utilizar la variable de índice que puede variar de 0 a dimensión(MICAMPO)-1. Ejemplos clásicos: varias familias estadísticas (artículos, proveedores, clientes…) cuya estructura de la clave es el número de la familia seguido del código estadístico. La expresión de la clave se escribe: índice+1 ;MiCAMPO(índice).

  • Si el componente de la clave es una variable global, hay que indicar la clase [V] delante del nombre de la variable.
  • Para ignorar un elemento de la clave en el control de coherencia de la base, utilice la variable [V]GSUPCLE en dicho elemento.
  • Copia legislación (campo CHPLEG)

Este campo está vinculado a la casilla Copia legislación.

Permite indicar el campo que contiene la legislación o el campo que vincula a la tabla maestra que contiene la legislación.

  • Cancelación (campo ANNUL)

Cuando se cancela una línea de la tabla vinculada (tabla de origen), se puede realizar una acción específica en la tabla que se está modificando o creando (tabla de destino). Esta acción se define con el siguiente código:

  • Bloqueante - No se puede cancelar el registro de la tabla de origen si hay un vínculo con la tabla que se está definiendo.
  • Supresión - Se suprimen los registros de la tabla en curso comprobando el vínculo con la tabla de origen.
  • Reinicio - Se reinicia a cero el campo de la tabla en curso comprobando el vínculo con la tabla origen.
  • Otro - No se realiza ningún proceso específico.
  • Verificación (campo VERIF)

Este campo permite indicar si la utilidad de verificación de coherencia debe verificar el vínculo.

  • Obligatorio (campo OBLIG)

El campo Obligatorio permite definir si el campo puede estar vacío, o si debe contener un valor no vacío. Se entiende por campo vacío: una cadena de longitud vacía, un valor numérico nulo, un valor de menú local igual a cero (sin efectuar selección) o la fecha vacía [0/0/0].

Cuando el campo es una clave de una tabla, si el control de anulación se posiciona en el valor RAZ, el vínculo no puede ser obligatorio (ya que la anulación puede borrar el valor del campo clave): el campo Obligatorio toma automáticamente el valor en No.

  • Rein. (campo ZERO)

 

Cerrar

 

Pestaña ͍ndice

Presentación

Esta pestaña permite determinar los distintos índices definidos en la tabla.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Tabla Índice

  • N.º (campo NUMLIG)

 

  • Código índice (campo CODIND)

Este campo corresponde al nombre con el que se conoce al índice en la base de datos. En todas las tablas de la aplicación se utiliza una norma: consiste en nombrar las claves utilizando la abreviatura de la tabla, seguida por 0 para la clave principal, de 1 para la segunda clave, etc. Para el específico, hay que empezar este código por una de estas tres letras: X,Y o Z.

  • Descripción índice (campo DESCRIPT)

Aquí se introduce la lista de los campos que componen el índice, separado con el símbolo "+" si existen varios campos (por ejemplo en la tabla de plantas FACILITY, se encuentra una clave cuya definición es LEGCPY+FCY)

Un campo seleccionado en sentido descendente está precedido del símbolo "-" (atención, si se utiliza en lista izquierda)

El primer campo que compone un índice no tiene símbolo y es obligatoriamente ascendente.

  • Homónimos (campo HOMONYM)

Esta columna permite definir si la clave admite o no homónimos.

  • Índice clúster por defecto (campo DEFORDIND)

Utiliza esta columna para añadir un índice clúster por defecto, proporcionado por Sage.

Si seleccionas No, no se definirá ningún índice clúster.

Si seleccionas , se utilizará el índice clúster indicado.

Para modificar este índice, define un Índice clúster específico o marca la casilla Índice clúster desactivado si no quieres utilizar ninguno.

Este valor se puede modificar mediante un parche.

Si ya has configurado un índice clúster en local (en el fichero de configuración o en el campo Índice clúster específico), no se aplica este parámetro por defecto.

  • Índice clúster específico (campo ORDIND)

Selecciona para definir este índice como índice clúster. Solo puedes seleccionar uno por tabla.

Un índice clúster es un tipo de índice en el que los registros de la tabla se ordenan para corresponder al índice.

Esta parametrización es específica y no se puede modificar mediante un parche.

Si esta zona no se indica, el índice estará siempre presente. Si esta zona corresponde a un código de actividad inactivo, el índice no se generará.

 Es posible añadir una clave específica mediante un código actividad que empiece por X, Y o Z.

Bloque Número 2

  • Índice clúster desactivado por defecto (campo ORDINDSTA)

Utiliza esta columna para desactivar los índices clúster asociados a la tabla. El índice proporcionado por Sage en la columna Índice clúster por defecto está desactivado, incluso si no definiste ningún índice clúster en la columna destinada a esta parametrización.

Marca esta casilla para desactivar el índice clúster.

Fichero de configuración

  • campo FICCFG

En este bloque se puede introducir un texto que describa la configuración técnica de tabla en las bases de datos. Este texto queda grabado en un fichero con el nombre "número de tabla.cfg" en el listado FIL de la aplicación. Este fichero se utilizará para la instrucción "valfil". Para más detalles, consultar el anexo técnico dedicado.

Cerrar

 

Pestaña Auditar

Presentación

Esta pestaña permite crear la parametrización que muestra, con desencadenantes de base de datos generados automáticamente, las inserciones, supresiones y modificaciones realizadas en una tabla almacenando, si es necesario, los valores anteriores y posteriores en campos específicos. Las modificaciones del registro se muestran cuando se verifica una de las condiciones de campo.  Esta traza se almacena en dos tablas específicas (AUDITH y AUDITL). Puede consultarse sin más o dar lugar a modificaciones automatizadas mediante el workflow.

El principio es el siguiente:

  • Si hay marcado al menos un indicador de auditoría (creación, modificación, supresión), cada operación de este tipo crea una línea en la tabla AUDITH, independientemente de si se han trazado los campos y se han realizado las modificaciones correspondientes.
  • Una vez que los campos aparecen en la tabla de campos, cualquier modificación del valor del campo que respete la condición proporcionada creará una línea en AUDITL.

La técnica de los desencadenantes permite trazar las operaciones aunque se realicen con un programa distinto a Adonix. Los datos de esta tabla se tienen en cuenta revalidando la tabla. En este momento es cuando se crean y/o modifican automáticamente los desencadenantes.

El procesamiento SUBTRIGGER contiene la descripción de los desencadenantes en función de la base de datos. El procesamiento SPETRIGGER está dedicado al específico para poder personalizar su descripción.

La información de esta pestaña se considera parte de la parametrización. El estándar no entrega ninguna parametrización de auditoría. No es necesario proteger las modificaciones realizadas en esta pestaña con códigos de actividad X, Y o Z. 

La auditoría está condicionada globalmente por el código de actividad AUDIT.

No se pueden auditar:

  • Las propias tablas de auditoría.
  • Los campos de tipo clob y blob.
  • Los campos con un tipo de datos AXX.

Los resultados de la auditoría se pueden consultar en las siguientes funciones:

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Tipo de auditoría

  • Creación (campo AUDCRE)

Estas tres casillas permiten definir las operaciones que hay que trazar en los registros de la tabla:

  • Creación
  • Modificación
  • Supresión

Nota:
Los objetos "tabla" y "combinado" no actualizan registros, sino que operan mediante supresión y creación de registros.

  • Modificación (campo AUDUPD)

 

  • Supresión (campo AUDDEL)

 

Funciones

  • Workflow (campo AUDWRK)

Permite recibir una notificación automatizada por workflow.

Una tarea batch de workflow desencadena un evento de workflow para cada línea de la tabla AUDITH con un estado de workflow "A procesar" y actualiza el estado a "Procesado".

  • Auditoría BI (campo AUDBI)

Permite la sincronización incremental de las tablas de hechos BI. Solo se muestra cuando el código de actividad ABI está activo.

Actualización por generación de almacenamiento de datos en función del tipo de actualización prevista para la tabla de hechos. De acuerdo con las normas de sincronización BI, si una tabla de hechos se actualiza en sincronización incremental a partir de una tabla de X3, dicha tabla muestra el valor "AUDIT BI".

  • Auditoría S-Data (campo AUDSDA)

Clave de seguimiento

  • Clave (campo AUDCLE)

Se indica una de las claves de la tabla. Es preferible que no tenga homónimos para facilitar la identificación de los registros en la lectura de la auditoría.

Si este campo no se completa, se tiene en cuenta la clave primaria.

  • Clave S-Data (campo ASDCLE)

 

Tabla Campos auditados

  • Campo (campo FLD)

Lista de campos para auditar. Si solo quiere trazar las operaciones de un registro sin trazar el contenido de los campos, deje la tabla en blanco. 

La traza de un registro modificado se obtiene cuando los nuevos valores del campo verifican al menos una de las condiciones de campo. La traza de un registro creado o suprimido se obtiene automáticamente.

  • Descripción (campo FLDDES)

 

  • Operador (campo FLDOPE)

 

  • Valor (campo FLDVAL)

 

Cerrar

 

Icono Acciones

Todos los campos

Permite alimentar la tabla de la pestaña Auditar con todos los campos de las tablas.

 

Cerrar

 

Limitaciones

Hay restricciones en la creación de una tabla. Las restricciones son las siguientes:


Relativas a la clave:

  • Limitada a un máximo de 15 índices.
  • Limitada a un máximo de 16 campos por índice.
  • Limitada a un máximo de 250 caracteres por índice.

Relativas al registro:

  • Limitado a 32 KB en Oracle y SQL Server.
  • Limitado a 255 campos por tabla.
  • Limitado a 512 columnas (campo1*dimensión1 + campo2*dimensión2+... + campoN*dimensiónN )
  • Limitado a un campo de tipo blob/clob independientemente del tamaño, o a varios campos (en este caso, el tamaño total de la tabla está limitado a 64 KB).

Número de tablas abiertas:

  • Limitado a 255 tablas.

Informes

Por defecto, los informes siguientes están asociados a la función :

 DICOX3 : Diccionario tablas

 ATABLIST : Lista de las tablas

Pero esto se puede modificar por parametrización.

Barra de menú

Esta función permite crear o actualizar la tabla de la base de datos a partir del diccionario. Si la tabla no existe, se crea sin datos. Si existe, la estructura de la tabla se actualiza de acuerdo con la nueva descripción que proporciona el diccionario (se añaden los nuevos campos, se eliminan los campos suprimidos, se copian de nuevo los campos cuya estructura o dimensión ha cambiado: los registros se almacenan en la tabla). Se puede realizar una validación forzada revalidando por completo los datos y los índices. Si no se indica esta opción y no ha cambiado la estructura de la tabla, solo se crean de nuevo los índices.

Puede proporcionar valores por defecto a los campos de la tabla de los registros ya existentes. Para ello, utilice el botón "Proceso" que se describe a continuación.

Permite crear un proceso temporal denominado WWINIXXX, donde XXX es la abreviatura de la tabla, que se ejecutará justo después de validar la tabla (si ya existe) para poder proporcionar valores por defecto a los campos de registro existentes. Al utilizar este botón, se propone un proceso por defecto y se pueden añadir instrucciones.

El proceso se compone de tres etiquetas:

 $OUVRE, que se ejecuta al principio, antes de comenzar la transacción de actualización, y que debe abrir al menos la tabla para la que se realiza la actualización (y eventualmente otras).

 $DEFAULT, que se ejecuta una vez iniciada la transacción, pero antes de leer el registro (hay que insertar al menos una instrucción Default File para que la tabla por defecto sea la tabla que se va a actualizar).

 $INIZON, que se ejecuta en cada registro justo antes de reescribirlo. En este subprograma es donde se pueden escribir las instrucciones de asignación de los campos de la tabla.

De esta forma, por ejemplo, si añade un campo numérico MICAMPO a la tabla y quiere que tenga el mismo valor que un campo OTRCAMPO ya existente en la tabla, superior en 1, se incluye en el proceso la siguiente línea:

           MICAMPO = OTRCAMPO + 1

Aviso:
El funcionamiento de este proceso es distinto al de las versiones anteriores de Adonix (por ejemplo, los utilizados en las versiones 2 y 3 de ADONIX ENTERPRISE). El proceso se ejecuta cuando acaba la fase de modificación de la estructura. Por lo tanto, si quiere renombrar un campo XXX llamándolo YYY, no es necesario realizar esta operación en dos etapas, guardando primero los dos campos en la base y realizando la asignación YYY=XXX en el proceso de inicialización. A continuación, se puede suprimir el campo XXX. Si intentáramos realizar esta operación en una sola etapa, el proceso no funcionaría y provocaría un error (el campo XXX no existiría). Por lo tanto, perdería su valor.

________________________________________________________________________________________________________

Los campos siguientes están en la ventana abierta por el botón :

Bloque Número 1

  • campo OBJET

 

  • campo CLES

 

Bloque Número 2

  • Desde el dossier (campo DOSORG)

Indica el dossier desde el que se va a copiar la ficha. Las posibles sintaxis se describen en el anexo dedicado.

  • Todos los dossieres (campo TOUDOS)

Esta opción permite copiar la ficha en todos los dossieres definidos en el diccionario (tabla ADOSSIER de la solución en curso).

  • Hacia el dossier (campo DOSDES)

Indica el dossier en el que se va a copiar la ficha. Las posibles sintaxis se describen en el anexo dedicado.

Cerrar

Este botón permite volver a copiar la definición de la tabla a otro dossier. Tenga en cuenta que solo se vuelve a copiar la descripción de la tabla del diccionario. La tabla no se crea en el dossier de destino (hay que validar esta descripción para que la tabla se cree). Por lo tanto, los datos de la tabla tampoco se vuelven a copiar.

Aviso: No se copian ni el campo NBENREG (Número de registros) ni los campos de la pestaña Auditar.

Esta función permite suprimir los datos de una tabla. Para mayor rapidez, la tabla se suprime y se vuelve a crear en blanco. Se solicita una confirmación, ya que esta operación es irreversible.

Este botón permite tanto suprimir la ficha del diccionario (comportamiento estándar de este tipo de botón) como suprimir físicamente la tabla de la base (equivalente a "Eliminar tabla").

 Ambas preguntas se realizan sucesivamente (ya que puede optar por cancelar únicamente la tabla sin borrar los datos del diccionario).

Barra de menú

Opciones/Informaciones

Esta función permite mostrar en un cuadro de información:

  • El número de campos de la tabla.
  • El espacio que ocupa (en bytes) una línea de la tabla (cuando se han completado todos los campos alfanuméricos).
  • El número de líneas de la tabla.

Opciones/Fuente

Permite visualizar el fichero *.srf que corresponde a la tabla en curso de la aplicación actual.
Esta opción es útil cuando trabaja en un servidor en el que no tiene los derechos requeridos para el directorio FIL.

Opciones/Mantenimiento

Esta opción de menú permite proceder directamente al mantenimiento de la tabla.

Mensajes de error

Además de los mensajes genéricos, los mensajes siguientes de error pueden aparecer durante la captura :

La tabla no contiene ningún campo

Se ha creado una tabla sin definir al menos un campo.

La tabla no contiene clave primaria

Cada tabla debe tener al menos un índice.

El campo descrito no está codificado

El título del campo introducido en la primera pestaña no existe en la lista de campos de la segunda pestaña.

Abreviatura ya existente

Las abreviaturas deben ser únicas en el dossier. Este mensaje aparece cuando intenta crear una tabla con una abreviatura que ya se utiliza en otra tabla.

Este mensaje de advertencia aparece cuando intenta introducir una abreviatura en una tabla que ya existe en otra vista. Por lo tanto, se recomienda utilizar abreviaturas únicas.

Carácter prohibido

Ha intentado utilizar el carácter '"' en un título (este carácter está prohibido).

El campo descrito no está codificado

En uno de los campos de la pestaña General se ha indicado un campo no definido en la pestaña Columnas.

Nº menú local incorrecto

La longitud es incorrecta en función del tipo interno del campo.

  • Menú local: longitud <= 30
  • Entero corto: longitud <= 4
  • Entero largo: longitud <= 8
  • Decimal: parte entera + parte decimal <= 32
  • Alfanumérico: longitud <= 250
  • Blob/clob:  longitud <= 20

Longitud incorrecta

El valor del campo de longitud es incorrecto (demasiado grande o nulo, por ejemplo).

Opción incorrecta

Ha intentado introducir una opción que no existe en la columna Opción asociada a un campo de la tabla.

Expresión de vínculo incorrecta

La sintaxis de la expresión de vínculo es incorrecta

Indice ya introducido

Se ha intentado definir dos veces el mismo índice en una tabla.

Campo inexistente

Ha referenciado un campo que no existe en la lista de campos en un índice.

Campo dimensionado

Ha intentado utilizar un campo dimensionado en un índice (prohibido).

Número de columnas demasiado elevado

Hay un límite de 512 columnas teniendo en cuenta la dimensión de los campos.

Número de campos demasiado elevado

Hay un límite de 255 columnas. Aquí no se tienen en cuenta las dimensiones.

Longitud de línea demasiado grande

Es el tamaño del registro.
En SQL, el límite es de 8 060 bytes.
En Oracle, es ilimitado, pero en Adonix está limitado a 32 K.

Clave demasiado larga

El tamaño de un índice no puede superar los 256 caracteres.

Demasiados componentes en la clave

Hay un límite de 16 campos por clave.

Sin texto traducible en esta tabla

Se ha intentado marcar la casilla "Generación textos traducibles" y la tabla principal gestionada por el objeto no contiene campos de tipo AXX, AX1, AX2 o AX3.

Esta modificación requiere la modificación de los informes Crystal vinculados a esta tabla.

Mensaje de advertencia. La modificación de la casilla "Génération texte traduisible" determina el método elegido para imprimir los textos traducidos en los informes Crystal Reports que utilizan esta tabla. Al modificar esta casilla, indicamos que queremos cambiar de método, de modo que hay que modificar los informes asociados a esta tabla. Por lo tanto, se recomienda no modificar este campo. 

Otros errores posibles

En la revalidación de la tabla (mediante la herramienta valfil), pueden aparecer otros errores. Estos errores se muestran en forma de fichero de traza. Entre los errores que pueden aparecer, se encuentran los siguientes:

  • Error de escritura (más espacio en disco)
  • Error Oracle/Error SQL SERVER (seguido del mensaje de error)

Tablas utilizadas

SEEREFERTTO Consulta la documentación de Puesta en marcha