Page Comparison

Panel

title	Estado

Status

colour	Green
title	En Uso

Info

title	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 alumnos asociados a un colegio para un ciclo específico con la BDC con cierta periodicidad.

Situación actual

Descripción

Consulta los

grados

Alumnos asociados a un

colegio

Colegio para un

ciclo

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

Opcionalmente se puede filtrar por nivel, grado y/o grupo. En esta consulta no se enlistan alumnos con borrado lógico.
Referencia SIF	Extensión de SIF 3.0.1
Entidad BDC

Grado

Alumno

Entidad SIF

grade

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

se 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. Valores: Ver maestro de niveles

.

o servicio /sif/unoSchool/schoolLevel.	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>
grade	(Opcional) Id del grado que se consulta.
group	(Opcional) Id del grupo que se consulta. Ver maestro de Grupos.
keys	(Opcional) Indicador de regresar solo llaves de entidades. Valores: true, false. Default: false.
timeModified	(Opcional) Fecha Brazil/East desde la cuál se solicitan las creaciones/actualizaciones de usuarios	Se consultan los alumno creados y modificados desde esta fecha, teniendo en cuenta los campos: persona.fecha_registro persona.fecha_actualizacion persona_login.fecha_actualizacion persona_rol.fecha_actualizacion alumno.fecha_actualizacion
endTimeModified	(Opcional) Fecha Brazil/East hasta la cuál se solicitan las creaciones/actualizaciones de usuarios	Se consultan los usuarios creados y modificados hasta esta fecha, teniendo en cuenta las mismas reglas de negocio de timeModified.

Ejemplo de llamada o de formulario

http

https://

desenv

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

grade

unoStudent;contextId={"school":1135, "schoolYear":

2016

2017, "keys":

"false"

false, "level":18, "grade":25, "

level

group":17}

Respuesta

<grade

<unoStudent refId="00000000-0000-1000-0000-

000000000019

000005221937" >

grado

alumno.

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

alumno_id (Identificador único en la BDC, asignado para el ciclo escolar)
<studentId></studentId> Clave del alumno
<name>
<firstName>DANA PAULINA</firstName> Nombre
<middleName>AMEZCUA</middleName> Apellido Paterno
<lastName>SANCHEZ</lastName> Apellido Materno
</name>
<birthDate>2003-06-15</birthDate> Fecha de nacimiento
<sex>Female</sex> (Male, Female, Not selected)
<userId>dana.amezcua.sm</userId> Username

<exitDate>2020-01-14</exitDate> Indica que el usuario se encuentra inactivo y fue actualizado en la fecha indicada
<language>ES</language> Idioma
<personRefId>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

000001029240</personRefId> persona.persona_id (Identificador único en la BDC)
<curp>AESD030615MHGMNNA1</curp> CURP
<addressList> Listado de domicilios
<address addressType="Physical"> Tipo de dirección (Physical, Mailing, Shipping)
<street>
<line1></line1> Calle
</street>
<city></city> Ciudad
<neighborhood></neighborhood> Colonia
<postalCode></postalCode> Código postal
<buildingSiteNumber></buildingSiteNumber> Número
<county>METEPEC</county> Municipio
<stateProvince>Estado de México</stateProvince> Estado
<countyRefId>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

000000011121</countyRefId> municipio.municipio_id (Identificador único en la BDC)
</address>
</addressList>
<phoneNumberList></phoneNumberList> Listado de teléfonos
<schoolEmailList></schoolEmailList> Listado de correos electrónicos
</unoStudent>

....

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

000005582760" >

.........
</unoStudent>
</unoStudentList>

¿Quién lo utiliza y cómo?

Version	Old Version 3	New Version Current
Changes made by	Samara Carmona. CCORP	Tania Romo
Saved on	Jan 23, 2017	Aug 20, 2020

Versions Compared

Key

Situación actual