L’interface du gestionnaire IDeleteCourseOfferingHandler est utilisée par les adaptateurs IPSIS pour supprimer des offres de cours de Brightspace.
La mise en œuvre de l’interface est D2L.IM.IPSIS.OrgUnits.CourseOfferings.Handlers.IDeleteCourseOfferingHandler.
Les listes de configuration suivantes offrent un point de départ pour toute mise en œuvre IPSIS :
IPSIS, Template – Course Offering
- DeleteCourseOfferingValidateHandler (Sort Order = 10)
- DeleteCourseOfferingIMHandler (Sort Order = 10)
DeleteCourseOfferingValidateHandler
Ce gestionnaire devrait toujours être utilisé. Il effectue la validation d’entrée requise pour assurer le bon fonctionnement de tous les autres gestionnaires de suppression.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingValidateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Vérifie que l’ID de SIS de la requête correspond à un élément réel dans les tableaux IM.
- Vérifie que le type d’unité organisationnelle anticipé par le service correspond au type de l’UO dans la base de données.
- Si toutes les vérifications aboutissent, le gestionnaire enregistre les données de l’objet ExternalOrgUnitInfo de la requête pour leur utilisation par des gestionnaires ultérieurs.
Comportement en cas d’erreur
Si l’une des étapes de la validation échoue, le gestionnaire génère une exception et un message d’information détaillé.
Note de configuration
Le gestionnaire de validation devrait généralement être exécuté en premier lieu dans la liste des gestionnaires, avant tout autre gestionnaire d’actualisation ou de suppression d’informations de la base de données.
DeleteCourseOfferingIMHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingIMHandler
Comportement prévu
Ce processus doit échouer si tout élément dépend de l’offre de cours (nœuds secondaires dans la hiérarchie IM). Ce gestionnaire effectue les tâches suivantes :
- Effectue une suppression superficielle de l’offre de cours dans les tableaux IPSIS si aucun élément n’en dépend.
- Supprime toutes les relations primaires de la hiérarchie IM pour cette offre.
- Définit l’état du résultat à EntityDeleted.
- Le traitement est cédé au prochain gestionnaire configuré.
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 DeleteIM devrait généralement être exécuté en dernier lieu dans la liste des gestionnaires.
DeleteCourseOfferingDeleteLEHandler
Ce gestionnaire est utilisé si le comportement visé consiste à supprimer toutes les offres correspondantes de Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingDeleteLEHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes pour chaque offre de cours de Brightspace mise en correspondance :
- Supprime l’offre de cours (et génère automatiquement une entrée de journal de vérification).
- Identifie toutes les correspondances à l’offre de cours de Brightspace comme étant supprimées.
- Définit l’état du résultat à EntityDeleted.
- 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
- Ceci doit se produire avant la suppression dans le tableau IM (p. ex., DeleteCourseOfferingIMHandler).
- Ce gestionnaire ne serait pas configuré en même temps que le gestionnaire DeleteCourseOfferingInactiveLEHandler.
DeleteCourseOfferingCascadeDeleteCourseSectionHandler
Ce gestionnaire est utilisé si le comportement visé consiste à effectuer la suppression en cascade de l’offre du cours et de toutes ses sections secondaires dans les tableaux IM.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingCascadeDeleteCourseSectionHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Identifie toutes les sections secondaires d’une offre de cours dans les tableaux IM.
- Pour chaque section, le gestionnaire transmet une opération DeleteCourseSection en fonction de la liste actuelle des gestionnaires pour l’interface IDeleteCourseSectionHandler.
- Si au moins une section est supprimée, le gestionnaire change l’état du résultat à EntityDeleted.
- Le traitement est cédé au prochain gestionnaire configuré.
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
- Ceci doit survenir avant la suppression de l’offre de cours dans les tableaux de Brightspace ou les tableaux IM (p. ex., DeleteCourseOfferingIMHandler, DeleteCourseOfferingDeleteLEHandler, DeleteCourseOfferingInactiveLEHandler).
- Ce gestionnaire ne fonctionne correctement que si chaque gestionnaire DeleteCourseOffering ultérieur configuré comprend un gestionnaire DeleteCourseSection configuré correspondant. Si par exemple les gestionnaires DeleteCourseOfferingCascadeDeleteCourseSectionHandler et DeleteCourseOfferingIMHandler sont utilisés, le gestionnaire DeleteCourseSectionIMHandler devra également l’être.