De plug-in-interface voor IDeleteCourseTemplateHandler wordt door IPSIS-adapters gebruikt om cursussjablonen uit Brightspace® te verwijderen.
De interface-implementatie is D2L.IM.IPSIS.OrgUnits.CourseTemplates.Handlers.IDeleteCourseTemplateHandler.
De configuratielijsten IPSIS, Sjabloon - Cursussjabloon voor de IDeleteCourseTemplateHandler-interface worden bij het product geleverd. Ze worden vermeld samen met het uitbreidingspunt waarvoor ze zijn bedoeld.
De volgende handlers worden als uitgangspunt gebruikt:
- DeleteCourseTemplateValidateHandler (sorteervolgorde = 10)
- DeleteCourseTemplateIMHandler (sorteervolgorde = 20)
DeleteCourseTemplateIMHandler
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseTemplateIMHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er iets is dat afhankelijk is van de cursussjabloon (onderliggende onderdelen van IM-hiërarchie), mislukt het proces.
- De handler verwijdert de cursussjabloon voorlopig uit de IPSIS-tabellen.
- Verwijdert alle bovenliggende vermeldingen van de IM-hiërarchie die naar de sjabloon verwijzen.
- 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.
DeleteCourseTemplateDeleteLEHandler
De DeleteCourseTemplateDeleteLEHandler wordt gebruikt als het gewenste gedrag eruit bestaat dat alle toegewezen Brightspace®-sjablonen worden verwijderd als er geen onderliggende onderdelen in Brightspace® zijn.
Verwacht gedrag
Voor elke toegewezen cursussjabloon voert de handler de volgende taken uit:
- Verwijdert de cursussjabloon (automatisch resulterend in een controlevermelding).
- Markeert alle toewijzingen in de IM-tabellen aan het verwijderde Brightspace®-onderdeel als verwijderd.
- 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: DeleteCourseTemplateIMHandler).
DeleteCourseTemplateCascadeDeleteCourseOfferingHandler
De DeleteCourseTemplateCascadeDeleteCourseOfferingHandler wordt gebruikt voor trapsgewijze verwijdering van alle onderliggende cursusedities die nog bestaan.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.DeleteCourseTemplateCascadeDeleteCourseOfferingHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Voor elke resterende cursuseditie die verwijst naar de sjabloon in de tabel IM-hiërarchieën worden de handlers die zijn geconfigureerd voor IDeleteCourseOffering gebruikt om de cursusedities te verwijderen.
- 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 organisatie-eenheid wordt verwijderd uit de tabellen van IM of Brightspace® (bijvoorbeeld: DeleteCourseTemplateIMHandler en DeleteCourseTemplateDeleteLEHandler).
DeleteCourseTemplateValidateHandler
Gebruik altijd de DeleteCourseTemplateValidateHandler. Het voert invoervalidatie uit die nodig is om te verzekeren dat alle andere Delete-handlers goed werken.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.DeleteCourseTemplateValidateHandler®
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, slaat de handler de ExternalOrgUnitInfo op de aanvraag op zodat latere handlers deze kunnen gebruiken.
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.