Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Este servicio será utilizado por las aplicaciones que necesiten consultar datos de grados asociados a un colegio para un ciclo específico con la BDC con cierta periodicidad.

Situación actual

Descripción

Consulta los grados asociados a un colegio para un ciclo en específico. Si se especifica un nivel se regresan los grados para ese nivel, si no se especifica el nivel se regresan los grados para todos los niveles asociados al colegio para el ciclo especificado.

Referencia SIFExtensión de SIF 3.0.1
Entidad BDCGrado
Entidad SIF

grade (Lista)

Tipo de PeticiónGET
Parámetros o Campos
CamposDescripciónReglas de negocio
school
  • (Obligatorio) Id del Colegio correspondiente
  • 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
  • (Opcional)Id del Nivel del Colegio que se consulta 
 
keys
  • (Opcional) Indicador de regresar solo llaves de entidades. Default: false.
     
 
Ejemplo de llamada o de formulario

http://desenv.uno-internacional.com/sif/unoSchool/

schoolLevel

grade;contextId={"school":1135,"schoolYear":2016,"keys":"false", "level":17}

Respuesta
<schoolLevelList>
<schoolLevel

<gradeList>
<grade refId="00000000-0000-1000-0000-000000000019" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>1P</gradeCode>
<gradeDescription>1º- Primero Primaria</gradeDescription>
<order>400</order>
</grade>
<grade refId="00000000-0000-1000-0000-000000000020" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>2P</gradeCode>
<gradeDescription>2º- Segundo Primaria</gradeDescription>
<order>500</order>
</grade>
<grade refId="00000000-0000-1000-0000-000000000021" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>3P</gradeCode>
<gradeDescription>3º- Tercero Primaria</gradeDescription>
<order>600</order>
</grade>
<grade refId="00000000-0000-1000-0000-000000000022" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>4P</gradeCode>
<gradeDescription>4º- Cuarto Primaria</gradeDescription>
<order>700</order>
</grade>
<grade refId="00000000-0000-1000-0000-

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

000000000023" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>5P</gradeCode>
<gradeDescription>5º- Quinto Primaria</gradeDescription>
<order>800</order>
</grade>
<grade refId="00000000-0000-1000-0000-000000000024" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>6P</gradeCode>
<gradeDescription>6º- Sexto Primaria</gradeDescription>
<order>900</order>
</grade>
<grade refId="00000000-0000-1000-0000-

000000000018

000000000037" >

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

<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>PF</gradeCode>
<gradeDescription>Prefirst (Primaria)</gradeDescription>
<order>90</order>
</grade>
<resumen>
<niveles>
<nivel>
<nivel_id>17</nivel_id>
<colegio_nivel_ciclo_id>22085</colegio_nivel_ciclo_id>
<grados>
<grado_id>19</grado_id>
<grado_id>20</grado_id>
<grado_id>21</grado_id>
<grado_id>22</grado_id>
<grado_id>23</grado_id>
<grado_id>24</grado_id>
<grado_id>37</grado_id>
</grados>
<total>7</total>
</nivel>
</niveles>
</resumen>
</gradeList>

¿Quién lo utiliza y cómo?