De IPSIS LIS v2.0-adapter implementeert de noodzakelijke LIS-services en -activiteiten ter ondersteuning van de volgende IMS LIS-profielen:
- IMS Global LIS v2.0-kernprofiel
- IMS Global LIS v2.0-profiel voor volledige cursushiërarchie
- IMS Global LIS v2.0-profiel voor gecombineerde secties
Elke service die door D2L® wordt geïmplementeerd als onderdeel van de LIS v2.0-adapter is zodanig uitgevoerd dat velden in de LIS-aanvragen kunnen worden toegewezen aan D2L®-velden op basis van de vereisten van een instelling. Dit wordt gedaan door middel van configureerbare en uitbreidbare omzettingsprogramma's die op effectieve wijze LIS-velden toewijzen aan velden op het D2L®-leerplatform.
Verdere details over de beschikbare toewijzingen en gedragingen worden geschetst binnen de specifieke LIS-serviceactiviteit en de interfaces voor omzettingsprogramma's waarvan elk gebruikmaakt.
LIS v2.0 Service-eindpunten
Er zijn aparte eindpunten voor HTTP en HTTPS. U moet het juiste service-eindpunt voor uw implementatie gebruiken, afhankelijk van hoe de site wordt gezien door IIS. Als uw SSL-ondersteuning wordt geleverd door een load balancer, moet u mogelijk de HTTP-eindpunten gebruiken.
HTTP
|
Servicenaam
|
Service-eindpunt
|
|
BDEMS (service voor uitwisselingsbeheer van bulkgegevens)
|
/d2l/im/ipsis/lis/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
COMS (service voor cursuseditiebeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseOfferingManagementServices.svc
|
|
CSMS (service voor cursussectiebeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseSectionManagementServices.svc
|
|
CTMS (service voor cursussjabloonbeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseTemplateManagementServices.svc
|
|
GMS (service voor groepsbeheer)
|
/d2l/im/ipsis/lis/gmsv2p0/GroupManagementServices.svc
|
|
MMS (service voor lidmaatschapbeheer)
|
/d2l/im/ipsis/lis/mmsv2p0/MembershipManagementServices.svc
|
|
OMS (service voor resultaatbeheer)
|
d2l/im/ipsis/lis/omsv1p0/ResultManagementServices.svc
|
|
PMS (service voor persoonsbeheer)
|
/d2l/im/ipsis/lis/pmsv2p0/PersonManagementServices.svc
|
|
SAMS (service voor sectiekoppelingbeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/SectionAssociationManagementServices.svc
|
HTTPS
|
Servicenaam
|
Service-eindpunt
|
|
BDEMS (service voor uitwisselingsbeheer van bulkgegevens)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
COMS (service voor cursuseditiebeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseOfferingManagementServices.svc
|
|
CSMS (service voor cursussectiebeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseSectionManagementServices.svc
|
|
CTMS (service voor cursussjabloonbeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseTemplateManagementServices.svc
|
|
GMS (service voor groepsbeheer)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/GroupManagementServices.svc
|
|
MMS (service voor lidmaatschapbeheer)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/MembershipManagementServices.svc
|
|
OMS (service voor resultaatbeheer)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/ResultManagementServices.svc
|
|
PMS (service voor persoonsbeheer)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/PersonManagementServices.svc
|
|
SAMS (service voor sectiekoppelingbeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/SectionAssociationManagementServices.svc
|
LIS v2.0 Service-WSDL's
Als de WSDL vereist is, moet u niet de WSDL's op de service-eindpunten gebruiken, maar de WSDL's op de volgende locaties:
HTTP
|
LIS-service
|
WSDL
|
|
BDEMS (service voor uitwisselingsbeheer van bulkgegevens)
|
/d2l/im/ipsis/lis/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
COMS (service voor cursuseditiebeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
CSMS (service voor cursussectiebeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
CTMS (service voor cursussjabloonbeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
GMS (service voor groepsbeheer)
|
/d2l/im/ipsis/lis/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
MMS (service voor lidmaatschapbeheer)
|
/d2l/im/ipsis/lis/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
OMS (service voor resultaatbeheer)
|
/d2l/im/ipsis/lis/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
PMS (service voor persoonsbeheer)
|
/d2l/im/ipsis/lis/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
SAMS (service voor sectiekoppelingbeheer)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
HTTPS
|
LIS-service
|
WSDL
|
|
BDEMS (service voor uitwisselingsbeheer van bulkgegevens)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
COMS (service voor cursuseditiebeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
CSMS (service voor cursussectiebeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
CTMS (service voor cursussjabloonbeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
GMS (service voor groepsbeheer)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
MMS (service voor lidmaatschapbeheer)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
OMS (service voor resultaatbeheer)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
PMS (service voor persoonsbeheer)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
SAMS (service voor sectiekoppelingbeheer)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
Verificatie
IPSIS LIS v2.0-services vereisen verificatie via WS-Security of HTTP-basisverificatie en gebruiken de D2L®-database om de gebruikersnaam en het wachtwoord te verifiëren. Om een van de services te kunnen gebruiken, moet de gebruikers-id die wordt gebruikt om te verifiëren, aan een bronsysteem worden gekoppeld.
De serviceverificatie bestaat uit het valideren van de gebruikersnaam en het wachtwoord op basis van het Leerplatform. Als er een geldige gebruikersnaam en een geldig wachtwoord van het Leerplatform worden verstrekt en er een actief IPSIS-bronsysteem aan die gebruiker is gekoppeld, worden alle LIS-serviceaanvragen bevestigd en verwerkt.
Als een ongeldige gebruikersnaam en wachtwoord worden opgegeven of als de gebruiker niet is gekoppeld aan een actief IPSIS-bronsysteem, wordt de aanvraag geweigerd met een passend responsbericht volgens de LIS-specificatie. Voor het oplossen van problemen kan foutopsporingsregistratie worden ingeschakeld om te helpen bepalen waarom de verificatie niet met succes wordt uitgevoerd.
De IMS LIS-werkgroep heeft het gebruik van WS-Security of HTTP-basisverificatie voor het verifiëren van de verzender van LIS-serviceaanvragen geregeld.
Kopteksten aanvragen
Alle LIS-aanvraagkopteksten bevatten dezelfde velden, en D2L® verwerkt deze als volgt:
|
Koptekst
|
Doel
|
Opmerking
|
|
imsx_syncRequestHeaderInfo.imsx_messageIdentifier
|
Deze koptekst is vereist.
De aanvraagbericht-id wordt geretourneerd in de respons (imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier) om koppeling van de respons met een oorspronkelijke aanvraag mogelijk te maken.
|
Niet alle leveranciers sturen een geldige waarde, dus D2L® handelt deze in beide richtingen af. Als ze het wel verzenden, retourneert D2L® het in de respons.
|
|
imsx_syncRequestHeaderInfo.imsx_version
|
Deze koptekst is vereist.
De versie is bedoeld om de service in staat te stellen ervoor te zorgen dat de twee systemen dezelfde versie van de service verwachten.
|
Op dit moment doen we niets met de nieuwe versie.
|
|
imsx_syncRequestHeaderInfo.imsx_sendingAgentIdentifier
|
Deze koptekst is optioneel (toegevoegd aan 2012-01-31 WSDL).
De verzendende agent-id wordt gebruikt om de verzendende partij te identificeren. Voor uitgaande aanvragen van D2L® wordt de waarde ingevuld met de waarde Naam bronsysteem uit IM_Sources.
|
Niet alle leveranciers sturen dit en D2L® gebruikt het helemaal niet voor inkomende aanvragen. D2L® gebruikt de userid die is gebruikt om de verzendende partij te verifiëren.
|
Responskopteksten
Alle LIS-responskopteksten bevatten dezelfde velden. D2L® verwerkt ze als volgt:
|
Koptekst
|
Respons
|
Waarde
|
|
imsx_syncResponseHeaderInfo.imsx_version
|
D2L® retourneert "V1.0" ongeacht de waarde in de aanvraagkoptekst.
|
|
|
imsx_syncResponseHeaderInfo.imsx_messageIdentifier
|
D2L® genereert en retourneert een unieke identificatie voor deze koptekst.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor
|
D2L® retourneert de hoofdstatuscode zoals gedefinieerd door IMS.
|
Fout - als er een probleem is met de verwerking van de aanvraag.
Verwerken - wanneer de aanvraag wordt verwerkt.
Succes - wanneer de verwerking van de aanvraag is geslaagd.
Niet ondersteund - als er geen implementatie is voor de LIS-aanvraag, of er geen omzettingsprogramma's zijn geregistreerd voor de bewerking.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity
|
D2L® retourneert de ernst zoals gedefinieerd door IMS.
|
Fout - wanneer er iets onverwachts of slechts is opgetreden. Het aanroepsysteem moet mogelijk de juiste actie ondernemen.
Status - Informatie. Actie die gewoonlijk niet vereist is door het aanroepsysteem.
Waarschuwing - wanneer er iets onverwachts is opgetreden. Het aanroepsysteem moet mogelijk de juiste actie ondernemen.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier
|
D2L® retourneert de waarde uit de imsx_syncRequestHeaderInfo.imsx_messageIdentifier.
Als er geen bericht-id is verzonden in de aanvraag, wordt dit veld niet opgenomen.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_description
|
D2L® retourneert een bericht met een door mensen leesbare beschrijving van alle statusberichten.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldName
|
D2L® retourneert de naam van het veld Minor Status Code zoals gedefinieerd door IMS.
|
TargetEndSystem
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue
|
D2L® retourneert de waarde van het veld Minor Status Code zoals gedefinieerd door IMS.
|
deletefailure - wanneer er een probleem is bij het verwerken van een verwijderaanvraag.
fullsuccess - als alles succesvol wordt verwerkt.
invaliddata - wanneer de aanvraag vereiste velden mist, kan de verwerking niet worden voortgezet.
partialdatastorage - wanneer D2L® een deel van de aanvraag in de database opslaat.
unknownobject - wanneer de aanvraag verwijst naar een object dat niet in IPSIS is gevonden, en D2L® daarom de gevraagde actie niet kan uitvoeren.
unsupportedLISoperation - als er momenteel geen implementatie is voor de LIS-aanvraag, of er geen omzettingsprogramma's zijn geregistreerd voor de bewerking.
idallocinusefail - wanneer de aanvraag probeert een bestaande entiteit van een ander type opnieuw te gebruiken of te wijzigen (bijvoorbeeld als een replaceGroupRequest probeert een college te veranderen in een semester).
|