Versions Compared

Version Old Version 6 New Version 7
Changes made by

Samara Carmona. CCORP

lfigueroa@santillana.com (Unlicensed)

Saved on

Key

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

Status
colourRedGreen
titleEn fase de análisis - desarrolloUso

Info
titleEn fase de análisis - desarrollo

Cuando un requisito de sistema software tenga el estado En fase de análisis - desarrollo Uso significa que aún no está disponible para su uso.

...

DescripciónConsulta los usuarios que han sido creados/modificados en un rango de fecha determinado.
Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónGET
Parámetros
CamposDescripciónReglas de negocio
school(Obligatorio) Identificador del colegio a consultar. Los valores de este campo se consultan con el servicio /sif/unoSchool/schools (Falta por documentar este servicio)
  • 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 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 . (documentar cómo se modifica este campo y confirmar qué modificaciones sobre qué tablas actualizan esta fecha, ver con Antonio de la Torre Camacha. EVRS (persona, persona_login, persona_rol))No debe ser anterior a la fecha de inicio del ciclo escolar activo. (Confirmar si se puede validar, No se valida ya que se estan filtrando por el ciclo escolarse actualiza la fecha con cualquier campo modificado del registro)
  • En caso de no encontrar datos regresa:
    <error><code>404<<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. (Validar si no afecta al rendimiento, No vi diferencia significante con filtro o sin filtro)
  • 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 

...