Versions Compared

Version Old Version 6 New Version Current
Changes made by

Samara Carmona. CCORP

Tania Romo

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Link Fixer



Panel
titleEstado

Status
colourGreen
titleEn Uso

Info
titleEn 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 las asociaciónes Alumno-Grado-Grupo para un Colegio en un Ciclo en específico , si se especifica un Nivel se regresan los datos para ese Nivel, si no se especifica el Nivel se regresan los datos para todos los Niveles asociados al Colegio para el Ciclo especificadoy modificados en un rango de fechas. Opcionalmente se pueden filtrar por nivel. No se enlistan asociaciones de alumnos con borrado lógico.

Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónGET
Parámetros o Campos


CamposDescripciónReglas de negocio
school
  • 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 
  • 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
  • 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

httphttps://desenvhomol.uno-internacional.com/sif/unoSchool/deltaStudentGroupAssociation;contextId={"school":1135,"schoolYear":2015, "level":18, "keys":false2017, "timeModified":"2015-01-01 00:00:01", "endTimeModified":"2016-05-03 23:00:01"}

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.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-000002657856<000002738150</unoStudentRefId> alumno.alumno_id (Identificador único en la BDC)
  <gradeRefId>00000000-0000-1000-0000-000000000026<000000000025</gradeRefId> grado_id
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId> grupo_id. Ver maestro de Grupos.
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657857000002738176" >
<unoStudentRefId>00000000-0000-1000-0000-000002657857<000002738176</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000026<000000000025</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657860000002769180" >
<unoStudentRefId>00000000-0000-1000-0000-000002657860<000002769180</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000026<000000000025</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>
</<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?