Versions Compared

Version Old Version 3 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 utilizado por las aplicaciones que necesiten sincronizar datos de la asociación Alumno-Grado-Grupo consultar datos de niveles asociados a un colegio para un ciclo específico con la BDC con cierta periodicidad.

Situación actual

Descripción

Consulta

la asociación Alumno-Grado-Grupo

los niveles asociados a un colegio para un

Colegio

ciclo 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 especificado.

Referencia SIFExtensión de SIF 3.0.1
Entidad BDCNivel
Entidad SIF

schoolLevel (Lista).

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
      • 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. Ver maestro de niveles. 
      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.

         

      •  


      Ejemplo de llamada o de formulario
      http

      https://

      desenv

      homol.uno-internacional.com/sif/unoSchool/

      studentGroupAssociation

      schoolLevel;contextId={"school":

      1135

      1140, "schoolYear":

      2015

      2018,

      "level

      "

      :18, "

      keys":false}

      Respuesta
      <studentGroupAssociationList>

      <schoolLevelList>

      <studentGroupAssociation

      <schoolLevel refId="

      00000016

      00000000-0000-1000-0000-

      000002657856

      000000000017" >

      refId compuesto por el grupo_id y alumno.alumno_id (Identificador único en la BDC).  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

      nivel.nivel_id. Ver maestro de  Grados y Niveles. 
      <schoolLevelCode>002</schoolLevelCode> Clave del nivel
      <schoolLevelDescription>Primaria</schoolLevelDescription> Descripción
      <order>200</order> Orden específico
      <country>MX</country> Clave del país
      </schoolLevel>
      <schoolLevel refId="00000000-0000-1000-0000-

      000002657860

      000000000018" >

      <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>

      <schoolLevelCode>003</schoolLevelCode>
      <schoolLevelDescription>Secundaria</schoolLevelDescription>
      <order>300</order>
      <country>MX</country>
      </schoolLevel>
      </schoolLevelList>

      ¿Quién lo utiliza y cómo?