En este módulo, se prevé el flujo de información en dos sentidos:

1. Obtención de datos personales y de matrícula (Educa -> Sistema cliente)

En este apartado, se pretende dar acceso a los datos personales de alumnos y familiares, así como los datos básicos de matrícula registrados en Educa. El sistema Educa mantendrá un registro de actualización de la información para que los sistemas cliente puedan solicitar los cambios en sus datos en un rango de tiempo.

Se proponen dos mecanismos de sincronización complementarios:

  • El sistema dispondrá de métodos para la obtención de matrículas o registros de datos personales modificados en un rango de fechas, en un curso escolar, etc.
  • Un mecanismo activo de notificación de las modificaciones realizadas en los datos mediante la implementación de un servicio de notificaciones en el cliente. En esta opción, el sistema cliente deberá implementar un servicio de recepción de notificaciones basado en Web Services que Educa invocará cuando se produzcan modificaciones en elementos asociados al centro.
  • Un método para obtener todos los grupos ordinarios de alumnos del centro en el que se devuelve el nombre en castellano o euskera, el identificador del grupo y la capacidad del mismo.

De manera adicional, se proveerán métodos directos para devolver los datos de las entidades concretas

2. Actualización de detalles de matrícula (Sistema cliente -> Educa)

En este caso, el sistema cliente actualiza en Educa los detalles de las matrículas, básicamente el grupo principal del alumno, las asignaturas que las componen, y sus datos asociados. El servicio permite la actualización de los detalles de múltiples matrículas, de forma que es posible registrar las asignaturas que la componen, así como los detalles de cada una de estas asignaturas.

EL parámetro de entrada es una colección de matriculas (MatriculaUpdateDTO). Cada uno de estos elementos contiene, a su vez, una colección de asignaturas (MatriculaAsignaturaDTO) con los detalles de las asignaturas que componen la matrícula (grupo de selección al que pertenece, modalidad, si es o no pendiente, etc.

Se han habilitado dos mecanismos para localizar la matrícula de la que se importan los datos:

  1. Campo identificador de matrícula en  MatriculaUpdateDTO: es el procedimiento que se utilizará por defecto, y que identifica de forma unívoca la matrícula.
  2. Identificador de alumno e identificador de curso escolar en  MatriculaUpdateDTO: en caso de no disponer del identificador de matrícula, es posible localizar la matrícula a través del identificador de alumno y el del curso escolar. Este procedimiento introduce la limitación de impedir que existan dos matrículas para un alumno en el mismo centro y curso escolar. En caso de que, a partir de los dos identificadores, el sistema no localice la matrícula, o localice más de una, el servicio devolverá un error.

Cada matrícula recibida en una misma petición se trata de forma independiente, de forma que, en caso de producirse algún error, se descartarán todos los cambios de las matrículas erróneas, y se realizará la actualización de aquellas con datos correctos.

La respuesta del servicio es una colección de elementos LogDTO, el mismo tamaño que la colección de matrículas recibida, de forma que proporciona una respuesta detallada  para cada una de las matrículas. Se puede obtener más información sobre los elementos de respuesta en la sección referente a la gestión de respuestas y errores.

Se adjuntan dos ficheros de ejemplo, con una petición de actualización, y una posible respuesta del servicio, con y sin errores.

Más información

Etiquetas:
Creado por Administrator el 2021/02/23 14:31
   
This wiki is licensed under a Creative Commons 2.0 license
XWiki Enterprise 11.10.11 - Documentation