Standaarden:ECK-DT: verschil tussen versies

Versie van 30 nov 2017 09:43

Digitale leermiddelen nemen ieder jaar een belangrijkere plaats in op de leermiddelenlijst van onderwijsinstellingen. Voor een foutloze distributie en toegang van digitale leermiddelen zijn uitgevers, distributeurs en leveranciers van elektronische leeromgevingen en leerlingadministratiesystemen afhankelijk van elkaar. De afspraak ECK Distributie en toegang maakt allerlei vormen van dienstverlening binnen de educatieve contentketen (ECK) mogelijk. De afspraak omvat een referentiearchitectuur met daarin relevante begrippen, de gehanteerde principes en een beschrijving van de processen, een beschrijving van de webservices en technische voorschriften.

Documentatie

Afspraak bij Edustandaard

(leidend)

Onderdelen

CatalogService
overige nog niet gedocumenteerd

SOAP

De SOAP header vereist een aantal WS-Addressing velden in het verzond en ontvangstbericht.

Request

Een overzicht van de WS-A argumenten:

naam	#	type	omschrijving
Action	1	uri	de webservice specificatie identifier
To	1	url	de endpoint waar het bericht naar toe verzonden wordt
MessageID	1	uri	unieke berichtcode
From	1	wsa:Adress met uri	afzender in uri waarbij organisationid als verplichte querystring parameter wordt opgenomen, wachtwoord idem, maar optioneel in de praktijk zullen zender en ontvanger hier een afspraak over maken.

Voorbeeld:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
        <wsa:Action soapenv:mustUnderstand="1">http://dt2.eck.nl/service/orderservice/v2.1/getstockstatus</wsa:Action>
        <wsa:From soapenv:mustUnderstand="1">
            <wsa:Address>https://distributeur.nl?organisationid=27244834&password=X</wsa:Address>
        </wsa:From>
        <wsa:MessageID soapenv:mustUnderstand="1">urn:uuid:1f64216c-ec95-489d-a1c1-0d1ea3656be0</wsa:MessageID>
        <wsa:To soapenv:mustUnderstand="1">https://uitgever.nl/OrderService</wsa:To>
    </soapenv:Header>
    <soapenv:Body>
    ...
    </soapenv:Body>
</soapenv:Envelope>

Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
        <wsa:Action>http://dt2.eck.nl/service/orderservice/v2.1/getstockstatus</wsa:Action>
        <!-- De Technische Voorschriften zijn niet volledig duidelijk hierover,
             maar de aanname hier is dat het berichtenverkeer synchroon is. -->
        <!-- <wsa:RelatesTo RelationshipType="http://www.w3.org/2005/08/addressing/reply">urn:uuid:7f9f9e8c-be3b-4b45-91b6-ce7c437c6967</wsa:RelatesTo> -->
        <wsa:To>https://distributeur.nl?organisationid=27244834</wsa:To>
        <wsa:MessageID>urn:uuid:0d7acc60-6044-4283-a2be-eb4a50ba4c97</wsa:MessageID>
    </soapenv:Header>
    <soapenv:Body>
    ...
    </soapenv:Body>
</soapenv:Envelope>

@@ Regel 13: / Regel 13: @@
 === Request ===
+Een overzicht van de WS-A argumenten:
+{| class="wikitable"
+! naam
+! #
+! type
+! omschrijving
+|-
+|Action
+|1
+|uri
+|de webservice specificatie identifier
+|-
+|To
+|1
+|url
+|de endpoint waar het bericht naar toe verzonden wordt
+|-
+|MessageID
+|1
+|uri
+|unieke berichtcode
+|-
+|From
+|1
+|wsa:Adress met uri
+|afzender in uri waarbij organisationid als verplichte querystring parameter wordt opgenomen, wachtwoord idem, maar optioneel<br/>
+in de praktijk zullen zender en ontvanger hier een afspraak over maken.
+|-
+|}
+'''Voorbeeld:'''
 <syntaxhighlight lang="xml">
 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">