Configuración
Breadcrumbs

Valores de referencia

En Anjana Data, los atributos de tipo selección (por ejemplo: listas desplegables, combos o taxonomías) requieren una configuración adicional para definir los valores posibles que podrá elegir el usuario.

image-20250905-112451.png
Ejemplo de valores de referencia conforme a la taxonomía de Riesgos de la AI Act

Estos atributos son aquellos cuyo Type corresponde a:

  • SELECT

  • SELECT_IMG

  • SELECT_IMG_TXT

  • TREE_SELECT

  • MULTI_SELECT

  • MULTI_SELECT_IMG

  • MULTI_SELECT_IMG_TXT

  • TREE_MULTISELECT

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

La configuración de estos valores de referencia se realiza en la tabla Attribute Definition Values, donde se almacenan los metadatos de referencia que aparecerán como opciones seleccionables en el Portal de Datos.

image-20250905-115322.png
Tabla Attribute Definition Values para alta de valores de referencia

Estructura de la tabla Attribute Definition Values

Cada valor registrado en esta tabla se caracteriza por los siguientes campos:

  • Id: identificador único del valor.

    • Se asigna automáticamente desde el Panel de configuración, en base a las secuencias de base de datos.

  • value: valor del atributo que se mostrará en la lista de selección.

    • En caso de internacionalización, debe utilizarse el propio value como clave de traducción en la tabla translations, generando un registro por cada idioma configurado.

    • Para atributos de tipo SELECT_IMG, SELECT_IMG_TXT, MULTI_SELECT_IMG o MULTI_SELECT_IMG_TXT, el icono a utilizar debe almacenarse en Minio o S3, con nombre formado por la concatenación:

      <name del attribute_definition>_<value>.svg
      

      (ejemplo: nivelGobierno_Gold.svg).

      image-20250905-113019.png
      Ejemplo de nomenclatura para iconos correspondientes a atributos de tipo imagen
  • attributeDefinition: referencia al atributo de metadatos al cual pertenecen los valores (hace referencia a los atributos definidos en Attribute Definitions).

Alta de un nuevo valor para un atributo en la tabla Attribute Definition Values

El alta de un nuevo valor implica añadir un registro en la tabla Attribute Definition Values para un atributo previamente definido en Attribute Definitions.

image-20250905-120115.png
Ejemplo de alta de un nuevo valor de referencia para el atributo Nivel de Riesgo

Para añadir un nuevo valor:

  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.

  2. Completar los campos conforme a la estructura descrita:

    • value: con el valor o su clave de traducción (ejemplo: Inaceptable - Sistema de IA prohibido).

    • attributeDefinition: seleccionar el atributo al que pertenece el valor (ejemplo: 10321-nivelRiesgo-SELECT).

  3. Pulsar en Save para guardar o en Cancel para descartar.

Nota: Tras el alta de valores, 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.

Modificación de un valor de un atributo en la tabla Attribute Definition Values

La modificación de un valor ya existente debe realizarse con precaución, ya que puede impactar tanto en la información mostrada en el Portal de Datos como en la consistencia de los metadatos configurados.

Los campos de esta tabla son sensibles y requieren que los cambios se apliquen siguiendo un orden adecuado:

Caso 1: No existen activos gobernados en el Portal de Datos:

  • La modificación del campo value requiere ejecutar los siguientes pasos en orden:

    1. Modificar el texto directamente o, si está internacionalizado, actualizar también los registros en la tabla Translations. En este caso, se debe decidir si basta con cambiar únicamente el valor de traducción (value) o si también es necesario ajustar la clave (config_key).

    2. Revisar y, en caso necesario, modificar las configuraciones existentes en la tabla Edition Configuration.

    3. Si el atributo es de tipo SELECT_IMG, SELECT_IMG_TXT, MULTI_SELECT_IMG o MULTI_SELECT_IMG_TXT, y el cambio de value implica un nuevo icono, será necesario subir el fichero correspondiente a Minio o S3 siguiendo la nomenclatura establecida:

      <name del attribute_definition><value>.svg
      
  • La modificación del campo attributeDefinition puede realizarse si no hay activos gobernados.

Si existen activos gobernados en el Portal de Datos:

  • La modificación del campo value requiere ejecutar los siguientes pasos en orden:

    1. Modificar el texto directamente o, si está internacionalizado, actualizar también los registros en la tabla Translations. En este caso, se debe decidir si basta con cambiar únicamente el valor de traducción (value) o si también es necesario ajustar la clave (config_key).

    2. Revisar y, en caso necesario, modificar las configuraciones existentes en la tabla Edition Configuration.

    3. Ejecutar una Edición masiva de atributos desde el Portal de Datos para forzar la actualización de los valores en todas las plantillas afectadas.

    4. Si el atributo es de tipo SELECT_IMG, SELECT_IMG_TXT, MULTI_SELECT_IMG o MULTI_SELECT_IMG_TXT, y el cambio de value implica un nuevo icono, será necesario subir el fichero correspondiente a Minio o S3 siguiendo la nomenclatura establecida:

      <name del attribute_definition><value>.svg
      
  • La modificación del campo attributeDefinition no puede realizarse cuando ya existen activos gobernados.

Nota: Tras la modificación, 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.


Configuración de valores de referencia mediante acceso directo a la base de datos (Visión desarrollador)

La tabla que almacena los valores de los atributos de selección es anjana.attribute_definition_value.

Columna

Tipo

Restricciones / Notas

id_attribute_definition_value

int4

PRIMARY KEY. Identificador del valor. Gestionado por secuencias.

id_attribute_definition

int4

FKattribute_definition(id_attribute_definition). Indica a qué atributo pertenece el valor.

value

varchar(255)

Texto del valor mostrado/clave de traducción. No nulo.

A continuación se muestra un script de ejemplo para configurar valores de referencia atributo de tipo SELECT para establecer el nivel de riesgo de un sistema de IA:

INSERT INTO anjana.attribute_definition_value
(id_attribute_definition_value, id_attribute_definition, value)
VALUES
  (2124, 10321, 'Inaceptable - Sistema de IA prohibido'),
  (2125, 10321, 'Alto - Sistema de IA de alto riesgo'),
  (2126, 10321, 'Limitado - Sistema de IA con obligaciones de transparencia'),
  (2127, 10321, 'Mínimo - Sistemas de IA de riesgo mínimo');

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.