Versions Compared

Version Old Version 4 New Version Current
Changes made by

lfigueroa@santillana.com (Unlicensed)

Christian Romo

Saved on

Key

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


Panel
titleEstado
 
Status
colourGreen
titleEn uso
 

 

Noteinfo
titlePetición de cambioEn uso

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


 

 

Panel
titleImpacto


Esta petición de cambio
Noteinfo
titlePetición de cambio
En uso

Este servicio impacta a los sistemas que

aprovisionan usuarios a través de SIF y que delegan la autenticación en Santillana Connect

relacionan empleados con un nivel educativo.


Situación actual

DescripciónRelaciona un empleado con un nivel educativo.
Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónPOST, PUT
Parámetros o Campos


CamposDescripciónReglas de negocio
refId

(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.


Ejemplo de llamada
http

https://

desenv

homol.uno-internacional.com/sif/staffSectionAssociation;contextId={"school":

1135

3726, "schoolYear":

2014

2018}

<staffSectionAssociation refId="">

<staffPersonRefId>
00000000

<staffPersonRefId>00000000-0000-1000-0000-

000001400596
<

000001400596</staffPersonRefId>

<schoolLevelRefId>
00000000

<schoolLevelRefId>00000000-0000-1000-0000-

000000000018
<

000000000017</schoolLevelRefId>
<roles>
<rol active="true" param="003">Profesor</rol>
</roles>
</staffSectionAssociation>


Respuesta

<createResponse>
<creates>
<create id="

00000018

00000017-

2014

2018-1000-0000-000001400596"


statusCode="200" ></

>

create>
</creates>
</createResponse>

¿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.