L’interface du gestionnaire IDeleteCourseSectionHandler est utilisée par les adaptateurs IPSIS pour supprimer des sections de cours de Brightspace.
La mise en œuvre de l'interface est D2L.IM.IPSIS.OrgUnits.CourseSections.Handlers.IDeleteCourseSectionHandler.
La liste de configuration suivante offre un point de départ pour toute mise en œuvre IPSIS :
IPSIS, Template – Course Section
- DeleteCourseSectionValidateHandler (Sort Order = 10)
- DeleteCourseSectionIMHandler (Sort Order = 20)
DeleteCourseSectionValidateHandler
Le gestionnaire DeleteCourseSectionValidateHandler 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.CourseSections.Handlers.DeleteCourseSectionValidateHandler
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.
- Vérifie que la section n'affiche aucune association de section primaire (celles-ci doivent être supprimées à l'aide des services SA au préalable).
- 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.
DeleteCourseSectionIMHandler
Le gestionnaire DeleteCourseSectionIMHandler identifie la section comme étant supprimée dans les tableaux IPSIS, mais n’a aucun effet dans Brightspace. Si les inscriptions ou les unités organisationnelles de Brightspace doivent être modifiés, des gestionnaires supplémentaires seront requis.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.DeleteCourseSectionIMHandler
Comportement prévu
Le processus échouera si des éléments dépendent de la section de cours (p. ex., des inscriptions IM non supprimées). Ce gestionnaire effectue les tâches suivantes :
- Effectue une suppression superficielle de la section de cours dans le tableau IM ExternalOrgUnit (mais non des correspondances).
- Supprime toutes les références à la section de la hiérarchie IM.
- 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.
DeleteCourseSectionLEHandler
Le gestionnaire DeleteCourseSectionLEHandler est utilisé si le comportement visé consiste à supprimer toutes les sections correspondantes de Brightspace. Tous les utilisateurs actifs restants demeurent inscrits dans toute offre de cours primaire à moins d'avoir été supprimés ou désactivés. Vous pouvez utiliser le gestionnaire DeleteCourseSectionCascadeDeleteEnrollmentHandler pour supprimer tout utilisateur restant des sections.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.DeleteCourseSectionLEHandler
Comportement prévu
Pour chaque section de cours mise en correspondance, le gestionnaire :
- Supprime la section de cours (et génère automatiquement une entrée de journal de vérification).
- Identifie la correspondance IM comme étant supprimée.
- Cède le traitement 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
Ceci doit se produire avant la suppression dans le tableau IM (p. ex., DeleteCourseSectionIMHandler).
DeleteCourseSectionCascadeDeleteEnrollmentHandler
Si la section à supprimer comprend des inscriptions actives restantes, les gestionnaires configurés de la plateforme IPSIS pour l'interface IDeleteEnrollmentHandler sont utilisés pour exécuter le comportement visé et supprimer les inscriptions pour l'organisation.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.DeleteCourseSectionCascadeDeleteEnrollmentHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Obtient la liste des inscriptions restantes qui n'ont pas été supprimées pour la section.
- Utilise l'interface IDeleteEnrollmentHandler pour les supprimer.
- 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é.
- Ce gestionnaire interrompt le traitement à la première inscription qui échoue et génère une exception. Il ne passe pas aux autres inscriptions (si elles existent).
Notes de configuration
- Ceci doit se produire avant la suppression dans le tableau IM (p. ex., DeleteCourseSectionIMHandler).
- Cette opération doit survenir avant la suppression du SGA si vous désirez également supprimer des sections du SGA (p. ex., DeleteCourseSectionLMSHandler).