L'interface du gestionnaire IReadGradesHandler est utilisée par les adaptateurs IPSIS pour prendre en charge l'opération de lecture pour les notes.
La mise en œuvre de l'interface est D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
Les listes de configuration suivantes pour l'interface du gestionnaire ReadGradesHandler sont expédiées avec le produit. Ces listes comprennent également le point d'extension pour lequel elles sont conçues.
IPSIS, Template – Grades
- ReadGradesGradableMappingGetFirstMappingWithGradesHandler (Sort Order = 10)
- ReadGradesResolveGradeTypeFromCourseSettingHandler (Sort Order = 20)
- ReadGradesStatusDefaultAllHandler (Sort Order = 30)
- ReadGradesDisplayTypeDefaultPointsHandler (Sort Order = 40)
- ReadGradesValidateHandler (Sort Order = 50)
- ReadGradesGetGradesForSectionMappingHandler (Sort Order = 60)
- ReadGradesFilterBySISEnrollmentsHandler (Sort Order = 70)
ReadGradesGradableMappingDefaultToFirstMappingHandler
Un même objet unité organisationnelle dans le SIS peut correspondre à plusieurs UO dans Brightspace. Ceci peut survenir par exemple avec les gestionnaires par défaut utilisés pour une section faisant partie d'une ou de plusieurs associations de section. Lorsque l'entrée comprend un ID de SIS pour une UO mais aucune correspondance, une seule correspondance doit être sélectionnée dans l'ensemble. Le gestionnaire ReadGradesGradableMappingDefaultToFirstMappingHandler sélectionne simplement la première correspondance dans la liste renvoyée par la base de données.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingDefaultToFirstMappingHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si un objet OrgUnitMapping est déjà lié à la requête, le gestionnaire ne fait rien.
- Dans le cas contraire, si aucun ID de SIS n'est lié à la requête, le gestionnaire génère une exception IncompleteRequestException.
- Si l'ID de SIS existe, le gestionnaire recherche ses objets OrgUnitMappings dans la base de données.
- Si plusieurs correspondances sont renvoyées, le gestionnaire sélectionne la première de la liste. Il s'agit généralement de la correspondance qui affiche l'ID le plus bas, ce qui signifie qu'elle a été effectuée en premier.
- La correspondance de l'objet de requête est actualisée pour refléter cette valeur. Cette information est disponible pour les gestionnaires ultérieurs.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Note de configuration
- Le gestionnaire GradableMapping devrait précéder toute récupération de notes de la base de données.
- Certains gestionnaires planifiés se basent sur d'autres critères pour sélectionner une correspondance, par exemple la première correspondance affichant des notes ou la première correspondance identifiée comme pouvant être notée. Il est recommandé afin d'éviter toute confusion de n'utiliser qu'un seul gestionnaire GradableMapping dans une liste de configuration.
ReadGradesGradableMappingGetIsGradableMappingHandler
Un même objet unité organisationnelle dans le SIS peut correspondre à plusieurs UO dans Brightspace. Ceci peut survenir par exemple avec les gestionnaires par défaut utilisés pour une section faisant partie d'une ou de plusieurs associations de section. Lorsque l'entrée comprend un ID de SIS pour une UO mais aucune correspondance, une seule correspondance doit être sélectionnée dans l'ensemble. Le gestionnaire ReadGradesGradableMappingGetIsGradableMappingHandler sélectionne la première correspondance identifiée comme pouvant être notée.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetIsGradableMappingHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si un objet OrgUnitMapping est déjà lié à la requête, le gestionnaire ne fait rien.
- Dans le cas contraire, si aucun ID de SIS n'est lié à la requête, le gestionnaire génère une exception IncompleteRequestException.
- Si l'ID de SIS existe, le gestionnaire recherche ses objets OrgUnitMappings dans la base de données.
- Si plusieurs correspondances sont renvoyées, le gestionnaire sélectionne la première pour laquelle l'indicateur Gradable (peut être noté) est réglé à True (vrai). Si aucune correspondance de satisfait ce critère, le gestionnaire génère une exception NoGradableSectionsException.
- Si plusieurs correspondances peuvent être notées, le gestionnaire génère une exception MultipleGradableSectionsException.
- La correspondance de l'objet de requête est actualisée pour refléter cette valeur. Cette information est disponible pour les gestionnaires ultérieurs.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Notes de configuration
- Le gestionnaire GradableMapping devrait précéder toute récupération de notes de la base de données.
- Certains gestionnaires se basent sur d'autres critères pour sélectionner une correspondance, par exemple la première correspondance affichant des notes ou simplement la première correspondance d'une liste. Il est recommandé afin d'éviter toute confusion de n'utiliser qu'un seul gestionnaire GradableMapping dans une liste de configuration.
ReadGradesResolveGradeTypeFromCourseSettingHandler
Lorsqu'un type de note (note finale ajustée ou calculée) n'est pas encore défini par le biais d'un traducteur ou d'un gestionnaire antérieur, ce gestionnaire définit le type de note en fonction de la variable de configuration pertinente (Grades.Calculation.ReleaseAdjustedGrade).
Le gestionnaire lit le réglage de l'offre de cours, et non de la section. Il récupère la correspondance d'unité organisationnelle primaire (offre de cours) pour l'accès à la variable de configuration.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesResolveGradeTypeFromCourseSettingHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Récupère la variable de configuration pour l'objet GradeType si le type de note n'est pas encore défini. Le type de note dépend d'un réglage du cahier de notes.
- Définit le type de note (à note finale calculée ou note finale ajustée).
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Note de configuration
Le gestionnaire ResolveGradeType devrait s'exécuter avant que les notes ne soient récupérées de la base de données (p. ex., avant le gestionnaire ReadGradesGetGradesForSectionHandler) et après la sélection de la correspondance.
ReadGradesStatusDefaultAllHandler
Ce gestionnaire définit l'état de la note à All (toutes).
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultAllHandler
Comportement prévu
Définit l'état de la note à All (toutes) si l'état n'est pas encore défini.
Notes de configuration
- Le gestionnaire StatusDefault doit s'exécuter avant le gestionnaire DisplayTypeDefault (points ou symboles).
- Le gestionnaire StatusDefault devrait s'exécuter avant que les notes ne soient récupérées de la base de données (p. ex., avant le gestionnaire ReadGradesGetGradesForSectionMappingHandler).
- Ce gestionnaire ne devrait pas être utilisé de concert avec tout autre gestionnaire StatusDefault.
ReadGradesGetGradesForSectionMappingHandler
Le gestionnaire ReadGradesGetGradesForSectionMappingHandler récupère les notes de la base de données.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGetGradesForSectionMappingHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Génère une exception si l'ID de SIS saisi ne correspond pas à une valeur de section dans les tableaux IM.
- Autrement, le gestionnaire récupère les notes actuelles du Gestionnaire de notes, filtrées en fonction des options définies.
- Récupère les inscriptions SIS de la correspondance pour tous les utilisateurs inscrits dans l'unité organisationnelle indiquée.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Note de configuration
Ce gestionnaire devrait s'exécuter après tout gestionnaire qui définit le type, l'état ou la correspondance de la requête, mais avant que les notes ne soient filtrées.
ReadGradesValidateHandler
Le gestionnaire ReadGradesValidateHandler confirme que toutes les propriétés requises ont été définies, et que l’unité organisationnelle affiche un type qui assure la prise en charge des notes dans Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesValidateHandler
Comportement prévu
- Génère une exception si l'ID de SIS saisi ne correspond pas à une valeur de section ou d'offre de cours dans les tableaux IM.
- Sinon, le gestionnaire confirme que les valeurs des objets GradeType et GradeStatus de la requête ont été définies par des traducteurs ou des gestionnaires antérieurs.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Note de configuration
Ce gestionnaire devrait s'exécuter après la sélection du type et de l'état, mais avant la lecture actuelle des notes dans la base de données.
ReadGradesMatchGradesToSISEnrolledUsersHandler
Le gestionnaire ReadGradesMatchGradesToSISEnrolledUsersHandler accepte une liste de notes et renvoie une liste de notes jumelées à des ID utilisateurs SIS. Toutes les notes qui ne correspondent pas à des utilisateurs inscrits dans le SIS sont omises.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesIncludeOnlySISEnrolledUsersHandler
Comportement prévu
Le gestionnaire Grades renvoie toutes les notes pour l'unité organisationnelle, mais ces notes correspondent à un ID utilisateur du SGA plutôt qu'à un ID utilisateur du SIS. Ce gestionnaire détermine l'ID utilisateur du SIS approprié pour chaque note et renvoie un ensemble de valeurs note/ID utilisateur SIS. Si un utilisateur ne comprend aucun ID utilisateur SIS, la note associée est omise des résultats.
Ce gestionnaire effectue les tâches suivantes :
- Récupère une liste d'inscriptions pour l'unité organisationnelle actuelle.
- Détermine l'ID utilisateur SIS de chaque utilisateur inscrit.
- Trouve la première valeur IGrade correspondant à cet utilisateur, le cas échéant.
- Crée un objet encapsulant les paires IGrade et SISUserId, et le joint à la réponse.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Notes de configuration
- Ce gestionnaire devrait s'exécuter après la lecture des notes dans la base de données.
- Ce gestionnaire est requis pour permettre au SIS de faire correspondre les notes aux utilisateurs à l'aide d'un ID qu'il peut interpréter. Ce gestionnaire (ou un gestionnaire de remplacement personnalisé) devrait toujours être configuré.
ReadGradesStatusDefaultReleasedOnlyHandler
Le gestionnaire ReadGradesStatusDefaultReleasedOnlyHandler définit le type de note à Released (diffusé).
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultReleasedOnlyHandler
Comportement prévu
Définit le type de la note à Released (diffusé) si le type n'est pas encore défini.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Notes de configuration
- Le gestionnaire StatusDefault doit s'exécuter avant le gestionnaire DisplayTypeDefault (points ou symboles).
- Le gestionnaire StatusDefault devrait s'exécuter avant que les notes ne soient récupérées de la base de données (p. ex., avant le gestionnaire ReadGradesGetGradesForSectionMappingHandler).
- Ce gestionnaire ne devrait pas être utilisé de concert avec tout autre gestionnaire StatusDefault.
ReadGradesGradableMappingGetFirstMappingWithGradesHandler
Le gestionnaire ReadGradesGradableMappingGetFirstMappingWithGradesHandler définit la correspondance de l'unité organisationnelle à la première (selon l'ID de correspondance d'UO) qui présente des notes disponibles.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetFirstMappingWithGradesHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Récupère toutes les correspondances d'unité organisationnelle (si la correspondance n'est pas encore définie) qui correspondent à l'identificateur externe et les trie par ID de correspondance d'UO.
- Recherche la première correspondance affichant une note identifiée comme étant disponible. Les notes vérifiées sont récupérées en fonction de l'indicateur de type de note de l'offre associée (p. ex., si l'offre de cours de la section est configurée pour diffuser les notes finales ajustées, le gestionnaire vérifie les notes finales ajustées disponibles). La disponibilité signifie que la note comprend un numérateur supérieur à 0 ou un symbole. Cette disponibilité signifie en gros que la note présente une valeur définie dans cette section.
- Définit la correspondance d'UO de la requête à cette correspondance.
Comportement en cas d'erreur
- Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
- Si aucune correspondance d'UO n'est trouvée, le gestionnaire génère une exception OrgUnitMappingNotFoundException.
- Si aucune note n'est trouvée pour aucune des correspondances d'UO, le gestionnaire génère une exception NoGradableSectionFoundException.
Notes de configuration
- Ce gestionnaire devrait précéder la lecture des notes dans la base de données. Il devrait également être placé devant tout gestionnaire qui doit connaître l'UO avec laquelle il interagit (par exemple le gestionnaire qui tente de lire la configuration de l'unité organisationnelle).
- Ce gestionnaire est l'un des nombreux gestionnaires qui sélectionnent une correspondance d'UO. Il ne devrait jamais y avoir plus d'un de ces gestionnaires dans la configuration active au même moment.
ReadGradesDisplayTypeDefaultPointsHandler
Le gestionnaire ReadGradesDisplayTypeDefaultPointsHandler définit le type d'affichage de la note à Points. Cette définition influe sur l'affichage dans l'IU d'exportation des notes, ainsi que sur les notes transmises au SIS.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultPointsHandler
Comportement prévu
Définit le type d'affichage de la note à Points si ce type n'est pas encore défini.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Notes de configuration
- Le gestionnaire DisplayTypeDefault devrait s'exécuter avant que les notes ne soient récupérées de la base de données (p. ex., avant le gestionnaire ReadGradesGetGradesForSectionMappingHandler).
- Ce gestionnaire ne devrait pas être utilisé de concert avec tout autre gestionnaire DisplayTypeDefault.
ReadGradesDisplayTypeDefaultSymbolsHandler
Le gestionnaire ReadGradesDisplayTypeDefaultSymbolsHandler définit le type d'affichage de la note à Symboles. Cette définition influe sur l'affichage dans l'IU d'exportation des notes, ainsi que sur les notes transmises au SIS.
Mise en œuvre
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultSymbolsHandler
Comportement prévu
Définit le type d'affichage de la note à Symboles si ce type n'est pas encore défini.
Comportement en cas d'erreur
Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.
Notes de configuration
- Le gestionnaire DisplayTypeDefault devrait s'exécuter avant que les notes ne soient récupérées de la base de données (p. ex., avant le gestionnaire ReadGradesGetGradesForSectionMappingHandler).
- Ce gestionnaire ne devrait pas être utilisé de concert avec tout autre gestionnaire DisplayTypeDefault.