Atributos de metadatos

En Anjana Data, los atributos de metadatos son las unidades básicas de información que describen a los objetos (entidades y relaciones) gobernados en la plataforma. Estos atributos permiten documentar de manera estructurada las características técnicas, funcionales y de gobierno de cada activo, facilitando la búsqueda, clasificación y control de calidad entre otros.

Los atributos se configuran en la tabla Attribute Definitions, y pueden ser reutilizados en distintas plantillas de metadatos, aunque nunca pueden aparecer más de una vez en la misma plantilla.

Gracias a esta modularidad, la organización puede crear un catálogo consistente de atributos reutilizables que soporten su modelo de gobierno.

En Anjana Data los distintos tipos de atributos de metadatos soportados son los siguientes:

• Array de boolean: atributo para indicar uno o varios valores ‘true’ o ‘false’

• Array de date: atributo para indicar uno o varias fechas

• Array de decimal: atributo para indicar uno o varios números decimales

• Array de entities: atributo para elegir una o varias entidades aprobadas en Anjana

• Array de file: atributo para adjuntar uno o varios ficheros

• Array de number: atributo para indicar uno o varios números enteros

• Array de Organizational Unit: atributo para seleccionar una o varias unidades organizativas del listado de todas ellas

• Array de text: atributo para introducir uno o varios textos cortos de hasta 255 caracteres

• Array de URL: atributo para introducir uno o varios links a URLs navegables

• Array de users: atributo para elegir uno o varios usuario de la lista completa de usuarios de la aplicación

• Boolean: ‘true’ o ‘false’

• Date: fecha (año, mes, día, hora y minutos)

• Decimal: número con decimales

• Enriched Text Area: atributo para introducir un texto largo de hasta 300 mil caracteres enriquecido con formato (negrita, subrayados, cursivas, etc)

• Entity Container: atributo para elegir una entidad aprobada en Anjana Data y generar relaciones nativas entre entidades. Sólo es posible utilizar este atributo en las entidades DSA, instancia y solución

• Entity Search: atributo para elegir una entidad aprobada en Anjana Data

• File: fichero que se almacena internamente en Anjana Data. También se permite descargar el fichero si se tiene permisos de lectura

• International Text: cuadro de texto normal disponible para los distintos tipos de idiomas disponibles de la aplicación

• International Text Editor: atributo para introducir un texto largo de hasta 300 mil caracteres enriquecido con formato (negrita, subrayados, cursivas etc) disponible para los distintos tipos de idiomas disponibles de la aplicación

• International Textarea: atributo para introducir un texto largo de hasta 300 mil caracteres en los distintos idiomas disponibles para la aplicación

• MultiSelect: atributo para seleccionar uno o varios valores de una lista preconfigurada en la pestaña Reference Metadata

• MultiSelect con iconos: atributo para seleccionar uno o varios iconos de una lista preconfigurada en la pestaña Reference Metadata

• MultiSelect con iconos y texto: atributo para seleccionar uno o varios valores (icono+texto) de una lista preconfigurada en la pestaña Reference Metadata

• Number: atributo para indicar un número entero

• Number range: selector de número entero entre un mínimo y un máximo definidos

• Organizational Unit: atributo para seleccionar una unidad organizativa del listado de todas ellas

• Reference Metadata: lista de valores posibles que se tiene que definir para el atributo

• Selector con icono: lista de iconos posibles que se tiene que definir para el atributo

• Selector con icono y texto: lista de valores (icono+texto) posibles que se tiene que definir para el atributo

• Taxonomía única: árbol de taxonomía

• Taxonomía de selección múltiple: árbol de taxonomías donde se pueden seleccionar uno o varios valores

• Text: cuadro de texto normal

• Text Area: atributo para introducir un texto largo de hasta 300 mil caracteres

• URL: texto considerado como una URL para que el usuario pueda clicar sobre el atributo y se abra una nueva pestaña con esa URL

• User: lista completa de usuarios de Anjana Data

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

Las secciones se configuran en la tabla Sections del Panel de configuración. La definición de las secciones es el segundo paso, tras la creación de los menús, para estructurar las plantillas de metadatos.

Estructura de la tabla Attribute Definitions

Cada atributo registrado se caracteriza por los siguientes campos:

• Id: identificador único del atributo.

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

• Name: nombre interno del atributo.

• Type: tipo de atributo.

  • Determina la naturaleza del dato que se podrá almacenar (texto, número, fecha, usuario, unidad organizativa, fichero, taxonomía, etc.).

  • Ver tabla de equivalencias más abajo.

• Label: etiqueta visible del atributo en los formularios de metadatos.

  • Puede configurarse para internacionalización usando su valor como config_key en la tabla translations, con un registro por cada idioma activo en la aplicación.

• Place Holder: texto de ejemplo que se muestra cuando el campo está vacío.

  • Puede configurarse para internacionalización en translations.

• shortDescription: descripción breve del propósito del atributo.

  • Campo opcional, pensado para ayudar a administradores y validadores en la comprensión del atributo.

• Descritpion: descripción más extensa del atributo.

  • Puede usarse para detallar instrucciones o contexto adicional y es visible dentro de la plantilla en la junto al nombre del atributo.

  • Al igual que Label y Place Holder, puede configurarse como clave de traducción.

Consideraciones especiales por tipo de atributo

• Atributos de tipo SELECT, SELECT_IMG, SELECT_IMG_TXT, TREE_SELECT, MULTI_SELECT, MULTI_SELECT_IMG, MULTI_SELECT_IMG_TXT y TREE_MULTISELECT:

  • Requieren definir los valores posibles en la tabla Attribute Definition Value.

    

