De ITranslateGroup-interface wordt gebruikt om een LIS-groepsrecord te vertalen naar een OrgUnit van Brightspace®.
De interface-implementatie is D2L.IM.IPSIS.LIS.GMS.ITranslateGroup.
De volgende configuratielijst biedt een startpunt voor elke LIS-implementatie.
Sjabloon, IPSIS
- GroupRequestBaseTranslator (sorteervolgorde = 10)
- GroupRequestTypeValueIdRequiredTranslator (sorteervolgorde = 20)
- GroupRequestNameShortDescRequiredTranslator (sorteervolgorde = 30)
GroupRequestBaseTranslator
De GroupRequestBaseTranslator wijst de groeps-id toe.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestBaseTranslator®
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.
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Code
|
result.Entity.Code
|
groupRecord.sourcedGUID.sourcedId
|
|
Naam
|
result.Entity.Name
|
groupRecord.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.
Opmerking over de configuratie
Dit omzettingsprogramma (of een alternatief omzettingsprogramma) moet eerst worden geconfigureerd in de lijst met omzettingsprogramma's.
GroupRequestTypeValueIdRequiredTranslator
De GroupRequestTypeValueIdRequiredTranslator vereist en wijst het eerste groepstype toe met behulp van de eerste typeValue in de aanvraag.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestTypeValueIdRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Voegt de OrgUnitType-toewijzing toe uit de eerste grouptype-typeValue.
- De verwerking gaat door naar het volgende omzettingsprogramma.
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Type
|
result.LISGroupType
|
groupRecord.group.groupType.typeValue{0}.id.textString
|
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 (of een aangepaste vervanging) moet altijd worden geconfigureerd.
GroupRequestNameShortDescRequiredTranslator
De GroupRequestNameShortDescRequiredTranslator vereist en wijst de naam toe op basis van de korte beschrijving.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Werkt de OrgUnitName bij om de waarde uit de korte beschrijving in de aanvraag te bevatten.
- De verwerking gaat door naar het volgende omzettingsprogramma.
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Naam
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
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.
GroupRequestNameLongDescRequiredTranslator
De GroupRequestNameLongDescRequiredTranslator vraagt de naam op en wijst deze toe op basis van de lange beschrijving.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameRequiredLongDescTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Werkt de OrgUnitName bij zodat deze de waarde van de lange beschrijving in de aanvraag bevat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Naam
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
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.
GroupRequestNameLongDescOptionalTranslator
De GroupRequestNameLongDesopOptionalTranslator stelt de naam in op basis van de lange beschrijving als deze bestaat.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameLongDescOptionalTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Werkt de naam van de organisatie-eenheid bij zodat deze de waarde bevat uit de lange beschrijving in de aanvraag als deze bestaat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Naam
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
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.
GroupRequestNameShortDescOptionalTranslator
De GroupRequestNameShortDescOptionalTranslator stelt de naam in op basis van de korte beschrijving als deze wordt verstrekt.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescOptionalTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Werkt de OrgUnitName bij om de waarde uit de korte beschrijving in de aanvraag te bevatten als deze bestaat.
- De verwerking gaat door naar het volgende omzettingsprogramma.
|
Eigenschap
|
Object voor omzettingsresultaat
|
Toewijzing LIS-aanvraag
|
|
Naam
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
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.
GroupRequestCreateRecordFromSourcedIdRequiredTranslator
De GroupRequestCreateRecordFromSourcedIdRequiredTranslator maakt een geldige groepsrecord als alleen de bron-id is doorgegeven.
Implementatie
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestCreateRecordFromSourcedIdRequiredTranslator®
Verwacht gedrag
Het omzettingsprogramma voert de volgende taken uit:
- Als er geen geldige groepsrecord bestaat in de aanvraag, stelt het omzettingsprogramma een dummy-groepsrecord op, waarbij de broncode wordt gebruikt voor de korte beschrijving en het type standaard wordt ingesteld op Afdeling.
- De verwerking gaat door naar het volgende omzettingsprogramma.
Opmerking over de configuratie
Dit omzettingsprogramma moet direct na het Base-omzettingsprogramma worden geplaatst.
GroupRequestTruncateOrgUnitCodeTranslator
De GroupRequestTruncateOrgUnitCodeTranslator 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.GroupRequestTruncateOrgUnitCodeTranslator®
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.