Uso de la integración IPSIS LIS 2.0 en Brightspace Parent & Guardian
Asegúrese de tener una estrategia para definir exclusivamente sourceId para los padres o tutores en Brightspace, ya que usuario-relación es una asignación de sourceId única entre padres o tutores e hijos. Cuando envía solicitudes replacePerson para crear usuarios, asegúrese de enviar información de sourceId de padre o tutor en la sección de agentes de la solicitud para niños/estudiantes. Con esto se crea la relación entre padre o tutor e hijo.
Se agregaron cinco complementos nuevos al adaptador de LIS IPSIS 2.0, lo que ayuda a crear, actualizar y eliminar la relación padre o tutor-hijo. Los complementos se configuran automáticamente:
- Interfaz IReplaceUserHandler ParentPortalUpdateRelationshipHandler
- Interfaz IDeleteUserHandler ParentPortalDeleteRelationshipHandler
- Interfaz IDeleteUserHandler DeleteUserRemoveRelationshipsHandler
- Interfaz ITranslatePerson PersonRequestAgentsTranslator
- Interfaz ITranslateReadPersonResponse ReadUserAgentsTranslator
ParentPortalCreateRelationshipHandler
ParentPortalUpdateRelationshipHandler crea de forma implícita y actualiza relaciones entre los padres o tutores y los estudiantes (niños).
Implementación:
D2L.Integration.ParentPortal.IPSIS.RequestAdapters.ParentPortalUpdateRelationshipHandler,D2L.Integration.ParentPortal.IPSIS
Comportamiento esperado:
El controlador realiza las siguientes tareas:
• Crea de forma implícita y actualiza una relación padre o tutor-hijo tal según se define en el campo de agente para un estudiante en una solicitud de reemplazo de usuario.
• Sincroniza las relaciones del usuario si se proporciona el campo de extensión SynchronizeRelationships. El estudiante se mantiene en el sistema, pero se eliminan todas las relaciones.
Comportamiento de error:
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Aviso de configuración:
• Debe colocarse después de los controladores de reemplazo.
DeleteUserRemoveRelationshipsHandler
Se utiliza DeleteUserRemoveRelationshipsHandler para quitar las relaciones del agente cuando se elimina el usuario.
Implementación
D2L.IM.IPSIS.Default.Users.Handlers.DeleteUserRemoveRelationshipsHandler,D2L.IM.IPSIS.Default
Comportamiento esperado:
Cuando se elimina un padre o tutor o hijo, la relación se elimina.
Nota de configuración:
Se debe colocar esto después de ParentPortalDeleteRelationshipHandler
ParentPortalDeleteRelationshipHandler
ParentPortalDeleteRelationshipHandler elimina implícitamente las relaciones entre padres o tutores y estudiantes (niños) (es decir, cuando falta una relación, Brightspace eliminará la relación).
Implementación
D2L.Integration.ParentPortal.IPSIS.RequestAdapters.ParentPortalDeleteRelationshipHandler,D2L.Integration.ParentPortal.IPSIS
Comportamiento esperado:
El controlador realiza las siguientes tareas:
• Elimina las relaciones padre o tutor-hijo
Comportamiento de error:
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Aviso de configuración:
• Debe ejecutarse antes de los controladores de eliminación.
PersonRequestAgentsTranslator
Se necesita PersonRequestAgentsTranslator para asignar el identificador del agente.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.PMS.Default.PersonRequestAgentsTranslator,D2L.IM.IPSIS.LIS
Comportamiento esperado:
Asigna a los agentes de la solicitud y crea relaciones de padres o tutores.
Nota de configuración:
Se la debe colocar al final de los traductores.
ReadUserAgentsTranslator
Se utiliza ReadUserAgentsTranslator para recuperar padres y tutores asociados con el usuario.
Implementación:
D2L.IM.IPSIS.LIS.ResultAdapters.PMS.Default.ReadUserAgentsTranslator,D2L.IM.IPSIS.LIS
Nota de configuración:
Se la debe colocar al final de los traductores.
Acerca de la solicitud replacePerson
Extracto de la solicitud replacePerson en la que se destaca la sección de agente.
<ims:agent>
<ims:agentType>
<ims:instanceIdentifier>
<ims:language>en-US</ims:language>
</ims:instanceIdentifier>
<ims:instanceVocabulary> limsglobal.org/lis/pmsv2p0/agenttypevocuabularyvp0 </ims:instanceVocabulary>
<ims:instanceValue>
<ims:textString>Parent</ims:textString>
</ims:instanceValue>
</ims:agentType>
<ims:agentId>
<ims:language>en-US</ims:language>
<ims:textString>parentsourceid</ims:textString>
</ims:agentId>
</ims:agent>
Tipo de agente admitido: Padre o Tutor