Vinculación de usuarios y personas

Una de las funciones de SIU-Araí: Usuarios es la gestión de los distintos datos que pertenecen a una Persona.

Para llevar adelante esa funcionalidad, necesitamos vincular los usuarios con Personas.

Lo que detallamos a continuación es como realizar dicha vinculación de usuarios y personas (Arai-Personas).

Consideraciones iniciales

• Es necesario contar con una instalación de SIU-Arai: Personas en la versión 1.0.
• Es necesario contar con una instalación de SIU-Araí: Usuarios en la versión 3.2 configurada para conectarse con SIU-Arai: Personas.

En adelante, nos referiremos de la siguiente manera:

- llamaremos `usuario` a los usuarios de SIU-Araí: Usuarios
- llamaremos `persona` a la identificación que tiene un usuario en Arai-Personas

Cabe aclarar que por los datos manejados un usuario puede ser tanto una persona física como jurídica.

Se recomienda hacer un backup de las bases de datos LDAP y PostgreSQL antes de continuar.

Configuraciones que afectan la vinculación

Dentro de los parámetros se encuentran los que controlan la conexión con SIU-Arai: Personas. A saber:

Variable
CREDENCIALES_API_BASIC_PERSONAS

Es importante que previo a iniciar el proceso verifique estos datos y los modifique si es que resulta necesario

Administración vía consola

Existe una serie de comandos que permiten realizar la gestión de la vinculación entre Arai-Usuarios y Arai-Personas.

Las opciones disponibles para el comando de consola son las siguientes:

Opciones:
  inicializar: Realiza la vinculación inicial con Arai-Personas
  actualizar : Actualiza datos de sellos de cada Persona

Inicialización

Este mecanismo inicializa la base de datos de Arai-Personas con los usuarios registrados en SIU-Arai: Usuarios. Por cada uno de ellos, se generará una entrada representandolo como Persona y se le asociará un Sello inicial.

Desde una consola con acceso a los comandos administrativos de SIU-Araí: Usuarios, invocar el siguiente comando, reemplazando $VERSION por el valor adecuado:

    docker run --rm -it \
      --env-file usuarios.env \
      hub.siu.edu.ar:5005/siu-arai/arai-usuarios/idm:$VERSION \
      -- idm/bin/instalador arai:personas inicializar -n

Al finalizar la ejecución del comando se muestran los resultados del proceso:

En caso de visualizarse alguno de los siguientes renglones con un valor distinto de cero (0):

usuarios con error en la migracion: 0
personas fallidas: 0

Deberá buscarse las razones de la falla y una vez subsanadas volver a ejecutar la Inicialización.

Nota: la inicialización es un proceso idempotente, es decir se puede ejecutar sucesivas veces y se encarga de procesar solo los usuarios pendientes (tanto sea usuarios nuevos, como los no procesados por algún error previo).

Actualizacion

Este mecanismo actualizará los datos correspondientes a los Sellos de la Persona con los datos presentes en SIU-Arai: Usuarios y las etiquetas configuraas previamente en SIU-Araí: Personas.

De esta manera, al incorporar actualizaciones de datos a un usuario (ej: cambiar el email o el DNI) el módulo IDM puede trasladarlas hacia los datos internos de los Sellos de la Persona.

Desde una consola con acceso a los comandos administrativos de SIU-Araí: Usuarios, invocar el siguiente comando, reemplazando $VERSION por el valor adecuado:

    docker run --rm -it \
      --env-file usuarios.env \
      hub.siu.edu.ar:5005/siu-arai/arai-usuarios/idm:$VERSION \
      -- idm/bin/instalador arai:personas actualizar -n "

Nota: Tener en cuenta que el uso de este comando es destructivo, es decir reemplazará datos modificados por el Usuario final con aquellos vigentes en el módulo IDM

Desvinculación de la Persona

La Desvinculación de una Persona es un proceso individual por lo que se lleva a cabo mediante la GUI del IDM.

Para llevarlo adelante, se selecciona el usuario en particular que deseamos desvincular y nos dirigimos a la pestaña Persona.

Luego seleccionamos sobre el margen derecho el boton Desvincular Persona y proseguimos a clickear en Guardar para completar la operación.

Nota: La desvinculación es un proceso destructivo, una vez realizado el usuario no tendrá acceso a sus sellos previos