Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Link Fixer


Panel
titleEstado

Status
colourGreen
titleEn Uso

Info
titleEn Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.


...

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 escolarCiclo 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 usuariosEl parámetro se adiciona para aquellas empresas que cuentan con ciclos escolares semestrales
  • Se consultan los usuarios creados y modificados hasta esta fecha, teniendo en cuenta las mismas reglas de negocio de timeModified.
sessionId
  • (Opcional) Id del ciclo escolar dónde se desea crear. Ver maestro de Ciclo Escolar
  • .



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


...