Validaciones sobre plantillas

En Anjana Data existe la posibilidad de definir un conjunto de validaciones sobre los atributos de metadatos configurados en las plantillas de cada objeto. El objetivo de estas validaciones es asegurar la correcta entrada de datos y garantizar la coherencia, consistencia y control en la documentación de los activos de datos.

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

Estas validaciones se registran en la tabla Template Attribute Validations y permiten aplicar reglas sobre los atributos asignados a una plantilla concreta.

Tipos de validaciones soportadas

Las validaciones pueden cubrir distintas necesidades funcionales:

• Atributos obligatorios (REQUIRED)
  Identifican los atributos que obligatoriamente deben ser informados en una plantilla.

• Atributos no modificables (NOT_EDITABLE)
  Restringen la edición de un atributo, bloqueando su modificación en las plantillas.

• Dependencia entre valores (DEPENDS_ON)
  Vinculan los valores de un atributo tipo selector (SELECT, SELECT_IMG, SELECT_IMG_TXT, MULTI_SELECT, etc.) con el valor escogido en otro atributo.

• Herencia de valor (HERITABLE)
  Identifican atributos booleanos cuyo valor se hereda de otros objetos relacionados según el metamodelo (ej.: un dataset hereda el valor booleano true que indica que tiene datos personales si alguno de sus dataset field lo tiene a true). La herencia sólo puede darse entre entidades que tengan un parentesco según el metamodelo nativo de Anjana Data, es decir, los siguientes casos:

  • Atributos de DATASET heredan valores boleanos de atributos de DATASET FIELD.

  • Atributos de DSA heredan valores boleanos de atributos de las entidades contenidas en el atributo dsaContent.

  • Atributos de INSTANCE heredan valores boleanos de atributos de las entidades contenidas en el atributo datasetsinputininstance y datasetsoutputininstance .

• Rangos de valores (MIN / MAX)
  Definen valores mínimos y máximos para atributos numéricos.

• Longitudes de cadenas (MIN_LENGTH / MAX_LENGTH)
  Establecen restricciones número de caracteres en atributos de texto corto/largo.

• Precisión decimal (MIN_DECIMAL_PRECISION / MAX_DECIMAL_PRECISION)
  Definen el número mínimo o máximo de decimales en atributos decimales.

• Restricciones en arrays (MIN_LENGTH_ARRAY / MAX_LENGTH_ARRAY)
  Controlan la cantidad mínima o máxima de valores en atributos multivalor.

• Filtro de subtipos (SUBTYPE_FILTER)
  Limita los subtipos de entidades que pueden asociarse en atributos de tipo ENTITY_CONTAINER, ENTITY_SEARCH o ARRAY_ENTITY.

• Tipo de relación (RELATIONSHIP_TYPE)
  Determina la relación nativa que se crea automáticamente a partir de un atributo ENTITY_CONTAINER .

Matriz de validaciones por tipos de atributos

Estructura de la tabla Template Attribute Validations

Cada validación registrada se caracteriza por los siguientes elementos:

• templateAttribute: Identificador único de un atributo dentro de la plantilla del objeto para el que se define la validación.

