Configuración
Breadcrumbs

Asignación de atributos a plantillas

Configurar las plantillas de metadatos supone definir en qué menú y sección se mostrarán los atributos de metadatos previamente definidos en la tabla Attribute Definitions.

image-20250904-155002.png
Ejemplo de plantilla de DATASET con variedad de menús, secciones y atributos de metadatos con validaciones

Tabla Template Attribute del Panel de Configuración (Visión administrador)

La asociación de metadatos a secciones se gestiona en la tabla Template Attribute y permite construir los formularios dinámicos de cada subtipo de entidad o relación del metamodelo.

image-20250908-170528.png
Tabla Template Attribute para confeccionar las plantillas de las entidades y relaciones del metamodelo

Estructura de la tabla Template Attribute

Cada registro de atributo de plantilla se caracteriza por los siguientes campos:

  • Id: identificador único del atributo de plantilla.

    • Se asigna automáticamente desde el Panel de configuración.

  • active: flag que indica si el atributo está activo en la plantilla del objeto.

    • Si active = true, el atributo se muestra y es editable (si el usuario tiene permisos).

    • Si active = false, el atributo deja de estar disponible en el Portal de Datos. Los objetos que lo tuvieran previamente informado conservarán el valor, pero este será invisible y no modificable.

    • Si posteriormente se vuelve a activar, reaparecerá en el formulario con el valor previamente guardado.

    • ⚠️ Excepción: en la plantilla de ADHERENCE, los atributos de metadatos siempre debe ser false porque la plantilla de este objeto no es visible.

Nota: El flag active = false es el mecanismo de borrado lógico de atributos dentro de las plantillas que se debe implementar cuando hay objetos gobernados.

  • isVisible: flag que indica si el atributo se muestra en la tabla Structure de la pantalla del dataset. (Solo aplica en la plantilla de DATASET FIELD). No afecta a la visibilidad en la plantilla de metadatos.

    • Para atributos de la plantilla DATASET_FIELD → aplicar true (para hacerlo visible) o false (para ocultarlo) según convenga.

    • Para atributos de ADHERENCE → siempre false.

    • Para cualquier otra plantilla → siempre true.

  • sort: orden de visualización del atributo dentro de la sección a la que pertenece (1, 2, 3, …).

  • attributeDefinitions: referencia al atributo definido en la tabla attribute Definitions que se va a incluir en la plantilla.

  • section: sección en la que se agrupa el atributo dentro del formulario.

    • Corresponde a un valor de la tabla Sections.

Notas importantes:

  • Un mismo atributo no puede aparecer más de una vez en la misma plantilla.

  • Los atributos indicados como Atributos Obligatorios deben configurarse en las plantillas de las entidades y relaciones correspondientes (incluyendo la relación ADHERENCE).

Alta de un atributo en la plantilla de un objeto mediante la tabla Template Attributes

El alta de nuevos atributos en una plantilla se realiza desde el Panel de configuración, en la tabla Template Attributes.

image-20250909-134710.png
Ejemplo de alta de un nuevo atributo en una sección de la plantilla de DATASET
  1. Pulsar el botón New en la esquina superior derecha. Esto abrirá un asistente (wizard) con los campos definidos en el apartado Estructura de la tabla Template Attributes.

  2. Completar los campos conforme a la estructura descrita:

    • sort: posición que ocupará el atributo dentro de la sección (ej.: 1).

    • atributeDefinition: seleccionar el atributo que se desea añadir a la plantilla (ej.: 10321-nivelRiesgo-SELECT).

    • section: seleccionar la sección en la que se mostrará el atributo (ej.: 1031-RIESGOS-AI_MODEL).

    • active: marcar si se quiere que el atributo esté habilitado en la plantilla.

    • isVisible: marcar según corresponda (ver reglas anteriores).

  3. Pulsar Save para guardar o Cancel para descartar.

Nota: Tras el alta de atributos, es necesario ejecutar la acción Clear cache desde el Panel de configuración (Actions > Clear cache) para que los cambios sean visibles en el Portal de Datos.


Modificación de un atributo en la plantilla de un objeto mediante la tabla Template Attributes

La modificación de un atributo ya asignado a una plantilla se gestiona desde la tabla Template Attributes en el Panel de configuración. Esta operación debe realizarse con precaución, ya que puede tener impacto en la visualización y edición de metadatos en el Portal de Datos.

Campos que pueden modificarse:

  • sort: permite cambiar el orden de aparición del atributo dentro de la sección.

  • active: permite activar o desactivar (borrado lógico) un atributo de la plantilla en cualquier momento.

    • Si se desactiva (false), el atributo deja de estar disponible en la plantilla, aunque el valor que tuviera asignado se mantiene en la base de datos.

    • Si se activa (true), el atributo mostraría el valor que tuviera asignado de forma previa a la desactivación.

  • isVisible: puede modificarse libremente.

    • Si se marca en la plantilla de DATASET_FIELDS, el atributo será visible en la pestaña de Estructura del Portal de Datos. En cualquier otra plantilla, se trataría de un error de configuración.

    • Si se desmarca en la plantilla de DATASET_FIELDS, el atributo dejará de ser visible en la pestaña de Estructura del Portal de Datos.

  • section: puede modificarse siempre y cuando se trate de una sección que pertenece al mismo subtipo de objeto. Nunca se debe cambiar entre secciones de objetos diferentes.

Campos que no pueden modificarse si existen activos gobernados:

  • atributeDefinition: una vez creado el registro, no puede sustituirse por otro atributo.

Procedimiento de modificación:

  1. Pulsar el botón de edición en la fila del atributo que se desee modificar.

  2. Ajustar los campos permitidos (sort, active , isVisible o section).

  3. Pulsar Save para guardar los cambios o Cancel para descartarlos.

Nota: Tras la modificación de atributos en una plantilla, es necesario ejecutar la acción Clear cache desde el Panel de configuración (Actions > Clear cache) para que los cambios se apliquen y sean visibles en el Portal de Datos.

Asignación de atributos a las plantillas mediante acceso directo a la base de datos (Visión desarrollador)

La asignación de atributos a las plantillas se almacena en la tabla anjana.template_attribute.

Columna

Tipo

Restricciones / Notas

id_template_attribute

int4

PRIMARY KEY. Identificador del registro (gestión por secuencia).

active

bool

NOT NULL. Si true, el atributo está operativo en la plantilla. Si false, queda deshabilitado (no visible/editable en formularios).

is_visible

bool

Puede ser NULL. Controla visibilidad en la UI (oculto/visible) cuando el registro está activo.

sort

int4

Orden de aparición del atributo dentro de la sección (1, 2, 3, …).

id_attribute_definition

int4

NOT NULL. FK a anjana.attribute_definition(id_attribute_definition). Atributo que se incluye.

id_section

int4

NOT NULL. FK a anjana.sections(id_section). Sección de la plantilla donde se mostrará.

A continuación se muestra un script de ejemplo para añadir el nivel de riesgo en la plantilla de un Sistema de IA:

INSERT INTO anjana.template_attribute
(id_template_attribute, active, is_visible, sort, id_attribute_definition, id_section)
VALUES(10371, true, true, 1, 10321, 1031);

Importante:

  • Una vez ejecutado el insert, ejecutar la actualización de secuencias de la tabla. (Desde el Panel de configuración en Actions > Reset DQ sequences se pueden actualizar las secuencias de todas las tablas, incluida esta).

  • Todo el peso de la lógica de configuración recae en el desarrollador que ejecuta las queries SQL directamente sobre la tablas. Se recomienda revisar cuidadosamente el apartado de Estructura.