En este módulo, el flujo sólo se da en el sentido sistema cliente -> Educa

1. Actualización de detalles de datos académicos (Sistema cliente -> Educa)

En este caso, el sistema cliente actualiza en Educa los detalles de los datos académicos, básicamente los datos finales y las calificaciones de las asignaturas y sus datos asociados para cada una de las evaluaciones finales. El servicio permite la actualización de los detalles de múltiples matrículas, de forma que es posible registrar todas las evaluaciones finales con sus asignaturas y datos finales. Será necesario enviar todos los datos de todas las asignaturas para que el servicio funcione correctamente.  Es decir, se podrá enviar sólo la evaluación de junio / ordinaria / primera evaluación final, pero si se quiere enviar la evaluación extraordinaria o de septiembre, habrá que enviar también obligatoriamente la de junio para asegurar coherencia de los datos.  No se podrá enviar la petición sin evaluaciones y se deberán incluir todos los datos de todas las asignaturas matriculadas.

El parámetro de entrada es una colección de datos académicos de matriculas (DatosAcademicosMatriculaDTO). Cada uno de estos elementos contiene, a su vez, una colección de evaluaciones (DatosAcademicosEvaluacionDTO) y cada evaluación tiene una colección de calificaciones de asignaturas (CalificacionAsignaturaDTO) con los detalles de las calificaciones de las asignaturas que componen la matrícula y la evaluación (nota posible, calificación, convocatoria...).

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

  1. Campo identificador de matrícula en  DatosAcademicosMatriculaDTO: 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  DatosAcademicosMatriculaDTO: 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.

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