Servicio /sif/unoSchool/studentGroupAssociation

Estado

EN USO

En Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.

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 la asociación Alumno-Grado-Grupo para un Colegio en un Ciclo en específico. Opcionalmente se puede filtrar por nivel, grado y/o grupo. 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	(Obligatorio) Id del Colegio correspondiente. Los valores se puede consultar con el servicio /sif/unoSchool/schools.	El identificador del colegio debe existir, en caso de no ser válido devuelve: <code>404</code> <message>No se encontraron datos con los parámetros especificados.</message> 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 ( ó Id del Ciclo Escolar )	El colegio debe existir en el año escolar, en caso de no ser válido devuelve: <code>404</code> <message>No se encontraron datos con los parámetros especificados.</message> Si no se especifica el parámetro, como es obligatorio devuelve: <code>400</code> <message>Debe especificar un ciclo para consultar.</message>
level	(Opcional) Id del Nivel del Colegio que se consulta. Los valores se pueden consultar en maestro de niveles o servicio /sif/unoSchool/schoolLevel.	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>
grade	(Opcional) Id del grado que se consulta.
group	(Opcional) Id del grupo que se consulta. Ver maestro de Grupos.
keys	(Opcional) Indicador de regresar solo llaves de entidades. Valores: true, false. Default: false.

Ejemplo de llamada o de formulario

https://homol.uno-internacional.com/sif/unoSchool/studentGroupAssociation;contextId={"school":1135, "schoolYear":2017, "level":18, "keys":false, "grade":27, "group":16}

Respuesta

<studentGroupAssociationList>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657856" > refId compuesto por el grupo_id y alumno.alumno_id (Identificador único en la BDC , asignado para el ciclo escolar). Ver maestro de Grupos.
<unoStudentRefId>00000000-0000-1000-0000-000002657856</unoStudentRefId> alumno.alumno_id (Identificador único en la BDC)
<gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId> grado_id
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId> grupo_id. Ver maestro de Grupos.
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657857" >
<unoStudentRefId>00000000-0000-1000-0000-000002657857</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657860" >
<unoStudentRefId>00000000-0000-1000-0000-000002657860</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
......
......

<resumen>
<niveles>
<nivel>
<nivel_id>18</nivel_id> nivel_id
<colegio_nivel_ciclo_id>12776</colegio_nivel_ciclo_id> colegio_nivel_ciclo_id
<grupos>
<grupo>
<grado_id>26</grado_id> grado_id
<grupo_id>16</grupo_id> grupo_id
<total>23</total> total alumno del nivel_id, grado_id y grupo_id
</grupo>

</grupos>
</nivel>
</niveles>
<total>141</total> total alumno del colegio
</resumen>
</studentGroupAssociationList>

¿Quién lo utiliza y cómo?