L'interface du gestionnaire IReplaceCourseOfferingHandler est utilisée par les adaptateurs IPSIS pour prendre en charge l'opération de remplacement pour les offres de cours.
La mise en œuvre de l'interface est D2L.IM.IPSIS.OrgUnits.CourseOfferings.Handlers.IReplaceCourseOfferingHandler.
Les listes de configuration suivantes pour l'interface du gestionnaire ReplaceCourseOfferingHandler sont expédiées avec le produit. Ces listes comprennent également le point d'extension pour lequel elles sont conçues.
IPSIS, Template – Course Offering
- ReplaceCourseOfferingReadHandler (Sort Order = 10)
- ReplaceCourseOfferingValidateHandler (Sort Order = 20)
- ReplaceCourseOfferingDisallowParentChangesIfChildrenExistHandler (Sort Order = 30)
- ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler (Sort Order = 40)
- ReplaceCourseOfferingCreateLMSHandler (Sort Order = 50)
- ReplaceCourseOfferingCreateIMHandler (Sort Order = 60)
- ReplaceCourseOfferingSaveLMSHandler (Sort Order = 70)
- ReplaceCourseOfferingSaveIMHandler (Sort Order = 80)
ReplaceCourseOfferingCopyCourseHandler
Le gestionnaire ReplaceCourseOfferingCopyCourseHandler configure le système pour effectuer la copie automatique du contenu d'un cours source dans une nouvelle offre de cours par le biais de la plateforme IPSIS.
Mise en œuvre
D2l.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCopyCourseHandler.
Comportement prévu
Ce gestionnaire effectue les tâches suivantes en recherchant l'unité organisationnelle à partir de laquelle copier le contenu :
- Si la copie de cours implicite est activée par le biais de l'IU, le gestionnaire tente de trouver l'unité organisationnelle de laquelle copier en copiant depuis un modèle primaire ou une offre de cours fraternelle dont le champ de code d'UO (OrgUnit Code) correspond au code d'UO du modèle.
- Si la copie de cours explicite est utilisée, le gestionnaire recherche les champs d'extension CopyCourseSourceExternalId, CopyCourseParent, CoupCourseSourceOrgUnitId ou CopyCourseSourceOrgUnitCode.
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
Si vous configurez la liste ReplaceCourseOfferingHandler de façon manuelle, ce gestionnaire doit être placé en dernier lieu.
ReplaceCourseOfferingReadHandler
Le gestionnaire ReplaceCourseOfferingReadHandler lit toutes les informations relatives à l’offre de cours stockées dans les tableaux de Brightspace ou les tableaux IM de la base de données à des fins d’utilisation par les gestionnaires ultérieurs.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingReadHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Tente de lire les informations relatives à l'offre de cours dans les tableaux IM.
- S’il en trouve, il tente de lire toute correspondance à Brightspace pour l’offre de cours.
- S’il en trouve, il tente de lire l’information relative à l’offre de cours dans Brightspace.
- Vérifie si tout nœud primaire (semestre, modèle ou département) est précisé dans la requête.
- Le cas échéant, le gestionnaire tente de récupérer le détail des correspondances et des UO pour chaque nœud primaire indiqué et les place dans la requête Request.ParentOrgUnits.
- Si un ID de SIS primaire correspond à plusieurs UO de D2L, seul le premier semestre ou le premier modèle sera utilisé pour chaque ID de SIS.
- Si un nœud primaire précisé n'existe pas dans la base de données, l'objet DataProvider génère une exception OrgUnitMappingNotFoundException qui sera consignée.
- Le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
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
Un gestionnaire de lecture devrait s'exécuter avant un gestionnaire de validation.
ReplaceCourseOfferingValidateHandler
Ce gestionnaire vérifie qu'un code et qu'un nom valides sont affectés à l'offre de cours et qu'un modèle valide existe.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingValidateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Vérifie qu'un code et qu'un nom sont précisés pour la requête. Ces valeurs doivent être des chaînes d'une longueur supérieure à 0.
- Si les champs de code ou de nom affichent une valeur nulle ou vide, le gestionnaire génère une exception ArgumentNullException et interrompt tout le traitement.
- Au moins un modèle primaire doit être présent dans la requête Request.ParentOrgUnits. Si aucun modèle n'est trouvé, une exception ParentNotFoundException est générée et le traitement est interrompu.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
ReplaceCourseOfferingDisallowParentChangesIfChildrenExistHandler
Ce gestionnaire peut servir à prévenir la suppression ou le remplacement d'un modèle primaire ajouté par IPSIS pour toute offre de cours qui comprend déjà des nœuds secondaires. Si ce gestionnaire est absent, les nœuds primaires ajoutés par IPSIS peuvent être mis à jour librement, ce qui pourrait modifier les informations de hiérarchie pour les ancêtres et les descendants de l'offre de cours actuelle.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingParentDepartmentValidateHandler
Comportement prévu
- Si l'offre de cours existe déjà, le remplacement est utilisé plutôt que la création.
- Si une UO primaire ajoutée par IPSIS doit être supprimée ou remplacée, le gestionnaire génère une exception pour empêcher l'exécution de tout autre gestionnaire.
Remarque : Les unités organisationnelles ajoutées manuellement seront toujours supprimées que ce gestionnaire soit en place ou non.
Notes de configuration
- Ce gestionnaire devrait être configuré de façon à s'exécuter après les gestionnaires de validation.
- Ce gestionnaire devrait être configuré de façon à s'exécuter avant les gestionnaires de création.
ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
Ce gestionnaire actualise le modèle de cours qui constitue le nœud primaire de l'offre en fonction des nœuds primaires du département précisés dans la requête d'offre.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Lit les départements associés au modèle primaire de l'offre de cours actuelle.
- Si un département précisé dans l'offre n'est pas désigné comme nœud primaire du modèle de cours, le gestionnaire l'actualise en conséquence.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
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 peut s'exécuter n'importe quand après les gestionnaires de lecture.
ReplaceCourseOfferingCreateLMSHandler
Ce gestionnaire crée des offres de cours dans Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCreateLMSHandler
Comportement prévu
Ce gestionnaire ne s’exécute que si les tableaux IM et LMS (SGA) ne comprennent aucune offre de cours de Brightspace associée à la requête. Ce gestionnaire effectue les tâches suivantes :
- Crée l'offre de cours à l'aide des informations transmises dans la requête (ce qui génère automatiquement une entrée de journal de vérification).
- Si le processus de création aboutit, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus et le traitement est cédé au prochain gestionnaire.
- Si le processus échoue, le gestionnaire attribue l'état CreateFailed à l'objet ReplaceRequestStatus et renvoie une valeur False (faux).
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 doit être placé après tout gestionnaire de validation.
- Le gestionnaire CreateLMS devrait précéder le gestionnaire CreateIM.
ReplaceCourseOfferingCreateIMHandler
Ce gestionnaire crée l'objet Entity dans les tableaux IM, et une correspondance si elle est définie.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCreateIMHandler
Comportement prévu
Ce gestionnaire ne s'exécute que si les tableaux IM ne comprennent aucun objet Entity correspondant. Ce gestionnaire effectue les tâches suivantes :
- Crée l'offre de cours dans la plateforme IM.
- Crée la hiérarchie IM.
- Si une UO est associée à la requête, le gestionnaire crée la correspondance de l’offre de cours de la plateforme IM à l’offre de cours de Brightspace.
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus.
- Le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
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 doit être placé après tout gestionnaire CreateLMS.
ReplaceCourseOfferingSaveLMSHandler
Le gestionnaire ReplaceCourseOfferingSaveLMSHandler enregistre toute modification apportée à l’offre de cours de Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingSaveLMSHandler
Comportement prévu
Ce gestionnaire ne s’exécute que si des modifications relatives à l’offre de cours de Brightspace doivent être enregistrées. Ce gestionnaire effectue les tâches suivantes :
- Supprime tout département de la requête ParentOrgUnits (ceux-ci seront ajoutés comme nœuds primaires du modèle primaire de l'offre de cours).
- Actualise l'offre de cours (ce qui génère automatiquement une entrée de journal de vérification).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityUpdated à l'objet ReplaceRequestStatus s'il affichait l'état EntityCreated.
- Le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
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 doit être placé après tout gestionnaire de création.
ReplaceCourseOfferingSaveIMHandler
Le gestionnaire ReplaceCourseOfferingSaveIMHandler enregistre toute modification apportée à l'offre de cours.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingSaveLMSHandler
Comportement prévu
Ce gestionnaire ne s'exécute que si des modifications relatives à l'offre de cours doivent être enregistrées. Ce gestionnaire effectue les tâches suivantes :
- Supprime tout département de la requête ParentOrgUnits (ceux-ci sont ajoutés comme nœuds primaires du modèle primaire de l'offre de cours).
- Actualise l'offre de cours (ce qui génère automatiquement une entrée de journal de vérification).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityUpdated à l'objet ReplaceRequestStatus s'il affichait l'état EntityCreated.
- Le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
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 doit être placé après tout gestionnaire de création.
ReplaceCourseOfferingSaveIMHandler
Le gestionnaire ReplaceCourseOfferingSaveIMHandler enregistre toute modification apportée à l'entité IM et aux correspondances. Ce processus comprend l'actualisation des informations de hiérarchie et à propagation des changements à tous les ancêtres et descendants de l'offre de cours indiquée.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingSaveIMHandler
Comportement prévu
Ce gestionnaire ne s'exécute que si des modifications relatives à l'entité ou aux correspondances dans les tableaux IM doivent être enregistrées. Ce gestionnaire effectue les tâches suivantes :
- Actualise l'entité IM.
- Actualise la hiérarchie IM et les informations de relation de tous les nœuds primaires/secondaires touchés.
- Actualise les correspondances de l'entité IM.
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityUpdated à l'objet ReplaceRequestStatus.
- Le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
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 doit être placé après tout gestionnaire d'enregistrement SaveLMS.
ReplaceCourseOfferingNameNoUpdateLMSHandler
Le gestionnaire ReplaceCourseOfferingNameNoUpdateLMSHandler est utilisé lorsqu'une organisation ne désire pas que le nom de l'offre de cours soit actualisé après sa création initiale. Ce gestionnaire est nécessaire si une organisation permet à ses utilisateurs d’actualiser les noms de cours par l’entremise de Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingNameNoUpdateLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le nom ne doit pas être actualisé.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
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 les gestionnaires de lecture, mais avant les gestionnaires de création.
ReplaceCourseOfferingStatusNoUpdateLMSHandler
Le gestionnaire ReplaceCourseOfferingStatusNoUpdateLMSHandler est utilisé lorsqu'une organisation ne désire pas que l'état de l'offre de cours soit actualisé après sa création initiale.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingStatusNoUpdateLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que l'état ne doit pas être actualisé.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
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 les gestionnaires de lecture, mais avant les gestionnaires de création.
ReplaceCourseOfferingDatesNoUpdateLMSHandler
Le gestionnaire ReplaceCourseOfferingDatesNoUpdateLMSHandler est utilisé lorsqu'une organisation ne désire pas que les dates de l'offre de cours soient actualisées après sa création initiale.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingDatesNoUpdateLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que les dates de début et de fin ne doivent pas être actualisées.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
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 les gestionnaires de lecture, mais avant les gestionnaires de création.
ReplaceCourseOfferingCodeNoUpdateLMSHandler
Le gestionnaire ReplaceCourseOfferingCodeNoUpdateLMSHandler est utilisé lorsqu'une organisation ne désire pas que le code de l'offre de cours soit actualisé après sa création initiale. Ce gestionnaire est nécessaire si une organisation permet à ses utilisateurs d’actualiser les codes de cours par l’entremise de Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCodeNoUpdateLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le code ne doit pas être actualisé.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
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 les gestionnaires de lecture, mais avant les gestionnaires de création.
ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
Le gestionnaire ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler actualise le modèle de cours qui constitue le nœud primaire de l'offre en fonction des nœuds primaires du département précisés dans la requête d'offre.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
Comportement prévu
- Lit les départements (de Brightspace) associés au modèle qui constitue le nœud primaire de l’offre de cours actuelle.
- Si un département précisé dans l'offre n'est pas désigné comme nœud primaire du modèle de cours, le gestionnaire l'actualise en conséquence.
- Si toutes les étapes aboutissent, le traitement est cédé au prochain gestionnaire (renvoi d'une valeur True [vrai]).
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 peut être utilisé en tout temps après les gestionnaires de lecture.
ReplaceCourseOfferingValidateLMSOrgUnitExistsHandler
Ce gestionnaire vérifie si l’unité organisationnelle à laquelle la requête correspond a été supprimée dans Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingValidateLMSOrgUnitExistsHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Tente de récupérer l'unité organisationnelle actuelle.
- Si l’UO actuelle n’existe pas (la requête est une opération de création ou l’UO a été supprimée dans Brightspace), le gestionnaire tente de récupérer la valeur de l’objet ExternalOrgUnitInfo de la requête.
- Si la valeur de l’objet ExternalOrgUnitInfo est valide, il ne s’agit pas d’une opération de création et l’UO a été supprimée dans Brightspace. Le gestionnaire génère une exception UpdateOrgUnitFailedException.
- Cette exception pousse les services LIS à générer un code de données non valides. Ce code a été évalué comme représentant la réponse la plus appropriée pour cette situation.
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 est placé après les gestionnaires de lecture, généralement comme l'un des premiers gestionnaires de validation.