Diferencia entre revisiones de «SIU-Arai/Administrar»
m (→Resolviendo conflictos) |
m (error en el comando) |
||
Línea 52: | Línea 52: | ||
<syntaxhighlight lang="bash" enclose="div"> | <syntaxhighlight lang="bash" enclose="div"> | ||
− | toba proyecto | + | toba proyecto exportar_usuarios_arai -f cuentas-xxx-arai.json |
</syntaxhighlight>Este comando exportará y creará un archivo en la ruta <code>/ruta/modulo/siu/instalacion/usersExportFiles/cuentas-xxx-arai.json</code> disponible para ser importado luego. <blockquote>Nota: el parámetro <code>-f</code> es opcional, así como <code>-d</code> para la ruta donde guardar dicho archivo, <code>-m</code> para indicar la persona responsable y <code>-e</code> para indicar su email.</blockquote>Este archivo '''json''' tiene una estructura similar a:<syntaxhighlight lang="bash" enclose="div"> | </syntaxhighlight>Este comando exportará y creará un archivo en la ruta <code>/ruta/modulo/siu/instalacion/usersExportFiles/cuentas-xxx-arai.json</code> disponible para ser importado luego. <blockquote>Nota: el parámetro <code>-f</code> es opcional, así como <code>-d</code> para la ruta donde guardar dicho archivo, <code>-m</code> para indicar la persona responsable y <code>-e</code> para indicar su email.</blockquote>Este archivo '''json''' tiene una estructura similar a:<syntaxhighlight lang="bash" enclose="div"> | ||
{ | { |
Revisión del 09:33 24 oct 2018
![Siu-arai.png](/wiki/images/d/d7/Siu-arai.png)
Sumario
Administrando la plataforma
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:. ./entorno_toba.env
Una vez cargado el entorno, es posible ejecutar la exportación de la siguiente forma:
/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:. ./entorno_toba.env
Una vez cargado el entorno, es posible ejecutar la exportación de la siguiente forma:
/ruta/modulo/siu/instalacion/usersExportFiles/cuentas-xxx-arai.json
disponible para ser importado luego. Nota: el parámetroEste archivo json tiene una estructura similar a:-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.
"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:. ./entorno_toba.env
Una vez cargado el entorno, es posible ejecutar la exportación de la siguiente forma:
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.
/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:
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