Versions Compared

Version Old Version 17 New Version Current
Changes made by

Tania Romo

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.


...

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
  • 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
  • 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.
     
sessionId
  • (Opcional) Id del ciclo escolar dónde se desea crear. Ver maestro de Ciclo Escolar
El parámetro se adiciona para aquellas empresas que cuentan con ciclos escolares semestrales.


Ejemplo de llamada o de formulario

https://homol.uno-internacional.com/sif/unoSchool/grade;contextId={"school":1140, "schoolYear":2018, "level":17, "keys":false}

Respuesta

<gradeList>
<grade refId="00000000-0000-1000-0000-000000000019" > grado.grado_id. Ver maestro de  Grados y Niveles. 
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId> nivel.nivel_id. Ver maestro de Grados y Niveles. 
<gradeCode>1P</gradeCode> Clave del grado
<gradeDescription>1º- Primero Primaria</gradeDescription> Descripción
<order>400</order> Orden específico
</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-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-000000000037" >
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<gradeCode>PF</gradeCode>
<gradeDescription>Prefirst (Primaria)</gradeDescription>
<order>90</order>
</grade>
<resumen> Resumen
<niveles>
<nivel>
<nivel_id>17</nivel_id> nivel.nivel_id
<colegio_nivel_ciclo_id>22085</colegio_nivel_ciclo_id> colegio_nivel_ciclo_id (Identificador único en la BDC asignado para el colegio y nivel por ciclo escolar)
<grados>
<grado_id>19</grado_id> 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> Total de grados
</nivel>
</niveles>
</resumen>
</gradeList>

¿Quién lo utiliza y cómo?


...