1.2 Proceso de sincronización ETL: guarani, moodle, idUNC

1. Introducción y contexto

Este documento describe el proceso de integración entre los sistemas Moodle, Guaraní e IdUNC. Está orientado a las aulas virtuales que ya se encuentran vinculadas con Guaraní, así como a aquellas que estén evaluando la posibilidad de integrar Moodle con dicho sistema.

Sistemas involucrados

Sistema	Rol en la integración	Descripción
Guaraní	Fuente de verdad	Define qué usuarios deben existir, qué materias cursan y qué docentes están asignados.
Moodle	Plataforma de aulas virtuales	Sistema de aulas virtuales utilizado por las diferentes facultades y dependencias. No administra usuarios de forma autónoma en este modelo.
IdUNC (SSO)	Autenticación centralizada	Sistema de Single Sign-On propio de la UNC. Todos los usuarios acceden a Moodle exclusivamente a través de este sistema.
ETL ~~(proceso automatizado)~~	Sincronización ~~Sincronización~~ automatizada	Proceso que extrae datos de Guaraní, los preformatea para su correcta importación y los carga en Moodle de forma automática.

Principio fundamental

Guaraní es la única fuente de ~~verdad~~verdad.

Moodle no crea, modifica ni elimina usuarios por sí mismo. Todo cambio en la base de usuarios de Moodle se origina en Guaraní y se aplica mediante el proceso ETL. Esta es la regla más importante que debe tener presente un administrador de Moodle.

2. Arquitectura del proceso

El flujo de datos sigue una dirección única: desde Guaraní hacia Moodle, pasando por el proceso ETL. La autenticación de los usuarios corre por fuera de este flujo, delegada completamente en IdUNC.

Diagrama simplificado del flujo

GUARANÍ

Fuente de datos

→

ETL

Sincronización

→

MOODLE

Destino

←

IdUNC

Auth (SSO)

Etapas del proceso ETL

Etapa	Nombre	Qué hace
1	Extracción	Obtiene desde Guaraní: datos personales de usuarios, vinculación con IdUNC, e información académica (comisiones, inscripciones a materias).
2	Transformación	Normaliza los datos, filtra los usuarios que cumplen los criterios de sincronización y prepara la estructura compatible con Moodle.
3	Carga	Crea o actualiza usuarios en Moodle, define el método de autenticación como SSO (IdUNC) y genera las relaciones de matriculación según la estructura de Guaraní.

3. Usuarios sincronizados

No todos los usuarios de Guaraní se sincronizan automáticamente. Para que un usuario sea dado de alta en Moodle, debe cumplir dos requisitos en ~~simultáneo:~~simultáneo: vinculación con IdUNC y condición académica activa.

Docentes	~~Docentes~~	Estudiantes
✓	Req. 1 –— Vinculación con IdUNC Cuenta de Guaraní vinculada con su cuenta UNC (IdUNC). Trámite en: `mi.unc.edu.ar` → "Iniciar trámite en Guaraní" → "Vincular" . Requisito adicional: e-mail principal definido en Guaraní.	Req. 1 –— Vinculación con IdUNC Ídem docentes. Mismo procedimiento de vinculación.
✓	Req. 2 –— Participación académica activa El docente debe estar asignado a al menos una comisión dentro de Guaraní para el período lectivo vigente o el año anterior.	Req. 2 –— Condición académica activa El estudiante debe estar inscripto o reinscripto en alguna propuesta académica correspondiente al período lectivo vigente (ej. ciclo 2026).

Docentes

~~Docentes~~

Estudiantes

✓

Req. 1 –— Vinculación con IdUNC

Cuenta de Guaraní vinculada con su cuenta UNC (IdUNC).

Trámite en: mi.unc.edu.ar → "Iniciar trámite en Guaraní" → "Vincular"

.
Requisito adicional: e-mail principal definido en Guaraní.

Req. 1 –— Vinculación con IdUNC

Ídem docentes. Mismo procedimiento de vinculación.

✓

Req. 2 –— Participación académica activa

El docente debe estar asignado a al menos una comisión dentro de Guaraní para el período lectivo vigente o el año anterior.

Req. 2 –— Condición académica activa

El estudiante debe estar inscripto o reinscripto en alguna propuesta académica correspondiente al período lectivo vigente (ej. ciclo 2026).

⚠ SiAtención: si un usuario no cumple alguno de los dos requisitos, NO se sincroniza a Moodle. El problema debe resolverse en Guaraní, no en Moodle.

4. Autenticación y acceso

Una vez implementado el modelo de integración, el acceso a Moodle funciona exclusivamente mediante IdUNC (SSO). ~~Este cambio implica que el~~El login manual con usuario y contraseña locales queda deshabilitado.

Antes de la integración	Después de la integración
Login con usuario/contraseña local en Moodle Gestión de usuarios dentro del propio Moodle Alta manual de usuarios posible	Login exclusivamente mediante IdUNC (SSO) Moodle delega la autenticación completamente en IdUNC Los usuarios se crean automáticamente vía ETL

5. Gestión de usuarios en Moodle

El ciclo de vida de los usuarios en Moodle está determinado íntegramente por Guaraní. A continuación se describe cómo se gestionan las altas, bajas y modificaciones.

5.1 Altas

