Versions Compared

Version Old Version 3 New Version 4
Changes made by

lfigueroa@santillana.com (Unlicensed)

lfigueroa@santillana.com (Unlicensed)

Saved on

Key

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

...

DescripciónConsulta los usuarios que han sido creados/modificados en un rango de fecha determinado.
Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónGET
Parámetros
CamposDescripciónReglas de negocio
school(Obligatorio) Identificador del colegio a consultar. Los valores de este campo se consultan con el servicio /sif/unoSchool/schools (Falta por documentar este servicio)
  • 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>
page(Obligatorio) La página de resultados a consultar, valor inicial 0
  • Se devuelven como máximo 50 resultados por página, si la página devuelve menos de 50 resultados, significa que ha llegado a su fin.
timeModified(Obligatorio) Fecha UTC desde la cuál se solicitan las creaciones/actualizaciones de usuarios
  • Se consultan los usuarios creados y modificados, consultando el valor persona_rol.fecha_actualizacion (documentar cómo se modifica este campo y confirmar qué modificaciones sobre qué tablas actualizan esta fecha, ver con Antonio de la Torre Camacha. EVRS (persona, persona_login, persona_rol))
  • No debe ser anterior a la fecha de inicio del ciclo escolar activo. (Confirmar si se puede validar)
endTimeModified(Obligatorio) Fecha UTC 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.
active (Opcional) true/false Campo activo de la tabla persona. (Validar si no afecta al rendimiento)
  • Según el valor de este parámetro:
    • true: los usuarios activos modificados
    • false: los usuarios no activos modificados
    • no se especifica: todos los usuarios modificados

 

 

Lógica de negocio

agregada

  • El listado de usuarios solo debe ser para el ciclo activo actual y los datos de cada usuario también. (schoolYear opcional, podría ser una opción)
  • (Añadir la existente)

Ejemplo de llamada

http://desenv.uno-internacional.com/sif/unoSchool/deltaUsers;contextId={"school":"XXXX","page":0, "timeModified":"2015-07-21T00:00:01.000+0000","endTimeModified":"2015-07-27T00:00:01.000+0000";active=true}}

Ejemplo de respuesta:

<usersList pageSize="50">

<unoUser personRefId="00000000-0000-1000-0000-000003781040">

<name>
<firstName>ANTONIO RAY</firstName>
<middleName/>
<lastName>SILVA</lastName>
</name>
<birthDate>1992-07-09</birthDate>
<sex>Male</sex>
<userId>rayprogramadorweb1122@gmail.com</userId>
<active>true</active>
<phoneNumberList/> * Si está en otra tabla no es tan importante
<schoolEmailList>
<schoolEmail>
<email>lionefv@hotmail.com</email>
</schoolEmail>
<schoolEmail>
<email>lionefv@hotmail.com</email>
</schoolEmail>
</schoolEmailList>
<businessList>
<business name="BR/COMP">
<role>
<roleDescription>Profesor</roleDescription>
<roleParam>003</roleParam>
</role>
</business>
</businessList>
</unoUsert>

...

</usersList>

Clientes que lo consumen 

...