Este servicio será consultado por las aplicaciones que necesiten sincronizar datos de la asociación Alumno-Grado-Grupo con la BDC con cierta periodicidad.
Situación actual
| Descripción | Consulta las asociaciónes Alumno-Grado-Grupo para un Colegio en un Ciclo en específico y modificados en un rango de fechas. Opcionalmente se pueden filtrar por nivel. No se enlistan asociaciones de alumnos con borrado lógico. |
| Referencia SIF | Extensión de SIF 3.0.1 |
| Tipo de Petición | GET |
| Parámetros o Campos | | Campos | Descripción | Reglas de negocio |
|---|
| school | | - El identificador del colegio debe existir, en caso de no ser válido devuelve:
- Si no ese especifica el parámetro, como es obligatorio devuelve:
- <code>400</code>
<message>Debe especificar el identificador del colegio.</message>
| | schoolYear | - (Obligatorio) Año escolar que se consulta
| - El colegio debe existir en el año escolar, en caso de no ser válido devuelve:
- Si no se especifica el parámetro, como es obligatorio devuelve:
- <code>400</code>
<message>Debe especificar un ciclo para consultar.</message>
| | level | | - El nivel debe existir para el colegio, en caso de no ser válido devuelve
- <code>404</code>
<message>No se encontraron datos con los parámetros especificados.</message>
| | keys | - (Opcional) Indicador de regresar solo llaves de entidades.
- Valores: true, false.
- Default: false.
| | | timeModified | - (Obligatorio) Fecha UTC desde la cuál se solicitan las creaciones/actualizaciones de usuarios
| - En caso de no encontrar datos regresa:
<error><code>404</code><message>No se encontraron datos con los parametros especificados.</message></error>
| | endTimeModified | - (Obligatorio) Fecha UTC hasta la cuál se solicitan las creaciones/actualizaciones de usuarios
|
|
|
| Ejemplo de llamada o de formulario | https://homol.uno-internacional.com/sif/unoSchool/deltaStudentGroupAssociation;contextId={"school":1135,"schoolYear":2017,"page":0, "timeModified":"2015-01-01 00:00:01", "endTimeModified":"2016-05-03 23:00:01"}
|
| Respuesta | <studentGroupAssociationList>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002738134" >
<unoStudentRefId>00000000-0000-1000-0000-000002738134</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000025</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002738150" >
<unoStudentRefId>00000000-0000-1000-0000-000002738150</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000025</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002738176" >
<unoStudentRefId>00000000-0000-1000-0000-000002738176</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000025</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002769180" >
<unoStudentRefId>00000000-0000-1000-0000-000002769180</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000025</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation> ....... ...... <unoStudentRefId>00000000-0000-1000-0000-000002657896</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000017</groupRefId>
</studentGroupAssociation>
</studentGroupAssociationList> |
| ¿Quién lo utiliza y cómo? | |
| | |