DSA

Esta página describe el objeto DSA (Data Sharing Agreement) de Anjana Data Platform. Recoge, por un lado, los atributos que forman su clave primaria (PK) —y que componen su ARI, identificador con el que cada objeto se representa de forma unívoca en Anjana— y, por otro, las pestañas que muestran la información del objeto en su detalle.

Clave primaria (PK) y ARI

Cada objeto de Anjana Data Platform se identifica de forma unívoca mediante su ARI (Anjana Resource Identifier), que se construye a partir de los atributos que forman su clave primaria (PK). En el caso del DSA, el atributo que forma la PK —con su nomenclatura interna entre paréntesis— es:

• nombre (name)

La ARI incluye además la unidad organizativa (organizationalUnit) del objeto. Por ejemplo, para un DSA con ID 83:

ANJA:OBJECT:ENTITY:DSA:83:Facturación:Europe/SPA/Finance

donde la estructura es:

ANJA:OBJECT:ENTITY:DSA:<idDSA>:<nombre>:<unidad organizativa>

NOTAS:

• El atributo nombre (name) no debe contener el carácter ‘:’, ya que es el separador de los componentes de la ARI e interferiría en la lógica interna de la aplicación.

• Para garantizar que los campos que componen la ARI no sean editables, es responsabilidad del administrador configurar dichos atributos en las plantillas con las validaciones de “no editable”. Cualquier intervención manual para modificar estos valores romperá la integridad referencial del objeto.

• El valor de organizationalUnit que aparece en la ARI no tiene por qué coincidir con el que visualiza el usuario en la plantilla. Si se ha configurado el multi-idioma, la clave de traducción es la que forma parte de la ARI, mientras que el usuario ve en la plantilla el valor de traducción de esa clave para el idioma seleccionado en su perfil.

Pestañas del detalle

El detalle de un DSA se organiza en varias pestañas, cada una con un tipo de información del objeto. Al acceder al detalle, la pantalla que se muestra por defecto es la de Atributos.

Atributos

Cuando un usuario accede al detalle de un DSA, la pantalla que se muestra es la de Atributos, donde el usuario puede acceder a los diferentes atributos funcionales, técnicos, operacionales, etc., que se hayan definido en la plantilla, dentro de los correspondientes menús y secciones así como los atributos específicos que no forman parte de la plantilla pero se han incluido en el DSA en particular.

La plantilla de DSA debe contener un atributo donde incluir los términos del contrato del DSA. Este contrato determinará el uso que harán los usuarios adheridos al DSA de los datos de los datasets. Este atributo puede definirse en cualquier menú y sección de la plantilla del DSA y puede ser tanto de tipo Fichero como de tipo URL. Internamente en Anjana este atributo es ‘termCondFile’.

Otro atributo que debe contener el DSA es la lista de las entidades que va a englobar ese DSA. Este atributo puede definirse en cualquier menú y sección de la plantilla del DSA y debe ser de tipo ENTITY_CONTAINER. El nombre de este atributo es ‘dsa_content’.

NOTAS:

• Puesto que el DSA se corresponde con un grupo en el gestor de identidades hay restricciones en los nombres de éstos:

  • GCP IAM no permite grupos cuyos nombres contengan = < > &

  • Azure no permite "/ \\ [ ] : | < > + = ; ? * , y que no termine en .

  • AWS IAM sólo permite nombres formados por letras, números y los siguientes caracteres: + = , . @ _ y -

  • Para el protocolo LDAP es recomendable que los nombres contengan letras, dígitos y -. Conviene, además, revisar la implementación usada del protocolo por limitaciones específicas

Relaciones

En la pantalla de relaciones, el usuario puede consultar las relaciones existentes entre el DSA y otras entidades del repositorio de Anjana.

Las relaciones pueden ser:

• Directas: Relaciones en las que el DSA es origen o destino

También se puede filtrar las relaciones por el nombre y el subtipo de la entidad relacionada, el tipo de relación (origen o destino), el nombre y el subtipo de la relación.

Linaje

En esta pantalla, el usuario puede consultar el linaje del DSA, pudiendo expandir el DSA para ver, por ejemplo, la unidad organizativa a la que pertenece, los usuarios que tienen acceso a sus datos por medio de adherencias, las estructuras de datos a las que da acceso…

Los objetos mostrados en este grafo dependen de la capa de linaje elegida y su relación con el DSA (si es origen, destino y de qué tipo de relación). Se puede filtrar qué tipos de entidad, relaciones y estados se quieren mostrar.

Se incluye más detalle del grafo en el apartado Linaje de esta Guía.

Intervinientes

Dentro de la pantalla de Intervinientes, el usuario puede consultar los usuarios que son parte interesada del DSA, incluidos todos los usuarios adheridos al DSA.

Los usuarios aparecen tipados como:

• Adheridos: usuario que tiene adherencia al DSA

• Principal: usuario creador o propietario del DSA

• Secundario: usuario asignado en algún atributo de la plantilla (en caso de que el objeto tenga algún atributo de tipo Usuario nominal)

También se puede filtrar los intervinientes por tipo de interviniente, su rol o nombre.

Auditoría

Dentro de la pantalla de Auditoría, el usuario puede consultar la auditoría interna de Anjana donde se puede ver la evolución del DSA a lo largo de toda su vida en la herramienta: la creación, las validaciones de sus workflows, las modificaciones sufridas, solicitudes de adherencia…

Es posible filtrar según sea acción de búsqueda o no, qué, quién y cuándo se hizo una acción sobre ese DSA.

El origen permite distinguir sobre las distintas fuentes que generan auditoría: “anjana” en caso de la auditoría interna y el nombre del sistema en el caso de la externa.

Versiones

Listado de versiones del DSA desde donde se puede acceder al detalle de todas ellas.

En esta ventana, el usuario puede:

• Navegar a cada una de las versiones del DSA

• Descargar el snapshot de cada versión del DSA

• En caso de tener una versión pendiente de aprobación, navegar a su workflow de validación