/
Servicio /sif/unoSchool/deltaStaffSectionAssociation

Servicio /sif/unoSchool/deltaStaffSectionAssociation

Jun 07, 2019
Estado

EN USO

En Uso

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.

Situación actual

Descripción

Entrega listado de personas de tipo staff modificadas o creadas en un rango de fechas determinados y 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  ( ó Id del 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 de tipo STAFF 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.

 

 

Ejemplo de llamada

https://homol.uno-internacional.com/sif/unoSchool/deltaStaffSectionAssociation;contextId={"school":1135,"schoolYear":2017,"page":0, "timeModified":"2015-01-01 00:00:01", "endTimeModified":"2016-05-03 23:00:01"}

Respuesta

<staffSectionAssociationList pageSize="200">

<staffSectionAssociation refId="00000017-2015-1000-0000-000001175291" > refId compuesto por nivel_id del colegio al que fue vinculado el staff, año del ciclo escolar en el que fue vinculado el staff y persona.persona_id (identificador único en la BDC)
<staffPersonRefId>00000000-0000-1000-0000-000001175291</staffPersonRefId>persona.persona_id (identificador único en la BDC)
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>nivel_id del colegio al que fue vinculado el staff
<roles>
<rol active="true" param="003">Profesor</rol>activo, parámetro del rol y descripción del rol
</roles>
</staffSectionAssociation>

</staffSectionAssociationList>

Clientes que lo consumen

 

Enlaces

  • SSB-490 - Getting issue details... STATUS