Los adaptadores del IPSIS usan la interfaz de complemento para IReplaceEnrollmentHandler a fin de respaldar la operación de reemplazo de las inscripciones.
La implementación de la interfaz es D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
Las siguientes listas de configuración para la interfaz ReplaceEnrollmentHandler se entregan con el producto. Aparecen junto con el punto de extensión al que están destinadas.
IPSIS, Plantilla: inscripciones
- ReplaceEnrollmentReadIMHandler (Orden de clasificación = 10)
- ReplaceEnrollmentStatusDefaultActiveHandler (Orden de clasificación = 20).
- ReplaceEnrollmentValidateSectionHandler (Orden de clasificación = 30)
- ReplaceEnrollmentCreateIMEnrollmentHandler (Orden de clasificación = 40)
- ReplaceEnrollmentSaveIMEnrollmentHandler (Orden de clasificación = 50)
- ReplaceEnrollmentEnrollLMSOfferingHandler (Orden de clasificación = 60)
- ReplaceEnrollmentEnrollLMSGroupSectionHandler (Orden de clasificación = 70)
- ReplaceEnrollmentUnenrollLMSGroupSectionHandler (Orden de clasificación = 80)
- ReplaceEnrollmentUnenrollLMSOfferingHandler (Orden de clasificación = 90)
Segundo plano, Plantilla: segundo plano
- ReplaceEnrollmentUnenrollLMSGroupSectionHandler (Orden de clasificación = 10)
- ReplaceEnrollmentEnrollLMSGroupSectionHandler (Orden de clasificación = 20)
- ReplaceEnrollmentUnenrollLMSOfferingHandler (Orden de clasificación = 30)
- ReplaceEnrollmentEnrollLMSOfferingHandler (Orden de clasificación = 40)
ReplaceEnrollmentReadIMHandler
Se espera que el ReplaceEnrollmentReadIMHandler obtenga toda la información relevante de la base de datos en las tablas de IM.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentReadIMHandler
Comportamiento esperado
Para Brightspace, una inscripción es simplemente un enlace entre una Unidad de organización, un Usuario y un Rol. El controlador ReadIM espera que se lo transmita en los identificadores SIS para cada una de esas entidades, las que utiliza para buscar los objetos asociados del Rol, el Usuario y la Unidad de organización en las tablas de IM y LMS.
El controlador realiza las siguientes tareas:
- Lee la IExternalOrgUnitInfo de la Unidad de organización SIS determinada. Se produce una falla con una excepción si no se encuentra la ExternalOrgUnitInfo (obligatorio).
- Lee la Asignación de roles del Rol SIS determinado, mediante la selección del primero si se transfiere más de uno. Se produce una falla con una excepción si no se encuentra la Asignación de roles (obligatorio).
- Lee la Asignación de usuario de un Usuario SIS determinado. Se produce una falla con una excepción si no se encuentra la Asignación de usuario (obligatorio).
- Si se trata de una actualización a una inscripción de SIS existente, el controlador lee la IEnrollmentMapping. Si no se encuentra la Asignación de inscripción, la solicitud crea una nueva.
- Si se encuentra una Asignación de inscripción, el controlador valida que el Usuario en la solicitud coincida con el Usuario en la inscripción existente.
- Lee la IOrgUnitMappings si existe alguna. Si no se encuentra una Asignación de unidad de organización, el controlador registra un mensaje y continúa. Pueden existir casos de uso válido donde solo se actualicen las tablas de IM.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
Por lo general, el controlador Read se configura primero en la lista.
ReplaceEnrollmentValidateSectionHandler
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentValidateSectionHandler
Comportamiento esperado
El comportamiento esperado para este controlador es el de validar que la solicitud de inscripción actual sea para una sección o grupo de curso.
Comportamiento de error
Si la inscripción no es para un grupo o sección de curso, se genera una InvalidOrgUnitTypeException.
Nota de configuración
Este controlador debe configurarse antes que el controlador ReplaceEnrollmentCreateIMEnrollmentHandler.
ReplaceEnrollmentKeepLMSCreatedEnrollmentsOnUnenrollValidateHandler
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentKeepLMSCreatedEnrollmentsOnUnenrollValidateHandler
Comportamiento esperado
El comportamiento esperado para este controlador es el de validar que la solicitud de inscripción actual corresponda a un registro de inscripción que se originó a partir de una solicitud de SIS (no a una inscripción manual de Brightspace).
Comportamiento de error
Si el registro de inscripción se originó en Brightspace (por ejemplo, el usuario primero se inscribió manualmente en el y, a continuación, el SIS envió una replaceMembership para el mismo usuario y la unidad de organización), el controlador genera una UserManuallyEnrolledInLMSException.
Nota de configuración
Este controlador debe configurarse antes que el ReplaceEnrollmentCreateIMEnrollmentHandler, pero después que el ReplaceEnrollmentReadIMHandler.
ReplaceEnrollmentCreateIMEnrollmentHandler
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentCreateIMEnrollmentHandler
Comportamiento esperado
El comportamiento esperado para este controlador es el de crear Registros de inscripción en las tablas de la base de datos de IM si es que aún no existen. Para cada objeto de Inscripción en la lista de creación de la solicitud, si no existe ninguna Asignación IM, se actualiza IM_ENROLLMENTS.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
Este controlador debe configurarse después de los controladores Read y Validate.
ReplaceEnrollmentEnrollLMSGroupSectionHandler
El ReplaceEnrollmentEnrollLMSGroupSectionHandler inscribe a los usuarios en secciones o grupos que se asignan en Brightspace.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSGroupSectionHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Para cada Objeto de inscripción activo en la lista de inscripciones que se va a actualizar, si el Usuario todavía no está inscrito en la Sección/Grupo, el controlador inscribe al Usuario (esto se traduce automáticamente una entrada de auditoría).
- Si el Usuario ya está inscrito en la Sección/Grupo con un Rol diferente, el controlador anula la inscripción del usuario y lo vuelve a inscribir con un nuevo Rol (esto se traduce automáticamente en una entrada de auditoría).
- Si el Usuario ya está inscrito en la Sección/Grupo con el mismo Rol, el controlador no hace nada.
- El proceso continúa con el controlador siguiente (devuelve True).
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- Este controlador debe configurarse después del controlador SaveIM.
- Este identificador debe configurarse antes que los controladores Inscribir y Anular inscripción de LMSOffering.
- Este controlador no debe configurarse al mismo tiempo que ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler.
ReplaceEnrollmentEnrollLMSOfferingHandler
El ReplaceEnrollmentEnrollLMSOfferingHandler inscribe a los usuarios en las ofertas en Brightspace.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSOfferingHandler
Comportamiento esperado
El controlador realiza las siguientes opciones:
- Para cada Objeto de inscripción activo en la lista de inscripciones que se va a actualizar, si el Usuario todavía no está inscrito en la Oferta, el controlador inscribe al Usuario en la Oferta de cursos (esto crea automáticamente una entrada de auditoría).
- Si el Usuario ya está inscrito en la Oferta con un Rol diferente, el controlador anula la inscripción del usuario y lo vuelve a inscribir con un nuevo Rol (esto se traduce automáticamente en una entrada de auditoría).
- Si el Usuario ya está inscrito en la Oferta con el mismo Rol, el controlador no hace nada.
- El proceso continúa con el controlador siguiente (devuelve True).
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- Este controlador debe configurarse después del controlador EnrollLMSGroupSection.
- Este controlador no debe configurarse al mismo tiempo que ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler.
ReplaceEnrollmentSaveIMEnrollmentHandler
El controlador ReplaceEnrollmentSaveIMEnrollmentHandler guarda cualquier cambio a la inscripción en las Tablas IM, incluidos el Estado y el Rol. También crea una lista de Inscripciones que necesitan actualizarse.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentSaveIMEnrollmentHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Actualiza el Rol y el estado Activo/Inactivo de la inscripción IM actual y guarda los cambios realizados en la base de datos en caso de que algún valor difiera del original.
- Crea una lista de inscripciones que necesitan actualizarse. Una única inscripción IM podría asignar varias inscripciones si las OrgUnitMappings no son uno a uno.
- El procesamiento continúa al siguiente controlador disponible.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
- Este controlador debe ejecutarse después del controlador CreateIMEnrollment.
- Este controlador debe ejecutarse antes que los controladores Inscribir y Anular inscripción del LMS.
ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler
El controlador ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler crea o actualiza la inscripción en la sección o el grupo, pero no actualizará el rol si ya tiene uno. Este controlador inscribe a los usuarios en las secciones o los grupos de Brightspace si aún no están listos. No altera las inscripciones existentes.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Para cada Objeto de inscripción activo en la lista de inscripciones que deben actualizarse, el controlador inscribe al Usuario en la Sección o el Grupo de Brightspace (crea automáticamente una entrada de auditoría).
- El proceso continúa con el controlador siguiente (devuelve True).
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- Este controlador debe configurarse después del controlador SaveIMEnrollment.
- Este controlador debe configurarse antes del controlador EnrollLMSOffering.
- Este controlador no debe configurarse al mismo tiempo que el controlador ReplaceEnrollmentEnrollLMSGroupSectionHandler.
ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler
El controlador ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler crea o actualiza la inscripción en la oferta de cursos, pero no actualizará el rol si ya tiene uno. El controlador no altera las inscripciones existentes.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Para cada Objeto de inscripción activo en la lista de inscripciones que debe actualizarse, el controlador inscribe al Usuario en la Oferta de cursos (crea automáticamente una entrada de auditoría).
- El proceso continúa con el controlador siguiente (devuelve True).
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
- Este controlador debe configurarse después del controlador EnrollLMSGroupSection.
- Este controlador no debe configurarse al mismo tiempo que el controlador ReplaceEnrollmentEnrollLMSOfferingHandler.
ReplaceEnrollmentStatusDefaultActiveHandler
El controlador ReplaceEnrollmentStatusDefaultActiveHandler establece de forma predeterminada el estado de inscripción en Activo si es nulo.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentStatusDefaultActiveHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si el estado actualmente es nulo, el controlador establece el estado en Activo.
- De lo contrario, este controlador se omite y no altera el estado existente.
Situaciones de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- Este controlador debe configurarse después del controlador Read.
- Este controlador debe configurarse antes de los controladores CreateIM y SaveIM.
ReplaceEnrollmentStatusDefaultInactiveHandler
El controlador establece de forma predeterminada el estado de inscripción en inactivo si es nulo.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentStatusDefaultInactiveHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si el estado actualmente es nulo, el controlador establece el estado en Inactivo.
- De lo contrario, este controlador se omite y no altera el estado existente.
Notas de configuración
- Este controlador debe configurarse después del controlador Read.
- Este controlador debe configurarse antes de los controladores CreateIM y SaveIM.
ReplaceEnrollmentUnenrollLMSGroupSectionHandler
El controlador ReplaceEnrollmentUnenrollLMSGroupSectionHandler elimina inscripciones de los Grupos y las Secciones de Brightspace.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentUnenrollLMSGroupSectionHandler
Comportamiento esperado
Este controlador anula las inscripciones de usuarios de las secciones si ya no deben estar inscritos. El controlador realiza las siguientes tareas:
- Para cada Objeto de inscripción inactivo en la lista de inscripciones que debe actualizarse, si la OrgUnit es una Sección de cursos del LMS o un Grupo del LMS, el controlador anula la inscripción del usuario en la Sección o el Grupo (genera automáticamente una entrada de auditoría) y establece RequestStatus = EntityDeleted.
- De lo contrario, el controlador lo omite y continúa con la siguiente inscripción.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
UnenrollLMSGroupSection debe ocurrir después de Validar y antes de UnenrollLMSOffering.
ReplaceEnrollmentUnenrollLMSOfferingHandler
El controlador ReplaceEnrollmentUnenrollLMSOfferingHandler elimina inscripciones de las ofertas de Brightspace.
Implementación
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentUnenrollLMSOfferingHandler
Comportamiento esperado
Este controlador anula las inscripciones de usuarios de las ofertas en Brightspace si ya no deben estar inscritos. Solo anula la inscripción de los usuarios en ofertas si ya no están inscritos en ninguna de las secciones de la oferta.
El controlador realiza las siguientes tareas:
- Para cada Objeto de inscripción en la lista Eliminación, si la inscripción ya no está activa y el usuario no está inscrito es ninguna otra sección de la misma Oferta, el controlador anula la inscripción del usuario de la Oferta de cursos (genera automáticamente una entrada de auditoría) y establece RequestStatus = EntityDeleted.
- De lo contrario, el controlador lo omite y continúa con la siguiente inscripción.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
UnenrollLMSOffering debe ejecutarse después del controlador UnenrollLMSGroupSection.