Detalle técnico del API de comunicación entre el EVA y el SGA de la UTPL

1. API de comunicación entre el EVA y el SGA UTPL Detalle técnico del API de comunicación EVA-SGA. José Luis Granda http://cafedechucho.blogspot.com [email_address]

2. EVA EVA (Entorno Virtual de Aprendizaje) El EVA es un entorno basado en web que permite recrear la experiencia de aprendizaje desde el punto de vista del estudiante y la experiencia de enseñanza de cara al profesor y la unidad académica.

3. SGA SGA (Sistema de Gestión Académica) El SGA, es el sistema de gestión transaccional que registra desde la creación de estudiantes y profesores, la creación de materias y la asignaciones de estudiantes y profesores en las asignaturas correspondientes, según el proceso de matriculación en un período académico específico.

4. Instancia virtual Una instancia virtual, en el EVA, es la creación de todas las entidades (períodos académicos, planes de estudio, asignaturas, matriculas y asignación de profesores). La instancia virtual se alimenta de los datos generados por el SGA.

5. Solución: diferida Cuando el período de matricula finaliza, se hace una lectura todos los datos del SGA y se general la instancia virtual Problema La instancia no es estática

6. Solución: Justo a tiempo (JIT) Se implementan pseudo servicios web del lado del EVA, que pueden ser invocados desde el SGA para crear bajo demanda las entidades de la instancia virtual.

7. Modelo de comunicación EVA - SGA EVA API de invocación y respuesta Respuesta al usuario Secretaría

10. Esquema de implementación EVA API de invocación y respuesta Documento, incluye nombre de usuario y contraseña Secretaría

11. Descripción El API de invocación y respuesta para la creación de cuentas de usuario en el EVA, es un componente del lado del EVA que recibe una petición HTTP y devuelve una salida XML para el posterior tratamiento.

12. Arquitectura de implementación

13. Descripción técnica El API debe ser invocado vía HTTP en la URL: http://hostname/moodle/enrol/utpl/ws/adduser.php?cue=[CUE]

14. Entrada/salida ENTRADAS: CUE Identificador Único del Estudiante en DANTA SALIDAS: Flujo XML <eva><status>STATUS</status><cue>CUE</cue><username>USERNAME</username><password>PASSWORD</password></eva> En cada variable se reemplaza el dato correspondiente, sólo si el estado de retorno es OK_STATUS

16. Resumen del Algoritmo implementado El URL invoca un guión de comandos del lado del servidor del EVA, que implementa el API, pasandole un parámetro CUE o Código Único del Estudiante, con este valor se realiza una busqueda en DANTA y se procede a crear una cuenta de usuario en el EVA y se retorna la cadena XML completa con información válida.

19. Esquema de implementación EVA API de invocación y respuesta Nuevo estado de la asignatura Secretaría

20. Descripción El API de invocación y respuesta para la asignación de profesores en la asignatura en el EVA, es un componente del lado del EVA que recibe una petición HTTP y devuelve una salida XML para el posterior tratamiento.

21. Arquitectura de implementación

22. Descripción técnica El API debe ser invocado vía HTTP en la URL: http://hostname/moodle/enrol/utpl/ws/assingteacher.php?pdoid=[VALOR]&pasid=[VALOR]&paralelo=[VALOR]&idnumber=[VALOR]&command=[VALOR]

23. Entrada/salida ENTRADAS: pdoid : Identificador único del período académico pasid : Identificador único de la asignatura paralelo : Paralelo de la asignatura idnumber : Identificador del profesor (cédula, pasaporte) command : Comando de ejecución ( assign , unassign )

24. Salida SALIDAS: Flujo XML <eva><status>STATUS</status></eva> En cada variable se reemplaza el dato correspondiente, sólo si el estado de retorno es OK_STATUS

26. Resumen del Algoritmo implementado El URL invoca un guión de comandos del lado del servidor del EVA, que implementa el API, pasándole los parámetros descritos anteriormente, con estos valores se realiza una búsqueda en el SGA y se procede a realizar la asignación o desasignación, según se indique por el parámetro command , en el EVA y se retorna la cadena XML con el código de estatus resultante.