GET /sif/unoSchool/unoStudentExt

Owned by Gerardo Roque CCORP
Last updated: Nov 19, 2020 by Tania RomoVersion comment
Estado

EN USO

En Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.

Situación actual

Descripción

Consulta los Alumnos asociados a un Colegio para un Ciclo en específico. Opcionalmente se puede filtrar por nivel, grado y/o grupo. En esta consulta no se enlistan alumnos con borrado lógico.

Referencia SIFExtensión de SIF 3.0.1
Entidad BDCAlumno
Entidad SIF

UNOStudent (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 se 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 el identificador del colegio.</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>
  • Si no se especifica el parámetro, como es obligatorio devuelve:

    • <code>400</code>
      <message>Debe especificar el identificador del colegio.</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 usuariosSe 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

https://homol.uno-internacional.com/sif/unoSchool/unoStudentExt;contextId={"school":1135, "schoolYear":2017, "keys":false, "level":18, "grade":25, "group":17}

Respuesta

<unoStudentExtList>

    <unoStudentExt personRefId="00000000-0000-1000-0000-000001029240" >
        <name>
            <firstName>DANA PAULINA</firstName>
            <middleName>AMEZCUA</middleName>
            <lastName>SANCHEZ</lastName>
        </name>
        <birthDate>2003-06-15</birthDate>
        <sex>Female</sex>
        <userId>dana.amezcua.sm</userId>
        <language>ES</language>
        <zona_horaria_id>16</zona_horaria_id>
        <hash>*9A0E260DB980C19AC1625666E9BDEA88635F20D4</hash>
        <schoolRefId>00000000-0000-1000-0000-000000001135</schoolRefId>
        <addressList>
            <address addressType="Physical">
                <street>
                    <line1></line1>
                </street>
                <city></city>
                <neighborhood></neighborhood>
                <postalCode></postalCode>
                <buildingSiteNumber></buildingSiteNumber>
                <county>METEPEC</county>
                <stateProvince>Estado de México</stateProvince>
                <countyRefId>00000000-0000-1000-0000-000000011121</countyRefId>
            </address>
        </addressList>
        <phoneNumberList></phoneNumberList>
        <schoolEmailList></schoolEmailList>
    </unoStudentExt>
    <unoStudentExt personRefId="00000000-0000-1000-0000-000001924491" >
        <name>
            <firstName>ALEXEI</firstName>
            <middleName>RUIZ</middleName>
            <lastName>HERNANDEZ</lastName>
        </name>
        <birthDate>2003-09-20</birthDate>
        <sex>Male</sex>
        <userId>alexei.ruiz.sm</userId>
        <language>ES</language>
        <zona_horaria_id>16</zona_horaria_id>
        <hash>*A8635EE091969D31713C8CCA75BEDF263D533E94</hash>
        <schoolRefId>00000000-0000-1000-0000-000000001135</schoolRefId>
        <addressList>
            <address addressType="Physical">
                <street>
                    <line1></line1>
                </street>
                <city></city>
                <neighborhood></neighborhood>
                <postalCode></postalCode>
                <buildingSiteNumber></buildingSiteNumber>
                <county>METEPEC</county>
                <stateProvince>Estado de México</stateProvince>
                <countyRefId>00000000-0000-1000-0000-000000011121</countyRefId>
            </address>
        </addressList>
        <phoneNumberList></phoneNumberList>
        <schoolEmailList></schoolEmailList>
    </unoStudentExt>

    <unoStudentExt personRefId="00000000-0000-1000-0000-000004954309" >

.........

    </unoStudentExt>

</unoStudentExtList>

¿Quién lo utiliza y cómo?

Este servicio será utilizado sólo por MIM para consultar datos de alumnos asociados a un colegio para un ciclo específico con la BDC.