Skip to main content

LIS 2.0-gegevensformaat

Learning Information Services is een op SOAP gebaseerd webserviceprotocol dat gebruikmaakt van XML-geformatteerde gegevens. LIS maakt gebruik van twee bestandsindelingen: één voor gebeurtenisgestuurde of incrementele updates en één voor bulkupdates (of multi-record, multi-object). In dit document worden de LIS-elementrelaties met Learn-objectkenmerken beschreven en worden geannoteerde LIS-voorbeelden gegeven.

LIS SOAP bericht boilerplate

Een LIS SOAP-bericht is een XML-document dat de volgende elementen bevat:

  • Een SOAP-ENV:Envelope-element dat het XML-document identificeert als een SOAP-bericht

  • Een soap-env:Header element dat de header informatie bevat

  • Een SOAP-ENV:Lichaamselement dat de vraag- en antwoordinformatie bevat

LIS SOAP-berichten hebben dezelfde envelop-, koptekst- en foutopmaak, waarbij alleen de hoofdtekst onderscheid maakt tussen de verschillende services. De standaardtekst voor een LIS SOAP-bericht kan dus als volgt worden opgebouwd:

<?xml version="1.0"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

  <SOAP-ENV:Header>

    <imsx_syncRequestHeaderInfo xmlns="http://www.imsglobal.org/services/li...nc/imscms_v1p0">

      <imsx_version>V2.0</imsx_version>

      <imsx_messageIdentifier />

    </imsx_syncRequestHeaderInfo>

  </SOAP-ENV:Header>

  <SOAP-ENV:Body>

...

  </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

De SOAP-ENV:Body elementen voor elk ondersteund object worden hieronder beschreven, samen met de relaties tussen Blackboard en LIS-bronveld.