L'interface du gestionnaire IReplaceCourseSectionHandler est utilisée par les adaptateurs IPSIS pour prendre en charge l'opération de remplacement pour les sections de cours.
La mise en œuvre de l'interface est D2L.IM.IPSIS.OrgUnits.CourseSections.Handlers.IReplaceCourseSectionHandler.
Les listes de configuration IPSIS, Template – Sections et IPSIS, Template – Groups offrent un point de départ pour toute mise en œuvre IPSIS.
La liste de gestionnaires suivante est utilisée comme point de départ lorsque vous désirez utiliser les sections de cours de Brightspace pour vos sections SIS :
- ReplaceCourseSectionReadHandler (Sort Order = 10)
- ReplaceCourseSectionStatusDefaultActiveHandler (Sort Order = 20)
- ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler (Sort Order = 30)
- ReplaceCourseSectionValidateBaseHandler (Sort Order = 40)
- ReplaceCourseSectionValidateParentOfferingExistsHandler (Sort Order = 50)
- ReplaceCourseSectionCreateLMSSectionHandler (Sort Order = 60)
- ReplaceCourseSectionCreateIMSectionHandler (Sort Order = 70)
- ReplaceCourseSectionSaveLMSSectionHandler (Sort Order = 80)
- ReplaceCourseSectionSaveIMHandler (Sort Order = 90)
La liste de gestionnaires suivante est utilisée comme point de départ lorsque vous désirez utiliser les groupes de Brightspace pour vos sections SIS :
- ReplaceCourseSectionReadHandler (Sort Order = 10)
- ReplaceCourseSectionStatusDefaultActiveHandler (Sort Order = 20)
- ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler (Sort Order = 30)
- ReplaceCourseSectionValidateBaseHandler (Sort Order = 40)
- ReplaceCourseSectionValidateParentOfferingExistsHandler (Sort Order = 50)
- ReplaceCourseSectionCreateLMSGroupHandler (Sort Order = 60)
- ReplaceCourseSectionCreateIMSectionHandler (Sort Order = 70)
- ReplaceCourseSectionSaveLMSGroupHandler (Sort Order = 80)
- ReplaceCourseSectionSaveIMHandler (Sort Order = 90)
ReplaceCourseSectionReadHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionReadHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Tente de lire les informations relatives à la section de cours dans les tableaux IM.
- S’il en trouve, il tente de lire toute correspondance à Brightspace pour la section de cours, puis tente de lire les informations relatives à la section de cours dans Brightspace.
- Pour chaque UO primaire indiquée dans la requête, le gestionnaire lit l’information dans Brightspace et l’ajoute à la liste des UO primaires. Si l’UO primaire ne comprend aucune correspondance dans Brightspace, le gestionnaire génère une exception ParentNotFoundException.
- Le traitement est cédé au prochain gestionnaire.
ReplaceCourseSectionStatusDefaultActiveHandler
Mise en œuvre
ReplaceCourseSectionStatusDefaultActiveHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Définit l'état de l'objet section de cours à actif s'il n'affiche pas déjà une valeur.
- Le traitement est cédé au prochain gestionnaire.
ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Supprime le département primaire et/ou le semestre primaire de la requête.
- Supprime les UO primaires si elles sont définies dans l'adaptateur. Ces valeurs ne sont pas utilisées dans la mise en œuvre par défaut.
- Le traitement est cédé au prochain gestionnaire.
ReplaceCourseSectionValidateBaseHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionValidateBaseHandler
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 de validation génère une exception ArgumentNullException.
- Si la section existe déjà dans les tableaux IM, le gestionnaire vérifie que toute UO primaire indiquée dans la requête existe déjà comme UO primaire dans la hiérarchie IM. Si une tentative d'ajout ou de remplacement de nœud primaire de la section est effectuée, le gestionnaire génère une exception. Le message d'erreur indique : Unable to change the parent offering of course section with id {id}. This behavior is not supported. – (Impossible de modifier l'offre primaire de la section de cours affichant l'ID {ID}. Ce comportement n'est pas pris en charge.)
- Le traitement est cédé au prochain gestionnaire.
ReplaceCourseSectionValidateParentOfferingExistsHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionValidateParentOfferingExistsHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Vérifie que l’offre de cours primaire indiquée existe à la fois dans l’objet OrgUnit de Brightspace et dans l’objet IPSIS OrgUnit.
- S'il existe une association entre les deux, le gestionnaire s'assure que cette association est valide.
- Si une étape de la vérification échoue, le gestionnaire de validation génère une exception ParentNotFoundException. L'exception est reçue, consignée et traitée par le gestionnaire.
- Le traitement est cédé au prochain gestionnaire.
ReplaceCourseSectionNameNoUpdateLMSHandler
Le gestionnaire ReplaceCourseSectionNameNoUpdateLMSHandler est utilisé pour prévenir l’actualisation du nom du l’objet Groupe ou Section de Brightspace après sa création initiale.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionNameNoUpdateLMSHandler
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é.
- Le traitement est cédé au prochain gestionnaire.
Note de configuration
Ce gestionnaire est un gestionnaire de manipulation conçu pour être configuré avant les gestionnaires CreateLMS et SaveLMS.
ReplaceCourseSectionCreateLMSSectionHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionCreateLMSSectionHandler
Comportement prévu
Ce gestionnaire ne s’exécute que si la section n’existe pas encore dans les tableaux Brightspace et IM. Ce gestionnaire effectue les tâches suivantes :
- Crée la section de cours à l'aide des informations transmises dans la requête (ce qui génère une entrée de création de section dans le journal de vérification).
- Si l'opération CreateLMS aboutit, le gestionnaire génère une entrée de section de cours créée dans le journal de vérification qui fait référence à l'ID de section de cours.
- Si l'opération échoue, le gestionnaire attribue la valeur CreateFailed à l'objet ReplaceRequestStatus et tout le traitement s'interrompt (renvoi de la valeur False [faux]).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus et le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
ReplaceCourseSectionCreateIMSectionHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionCreateIMSectionHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Crée l'entité IPSIS OrgUnit si elle n'existe pas déjà.
- Ajoute la hiérarchie IM appropriée.
- Pour chaque UO à laquelle l'entité correspond, le gestionnaire crée la correspondance IPSIS si elle n'existe pas déjà. Si le processus aboutit, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus et renvoie la valeur True (vrai). Si le processus échoue, le gestionnaire attribue l'état CreateFailed à l'objet ReplaceRequestStatus et renvoie la valeur False (faux).
- Le traitement est cédé au prochain gestionnaire.
ReplaceCourseSectionSaveLMSSectionHandler
Le gestionnaire ReplaceCourseSectionSaveLMSSectionHandler enregistre les changements apportés à toutes les sections correspondantes de Brightspace (zéro ou plus) au besoin.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionSaveLMSSectionHandler
Comportement prévu
Si des mises à jour doivent être faites pour les sections mises en correspondance, le gestionnaire effectue les tâches suivantes :
- Actualise la section (ce qui génère une entrée d'actualisation de section dans le journal de vérification).
- Actualise les propriétés de l’UO dans Brightspace, mais ne modifie pas les nœuds primaires de la section.
- Si l'opération UpdateLMS aboutit, le gestionnaire génère une entrée de section de cours actualisée dans le journal de vérification qui fait référence à l'ID de section de cours.
- Si l'opération échoue, le gestionnaire attribue la valeur CreateFailed à l'objet ReplaceRequestStatus et tout le traitement s'interrompt (renvoi de la valeur False [faux]).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus et le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
ReplaceCourseSectionSaveIMHandler
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionSaveIMHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Enregistre toutes les modifications apportées à la section de cours IPSIS et aux associations si nécessaire.
- Enregistre toute modification apportée à la hiérarchie IM.
ReplaceCourseSectionCreateLMSGroupHandler
Le gestionnaire ReplaceCourseSectionCreateLMSGroupHandler est utilisé lorsqu’une organisation désire créer des groupes plutôt que des sections dans Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionCreateLMSGroupHandler
Comportement prévu
Ce gestionnaire ne s’exécute que si le groupe n’existe pas encore dans les tableaux Brightspace et IM. Ce gestionnaire effectue les tâches suivantes :
- Récupère la valeur de d2l.integration.IPSIS.GroupCategory. Si la valeur n'est pas définie, le gestionnaire génère une exception InvalidConfigurationVariableException.
- Si aucune catégorie de groupe correspondant au nom dans d2l.integration.IPSIS.GroupCategory n'existe, le gestionnaire crée une catégorie de groupe basée sur le nom et la description de la variable de configuration (ce qui génère une entrée de création de groupe dans le journal de vérification).
- Si la création de la catégorie de groupe échoue, le gestionnaire génère une exception décrivant le problème et l'identificateur de section.
- Crée le groupe de cours de la catégorie de groupe ci-dessus à l'aide des informations transmises dans la requête.
- Si l'opération CreateLMS aboutit, le gestionnaire génère une entrée de groupe de cours créé dans le journal de vérification qui fait référence à l'ID de groupe de cours.
- Si l'opération échoue, le gestionnaire attribue la valeur CreateFailed à l'objet ReplaceRequestStatus et tout le traitement s'interrompt (renvoi de la valeur False [faux]).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus et le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
Note de configuration
Ce gestionnaire remplace le gestionnaire ReplaceCourseSectionCreateLMSSectionHandler dans la liste des plugiciels par défaut.
ReplaceCourseSectionSaveLMSGroupHandler
Le gestionnaire ReplaceCourseSectionSaveLMSGroupHandler est utilisé lorsqu'une organisation désire créer des groupes plutôt que des sections dans le SGA.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionSaveLMSGroupHandler
Comportement prévu
Si des mises à jour doivent être faites pour les groupes de Brightspace mis en correspondance, le gestionnaire effectue les tâches suivantes :
- Actualise le groupe (ce qui génère une entrée d’actualisation de groupe dans le journal de vérification) et les propriétés de l’UO dans Brightspace, mais ne modifie pas les nœuds primaires du groupe.
- Si l'opération UpdateLMS aboutit, le gestionnaire génère une entrée de groupe de cours actualisé dans le journal de vérification qui fait référence à l'ID de groupe de cours.
- Si l'opération échoue, le gestionnaire attribue la valeur CreateFailed à l'objet ReplaceRequestStatus et tout le traitement s'interrompt (renvoi de la valeur False [faux]).
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus et le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
Note de configuration
Ce gestionnaire remplace le gestionnaire ReplaceCourseSectionSaveLMSSectionHandler dans la liste des plugiciels par défaut.
ReplaceCourseSectionValidateLMSOrgUnitExistsHandler
Le gestionnaire ReplaceCourseSectionValidateLMSOrgUnitExistsHandler 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.CourseSections.Handlers.ReplaceCourseSectionValidateLMSOrgUnitExistsHandler
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, l’UO a été supprimée dans Brightspace et une exception UpdateOrgUnitFailedException est générée. 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.
ReplaceCourseSectionBuildParentHierarchyRequiredHandler
Le gestionnaire ReplaceCourseSectionBuildParentHierarchyRequiredHandler élabore une offre et un modèle de cours primaires pour la section si aucun n'a été transmis dans la requête.
Mise en œuvre
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionBuildParentHierarchyRequiredHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Vérifie si une offre de cours primaire est indiquée dans la requête.
- Dans le cas contraire, le gestionnaire crée une offre et un modèle de cours primaires affichant le même nom et le même code que la section.
- Renvoie la valeur True (vrai).
Comportement en cas d'erreur
Si la création de l'offre ou du modèle de cours entraîne un problème, le gestionnaire génère une exception CreateOrgUnitFailedException.
Note de configuration
Ce gestionnaire doit précéder tout gestionnaire de validation et succède généralement au gestionnaire de lecture.