• Atributos de tipo INPUT_RANGE

  • Deben tener validaciones de mínimo y máximo configuradas para que funcione el selector de rango.

  • En ausencia de validaciones, se aplican los valores por defecto:

    • MIN_RANGE y MAX_RANGE, definidos en la tabla appConfiguration del Panel de Configuración.

• Atributos de tipo ENRICHED_TEXT_AREA y ENRICHED_TEXT_AREA_INTERNATIONAL

  • Admiten subida de ficheros con extensiones: .gif, .png, .jpg con restricciones de tamaño.

Atributos de clave primaria

Algunas entidades del metamodelo requieren un conjunto mínimo de atributos que actúan como clave primaria.

• Dataset: name, infrastructure, path, technology, zone.

• Dataset field: name, infrastructure, path, technology, zone.

• DSA: name.

• Proceso: name, infrastructure, path, technology, zone.

• Instancia de proceso: name, processAri, solutionAri.

• Solución: name.

• Entidades no nativas definidas por cliente: name.

• Relaciones: name, source, destination.

Atributos obligatorios

Algunos atributos son obligatorios para que Anjana Data funcione correctamente, ya que la plataforma tiene lógica interna asociada a ellos.

• El campo name debe coincidir exactamente con los nombres esperados.

• El campo attribute_type debe tener un valor específico.

• Cada atributo obligatorio solo debe aplicarse en las entidades o relaciones que se detallan en la tabla de obligatoriedad.

• Añadirlos en otros objetos puede provocar errores en la aplicación.

Atributos obligatorios para entidades

En la siguiente tabla se explica la finalidad y tipología de los atributos indicados en la tabla anterior:

Atributos obligatorios para relaciones

Atributos obligatorios no referenciados en plantillas

Algunos atributos internos y de carácter reservado deben estar incluidos en Attribute Definition para el correcto funcionamiento de la plataforma.

Alta de un atributo en la tabla Attribute Definitions

El alta de un nuevo atributo de metadatos implica registrar en la tabla Attribute Definitions un nuevo campo que podrá ser reutilizado en diferentes plantillas de entidades o relaciones.

Para añadir un nuevo atributo:

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 Attribute Definitions.

2. Completar los campos del atributo conforme a la estructura descrita:

   • Name: nombre interno del atributo (ej.: nivelRiesgo).

   • Type: tipo de atributo (ej.: SELECT).

   • Label: etiqueta visible en el formulario. En caso de internacionalización, se debe dar de alta también en la tabla translations para cada idioma.

   • Place Holder: texto de ejemplo cuando el campo está vacío (opcional). En caso de internacionalización, se debe dar de alta también en la tabla translations para cada idioma.

   • shortDescription: descripción breve del atributo (opcional).

   • Description: descripción más extensa o instrucciones de uso. En caso de internacionalización, se debe dar de alta también en la tabla translations para cada idioma. (ej.: (PD) Indica el nivel de riesgo que supone el modelo de acuerdo con la taxonomía de la regulación europea).

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

Modificación de un atributo en la tabla Attribute Definitions

La modificación de un atributo en la tabla Attribute Definitions debe realizarse con especial precaución, ya que puede tener distintos impactos en las plantillas donde el atributo esté siendo utilizado y en los objetos ya creados en el Portal de Datos.

Campos que pueden modificarse sin impacto elevado:

• Label, Place Holder, Description y shortDescriptionpueden ajustarse, ya que solo se utilizan como apoyo informativo en los formularios:

  • Si no se ha configurado internacionalización, los textos pueden modificarse directamente.

  • Si existe internacionalización, la modificación debe realizarse en la tabla translations, asegurando que las config_key correspondientes (definidas a partir del Label/Place Holder originales) siguen siendo consistentes.

Campos cuya modificación requiere precaución:

• Type: no se recomienda modificar el tipo de un atributo una vez que este se encuentra en uso, ya que:

  • Puede invalidar validaciones configuradas en las plantillas.

  • Puede generar inconsistencias en la indexación de Solr si el tipo nuevo no es compatible con el anterior (ejemplo: cambiar un atributo numérico a alfanumérico).

  • Si es absolutamente necesario cambiarlo, seguir las recomendaciones del apartado de FAQ.

• Name: nunca debe cambiarse si el atributo ya está en uso en alguna plantilla, ya que:

  • Puede generar inconsistencias en la indexación de Solr

  • Puede generar inconsistencias en la configuración de Filtros (tabla Filter Confs) .

  • Puede generar inconsistencias en la configuración de validaciones de tipo Depends On (tabla Template Attribute validations) .

  • Podrían producirse errores en workflows.

  • Si fuera imprescindible cambiarlo, sería necesario ejecutar un Clear data en el Panel de configuración (Actions > Clear data) y reindexar toda la información.

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

La parametrización de los atributos de metadatos también puede realizarse directamente sobre la base de datos, en la tabla anjana.attribute_definition. Esta tabla contiene la definición de todos los atributos reutilizables en las plantillas de entidades y relaciones del metamodelo.

A continuación se muestra un script de ejemplo para configurar un atributo de tipo SELECT para catalogar el nivel de riesgo de un Sistema de IA:

INSERT INTO anjana.attribute_definition
(id_attribute_definition, description, "label", last_modified_date, "name", place_holder, short_description, start_date, attribute_type)
VALUES(10321, '(PD) Indica el nivel de riesgo que supone el modelo de acuerdo con la taxonomía de la regulación europea', 'Nivel de riesgo', '2024-10-11 11:41:09.720', 'nivelRiesgo', NULL, NULL, '2024-10-11 11:41:09.720', 'SELECT');