Se generan automáticamente mediante el proceso ETL al inicio de cada ciclo lectivo. El alta se produce cuando:

Un docente es asignado a una comisión en Guaraní.
Un estudiante es inscripto o reinscripto en una propuesta académica.

ℹ Acceso ~~anticipado~~anticipado:

Elel proceso de carga masiva al inicio del ciclo permite que los estudiantes puedan acceder a Moodle con su cuenta UNC incluso antes de que sus cursos estén visibles.

5.2 Bajas y modificaciones

Cualquier cambio en la situación académica de un usuario se origina y gestiona en Guaraní. Las bajas y modificaciones se reflejan en Moodle mediante las operaciones correspondientes dentro del sistema Guaraní, no mediante acciones manuales en Moodle.

5.3 Restricciones operativas — MUY IMPORTANTE

⚠ ~~Las~~Atención: las siguientes restricciones son críticas para mantener la integridad del sistema. Toda excepción debe coordinarse con PSI.

✗	No crear usuarios manualmente en Moodle Los usuarios creados manualmente quedan fuera del sistema de sincronización y pueden generar inconsistencias.

✗	No eliminar usuarios manualmente en Moodle La eliminación de usuarios sólo debe producirse como consecuencia de cambios en Guaraní.

6. Matriculación a cursos

La matriculación de estudiantes y docentes a los cursos de Moodle es automática y refleja la estructura académica definida en Guaraní.

La integración toma en cuenta:

Las inscripciones a materias de los estudiantes.
Las asignaciones de docentes a comisiones.

El resultado es que Moodle muestra exactamente la misma estructura académica que está definida en Guaraní. No es necesario gestionar matriculaciones de forma manual desde Moodle.

7. Inicio de ciclo lectivo

Al comienzo de cada período académico se ejecuta una carga masiva inicial. Esta carga garantiza que todos los usuarios con condición académica activa puedan acceder a Moodle desde el primer día.

Secuencia de inicio de ciclo

1	Guaraní registra las inscripciones y asignaciones del nuevo ciclo lectivo.
2	El ETL realiza la carga masiva: sincroniza nuevos estudiantes inscriptos y docentes asignados a comisiones.
3	Los usuarios quedan habilitados en Moodle con autenticación SSO. Pueden ingresar con su cuenta UNC aunque sus aulas aún no estén activas.
4	La sincronización continúa de forma periódica durante el ciclo lectivo para reflejar altas y cambios en Guaraní.

8. Responsabilidades

Actor	Responsabilidades
PSI (Prosecretaría de Informática)	Implementación y mantenimiento del proceso ETL. Configuración de Moodle e integración con SSO. Soporte técnico del proceso de sincronización.
Facultades / Dependencias	Comunicar a docentes y estudiantes el cambio en el método de autenticación. Verificar que los usuarios tengan correo electrónico definido en Guaraní. Verificar las asignaciones correctas de docentes a comisiones. Acompañar a los usuarios durante la transición.

9. Resolución de problemas frecuentes

Cuando un administrador de Moodle recibe un reporte de problema relacionado con usuarios o acceso, la primera acción debe ser verificar el estado del usuario en ~~Guaraní.~~Guaraní. La mayoría de los problemas tienen origen allí.

Problema reportado	Causa probable	Acción correctiva
El usuario no aparece en Moodle	No cumple alguno de los dos requisitos de sincronización	Verificar en Guaraní: vinculación con IdUNC, e-mail ~~definido,~~definido y participación académica activa.
El usuario no puede iniciar sesión	Problema con la cuenta IdUNC o la vinculación en Guaraní	Verificar que la vinculación en Guaraní esté activa. Derivar a soporte de PSI si corresponde.
El usuario no ve sus cursos	No está matriculado o ella ~~profesor o gestor académico~~matriculación aún no ~~procesó~~fue ~~la matriculación~~ procesada	Verificar en Guaraní.
Docente sin acceso a su comisión	No está asignado a la comisión en Guaraní	Verificar y corregir la asignación en Guaraní. No modificar manualmente en Moodle.

⚠ Regla de oro: si el problema no tiene origen en Guaraní, coordinar con PSI antes de realizar cualquier intervención manual en Moodle.

10. Consideraciones y dependencias

Para que el proceso funcione correctamente, deben cumplirse las siguientes condiciones previas:

Todos los usuarios deben tener una cuenta IdUNC ~~activa.~~

activa
Sin cuenta IdUNC, el usuario no puede autenticarse en Moodle.

La vinculación ~~entre la cuenta Guaraní y la cuenta~~ Guaraní–IdUNC debe estar ~~completada.~~

completada
Trámite disponible en: mi.unc.edu.ar → "Iniciar trámite en Guaraní" → "Vincular".

El e-mail principal debe estar definido en ~~Guaraní.~~

Guaraní
Sin e-mail, el usuario no es considerado válido por el ETL.

La calidad de los datos en Guaraní impacta directamente en ~~lo que~~ Moodle ~~refleja.~~

Asignaciones incorrectas, inscripciones mal registradas o datos desactualizados en Guaraní producirán inconsistencias en Moodle.

Los cambios en la estructura académica deben reflejarse ~~correctamente~~ en ~~Guaraní.~~

Guaraní
Moodle sólo puede reflejar lo que Guaraní tiene cargado.