Los Adaptadores del IPSIS usan la interfaz de complemento para IDeleteSectionAssociationHandler para eliminar las SectionAssociations de Brightspace.
La implementación de la interfaz es D2L.IM.IPSIS.OrgUnits.SectionAssociations.Handlers.IDeleteSectionAssociationHandler.
La lista de configuración del IPSIS Plantilla: asociación de sección ofrece un punto de partida para la implementación del IPSIS.
La siguiente lista de controladores se utiliza como un punto de partida:
- DeleteSectionAssociationValidateHandler (Orden de clasificación = 10)
- DeleteSectionAssociationIMHandler (Orden de clasificación = 20)
DeleteSectionAssociationValidateHandler
El controlador DeleteSectionAssociationValidateHandler debería utilizarse siempre. Realiza la validación de entrada necesaria para asegurar que todos los demás controladores Delete funcionen correctamente.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Comprueba que el Id del SIS en la solicitud corresponda a un elemento real en las tablas de IM.
- Comprueba que el tipo de OrgUnit que el servicio espera coincida con el Tipo de orgUnit en la base de datos.
- Si se superan todas las pruebas, el controlador guarda la ExternalOrgUnitInfo sobre la solicitud para que los controladores lo utilicen posteriormente.
Comportamiento de error
Si la validación falla, se genera una excepción, junto con información lo más detallada posible.
Nota de configuración
El controlador Validate normalmente debe ejecutarse en primer lugar en la lista de controladores, antes de que cualquier controlador actualice o elimine la información de la base de datos.
DeleteSectionAssociationIMHandler
El controlador DeleteSectionAssociationIMHandler debería utilizarse siempre. Realiza la validación de entrada necesaria para asegurar que todos los demás controladores Delete funcionen correctamente.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Comprueba que el Id del SIS en la solicitud corresponda a un elemento real en las tablas de IM.
- Comprueba que el tipo de OrgUnit que el servicio espera coincida con el Tipo de orgUnit en la base de datos.
- Si se superan todas las pruebas, el controlador guarda la ExternalOrgUnitInfo sobre la solicitud para que los controladores lo utilicen posteriormente.
Comportamiento de error
Si la validación falla, se genera una excepción, junto con información lo más detallada posible.
Nota de configuración
El controlador Validate normalmente debe ejecutarse en primer lugar en la lista de controladores, antes de que cualquier controlador actualice o elimine la información de la base de datos.
DeleteSectionAssociationIMHandler
El controlador DeleteSectionAssociationIMHandler realiza una eliminación temporal de la SectionAssociation en las tablas de IM.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationIMHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Marca la SectionAssociation como Eliminado en la Tabla de OrgUnits de IM.
- Elimina los registros de jerarquía de la SectionAssociation.
- Si se produce un problema durante el procesamiento, el controlador establece el estado del resultado según el código de error apropiado.
- Si todo es correcto, el procesamiento continúa con el siguiente controlador (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
El controlador IM Delete debe ejecutarse en último lugar.
DeleteSectionAssociationInactiveLMSOfferingHandler
El controlador DeleteSectionAssociationInactiveLMSOfferingHandler se utiliza si el comportamiento deseado es desactivar todas las Ofertas del LMS asignadas.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationInactiveLMSOfferingHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Desactive todas las Ofertas de cursos relacionadas con la SectionAssociation especificada en el LMS. Este controlador marca como inactivos todas las asignaciones de las Ofertas de cursos del LMS.
- Si todo se realiza correctamente, el controlador establece el estado del resultado en EntityDeleted.
- 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 ejecutarse antes del controlador DeleteIM.
DeleteSectionAssociationDeleteLMSGroupSectionHandler
El controlador DeleteSectionAssociationDeleteLMSGroupSectionHandler se utiliza si el comportamiento deseado es eliminar algún Grupo o Sección del LE que están asociados con una Oferta de cursos del LE asignada a la Asociación de sección.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSGroupSectionHandler
Comportamiento esperado
Este controlador solo puede actuar si existe una asignación del registro de la Asociación de sección propiamente dicha. El controlador realiza las siguientes tareas:
- Para cada OrgUnit del LMS a la que se asigna la Asociación de sección, el controlador determina los elementos secundarios de la OrgUnit del LMS en Brightspace.
- Para cada Grupo o Sección secundarios del LMS de una OrgUnit que la que se asigne la AS, el controlador elimina el Grupo o la Sección del LMS (genera automáticamente una entrada de auditoría) y elimina los registros de asignaciones de IM asociados con el Grupo o la Sección del LMS.
- Si todo se realiza correctamente, el controlador establece el estado del resultado en EntityDeleted.
- 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 ejecutarse antes del controlador DeleteIM.
- Si este controlador se utiliza junto con el controlador DeleteLMSOffering, el controlador DeleteLMSGroupSection debe preceder al controlador DeleteLMSOffering.
DeleteSectionAssociationDeleteLMSOfferingHandler
El controlador DeleteSectionAssociationDeleteLMSOfferingHandler se utiliza si el comportamiento deseado es eliminar la Oferta de cursos de Brightspace relacionadas con la Asociación de sección.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSOfferingHandler
Comportamiento esperado
Para cada Oferta de cursos del LMS asignada, el controlador realiza las siguientes tareas:
- Si la oferta no tiene más secciones asignadas como secundarias (se deben comparar todas las secciones secundarias de la oferta con las unidades de organización en la tabla de asignaciones de IM), el controlador elimina la oferta de cursos del LMS (se genera automáticamente una entrada de auditoría).
- Si la oferta tiene más Secciones asignadas como secundarias, el controlador no elimina la Oferta de cursos del LMS.
- El controlador realiza una eliminación temporal del registro de Asignaciones de IM asociada con la Oferta.
- Si todo se realiza correctamente, el controlador establece el estado del resultado en EntityDeleted.
- 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 ejecutarse antes del controlador DeleteIM.
DeleteSectionAssociationUnenrolLMSGroupSectionHandler
El controlador DeleteSectionAssociationUnenrolLMSGroupSectionHandler anula la inscripción de los usuarios de las secciones que deben eliminarse desde la asociación.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrollLMSGroupSectionHandler
Comportamiento esperado
Este controlador solo se ejecuta si existe una asignación para la Asociación de sección y si existen secciones asociadas (con una asignación) que deben eliminarse del LMS. El controlador realiza las siguientes tareas:
- Para cada Sección de la Jerarquía de asociación de sección, el controlador determina qué usuarios se inscriben en la Sección (desde la Tabla de inscripciones de IM).
- Anula la inscripción de los usuarios de la Sección de cursos específica del LMS que debe eliminarse (genera automáticamente una entrada de auditoría).
- Si todo se realiza correctamente, el controlador establece el estado del resultado en EntityDeleted.
- 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 colocarse antes del controlador DeleteLMSGroupSection para garantizar que las inscripciones no permanezcan en un LMS inadecuado.
DeleteSectionAssociationUnenrolLMSOfferingHandler
El controlador DeleteSectionAssociationUnenrolLMSOfferingHandler anula la inscripción de los usuarios de las ofertas principales de la asignación de secciones eliminada, a menos que estén inscritos en otro grupo/sección con el mismo tipo de grupo en la oferta.
Implementación
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrolLMSOfferingHandler
Comportamiento esperado
Este controlador solo se ejecuta si existe una asignación para la Asociación de sección y si existen secciones asociadas (con una asignación) que deben eliminarse del LMS. El controlador realiza las siguientes tareas:
- Para cada Sección de la Jerarquía de asociación de sección, el controlador determina qué usuarios se inscriben en la Sección (desde la Tabla de inscripciones de IM).
- Si el Usuario no está inscrito en las Secciones (o Grupos) con el mismo tipo de grupo, en la Oferta del LMS, el controlador anula las inscripciones de los usuarios de la Oferta de cursos del LMS que debe eliminarse (genera automáticamente una entrada de auditoría).
- Si todo se realiza correctamente, el controlador establece el estado del resultado en EntityDeleted.
- 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 colocarse después del controlador Create IM.
- Este controlador debe colocarse antes del controlador DeleteLMSGroupSection para garantizar que las inscripciones no permanezcan en un LMS inadecuado.
- Este controlador debe ejecutarse antes del controlador Save IM.