De ITranslateCourseSection-interface wordt gebruikt om een LIS-cursus om te zetten naar een IPSIS-cursus.
De interface-implementatie is D2L.IM.IPSIS.LIS.CMS.ITranslateCourseSection.
De volgende sjabloonconfiguratielijst biedt een startpunt voor elke LIS-implementatie:
IPSIS, Standaard
- CourseSectionRequestBaseTranslator (sorteervolgorde = 10)
- CourseSectionRequestParentOfferingIdRequiredTranslator (sorteervolgorde = 20)
- CourseSectionRequestNameRequiredTranslator (sorteervolgorde = 30)
- CourseSectionRequestDepartmentRequiredTranslator (sorteervolgorde = 40)
- CourseSectionRequestSemesterOptionalTranslator (sorteervolgorde = 50)
- CourseSectionRequestStartDateEndDateRequiredTranslator (sorteervolgorde = 60)
- CourseSectionRequestStatusOptionalTranslator (sorteervolgorde = 70)
CourseSectionRequestBaseTranslator
De CourseSectionRequestBaseTranslator haalt de unieke identificatie van de cursussectie op uit de aanvraag.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestBaseTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Stelt de OrgUnitCode en OrgUnitName in op de waarde die is opgegeven in de sourcedGUID.sourcedid.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Entiteit
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Code
|
result.Entity.Code
|
courseSectionRecord.sourcedGUID.sourcedId
|
|
Naam
|
result.Entity.Name
|
courseSectionRecord.sourcedGUID.sourcedId
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerkingen over de configuratie
Dit omzettingsprogramma (of een alternatief omzettingsprogramma) moet eerst worden geconfigureerd in de lijst met omzettingsprogramma's.
CourseSectionRequestParentOfferingIdRequiredTranslator
De CourseSectionRequestParentOfferingIdRequiredTranslator vereist en wijst het bovenliggende onderdeel voor de cursuseditie toe.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestParentOfferingIdRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Stelt de ParentOfferingId van het resultaat zo in dat deze de waarde van de ParentOfferingId in de aanvraag bevat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
ParentOfferingId
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Parent OfferingId
|
result.ParentOfferingId
|
courseSectionRecord.courseSection.parentOfferingId
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerking over de configuratie
Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
CourseSectionRequestNameRequiredTranslator
De CourseSectionRequestNameRequiredTranslator vereist de sectienaam en wijst deze toe.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestNameRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Werkt de OrgUnitName bij zodat deze de waarde uit de titel in de aanvraag bevat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Entiteit
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Naam
|
result.Entity.Name
|
courseSectionRecord.courseSection.title
|
Foutgedrag
Als er een probleem is met de verwerking, wordt er een IncompleteRequestException gemeld. Dit resulteert in:
- Opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerking over de configuratie
Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
CourseSectionRequestDepartment RequiredTranslator
De CourseSectionRequestDepartment RequiredTranslator vereist en wijst de afdelings-ID toe.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestDepartmentRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Hiermee stelt u de ParentDepartmentId van het resultaat in op de waarde van org.orgName in de aanvraag.
- De verwerking gaat door naar het volgende omzettingsprogramma.
ParentDepartmentID
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Bovenliggende DepartmentId
|
result.ParentDepartmentId
|
courseSectionRecord.courseSection.org.orgName
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerkingen over de configuratie
Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
CourseSectionRequestSemesterOptionalTranslator
De CourseSectionRequestSemesterOptionalTranslator wijst de semester-id toe.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestSemesterOptionalTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Stelt de bovenliggende semester-id van het resultaat zo in dat deze de waarde van academicSession in de aanvraag bevat (indien verstrekt).
- De verwerking gaat door naar het volgende omzettingsprogramma.
ParentSemesterId
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Bovenliggende SemesterId
|
result.ParentSemesterId
|
courseSectionRecord.courseSection.academicSession
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerkingen over de configuratie
Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
CourseSectionRequestStartDateEndDateOptionalTranslator
De CourseSectionRequestStartDateEndDateOptionalTranslator stelt de start- en einddatum van de sectie in.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateOptionalTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Hiermee wordt de start- en einddatum van de OrgUnit ingesteld zodat deze de waarden van de eerste timeFrame.begin en timeFrame.end in de aanvraag bevat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Entiteit
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Startdatum
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
Einddatum
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerkingen over de configuratie
- Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
- Dit omzettingsprogramma kan niet worden geconfigureerd met CourseSectionRequestStartDateEndDateRequiredTranslator.
CourseSectionRequestStartDateEndDateRequiredTranslator
De CourseSectionRequestStartDateEndDateRequiredTranslator vereist en wijst de start- en einddatums voor de cursussectie toe.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Hiermee wordt de start- en einddatum van de OrgUnit ingesteld zodat deze de waarden van de eerste timeFrame.begin en timeFrame.end in de aanvraag bevat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Entiteit
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Startdatum
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
Einddatum
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerkingen over de configuratie
- Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
- Dit omzettingsprogramma kan niet worden geconfigureerd met CourseSectionRequestStartDateEndDateOptionalTranslator.
CourseSectionRequestStatusOptionalTranslator
De CourseSectionRequestStatusOptionalTranslator stelt de status van de sectie in.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStatusOptionalTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Hiermee stelt u de eigenschap IsActive van de organisatie-eenheid zo in dat deze de waarde bevat van de status in de aanvraag, als de eigenschap courseSectionRecord.courseSection.status is ingesteld.
- Als de status niet wordt opgegeven, wordt de waarde standaard ingesteld op null, omdat het veld een nullable boolean is.
- Als de status wordt gegeven, maar de waarde niet in het woordenboek is gevonden (via de VocabManager), wordt de waarde ingesteld op false.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Entiteit
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Status
|
Result.Entity.IsActive
|
courseSectionRecord.courseSection.status
|
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Opmerking over de configuratie
Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
CourseSectionRequestTruncateOrgUnitCodeTranslator
De CourseSectionRequestTruncateOrgUnitCodeTranslator kapt de code van de organisatie-eenheid van het resultaatobject af als de code langer is dan 50 tekens. De afgekapte code is ingesteld op 50 tekens.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestTruncateOrgUnitCodeTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Controleert of result.entity.Code langer is dan 50 tekens. Zo ja, dan wordt de code afgekapt tot 50 tekens.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Opmerking over de configuratie
Dit omzettingsprogramma kan overal achter het basisomzettingsprogramma worden geplaatst.
CourseSectionRequestCreateParentsTranslator
De CourseSectionRequestCreateParentsTranslator zorgt voor automatische inrichting van de organisatie-eenheden, dat wil zeggen, cursusedities, sjablonen en afdelingen van de sectieaanvraag van Ellucian ILP.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestCreateParentsTranslator®
Verwacht gedrag
Wanneer een sectieaanvraag van Ellucian ILP wordt ontvangen, worden de volgende activiteiten op het Brightspace®-platform geactiveerd:
- Een afdeling maken/bijwerken op basis van de onderstaande toewijzingen
- Een cursussjabloon maken/bijwerken op basis van de onderstaande toewijzingen
- Een cursuseditie maken/bijwerken op basis van de onderstaande toewijzingen
- Een sectie maken/bijwerken op basis van de aanvraag
Bovendien wordt het bovenliggend onderdeel van organisatie-eenheden gewijzigd als een nieuw bovenliggend onderdeel een andere organisatiestructuur heeft.
Entiteit
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LS-aanvraag
|
| id |
result.Entity.id |
courseSectionRecord.sourceGUID.sourceId |
| title |
result.Entity.title |
courseSectionRecord.courseSection.title.textString |
| label |
|
courseSectionRecord.courseSection.label.textString |
| bovenliggend item |
|
courseSectionRecord.courseSection.parentOfferingId |
| department |
|
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 |
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een IncompleteRequestException gegenereerd. Dit resulteert in:
- De opschorting van alle verdere verwerking.
- Een LIS-responskoptekst met:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Als de aanvraag voor de cursussectie mislukt, worden de bovenliggende organisatie-eenheden niet verwijderd.
Opmerkingen over de configuratie
D2L® beveelt de volgende configuratievolgorde aan wanneer u dit omzettingsprogramma gebruikt:
- CourseSectionRequestBaseTranslator
- CourseSectionRequestNameRequiredTranslator
- CourseSectionRequestCreateParentsTranslator
- CourseSectionRequestStartDateEndDateOptionalTranslator