Versions Compared

Key

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

...

DescripciónEntrega listado de personas de tipo staff modificadas o creadas en un rango de fechas determinados y vinculadas a un colegio y ciclo escolar.
Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónGET
Parámetros o Campos
CamposDescripciónReglas 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 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

http://homol.uno-internacional.com/sif/unoSchool/deltaStaffSectionAssociation;contextId={"school":1135,"schoolYear":2015,"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, parametro parámetro del rol y descripción del rol
</roles>
</staffSectionAssociation>

</staffSectionAssociationList>

Clientes que lo consumen

 

...