De plug-in-interface voor IDeleteCourseOfferingHandler wordt door IPSIS-adapters gebruikt om cursusedities uit Brightspace® te verwijderen.
De interface-implementatie is D2L.IM.IPSIS.OrgUnits.CourseOfferings.Handlers.IDeleteCourseOfferingHandler.
De volgende configuratielijsten bieden een startpunt voor elke IPSIS-implementatie:
IPSIS, sjabloon - Cursuseditie
- DeleteCourseOfferingValidateHandler (sorteervolgorde = 10)
- DeleteCourseOfferingIMHandler (sorteervolgorde = 10)
DeleteCourseOfferingValidateHandler
Deze handler moet altijd worden gebruikt. Het voert invoervalidatie uit die nodig is om te verzekeren dat alle andere Delete-handlers goed werken.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingValidateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Controleert of de SIS-id op de aanvraag overeenkomt met een echt onderdeel in de IM-tabellen.
- Controleert of het type organisatie-eenheid dat de service verwacht overeenkomt met het type organisatie-eenheid in de database.
- Als alle controles slagen, wordt de ExternalOrgUnitInfo over de aanvraag opgeslagen voor gebruik door latere handlers.
Foutgedrag
Als een onderdeel van de validatie mislukt, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
De validate-handler moet doorgaans eerst in de lijst met handlers worden uitgevoerd, voordat een handler die informatie uit de database bijwerkt of verwijdert.
DeleteCourseOfferingIMHandler
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingIMHandler®
Verwacht gedrag
Als er iets afhankelijk is van de cursuseditie (onderliggende onderdelen van IM-hiërarchie), moet dit proces mislukken. De handler voert de volgende taken uit:
- Verwijdert de cursuseditie voorlopig uit de IPSIS-tabellen als er niets van de cursuseditie afhankelijk is.
- Verwijdert alle bovenliggende relaties van IM-hiërarchie voor deze editie.
- Stelt de status van het resultaat in op EntityDeleted.
- De verwerking gaat door naar de volgende geconfigureerde handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
De Delete IM-handler moet doorgaans als laatste in de lijst met handlers worden uitgevoerd.
DeleteCourseOfferingDeleteLEHandler
Deze handler wordt gebruikt als het gewenste gedrag is dat alle toegewezen Brightspace®-edities worden verwijderd.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingDeleteLEHandler®
Verwacht gedrag
Voor elke toegewezen Brightspace®-cursuseditie voert de handler de volgende taken uit:
- Verwijdert de cursuseditie (automatisch resulterend in een controlevermelding).
- Markeert alle toewijzingen aan de Brightspace®-cursuseditie als verwijderd.
- Stelt de status van het resultaat in op EntityDeleted.
- De verwerking gaat door naar de volgende handler (retourneert True).
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
- Dit moet gebeuren voordat de IM-tabel wordt verwijderd (bijvoorbeeld: DeleteCourseOfferingIMHandler).
- Deze handler zou niet tegelijkertijd met DeleteCourseOfferingInactiveLHandler worden geconfigureerd.
DeleteCourseOfferingCascadeDeleteCourseSectionHandler
Deze handler wordt gebruikt als het gewenste gedrag eruit bestaat om het verwijderen van de cursus door te geven aan alle secties die onderliggende onderdelen zijn van de cursuseditie in de IM-tabellen.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingCascadeDeleteCourseSectionHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Identificeert alle secties die onderliggende onderdelen zijn van een cursuseditie in de IM-tabellen.
- Voor elke sectie verzendt de handler een DeleteCourseSection met behulp van de huidige lijst met handlers voor IDeleteCourseSectionHandler.
- Als minstens één sectie wordt verwijderd, wijzigt de handler de resultaatstatus in EntityDeleted.
- De verwerking gaat door naar de volgende geconfigureerde handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- Dit moet gebeuren voordat de cursuseditie wordt verwijderd in Brightspace® of IM-tabellen (d.w.z.: DeleteCourseOfferingIMHandler, DeleteCourseOfferingDeleteLEHandler, DeleteCourseOfferingInactiveLEHandler)
- Deze handler werkt niet goed tenzij voor elke verdere geconfigureerde DeleteCourseOffering-handler een passende DeleteCourseSection-handler is geconfigureerd. Als u bijvoorbeeld DeleteCourseOfferingCascadeDeleteCourseSectionHandler en DeleteCourseOfferingIMHandler gebruikt, moet u ook DeleteCourseSectionIMHandler gebruiken.