L'interface ITranslateCourseSection sert à traduire les sections de cours LIS en sections de cours d'IPSIS.
La mise en œuvre de l'interface est D2L.IM.IPSIS.LIS.CMS.ITranslateCourseSection.
Le modèle de liste de configuration suivant offre un point de départ pour toute mise en œuvre de LIS :
IPSIS, Par défaut
- CourseSectionRequestBaseTranslator (Sort Order = 10)
- CourseSectionRequestParentOfferingIdRequiredTranslator (Sort Order = 20)
- CourseSectionRequestNameRequiredTranslator (Sort Order = 30)
- CourseSectionRequestDepartmentRequiredTranslator (Sort Order = 40)
- CourseSectionRequestSemesterOptionalTranslator (Sort Order = 50)
- CourseSectionRequestStartDateEndDateRequiredTranslator (Sort Order = 60)
- CourseSectionRequestStatusOptionalTranslator (Sort Order = 70)
CourseSectionRequestBaseTranslator
Le traducteur CourseSectionRequestBaseTranslator reçoit l'identificateur unique qui se trouve dans la section de cours de la demande.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestBaseTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Définit OrgUnitCode et OrgUnitName à la valeur fournie dans sourcedGUID.sourcedid.
- Le traitement passe au traducteur suivant.
Entité
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
Code
|
result.Entity.Code
|
courseSectionRecord.sourcedGUID.sourcedId
|
|
Nom
|
result.Entity.Name
|
courseSectionRecord.sourcedGUID.sourcedId
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Notes de configuration
Ce traducteur (ou un autre traducteur de base) doit d'abord être configuré dans la liste des traducteurs.
CourseSectionRequestParentOfferingIdRequiredTranslator
Le traducteur CourseSectionRequestParentOfferingIdRequiredTranslator envoie les requêtes relatives à l'ID primaire de l'offre de cours et la met en correspondance.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestParentOfferingIdRequiredTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Définit l'ID ParentOfferingId du résultat pour contenir la valeur du ParentOfferingId dans la demande.
- Le traitement passe au traducteur suivant.
ParentOfferingId
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
ID primaire de l'offre
|
result.ParentOfferingId
|
courseSectionRecord.courseSection.parentOfferingId
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Note de configuration
Ce traducteur peut être placé n'importe où après le traducteur de base.
CourseSectionRequestNameRequiredTranslator
Le traducteur CourseSectionRequestNameRequiredTranslator envoie les requêtes relatives au nom de la section et le met en correspondance.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestNameRequiredTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Met à jour l'OrgUnitName pour contenir la valeur du titre dans la requête.
- Le traitement passe au traducteur suivant.
Entité
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
Nom
|
result.Entity.Name
|
courseSectionRecord.courseSection.title
|
Comportement en cas d'erreur
Si un problème de traitement survient, IncompleteRequestException génère une exception. Résultat :
- L'interruption de tout traitement.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Note de configuration
Ce traducteur peut être placé n'importe où après le traducteur de base.
CourseSectionRequestDepartmentRequiredTranslator
Le traducteur CourseSectionRequestDepartmentRequiredTranslator envoie les requêtes relatives à l'ID du département et le met en correspondance.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestDepartmentRequiredTranslator
Comportement prévu
Le traducteur termine les tâches suivantes :
- Définit l'ID ParentDepartmentId du résultat pour contenir la valeur org.orgName dans la demande.
- Le traitement passe au traducteur suivant.
ParentDepartmentID
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
Id du département primaire
|
result.ParentDepartmentId
|
courseSectionRecord.courseSection.org.orgName
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Notes de configuration
Ce traducteur peut être placé n'importe où après le traducteur de base.
CourseSectionRequestSemesterOptionalTranslator
Le traducteur CourseSectionRequestSemesterOptionalTranslator met en correspondance l'ID du semestre.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestSemesterOptionalTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Définit l'ID ParentSemesterId du résultat pour contenir la valeur academicSession dans la demande (si présente).
- Le traitement passe au traducteur suivant.
ParentSemeseterId
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
Parent SemesterId
|
result.ParentSemesterId
|
courseSectionRecord.courseSection.academicSession
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Notes de configuration
Ce traducteur peut être placé n'importe où après le traducteur de base.
CourseSectionRequestStartDateEndDateOptionalTranslator
Le traducteur CourseSectionRequestStartDateEndDateOptionalTranslator définit la date de début et la date de fin de la section.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateOptionalTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Définit les dates de début et de fin de l'UO pour contenir les valeurs du commencement timeFrame.begin et de la fin timeFrame.end dans la requête.
- Le traitement passe au traducteur suivant.
Entité
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
Date de début
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
Date de fin
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Notes de configuration
- Ce traducteur peut être placé n'importe où après le traducteur de base.
- Ce traducteur ne peut être configuré avec le traducteur CourseSectionRequestStartDateEndDateRequiredTranslator.
CourseSectionRequestStartDateEndDateRequiredTranslator
Le traducteur CourseSectionRequestStartDateEndDateRequiredTranslator requiert et met en correspondance les dates de début et de fin de la section de cours.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateRequiredTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Définit les dates de début et de fin de l'UO pour contenir les valeurs du commencement timeFrame.begin et de la fin timeFrame.end dans la requête.
- Le traitement passe au traducteur suivant.
Entité
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
Date de début
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
Date de fin
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Notes de configuration
- Ce traducteur peut être placé n'importe où après le traducteur de base.
- Ce traducteur ne peut être configuré avec le traducteur CourseSectionRequestStartDateEndDateOptionalTranslator.
CourseSectionRequestStatusOptionalTranslator
Le traducteur CourseSectionRequestStatusOptionalTranslator définit l'état de la section.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStatusOptionalTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Définit la propriété IsActive de l'UO pour contenir la valeur de l'état dans la requête lorsque la propriété courseSectionRecord.courseSection.status a été définie.
- Si l'état n'est pas fourni, la valeur par défaut est nulle comme il s'agit d'un champ booléen Nullable.
- Si l'état est fourni, mais que la valeur est introuvable dans le dictionnaire (dans VocabManager), la valeur est réglée à Faux.
- Le traitement passe au traducteur suivant.
Entité
|
Propriété
|
Objet du résultat de la traduction
|
Mise en correspondance de requête LIS
|
|
État
|
result.Entity.IsActive
|
courseSectionRecord.courseSection.status
|
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
Note de configuration
Ce traducteur peut être placé n'importe où après le traducteur de base.
CourseSectionRequestTruncateOrgUnitCodeTranslator
Le traducteur CourseSectionRequestTruncateOrgUnitCodeTranslator tronque le code de l'UO de l'objet du résultat si le code contient plus de 50 caractères. Le code tronqué est fixé à 50 caractères.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestTruncateOrgUnitCodeTranslator
Comportement prévu
Le traducteur effectue les tâches suivantes :
- Vérifiez que le code result.Entity.Code ne dépasse pas 50 caractères. Le cas échéant, le code tronqué est fixé à 50 caractères.
- Le traitement passe au traducteur suivant.
Note de configuration
Ce traducteur peut être placé n'importe où après le traducteur de base.
CourseSectionRequestCreateParentsTranslator
Les UO d'auto-dispositions CourseSectionRequestCreateParentsTranslator, soit les offres de cours, les modèles et les départements des requêtes de section Ellucian ILP.
Mise en œuvre
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestCreateParentsTranslator
Comportement prévu
À la réception d'une requête de section par Ellucian ILP, les activités suivantes sont déclenchées dans la plateforme Brightspace :
- Créer/Mettre à jour un département en fonction des correspondances ci-dessous
- Créer/Mettre à jour un modèle de cours en fonction des correspondances ci-dessous
- Créer/Mettre à jour une offre de cours en fonction des correspondances ci-dessous
- Créer/Mettre à jour une section en fonction de la requête
De plus, les UO se voient réattribuer un primaire si un nouveau primaire avec une structure organisationnelle différente passe.
Entité
Propriété
|
Objet du résultat de la traduction
|
Correspondance de requête LS
|
| id |
result.Entity.id |
courseSectionRecord.sourceGUID.sourceId |
| titre |
result.Entity.title |
courseSectionRecord.courseSection.title.textString |
| label |
|
courseSectionRecord.courseSection.label.textString |
| parent |
|
courseSectionRecord.courseSection.parentOfferingId |
| département |
|
courseSectionRecord.courseSection.org.orgName.textString |
| term |
|
courseSectionRecord.courseSection.academicSession.textString |
| departmentId |
|
courseSectionRecord.courseSection.org.id.textString |
| startDate |
|
courseSectionRecord.courseSection.timeFrame.begin |
| endDate |
|
courseSectionRecord.courseSection.timeFrame.end |
| status |
result.Entity.status |
courseSectionRecord.courseSection.status |
Comportement en cas d'erreur
Si un problème survient lors du traitement, IncompleteRequestException génère une exception. Résultat :
- L'interruption de toute étape de traitement éventuelle.
- En-tête de réponse LIS contenant :
- CodeMajor = échec.
- Severity = état.
- CodeMinor = invaliddata.
En cas d'échec de la requête de section du cours, les UO primaires ne sont pas supprimées.
Notes de configuration
D2L recommande l'ordre de configuration suivant lors de l'utilisation de ce traducteur :
- CourseSectionRequestBaseTranslator
- CourseSectionRequestNameRequiredTranslator
- CourseSectionRequestCreateParentsTranslator
- CourseSectionRequestStartDateEndDateOptionalTranslator