/
Servicio /sif/unoSchool/unoStaff

Servicio /sif/unoSchool/unoStaff

Aug 20, 2020
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 del Staff del Colegio para un ciclo escolar específico con la BDC con cierta periodicidad.

Situación actual

Descripción

Consulta el Staff para un Colegio en un Ciclo en específico, si se especifica un Nivel se regresan los datos para ese Nivel, si no se especifica el Nivel se regresan los datos para todos los Niveles asociados al Colegio para el Ciclo especificado. No se enlista staff con borrado lógico.

Referencia SIF

UNOStaff (Lista).

Tipo de Petición

GET

Parámetros o Campos

Campos

Descripción

Reglas de negocio

school

  • (Obligatorio) Id del Colegio correspondiente.

  • Los valores se puede consultar 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

  • El colegio debe existir en el año escolar, en caso de no ser válido devuelve:

    • <code>404</code>
      <message>No se encontraron datos con los parámetros especificados.</message>

  • Si no se especifica el parámetro, como es obligatorio devuelve:

    •  <code>400</code>
      <message>Debe especificar un ciclo para consultar.</message>

level

  • El nivel debe existir para el colegio, en caso de no ser válido devuelve

    • <code>404</code>
      <message>No se encontraron datos con los parámetros especificados.</message>

keys

  • (Opcional) Indicador de regresar solo llaves de entidades.

  • Valores: true, false.

  • Default: false.
     



timeModified

(Opcional) Fecha Brazil/East desde la cuál se solicitan las creaciones/actualizaciones de usuarios

Se consultan los alumno creados y modificados desde esta fecha, teniendo en cuenta los campos:

  • persona.fecha_registro

  • persona.fecha_actualizacion

  • persona_login.fecha_actualizacion

  • persona_rol.fecha_actualizacion

  • alumno.fecha_actualizacion

endTimeModified

(Opcional) Fecha Brazil/East  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 o de formulario

https://homol.uno-internacional.com/sif/unoSchool/unoStaff;contextId={"school":1135,"schoolYear":2017,"keys":false, "level":17}

Respuesta

<unoStaffList>
<unoStaff refId="00000000-0000-1000-0000-000001158040"> persona.persona_id (Identificador único en la BDC)
<name>
<firstName>ADMINISTRADOR MacMini</firstName> Nombre
<middleName></middleName> Apellido paterno
<lastName></lastName> Apellido materno
</name>
<birthDate>1999-11-30</birthDate> Fecha de nacimiento
<sex>Not selected</sex> (Male, Female, Not selected)
<userId>macmini-1135</userId> Username
<language>ES</language> Idioma
<addressList> Listado de domicilios
<address addressType="Physical"> Tipo de dirección (Physical, Mailing, Shipping)
<street>
<line1>MARIANO MATAMOROS S/N ESQ. FRANCISCO MINA</line1> Calle
</street>
<city>METEPEC</city> Ciudad
<neighborhood>COL. SANTA MARÍA OTZACATIPAN</neighborhood> Colonia
<postalCode>55500</postalCode> Código postal
<buildingSiteNumber>0</buildingSiteNumber> Número
<county>METEPEC</county> Municipio
<stateProvince>Estado de México</stateProvince> Estado
<countyRefId>00000000-0000-1000-0000-000000011121</countyRefId> municipio.municipio_id (Identificador único en la BDC)
</address>
</addressList>
<phoneNumberList>
<phoneNumber phoneNumberType="Home"> Tipo teléfono (Home, Mobile)
<number>(722)319-0286 (722)318-4843 (722) 271-3148</number> Número de teléfono
</phoneNumber>
</phoneNumberList>
<schoolEmailList></schoolEmailList> Correo
</unoStaff>

......
<unoStaff refId="00000000-0000-1000-0000-000001403924">

......

</unoStaff>
</unoStaffList>

¿Quién lo utiliza y cómo?