SIU-Arai/Administrar

Administrando la plataforma SIU-Araí

Importar Agentes desde SIU-Mapuche

Es posible cargar la base de usuarios desde el módulo para gestión de RRHH, SIU-Mapuche, el cual posee el registro de la institución con la siguiente información:

• nombres
• apellidos
• legajo
• tipo y número de documento
• género

Este puede ser un proceso de suma importancia en la integración de la plataforma Araí con el portal SIU-Huarpe, ya que la información de legajo del agente es requerida esté configurada en el usuario, para que así este pueda consultar su información de personal desde dicho portal.

Requerimientos

Se debe contar con los siguientes elementos:

• SIU-Mapuche versión 3.5.0 o superior
• SIU-Araí 2.0.0 o superior

Exportar Agentes

Para exportar los agentes, SIU-Mapuche proporciona un comando de consola, que nos genera un archivo en formato json con los datos de todos los agentes que posee cargados. Para ejecutar el comando, primero será necesario cargar el entorno, para lo cual podemos ejecutar:

cd /ruta/mapuche/
. ./entorno_toba.env

Una vez cargado el entorno, es posible ejecutar la exportación de la siguiente forma:

toba proyecto exportar_agentes_arai -f agentes-arai.json

Este comando exportará y creará un archivo en la ruta /ruta/mapuche/instalacion/usersExportFiles/agentes-arai.json disponible para ser importado luego.

Nota: el parámetro -f es opcional, así como -d para la ruta donde guardar dicho archivo, -m para indicar la persona responsable y -e para indicar su email.

Importar Agentes

Hay que aclarar que, hasta aquí, lo que se realizó fue exportar la definición de personas existente en SIU-Mapuche. No así cuentas de acceso. Cuando se importe esta información, se dispondrá de información de una persona (definido como usuario en la plataforma) pero sin cuentas asociadas para el acceso a dicha aplicación (en el supuesto de que la base de usuarios estuviese vacía).

El proceso de importación de agentes se puede interpretar como cualquier otro proceso de importación de cuentas y personas en SIU-Araí: Usuarios.

Importar cuentas desde una aplicación vinculada

La plataforma SIU-Araí está pensada para ser integrada con las soluciones SIU, sean instalaciones nuevas o ya existentes y operativas. Esto quiere decir que un factor de suma importancia es poder migrar las cuentas de usuarios existentes de forma previa en dichos sistemas. Al momento de vincular una solución SIU a la plataforma, estamos configurando el acceso de forma centralizada. El siguiente paso es opcional y consiste en migrar las cuentas existentes.

Requerimientos

Se debe contar con los siguientes elementos:

• La aplicación de la cual se quiere exportar las cuentas, debe estar correctamente vinculada a la plataforma SIU-Araí
• Las cuentas en dicha aplicación deben tener al menos alguna información de contacto válida (tales como nombre y apellido, dirección de email).
• La aplicación

Exportar cuentas

Para exportar las cuentas, las soluciones SIU basadas en SIU-Toba proporcionan un comando de consola, que nos genera un archivo en formato json con los datos de todas las cuentas que posee cargados. Para ejecutar el comando primero será necesario cargar el entorno, para lo cual podemos ejecutar:

cd /ruta/modulo/siu
. ./entorno_toba.env

Una vez cargado el entorno, es posible ejecutar la exportación de la siguiente forma:

toba proyecto exportar_usuarios_arai -f cuentas-xxx-arai.json

Este comando exportará y creará un archivo en la ruta /ruta/modulo/siu/instalacion/usersExportFiles/cuentas-xxx-arai.json disponible para ser importado luego.

Nota: el parámetro -f es opcional, así como -d para la ruta donde guardar dicho archivo, -m para indicar la persona responsable y -e para indicar su email.

Este archivo json tiene una estructura similar a:

{
    "name": "usersExport",
    "description": "Exportación de usuarios para SIU-Araí.",
    "mantainer": "toba",
    "mantainer-email": "toba@siu.edu.ar",
    "people": [
        {
            "givenName": "JUAN ANTONIO",
            "sn": "PEREZ",
            "cn": "JUAN ANTONIO PEREZ",
            "bloqueada": "1",
            "employeeNumber": "1234",
            "genero": "M",
            "documento": {
                "tipo": "DNI",
                "numero": "123456789"
            }
        },
    ],
    "accounts": [
        {
            "uid": "toba",
            "appUniqueId": "siu_app-1.siu-app",
            "uniqueIdentifier": "toba",
            "password": "$2y$10$1Nuldmz0Q0AGIyf/.WV3Sullw/2cDTD34061zY4STT919yK2assg6",
            "passwordAlgorithm": "crypt",
            "person": {
                "givenName": "Usuario",
                "sn": "Administrador",
                "cn": "Usuario Administrador",
                "bloqueada": "0"
            }
        }
    ]
}

Importar cuentas

Para importar las cuentas, el módulo SIU-Araí: Usuarios proporciona un comando de consola, que nos permite cargar la información de un conjunto de usuarios y/o cuentas, todo a partir de un archivo en formato json. Para ejecutar el comando primero será necesario cargar el entorno, para lo cual podemos ejecutar:

cd /ruta/siu-arai/usuarios
. ./entorno_toba.env
export TOBA_PROYECTO=arai_usuarios

Una vez cargado el entorno, es posible ejecutar la exportación de la siguiente forma:

