Versions Compared

Version Old Version 2 New Version 3
Changes made by

Samara Carmona. CCORP

Samara Carmona. CCORP

Saved on

Key

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

Status
colourGreen
titleEn

uso 

 

Uso

Info
titleEn usoUso

Cuando un requisito de sistema software tenga el estado En Uso , tendrá descrita la situación actual.

 

 

Panel
titleImpacto
Info
titleEn uso

Este servicio impacta a los sistemas que relacionan empleados con un nivel educativosignifica que está disponible para su uso.

 

Este servicio será consultado por las aplicaciones que necesiten sincronizar datos de la asociación Staff-Nivel-Rol para un Colegio en un Ciclo en específico con la BDC con cierta periodicidad.

Situación actual

Ejemplo de llamada
DescripciónRelaciona un empleado con un nivel educativo

Consulta la asociación Staff-Nivel-Rol 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.

Referencia SIFExtensión de SIF 3.0.1staffSectionAssociation (Lista)
Tipo de PeticiónPOST, PUTGET
Parámetros o Campos
CamposDescripciónReglas de negocio
refId
school
  • (Obligatorio
en el caso del PUT) UUID de la entidad StaffSectionAssociation que se actualiza.
  • Este identificador se obtiene del servicio GET /sif/unoSchool/staffSectionAssociation
staffPersonRefId(Obligatorio) Tipo de relación que se establece
  • Este identificador se puede obtener del servicio /sif/unoUser
schoolLevelRefId(Obligatorio) RefId del nivel que se va a relacionar con el empleado
  • Este identificador se puede obtener del servicio /sif/unoSchool/schoolLevel/
roles(Obligatorio) Rol que se asigna al empleado
  • Los valores que puede tomar están en el maestro de roles Maestros.
school(Obligatorio) Colegio al que pertenece el nivel educativo.
schoolYear(Obligatorio) Año escolar activo del colegio
  • Año final del ciclo sobre el que se quiere trabajar.
  • ) Id del Colegio correspondiente
  • 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) Año escolar que se consulta 
  • 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 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>

 

 

Ejemplo de llamada o de formulario

http://desenv.uno-internacional.com/sif/unoSchool/staffSectionAssociation;contextId={"school":1135,"schoolYear":2014, "level":17}

Respuesta

<staffSectionAssociationList>
<staffSectionAssociation refId="00000017-2017-1000-0000-000001158040" >
<staffPersonRefId>
00000000 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-000001158040</staffPersonRefId> persona.persona_id (identificador único en la BDC)
<schoolLevelRefId>00000000-0000-1000-0000-000001400596000000000017</schoolLevelRefId> nivel_id del colegio al que fue vinculado el staff
<roles>
<rol active="true" param="ADMM">Administrador aplicación server colegio</rol> activo (true, false), parámetro del rol y descripción del rol. Ver maestro de roles.
</roles>
</staffPersonRefId>
<schoolLevelRefId>
00000000staffSectionAssociation>
<staffSectionAssociation refId="00000017-2017-1000-0000-000001403924" >
<staffPersonRefId>00000000-0000-1000-0000-000000000018
<000001403924</staffPersonRefId>
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<roles>
<rol active="true" param="003210">Profesor<>Coach</rol>
</roles>
</staffSectionAssociation>

Respuesta

<createResponse>
<creates>
<create id="00000018-2014.....

<staffSectionAssociation refId="00000017-2017-1000-0000-000005028949" >
<staffPersonRefId>00000000-0000-1000-0000-000005028949</staffPersonRefId>
<schoolLevelRefId>00000000-0000-1000-0000-000001400596"
statusCode="200" />
</creates>
</createResponse>000000000017</schoolLevelRefId>
<roles>
<rol active="true" param="111">Administrador</rol>
<rol active="true" param="006">Coordinador</rol>
</roles>
</staffSectionAssociation>
</staffSectionAssociationList>

¿Quién lo utiliza y cómo?Lo utiliza Compartir en Familia, Líderes Compartir, SIS, etc.
  • No hay limitación en los roles que se asignen, siempre y cuando estén en el maestro de roles (Maestros.)
  • El schoolYear debe estar habilitado para el colegio.
  • El schoolLevel debe ser un nivel válido para el colegio.
  • El param de rol está en el maestro informado como "paámetro" y el valor del rol también está informado en el maestro como "rol".
  • Cuando se relacione un familiar mediante el servicio StaffSectionAssociation (POST/PUT) con un nivel, solicitamos que el país de la empresa a la que pertenezca el nivel sea asignado al empleado en el campo destinado para ello (persona.pais_id), ya que en el propio servicio unoStaff POST no se permite.
    • Si el empleado ya tiene asignado un país, no se sobrescribe, se queda con el que ya tuviese informado.