De plug-in-interface voor IReadGradesHandler wordt door IPSIS-adapters gebruikt om leesbewerkingen voor scores te ondersteunen.
De interface-implementatie is D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
De volgende configuratielijsten voor de ReadGradesHandler-interface worden bij het product geleverd. Ze worden vermeld samen met het uitbreidingspunt waarvoor ze bedoeld zijn.
IPSIS, Sjabloon - Scores
- ReadGradesGradableMappingGetFirstMappingWithGradesHandler (sorteervolgorde = 10)
- ReadGradesResolveGradeTypeFromCourseSettingHandler (sorteervolgorde = 20)
- ReadGradesStatusDefaultAllHandler (sorteervolgorde = 30)
- ReadGradesDisplayTypeDefaultPointsHandler (sorteervolgorde = 40)
- ReadGradesValidateHandler (sorteervolgorde = 50)
- ReadGradesGetGradesForSectionMappingHandler (sorteervolgorde = 60)
- ReadGradesFilterBySISEnrollmentsHandler (sorteervolgorde = 70)
ReadGradesGradableMappingDefaultToFirstMappingHandler
Een enkel object Organisatie-eenheid in het studentinformatiesysteem kan worden toegewezen aan meerdere organisatie-eenheden in Brightspace®. Dit kan bijvoorbeeld gebeuren met de standaardhandlers voor een sectie die deel uitmaakt van een of meer sectiekoppelingen. Wanneer de invoer een SISId voor een organisatie-eenheid maar geen toewijzing bevat, moet één toewijzing uit de set worden geselecteerd. De DefaultToFirstMapping-handler selecteert eenvoudigweg de eerste toewijzing in de lijst die uit de database wordt geretourneerd.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingDefaultToFirstMappingHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er al een toewijzing van een organisatie-eenheid aan de aanvraag is gekoppeld, doet de handler niets.
- Anders genereert de handler, als geen SIS-id in de aanvraag is opgenomen, een IncompleteRequestException.
- Als de SisId bestaat, zoekt de handler de toewijzingen van de organisatie-eenheid op in de database.
- Als er meerdere toewijzingen worden geretourneerd, selecteert de handler de eerste uit de lijst. Dit is doorgaans de toewijzing met de laagste id, wat betekent dat deze eerst is toegewezen.
- De toewijzing van het aanvraagobject wordt bijgewerkt met deze waarde. Deze informatie is beschikbaar voor latere handlers.
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 GradableMapping-handler moet worden geplaatst voordat de werkelijke scores uit de database worden opgehaald.
- Er zijn geplande handlers die andere criteria gebruiken om een toewijzing te selecteren, zoals de eerste toewijzing met scores of een toewijzing die is gemarkeerd voor scores. Om verwarring te voorkomen, mag slechts één GradableMapping-handler in een bepaalde configuratielijst worden gebruikt.
ReadGradesGradableMappingGetIsGradableMappingHandler
Een enkel object Organisatie-eenheid in het studentinformatiesysteem kan worden toegewezen aan meerdere organisatie-eenheden in Brightspace®. Dit kan bijvoorbeeld gebeuren met de standaardhandlers voor een sectie die deel uitmaakt van een of meer sectiekoppelingen. Wanneer de invoer een SISId voor een OrgUnit bevat maar geen toewijzing, moet een enkele toewijzing uit de set worden geselecteerd. De Get Is Gradable Mapping-handler kiest de eerste toewijzing die is gemarkeerd als 'Is Gradable' (kan van een score worden voorzien).
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetIsGradableMappingHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er al een toewijzing van een organisatie-eenheid aan de aanvraag is gekoppeld, doet de handler niets.
- Anders genereert de handler, als geen SIS-id in de aanvraag is opgenomen, een IncompleteRequestException.
- Als de SIS-id bestaat, zoekt de handler zijn toewijzingen van organisatie-eenheden op in de database.
- Als er meerdere toewijzingen worden geretourneerd, selecteert de handler de eerste waarvoor de markering 'gradable' is ingesteld op True. Als er geen dergelijke toewijzing is, genereert de handler een NoGradableSectionsException.
- Als meerdere toewijzingen zijn ingesteld op 'gradable', genereert de handler een MultipleGradableSectionsException.
- De toewijzing van het aanvraagobject wordt bijgewerkt met deze waarde. Deze informatie is beschikbaar voor latere handlers.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- De GradableMapping-handler moet worden geplaatst voordat de werkelijke scores uit de database worden opgehaald.
- Er zijn handlers die andere criteria gebruiken voor het selecteren van een toewijzing, waaronder het kiezen van de eerste toewijzing met scores of alleen de eerste toewijzing in het algemeen. Om verwarring te voorkomen, mag slechts één GradableMapping-handler in een bepaalde configuratielijst worden gebruikt.
ReadGradesResolveGradeTypeFromCourseSettingHandler
Wanneer een scoretype (definitief aangepast/berekend) nog niet is ingesteld (via een omzettingsprogramma of een eerdere handler), stelt deze handler het scoretype in op basis van de relevante configuratievariabele (Grades.Calculation.RelaseAdjustedGrade).
De handler leest de instelling uit de cursuseditie en niet uit de sectie. De handler haalt de toewijzing van de bovenliggende organisatie-eenheid (cursuseditie) op voor de configuratie van variabele toegang.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesResolveGradeTypeFromCourseSettingHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als het scoretype nog niet is ingesteld, wordt de configuratievariabele voor GradeType opgehaald. Dit wordt geregeld door een instelling in het scorerapport.
- Stel het scoretype in (definitief berekend of definitief aangepast).
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 ResolveGradeType-handler moet plaatsvinden voordat de werkelijke scores worden opgehaald uit de database (d.w.z. vóór ReadGradesGetGradesForSectionHandler) en nadat de toewijzing is geselecteerd.
ReadGradesStatusDefaultAllHandler
Deze handler stelt de scorestatus in op Alle.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultAllHandler®
Verwacht gedrag
Als de status van de score nog niet is ingesteld, stelt u de status van de score in op Alle.
Opmerkingen over de configuratie
- De StatusDefault-handler moet vóór de DisplayTypeDefault (punten of symbolen) handler plaatsvinden.
- De StatusDefault-handler moet plaatsvinden voordat de werkelijke scores uit de database worden opgehaald (d.w.z. vóór ReadGradesGetGradesForSectionMappingHandler).
- Deze StatusDefault-handler mag niet worden gebruikt in combinatie met een andere StatusDefault-handler.
ReadGradesGetGradesForSectionMappingHandler
De ReadGradesGetGradesForSectionMappingHandler haalt de scores op uit de database.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGetGradesForSectionMappingHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als de SIS-id van de invoer niet overeenkomt met een sectie in de IM-tabellen, genereert de handler een uitzondering.
- Anders haalt de handler de werkelijke scores op uit Scorebeheer, gefilterd op de opties die tot nu toe zijn ingesteld.
- Haalt de SIS-inschrijvingen op voor alle gebruikers die zijn ingeschreven in de opgegeven organisatie-eenheid uit de toewijzing.
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 na elke handler die het type, de status of de toewijzing van aanvragen instelt, maar voordat de scores worden gefilterd.
ReadGradesValidateHandler
De ReadGradesValidateHandler valideert dat alle vereiste eigenschappen zijn ingesteld, en de OrgUnit is van een type is dat scores in Brightspace® ondersteunt.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesValidateHandler®
Verwacht gedrag
- Als de invoer-SIS-id niet overeenkomt met een sectie van de editie in de IM-tabellen, genereert de handler een uitzondering.
- Anders valideert de handler dat het GradeType en GradeStatus in het aanvraagobject zijn ingesteld door eerdere omzettingsprogramma's en/of handlers.
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 nadat het type en de status zijn geselecteerd, maar voordat de scores worden gelezen vanuit de database.
ReadGradesMatchGradesToSISEnrolledUsersHandler
De ReadGradesMatchGradesToSISEnrolledUsersHandler accepteert een lijst met scores en retourneert een lijst met scores die zijn gekoppeld aan SIS UserIds. Scores die niet overeenkomen met gebruikers die zijn ingeschreven bij SIS, worden weggelaten.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesIncludeOnlySISEnrolledUsersHandler®
Verwacht gedrag
De Score-manager retourneert alle scores voor de organisatie-eenheid, maar deze scores komen overeen met een LMS UserId, geen SIS UserId. Deze handler bepaalt de juiste SIS UserId voor elke score en retourneert een set score/SISUserId-paren. Als er geen SIS UserId voor een bepaalde gebruiker is, wordt de bijbehorende score uit de resultaten weggelaten.
De handler voert de volgende taken uit:
- Haal een lijst met inschrijvingen voor de huidige organisatie-eenheid op.
- Bepaal voor elke gebruiker de SIS UserId van de ingeschreven gebruiker.
- Zoek de eerste IGrade die overeenkomt met die gebruiker, indien van toepassing.
- Maak een nieuw object dat paren IGrade en SISUserId inkapselt, en voeg het toe aan de respons.
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 optreden na het lezen van de scores uit de database.
- Deze handler is nodig om het SIS in staat te stellen de scores af te stemmen op gebruikers met behulp van een ID die ze begrijpen. Deze handler (of een aangepaste vervanging) moet altijd worden geconfigureerd.
ReadGradesStatusDefaultRelasedOnlyHandler
De ReadGradesStatusDefaultRelaseedOnlyHandler-handler stelt het scoretype in op vrijgegeven.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultReleasedOnlyHandler®
Verwacht gedrag
Als het scoretype nog niet is ingesteld, stelt u het scoretype in op vrijgegeven.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- De StatusDefault-handler moet vóór de DisplayTypeDefault (punten of symbolen) handler plaatsvinden.
- De StatusDefault-handler moet plaatsvinden voordat de werkelijke scores uit de database worden opgehaald (d.w.z. vóór ReadGradesGetGradesForSectionMappingHandler).
- Deze StatusDefault-handler mag niet worden gebruikt in combinatie met een andere StatusDefault-handler.
ReadGradesGradableMappingGetFirstMappingWithGradesHandler
De ReadGradesGradableMappingGetFirstMappingWithGradesHandler stelt de toewijzing van de organisatie-eenheid in op de eerste organisatie-eenheid (gesorteerd op toewijzings-id van de organisatie-eenheid) die beschikbare scores heeft.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetFirstMappingWithGradesHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als de toewijzing van de organisatie-eenheid niet is ingesteld, pakt de handler alle toewijzingen van organisatie-eenheden die overeenkomen met de externe identificatie en sorteert deze op toewijzings-id van de organisatie-eenheid.
- De handler controleert op de eerste die een score heeft en die is gemarkeerd als beschikbaar. De geselecteerde scores worden verzameld op basis van de bijbehorende markering voor het type cursusscore (d.w.z. als de cursuseditie van de sectie zo is geconfigureerd dat FinalAdjusted wordt vrijgegeven, dan controleert de handler op beschikbare definitieve aangepaste eindscores). Beschikbaar betekent dat de score een waarde heeft die groter is dan 0 of dat deze een symbolenset heeft. In wezen betekent de beschikbaarheid dat de score een vaste waarde heeft in die sectie.
- De handler stelt de toewijzing van de organisatie-eenheid voor de aanvraag in op die toewijzing.
Foutgedrag
- Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
- Als er geen toewijzingen van organisatie-eenheden worden gevonden, wordt een OrgUnitMappingNotFoundException geretourneerd.
- Als er geen scores worden gevonden voor toewijzingen van organisatie-eenheden, wordt een NoGradableSectionFoundException geretourneerd.
Opmerkingen over de configuratie
- Deze handler moet worden geplaatst voordat de scores daadwerkelijk uit de database worden gelezen. Bovendien moet de handler worden geplaatst vóór elke handler die moet weten aan welke organisatie-eenheid de betreffende handler werkt (zoals de handler die de configuratie van de organisatie-eenheid probeert te lezen).
- Deze handler is een van de vele die een toewijzing van een organisatie-eenheid selecteert. Er mag nooit meer dan één van deze handlers tegelijk in de actieve configuratie aanwezig zijn.
ReadGradesDisplayTypeDefaultPointsHandler
De ReadGradesDisplayTypeDefaultPointsHandler stelt het weergavetype voor de score in op punten. Dit heeft invloed op de weergave in de gebruikersinterface van Scores exporteren, evenals op de scores die naar het studentinformatiesysteem worden verzonden.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultPointsHandler®
Verwacht gedrag
Als het weergavetype voor scores nog niet is ingesteld, stelt de handler het weergavetype voor scores in op punten.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- De DisplayTypeDefault-handler moet worden uitgevoerd voordat de werkelijke scores uit de database worden opgehaald (d.w.z. vóór ReadGradesGetGradesForSectionMappingHandler).
- Deze DisplayTypeDefault-handler mag niet worden gebruikt in combinatie met een andere DisplayTypeDefault-handler.
ReadGradesDisplayTypeDefaultSymbolsHandler
De ReadGradesDisplayTypeDefaultSymbolsHandler stelt het weergavetype voor de score in op Symbolen. Dit heeft invloed op de weergave in de gebruikersinterface van Scores exporteren, evenals op de scores die naar het studentinformatiesysteem worden verzonden.
Implementatie
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultSymbolsHandler®
Verwacht gedrag
Als het weergavetype voor de score nog niet is ingesteld, stelt de handler het weergavetype voor de score in op Symbolen.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- De DisplayTypeDefault-handler moet worden uitgevoerd voordat de werkelijke scores uit de database worden opgehaald (d.w.z. vóór ReadGradesGetGradesForSectionMappingHandler).
- Deze DisplayTypeDefault-handler mag niet worden gebruikt in combinatie met een andere DisplayTypeDefault-handler.