You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 7
Next »
EN USO
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 | - 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>
| schoolYear | (Obligatorio) Ciclo escolar | - Se devuelven datos del ciclo escolar especificado. En caso de no encontrar datos regresa:
<error><code>404</code><message>No se encontraron datos con los parametros especificados.</message></error>
| 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, persona.fecha_actualizacion y persona_login.fecha_actualizacion (se actualiza la fecha con cualquier campo modificado del registro)
- En caso de no encontrar datos regresa:
<error><code>404</code><message>No se encontraron datos con los parametros especificados.</message></error>
| 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. | - 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 | - Se informan los usuarios que han sido modificados segun rango de fechas indicadas, el colegio y ciclo escolar
|
Ejemplo de llamada | http://homol.uno-internacional.com/sif/unoSchool/deltaUsers;contextId= {"school":1252,"schoolYear":2016, "page":0, "timeModified":"2016-06-01 00:00:01", "endTimeModified":"2016-06-15 23:00:01", "active":"true"} |
Ejemplo de respuesta: | <usersList pageSize="50"> <unoUser personRefId ="00000000-0000-1000-0000-000001028615"> <name> <firstName>COLEGIO EL CAMINO</firstName> <middleName></middleName> <lastName></lastName> </name> <birthDate></birthDate> <sex>Not selected</sex> <userId>C.CAMINO-K</userId> <active>true</active> <phoneNumberList> <phoneNumber phoneNumberType="Home"> <number>(624) 143 2100</number> </phoneNumber> </phoneNumberList> <schoolEmailList> <schoolEmail> <email>alma@colegioelcamino.com, carmenp@colegioelcamino.com, danylu@colegioelcamino.com</email> </schoolEmail> <schoolEmail> <email>----</email> </schoolEmail> </schoolEmailList> <businessList> <business name="MX/UNOI"> <role> <roleDescription>Administrador</roleDescription> <roleParam>111</roleParam> </role> </business> </businessList> </unoUser> <usersList> |
Clientes que lo consumen | |
Tareas realacionadas