De plug-in-interface voor IDeleteCourseSectionHandler wordt door IPSIS-adapters gebruikt om cursussecties uit Brightspace® te verwijderen.
De interface-implementatie is D2L.IM.IPSIS.OrgUnits.CourseSections.Handlers.IDeleteCourseSectionHandler.
De volgende configuratielijst biedt een startpunt voor elke IPSIS-implementatie:
IPSIS, sjabloon - Cursussectie
- DeleteCourseSectionValidateHandler (sorteervolgorde = 10)
- DeleteCourseSectionIMHandler (sorteervolgorde = 20)
DeleteCourseSectionValidateHandler
De DeleteCourseSectionValidateHandler 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.CourseSections.Handlers.DeleteCourseSectionValidateHandler®
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.
- Controleert of de sectie geen bovenliggende sectiekoppelingen heeft (deze moeten van tevoren worden verwijderd met behulp van de SA-services).
- 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.
DeleteCourseSectionIMHandler
De DeleteCourseSectionIMHandler markeert de sectie als verwijderd in de IPSIS-tabellen, maar heeft geen effect op Brightspace®. Als het gaat om inschrijvingen of organisatie-eenheden van Brightspace®, zijn extra handlers vereist.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.DeleteCourseSectionIMHandler®
Verwacht gedrag
Als er iets is dat afhankelijk is van de cursussectie (bijv. IM-inschrijvingen niet verwijderd), moet dit mislukken. De handler voert de volgende taken uit:
- Hiermee voltooit u een voorlopige verwijdering (soft-delete) van de cursussectie uit de IM-tabel Externe organisatie-eenheid (maar niet de toewijzingen).
- Verwijdert alle IM-hiërarchieverwijzingen naar de sectie.
- 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.
DeleteCourseSectionLEHandler
De DeleteCourseSectionLEHandler wordt gebruikt als het gewenste gedrag is om alle toegewezen Brightspace®-secties te verwijderen. Tenzij alle resterende actieve gebruikers worden verwijderd of gedeactiveerd, blijven ze ingeschreven voor alle bovenliggende edities. U kunt de DeleteCourseSectionCascadeDeleteEnrollmentHandler gebruiken om alle resterende gebruikers uit de secties te verwijderen.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.DeleteCourseSectionLEHandler®
Verwacht gedrag
Voor elke toegewezen cursussectie geldt het volgende voor de handler:
- Verwijdert de cursussectie (er wordt automatisch een controlevermelding gegenereerd).
- Markeert de IM-toewijzing als verwijderd.
- Gaat door met de verwerking 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
Dit moet gebeuren voordat de IM-tabel wordt verwijderd (bijvoorbeeld: DeleteCourseSectionIMHandler)
DeleteCourseSectionCascadeDeleteEnrollmentHandler
Als er nog actieve inschrijvingen zijn die afhankelijk zijn van de sectie die is verwijderd, worden de geconfigureerde IPSIS-platformhandlers voor IDeleteEnrollmentHandler gebruikt om het gewenste gedrag toe te passen voor het verwijderen van inschrijvingen voor de organisatie.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.DeleteCourseSectionCascadeDeleteEnrollmentHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Haalt de lijst op met resterende inschrijvingen die niet zijn verwijderd voor de sectie.
- Gebruikt de interface van IDeleteEnrollmentHandler om ze allemaal te verwijderen.
- 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.
- Deze handler stopt met verwerken bij de eerste inschrijving die mislukt, waardoor de uitzondering wordt geretourneerd. De handler gaat niet verder met andere inschrijvingen (als ze bestaan).
Opmerkingen over de configuratie
- Dit moet gebeuren voordat de IM-tabel wordt verwijderd (bijvoorbeeld: DeleteCourseSectionIMHandler)
- Dit moet gebeuren voordat het LMS wordt verwijderd als u ook LMS-secties wilt verwijderen (bijvoorbeeld: DeleteCourseSectionLMSHandler).