Versions Compared

Version Old Version 2 New Version Current
Changes made by

Samara Carmona. CCORP

Tania Romo

Saved on

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.

...



Este servicio será consultado por las aplicaciones que necesiten sincronizar datos de la asociación Alumno-Grado-Grupo del Staff del Colegio para un ciclo escolar específico con la BDC con cierta periodicidad.

Situación actual

Descripción

Consulta

la asociación Alumno-Grado-Grupo

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
Extensión de SIF 3.0.1
UNOStaff (Lista).
Tipo de PeticiónGET
Parámetros o Campos


CamposDescripciónReglas de negocio
school
  • 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
  • (Opcional) Id del Nivel del Colegio que se consulta.
Ver
  • Los valores se pueden consultar en maestro de niveles
.  
  • 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 usuariosSe 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 usuariosSe 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
http

https://

desenv

homol.uno-internacional.com/sif/unoSchool/

studentGroupAssociation

unoStaff;contextId={"school":1135,"schoolYear":

2015

2017,"

level

keys":

18

false, "

keys

level":

false

17}

Respuesta
<studentGroupAssociationList>

<unoStaffList>

<studentGroupAssociation

<unoStaff refId="

00000016

00000000-0000-1000-0000-

000002657856

000001158040">

refId compuesto por el grupo_id y alumno.alumno

persona.persona_id (Identificador único en la

BDC).  Ver maestro de Grupos.
<unoStudentRefId>00000000-0000-1000-0000-000002657856</unoStudentRefId> alumno.alumno_id (Identificador único en la BDC)
  <gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId> grado_id
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId> grupo_id. Ver maestro de Grupos.
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657857" >
<unoStudentRefId>00000000-0000-1000-0000-000002657857</unoStudentRefId>
<gradeRefId>00000000

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-

000000000026</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>
<studentGroupAssociation refId="00000016-0000-1000-0000-000002657860" >
<unoStudentRefId>00000000-0000-1000-0000-000002657860</unoStudentRefId>
<gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId>
<groupRefId>00000000-0000-1000-0000-000000000016</groupRefId>
</studentGroupAssociation>

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">

......

<resumen>
<niveles>
<nivel>
<nivel_id>18</nivel_id> nivel_id</grupos>
</nivel>
</niveles>
<total>141</total> total alumno del colegio
</resumen>
</studentGroupAssociationList>

<colegio_nivel_ciclo_id>12776</colegio_nivel_ciclo_id> colegio_nivel_ciclo_id
<grupos>
<grupo>
<grado_id>26</grado_id> grado_id
<grupo_id>16</grupo_id> grupo_id
<total>23</total> total alumno del nivel_id, grado_id y grupo_id
</grupo>

</unoStaff>
</unoStaffList>

¿Quién lo utiliza y cómo?