L’interface du gestionnaire IDeleteSectionAssociationHandler est utilisée par les adaptateurs IPSIS pour supprimer des associations de section dans Brightspace.
La mise en œuvre de l'interface est D2L.IM.IPSIS.OrgUnits.SectionAssociations.Handlers.IDeleteSectionAssociationHandler.
La liste de configuration IPSIS, modèle d'association de section offre un point de départ pour toute mise en œuvre IPSIS.
La liste des gestionnaires ci-dessous est utilisée comme point de départ :
- DeleteSectionAssociationValidateHandler (Sort Order = 10)
- DeleteSectionAssociationIMHandler (Sort Order = 20)
DeleteSectionAssociationValidateHandler
Le gestionnaire DeleteSectionAssociationValidateHandler 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.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler
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.
DeleteSectionAssociationIMHandler
Le gestionnaire DeleteSectionAssociationIMHandler 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.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler
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.
DeleteSectionAssociationIMHandler
Le gestionnaire DeleteSectionAssociationIMHandler effectue une suppression superficielle de l'association de section dans les tableaux IM.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationIMHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Identifie l'association de section comme étant supprimée dans le tableau IM des unités organisationnelles.
- Supprime les enregistrements de la hiérarchie associés à l'association de section.
- Si une erreur survient lors du traitement, le gestionnaire attribue le code d'erreur approprié au résultat.
- 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
Le gestionnaire DeleteIM devrait s'exécuter en dernier.
DeleteSectionAssociationInactiveLMSOfferingHandler
Le gestionnaire DeleteSectionAssociationInactiveLMSOfferingHandler est utilisé si le comportement visé consiste à rendre inactives toutes les offres de cours correspondantes dans le SGA.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationInactiveLMSOfferingHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Attribue l'état inactif à toutes les offres de cours associées à l'association de section indiquée dans le SGA. Identifie toutes les correspondances aux offres de cours du SGA comme étant inactives.
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityDeleted au résultat.
- 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é.
Notes de configuration
Ce gestionnaire doit s'exécuter avant le gestionnaire DeleteIM.
DeleteSectionAssociationDeleteLMSGroupSectionHandler
Le gestionnaire DeleteSectionAssociationDeleteLMSGroupSectionHandler est utilisé si le comportement visé consiste à supprimer tout groupe ou toute section du SGA associée à offre de cours du SGA affectée à l'association de section.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSGroupSectionHandler
Comportement prévu
Ce gestionnaire ne peut s'exécuter que s'il existe une correspondance pour l'enregistrement Association de section même. Ce gestionnaire effectue les tâches suivantes :
- Détermine les nœuds secondaires de l’UO dans Brightspace pour chaque UO de SGA à laquelle l’association de section correspond.
- Supprime le groupe ou la section de SGA pour chaque groupe ou section secondaire d'une UO à laquelle l'association de section correspond (ce qui génère automatiquement une entrée de journal de vérification), et supprime tous les enregistrements de correspondance IM associés au groupe ou à la section de SGA.
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityDeleted au résultat.
- 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 s'exécuter avant le gestionnaire DeleteIM.
- Si ce gestionnaire est utilisé de concert avec le gestionnaire DeleteLMSOffering, le gestionnaire DeleteLMSGroupSection doit précéder le gestionnaire DeleteLMSOffering.
DeleteSectionAssociationDeleteLMSOfferingHandler
Le gestionnaire DeleteSectionAssociationDeleteLMSOfferingHandler est utilisé si le comportement visé consiste à supprimer l’offre de cours de Brightspace liée à l’association de section.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSOfferingHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes pour chaque offre de cours du SGA mise en correspondance :
- Si l'offre de cours ne comprend plus de sections constituant des nœuds secondaires (après la comparaison de tous les nœuds secondaires de l'offre aux UO du tableau IM des correspondances), le gestionnaire supprime l'offre de cours du SGA (ce qui génère automatiquement une entrée de journal de vérification).
- Si l'offre de cours comprend d'autres sections correspondantes comme nœuds secondaires, le gestionnaire ne supprime pas l'offre de cours du SGA.
- Le gestionnaire effectue une suppression superficielle de l'enregistrement de correspondance IM associé à l'offre.
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityDeleted au résultat.
- 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é.
Notes de configuration
Ce gestionnaire doit s'exécuter avant le gestionnaire DeleteIM.
DeleteSectionAssociationUnenrolLMSGroupSectionHandler
Le gestionnaire DeleteSectionAssociationUnenrolLMSGroupSectionHandler désinscrit les utilisateurs de toute section devant être supprimée de l'association.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrollLMSGroupSectionHandler
Comportement prévu
Ce gestionnaire ne s'exécute que s'il existe une correspondance pour l'association de section et des sections associées (avec une correspondance) à supprimer dans le SGA. Ce gestionnaire effectue les tâches suivantes :
- Détermine les utilisateurs inscrits dans la section pour chaque section de la hiérarchie d'association de section (au moyen du tableau IM des inscriptions).
- Désinscrit les utilisateurs de la section de cours SGA qui doit être supprimée (ce qui génère automatiquement une entrée de journal de vérification).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityDeleted au résultat.
- 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 devrait précéder le gestionnaire DeleteLMSGroupSection pour s'assurer qu'aucune inscription pertinente ne demeure dans le SGA.
DeleteSectionAssociationUnenrolLMSOfferingHandler
Le gestionnaire DeleteSectionAssociationUnenrolLMSOfferingHandlerUnenrolls désinscrit les utilisateurs des nœuds primaires de l'offre de la correspondance de section supprimée, à moins qu'ils ne soient inscrits dans un autre groupe ou une autre section du même type de groupe sous l'offre.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrolLMSOfferingHandler
Comportement prévu
Ce gestionnaire ne s'exécute que s'il existe une correspondance pour l'association de section et des sections associées (avec une correspondance) à supprimer dans le SGA. Ce gestionnaire effectue les tâches suivantes :
- Détermine les utilisateurs inscrits dans la section pour chaque section de la hiérarchie d'association de section (au moyen du tableau IM des inscriptions).
- Si l'utilisateur n'est inscrit dans aucune autre section ou aucun autre groupe du même type de groupe sous l'offre de cours du SGA, le gestionnaire désinscrit l'utilisateur de l'offre de cours du SGA à supprimer (ce qui génère automatiquement une entrée de journal de vérification).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityDeleted au résultat.
- 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é.
Notes de configuration
- Ce gestionnaire devrait être placé après le gestionnaire CreateIM.
- Ce gestionnaire devrait précéder le gestionnaire DeleteLMSGroupSection pour s'assurer qu'aucune inscription pertinente ne demeure dans le SGA.
- Ce gestionnaire devrait être placé avant le gestionnaire SaveIM.