• key: clave de la validación. Debe corresponder con uno de los siguientes valores:

  • DEPENDS_ON: dependencia con otro atributo de la misma plantilla. Se configura para el atributo destino, es decir, el atributo cuyos valores de referencia aparecen pre-filtrados en función de los valores seleccionados en el atributo del cual depende.

    • Aplica a: atributos de selección de valores (SELECT, SELECT_IMG, SELECT_IMG_TXT, MULTI_SELECT, MULTI_SELECT_IMG, MULTI_SELECT_IMG_TXT, TREE_SELECT, TREE_MULTISELECT)

  • HERITABLE: en el caso de que su valor se herede de otro metadato.

    • Aplica a: atributos booleanos (INPUT_CHECKBOX) y arrays booleanos (ARRAY_BOOLEAN).

  • MAX: número máximo.

    • Aplica a: atributos numéricos (INPUT_NUMBER, INPUT_DECIMAL, INPUT_RANGE, ARRAY_NUMBER, ARRAY_DECIMAL).

  • MIN: número mínimo.

    • Aplica a: atributos numéricos (INPUT_NUMBER, INPUT_DECIMAL, INPUT_RANGE, ARRAY_NUMBER, ARRAY_DECIMAL).

  • MAX_DECIMAL_PRECISION: número máximo de precisión para valores decimales.

    • Aplica a: atributos decimales (INPUT_DECIMAL, ARRAY_DECIMAL).

  • MIN_DECIMAL_PRECISION: número mínimo de precisión para valores decimales.

    • Aplica a: atributos decimales (INPUT_DECIMAL, ARRAY_DECIMAL).

  • MAX_LENGTH: longitud máxima en número de caracteres.

    • Aplica a: atributos de texto (INPUT_TEXT, TEXT_AREA, ENRICHED_TEXT_AREA, INPUT_TEXT_INTERNATIONAL, TEXT_AREA_INTERNATIONAL, ENRICHED_TEXT_AREA_INTERNATIONAL, ARRAY_ALPHANUMERICAL).

  • MIN_LENGTHMIN_LENGTH: longitud mínima en número de caracteres.

    • Aplica a: atributos de texto (INPUT_TEXT, TEXT_AREA, ENRICHED_TEXT_AREA, INPUT_TEXT_INTERNATIONAL, TEXT_AREA_INTERNATIONAL, ENRICHED_TEXT_AREA_INTERNATIONAL, ARRAY_ALPHANUMERICAL).

  • MAX_LENGTH_ARRAY: cantidad máxima de elementos de array.

    • Aplica a: atributos multivalor (ARRAY_BOOLEAN, ARRAY_DATE, ARRAY_NUMBER, ARRAY_DECIMAL, ARRAY_ALPHANUMERICAL, ARRAY_UPLOAD_FILE, ARRAY_UPLOAD_URL, MULTI_SELECT, MULTI_SELECT_IMG, MULTI_SELECT_IMG_TXT, MULTI_USERS, MULTI_ORGANIZATIONAL_UNIT, TREE_MULTISELECT).

  • MIN_LENGTH_ARRAY: cantidad mínima de elementos de array.

    • Aplica a: atributos multivalor (ARRAY_BOOLEAN, ARRAY_DATE, ARRAY_NUMBER, ARRAY_DECIMAL, ARRAY_ALPHANUMERICAL, ARRAY_UPLOAD_FILE, ARRAY_UPLOAD_URL, MULTI_SELECT, MULTI_SELECT_IMG, MULTI_SELECT_IMG_TXT, MULTI_USERS, MULTI_ORGANIZATIONAL_UNIT, TREE_MULTISELECT).

  • NOT_EDITABLE: no modificable.

    • Aplica a: todos los tipos de atributos

  • RELATIONSHIP_TYPE: subtipo de relación que se crea

    • Aplica a: atributos nativos de tipo ENTITY_CONTAINER

  • REQUIRED: atributo obligatorio

    • Aplica a: todos los tipos de atributos

  • SUBTYPE_FILTER: subtipo de entidad permitida.

    • Aplica a: atributos de tipo entidad (ENTITY_CONTAINER, ENTITY_SEARCH, ARRAY_ENTITY)

• params: parámetros a completar en función de la siguiente tabla

Alta de una validación en la tabla Template Attribute Validations

El alta de una nueva validación en una plantilla implica registrar en la tabla Template Attribute Validations un nuevo registro que vincula un atributo de plantilla con una regla de validación.

Para añadir el registro y dar de alta una nueva validación:

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

2. Completar los campos conforme a la estructura descrita:

   • templateAttribute: seleccionar el atributo de plantilla al que se desea asociar la validación (p.e: 10383-destination-GENERA).

   • key: seleccionar la clave de la validación que se aplicará (p.e: SUBTYPE_FILTER).

   • params: indicar los parámetros necesarios para la validación seleccionada.
     En este ejemplo, se limita el destino de la relación únicamente a determinados subtipos de entidad, listados en el campo separados por _- y sin espacios:

     AI_MODEL_-AGENTE_LLM_-MODELO_ML
     

     Esto implica que el atributo destination de la relación GENERA solo permitirá como destino entidades de tipo AI_MODEL, AGENTE_LLM o MODELO_ML.

3. Pulsar en Save para guardar la validación o en Cancel para descartar.

Modificación de una validación sobre un atributo de la plantilla en la tabla Template Attribute Validations

La modificación de una validación existente en una plantilla se gestiona desde la tabla Template Attribute Validations en el Panel de configuración.

Consideraciones importantes

• Únicamente es posible modificar el campo params de una validación ya creada.

• Los campos templateAttribute y key no son editables.

• Si es necesario cambiar el atributo de plantilla asociado (templateAttribute) o la clave de la validación (key), se debe eliminar la validación existente y crear una nueva con los valores correctos.

Procedimiento para modificar los params

1. Localizar la validación que se desea editar en la tabla Template Attribute Validations.

2. Pulsar el botón Editar (icono verde).

3. En el asistente (wizard), modificar el valor del campo params según corresponda a la regla de validación seleccionada.

   Ejemplos:

   • Para una validación de tipo SUBTYPE_FILTER , actualizar la lista de subtipos de entidad permitidos, separados por _- y sin espacios (ejemplo: AI_MODEL_-MODELO_ML).

   • Para una validación de tipo MAX_LENGTH, ajustar el número máximo de caracteres (ejemplo: 300000).

   • Para una validación de tipo HERITABLE, indicar si aplica herencia con el valor HIGH o LOW.

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

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

Las validaciones de los atributos de cada plantilla se almacenan en la tabla anjana.template_attribute_validation.

A continuación se muestra un script de ejemplo para configurar varias validaciones sobre el atributo destination de la relación GENERA:

INSERT INTO anjana.template_attribute_validation
  (id_template_attribute, validator_key, validator_params)
VALUES
  (10383, 'NOT_EDITABLE',   'true'),
  (10383, 'REQUIRED',       'true'),
  (10383, 'SUBTYPE_FILTER', 'AI_MODEL_-AGENTE_LLM_-MODELO_ML_DL');