You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 2
Next »
EN FASE DE ANÁLISIS - DESARROLLO
Este servicio será consultado por las aplicaciones que necesiten sincronizar datos de usuarios con la BDC con cierta periodicidad.
Situación actual
Descripción | Consulta los usuarios que han sido creados/modificados en un rango de fecha determinado. |
Referencia SIF | Extensión de SIF 3.0.1 |
Tipo de Petición | GET |
Parámetros | Campos | Descripción | Reglas 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:
- 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)
- 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 | |
Tareas realacionadas