toba proyecto importar_usuarios_arai -f cuentas-xxx-arai.json -m comparador [-t cuentas|personas]

Este comando procesará un archivo en la ruta /ruta/modulo/siu/instalacion/usersExportFiles/cuentas-xxx-arai.json importando las definiciones de personas y/o cuentas, teniendo en cuenta las opciones de comparación.

Al momento de importar, es necesario elegir como se comparan los datos de usuarios/personas a importar con los que pueden existir, mediante el argumento comparador. Este puede ser uno de los siguientes:

• 0: Género, tipo y número de documento

• 1: Tipo y número de documento

• 2: Email
• 3: atributo UniqueIdentifier
• 4: No intenta matchear, sólo agrega cuentas nuevas para las personas

De forma opcional, se puede indicar con el argumento -t si se desea importar la información de cuentas o solamente la información de personas. Algo utilizado como en casos similares al proceso de importación de agentes desde SIU-Mapuche, pero ignorando los datos de cuentas.

Una vez realizada la importación, el proceso nos mostrará un resumen de las acciones realizadas, así como los posibles inconvenientes que pueden haber surgido al momento de importar y comparar los datos existentes. Nos mostrará una salida similar a:

Resolver conflictos

Algunas veces sucede que al realizar la importación de cuentas, exista conflictos. Esto será indicado por Cantidad de usuarios Arai en conflictos: n donde n es un valor mayor que cero. En estos casos, se nos impedirá realizar otra importación hasta resolver dichos conflictos.

Para resolver los conflictos, hay que dirigirse a SIU-Araí: Usuarios, y realizar desde el menú Fusionar usuarios el proceso de consolidación de los datos con problemas. En él es posible seleccionar los atributos que presentan problemas y establecer una selección manual del valor adecuado.

• 

  Fusionar-usuarios.png

Una vez resueltos todos los conflictos, se eliminará de forma automática el archivo /ruta/siu-arai/logs/conflictFilesImport/userDataConflicts.json que los contenía.

Vinculación de usuarios mediante membresía de grupos

Una opción que incorpora la plataforma, es la de generar cuentas (de forma masiva) a usuarios para dar acceso a una determinada aplicación mediante la pertenencia de dicho usuario a un determinado grupo.

Requerimientos

Se debe contar con los siguientes atributos

• creado el grupo grupoX
• creada la aplicación appX y configurada para Filtrar por grupos, además de seleccionado al grupoX
• creado los usuarios usuarioX .... usuarioZ
• asignado al grupo grupoX los miembros usuarioX ... usuarioZ

Configuración

La configuración se realiza ejecutando un comando de consola especialmente creado. Si lo ejecutamos sin argumentos:

toba proyecto crear_cuentas_grupo

Nos listará todas las aplicaciones y grupos disponibles. Para realizar la vinculación masiva de usuarios a aplicaciones utilizando la membresía de grupo, ejecutar

toba proyecto crear_cuentas_grupo -a aplicacionX -g grupoX

Esto tomará todos los usuarios usuarioX .... usuarioZ miembros del grupo grupoX y les generará un identificador de cuenta similar al uid de dicho usuario para la aplicación appX.

Administrando el portal SIU-Huarpe

El objetivo del portal SIU-Huarpe como herramienta es ofrecer un espacio donde sea posible ofrecer servicios a los usuarios de la plataforma. Dichos servicios son expuestos a los usuarios de manera simple y directa. No requiere interacción del usuario con los sistemas que operan de fondo. Para lograr todo esto es necesario extender, mejorar y/o complementar dichos servicios.

Instalar un bundle en el portal

El portal SIU-Huarpe está construido para ser extensible por medio del uso de módulos simples denominados bundles y desarrollados por la herramienta Symfony Framework. Se pueden instalar los bundles desarrollados y proporcionados por el SIU, así como desarrollar sus propios bundles e integrarlos al portal.

Descargar el bundle

Los bundles se gestionan como cualquier otra librería PHP más del portal SIU-Huarpe. Por lo tanto, es neceario manejarlo haciendo uso de Composer.

Activar el bundle

Para activar el bundle en el portal existe un comando en SIU-Huarpe que se debe ejecutar

./bin/huarpe.sh -i bundle:activar siu/bundle-xxx

Esto configura automáticamente el uso de este bundle. Se ejecutan validaciones previas y como resultado :

• verifica que debe estar presente en el archivo composer.local.json
• agrega en el archivo bundles.yml una entrada
• crea/actualiza el archivo arai.local.json con los servicios que requiere consumir el bundle

Configurar el bundle

A veces, el bundle puede proporcionar cierta parametrización para cambiar su comportamiento. En la documentación de cada bundle estará detallado específicamente que puede ser adaptado. Cualquier valor a modificarse, debe ser realizado en el archivo de configuración global parameters.yml.

Desarrollar un bundle para el portal

Como se dijo, el portal SIU-Huarpe es un espacio donde es posible ofrecer servicios a los usuarios. La institución puede contar con servicios que considere pueden ser de utilidad a los usuarios de la plataforma y así decidir la construcción de un bundle que permita exponerlos en el portal.

Requerimientos

• Los bundles se gestionan como cualquier otra librería PHP más del portal SIU-Huarpe. Por lo tanto, los bundles deben estar alojados en un repositorio Git, poseer un archivo composer.json y se debe manejarlo haciendo uso de Composer.

...

< Volver