Post y Put /sif/StaffSectionAssociation

Estado

EN USO

En uso

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

Impacto

En uso

Este servicio impacta a los sistemas que relacionan empleados con un nivel educativo.

Situación actual

Descripción

Relaciona un empleado con un nivel educativo. Se valida que la persona no tenga borrado lógico.

Referencia SIF

Extensión de SIF 3.0.1

Tipo de Petición

POST, PUT

Parámetros o Campos

Campos	Descripción	Reglas 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.	(Preguntar a Jose Luis Gonzalez. SGLB)
schoolYear	(Obligatorio) Año escolar activo del colegio ( ó Id del Ciclo Escolar )	Año final del ciclo sobre el que se quiere trabajar.
personRoleId	(Opcional) Persona Rol Id del usuario que realiza el cambio.	Si el cambio en una entidad se realizó en alguna herramienta administrativa (Acuerdo, Censo, SINCROBDC, etc), el valor almacenado corresponde al usuario con rol administrativo que realizó el cambio (Administrador, Staff, Administrador de Colegio)

Ejemplo de llamada

https://homol.uno-internacional.com/sif/staffSectionAssociation;contextId={"school":3726, "schoolYear":2018}

PUT https://homol.uno-internacional.com/sif/staffSectionAssociation/00000017-2018-1000-0000-000001400596

<staffSectionAssociation refId="">
<staffPersonRefId>00000000-0000-1000-0000-000001400596</staffPersonRefId>
<schoolLevelRefId>00000000-0000-1000-0000-000000000017</schoolLevelRefId>
<roles>
	<rol active="true" param="003">Profesor</rol>
</roles>
<personRoleId>00000000-0000-1000-0000-000000526589</personRoleId>
</staffSectionAssociation>

Respuesta

<createResponse>
<creates>
	<create id="00000018-2014-1000-0000-000001400596" statusCode="200" />
</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.