...
| Panel |
|---|
|
| Info |
|---|
| Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso. |
|
Este servicio será consultado por las aplicaciones que necesiten sincronizar datos de usuarios con la BDC con cierta periodicidad.
...
| Descripción | Entrega listado de personas de tipo FAMILIAR modificadas o creadas en un rango de fechas determinados, vinculadas a un colegio y ciclo escolar. |
| Referencia SIF | Extensión de SIF 3.0.1 |
| Tipo de Petición | GET |
| Parámetros o Campos |
| 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:
- <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>
| | 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 200 resultados por página, si la página devuelve menos de 200 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 las personas tipo FAMILIAR creadas y modificadas, consultando el valor persona_rol.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.
| | grade | (Opcional) Id del grado que se consulta. |
| | group | (Opcional) Id del grupo que se consulta. Ver maestro de Grupos. |
| | sessionId | - (Opcional) Id del ciclo escolar dónde se desea crear. Ver maestro de
|
| El parámetro se adiciona para aquellas empresas que cuentan con ciclos escolares semestrales. |
|
| Ejemplo de llamada | https://homol.uno-internacional.com/sif/unoSchool/deltaContactRelationship;contextId={"school":1135,"schoolYear":2017,"page":0, "timeModified":"2015-01-01 00:00:01", "endTimeModified":"2016-05-03 23:00:01", "group":16, "grade":25} |
| Respuesta | <contactRelationshipList pageSize="200">
<contactRelationship refId="03157975-0000-1000-0000-000002657856" > persona.persona_id (identificador único en la BDC), alumno.alumno_id (refId asignado para el ciclo escolar)
<relationshipToLearnerType>Father</relationshipToLearnerType> tipo relacion. Los posibles valores son: Mother, Father y Other.
<unoStudentRefId>00000000-0000-1000-0000-000002657856</unoStudentRefId> alumno.alumno_id (refId asignado para el ciclo escolar)
<contactPersonRefId>00000000-0000-1000-0000-000003157975</contactPersonRefId> persona.persona_id (identificador único en la BDC)
</contactRelationship> </contactRelationshipList> |
| Quienes lo consumen |
|
| Panel |
|---|
|
| Jira Legacy |
|---|
| server | System Jira |
|---|
| serverId | 487df0e8-a840-3c8c-bc14-813b0587c34e |
|---|
| key | SSB-492 |
|---|
|
|
...