Servicio /sif/unoSchool/grade

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

Extensión de SIF 3.0.1

Entidad BDC

Grado

Entidad SIF

grade (Lista)

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