De plug-in-interface voor IDeleteSectionAssociationHandler wordt door IPSIS-adapters gebruikt om sectiekoppelingen uit Brightspace® te verwijderen.
De interface-implementatie is D2L.IM.IPSIS.OrgUnits.SectionAssociations.Handlers.IDeleteSectionAssociationHandler.
De configuratielijst IPSIS, Sjabloon - Sectiekoppeling biedt een startpunt voor elke IPSIS-implementatie.
De volgende lijst met handlers wordt als startpunt gebruikt:
- DeleteSectionAssociationValidateHandler (sorteervolgorde = 10)
- DeleteSectionAssociationIMHandler (sorteervolgorde = 20)
DeleteSectionAssociationValidateHandler
De DeleteSectionAssociationValidateHandler 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.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler®
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.
DeleteSectionAssociationIMHandler
De DeleteSectionAssociationIMHandler 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.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler®
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.
DeleteSectionAssociationIMHandler
De DeleteSectionAssociationIMHandler verwijdert de SectionAssociation voorlopig in de IM-tabellen.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationIMHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Markeert de SectionAssociation als verwijderd in de tabel IM OrgUnits.
- Hiermee verwijdert u de hiërarchische records voor de SectionAssociation.
- Als er tijdens de verwerking een probleem optreedt, stelt de handler de status van het resultaat in op de juiste foutcode.
- Als alles succesvol is, gaat de verwerking verder 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
De IM Delete-handler moet als laatste worden uitgevoerd.
DeleteSectionAssociationInactiveLMSOfferingHandler
De DeleteSectionAssociationInactiveLMSOfferingHandler wordt gebruikt als het gewenste gedrag is dat alle toegewezen LMS-edities worden gedeactiveerd.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationInactiveLMSOfferingHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Schakel alle cursusedities uit die zijn gekoppeld aan de opgegeven SectionAssociation in het LMS. Deze handler markeert alle toewijzingen aan de LMS-cursusedities als inactief.
- Als alles is gelukt, stelt de handler 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.
Opmerkingen over de configuratie
Deze handler moet worden uitgevoerd vóór de DeleteIM Handler.
DeleteSectionAssociationDeleteLMSGroupSectionHandler
De DeleteSectionAssociationDeleteLMSGroupSectionHandler wordt gebruikt als het gewenste gedrag is dat alle LE-groepen of -secties worden verwijderd die zijn gekoppeld aan een LE-cursuseditie die is toegewezen aan de sectiekoppeling.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSGroupSectionHandler®
Verwacht gedrag
Deze handler kan alleen worden uitgevoerd als er een toewijzing voor de record sectiekoppeling zelf is. De handler voert de volgende taken uit:
- Voor elke LMS-organisatie-eenheid waaraan de sectiekoppeling is toegewezen, bepaalt de handler de onderliggende niveaus van de LMS-organisatie-eenheid in Brightspace®
- Voor elke onderliggende LMS-groep of -sectie van een organisatie-eenheid waaraan de SA is toegewezen, verwijdert de handler de LMS-groep/-sectie (automatisch resulterend in een controlevermelding). De handler verwijdert ook alle IM-toewijzingsrecords die aan de LMS-groep/-sectie zijn gekoppeld.
- Als alles is gelukt, stelt de handler 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
- Deze handler moet worden uitgevoerd vóór de DeleteIM-handler
- Als deze handler samen met de DeleteLMSOffering-handler wordt gebruikt, moet DeleteLMSGroupSection voorafgaan aan DeleteLMSOffering.
DeleteSectionAssociationDeleteLMSOfferingHandler
De DeleteSectionAssociationDeleteLMSOfferingHandler wordt gebruikt als het gewenste gedrag is dat de cursuseditie van Brightspace® wordt verwijderd die aan de sectiekoppeling is gekoppeld.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSOfferingHandler®
Verwacht gedrag
Voor elke toegewezen LMS-cursuseditie voert de handler de volgende taken uit:
- Als de editie geen toegewezen secties meer heeft als onderliggende secties (alle onderliggende onderdelen van de editie moeten worden vergeleken met organisatie-eenheden in de tabel IM-toewijzing), verwijdert de handler de LMS-cursuseditie (automatisch resulterend in een controlevermelding).
- Als de editie meer toegewezen secties als onderliggende sectie heeft, verwijdert de handler de LMS-cursuseditie niet.
- De handler voert een voorlopige verwijdering uit van de IM-toewijzingsrecord die aan de editie is gekoppeld.
- Als alles is gelukt, stelt de handler 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.
Opmerkingen over de configuratie
Deze handler moet worden uitgevoerd vóór de DeleteIM Handler.
DeleteSectionAssociationUnenrolLMSGroupSectionHandler
De DeleteSectionAssociationUnenrolLMSGroupSectionHandler schrijft gebruikers uit bij alle secties die uit de koppeling moeten worden verwijderd.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrollLMSGroupSectionHandler®
Verwacht gedrag
Deze handler wordt alleen uitgevoerd als er een toewijzing voor de sectiekoppeling is en er bijbehorende secties (met een toewijzing) uit het LMS moeten worden verwijderd. De handler voert de volgende taken uit:
- Voor elke sectie in de hiërarchie van de sectiekoppelingen bepaalt de handler welke gebruikers zijn ingeschreven in de sectie (uit de tabel IM-inschrijvingen).
- Schrijft de gebruikers uit bij de specifieke LMS-cursussectie die wordt verwijderd (automatisch resulterend in een controlevermelding).
- Als alles is gelukt, stelt de handler 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
Deze handler moet vóór de DeleteLMSGroupSection-handler worden geplaatst om er zeker van te zijn dat er geen inschrijvingen in het LMS blijven staan die er niet moeten zijn.
DeleteSectionAssociationUnenrolLMSOfferingHandler
De DeleteSectionAssociationUnenrolLMSOfferingHandler maakt de inschrijving ongedaan van gebruikers van de bovenliggende onderdelen van de editie van de verwijderde sectietoewijzing, tenzij ze zijn ingeschreven in een andere groep/sectie met hetzelfde groepstype onder de editie.
Implementatie
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrolLMSOfferingHandler®
Verwacht gedrag
Deze handler wordt alleen uitgevoerd als er een toewijzing voor de sectiekoppeling is en er bijbehorende secties (met een toewijzing) uit het LMS moeten worden verwijderd. De handler voert de volgende taken uit:
- Voor elke sectie in de hiërarchie van de sectiekoppelingen bepaalt de handler welke gebruikers zijn ingeschreven in de sectie (uit de tabel IM-inschrijvingen).
- Als de gebruiker niet is ingeschreven in secties (of groepen) met hetzelfde groepstype onder de LMS-editie, schrijft de handler de gebruikers uit bij de LMS-cursuseditie (automatisch resulterend in een controlevermelding).
- Als alles is gelukt, stelt de handler 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.
Opmerkingen over de configuratie
- Deze handler moet na de Create IM-handler worden geplaatst.
- Deze handler moet vóór de DeleteLMSGroupSection-handler worden geplaatst om er zeker van te zijn dat er geen inschrijvingen in het LMS blijven staan die er niet moeten zijn.
- Deze handler moet vóór de Save IM-handler worden geplaatst.