ECK-iD and Dutch educational content chain

Background

From August, 1 2019 the ECK-ID is used as unique identifier for students and teachers in the ‘educational content chain’ (ECK). The implementation of the ECK-ID in The Netherlands is organized by Edu-K. This is a private-public body in which LMS providers, distributors, educational publishers, SIS providers, IAM providers, Kennisnet, schools, etc. are represented.

Every student and teacher in primary, secondary and further education in The Netherlands will have an ECK-ID in the near future. The ECK-ID is provided by the government. In school year 2019/2020 and 2020/2021 a hybrid situation will occur. Both the ECK-ID and the currently used ID (NEPRI) will be used in the ECK. After that those school years the ECK-ID will be used as the unique identifier.

Implementation

  • Only the following methods can be used to import ECK-iD: createPerson, createPersons, updatePerson, updatePersons.

  • The ECK-iD will not be shown in the logs, a placeholder is used.

  • ECK-iD is imported as an extension field EckId, see below.

Here an example how to add ECK-iD in a createPerson request; for the other requests the implementation is similar. The ECK-id shown in example below is a fictional one.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/common/imsMessBindSchema_v1p0" xmlns:ims1="http://www.imsglobal.org/services/pms/xsd/imsPersonManMessSchema_v1p0" xmlns:ims2="http://www.imsglobal.org/services/common/imsCommonSchema_v1p0" xmlns:ims3="http://www.imsglobal.org/services/pms/xsd/imsPersonManDataSchema_v1p0">
<soapenv:Header>
<ims:syncRequestHeaderInfo>
<ims:messageIdentifier>${#TestCase#guid}-${=request.name}</ims:messageIdentifier>
</ims:syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims1:createPersonRequest>
...
<ims1:person>
<ims3:formatName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
...
<ims3:extension>
...
<ims2:extensionField>
<ims2:fieldName>eckid</ims2:fieldName>
<ims2:fieldType>String</ims2:fieldType>
<ims2:fieldValue>https://ketenid.nl/pilot/8e0a9f57fc76854d3dd2d3c4fa732feaf7b7a2d5f549a5458ce</ims2:fieldValue>
</ims2:extensionField>
...
</ims3:extension>
</ims1:person>
</ims1:createPersonRequest>
</soapenv:Body>
</soapenv:Envelope>

In the IMS-ES logs, in “Admin- Manage IMS Enterprise web services” one can see the ECK-id has been added successfully in the tag <ims2:fieldValue> so one cannot see the value itself.

<ims3:extension>
<ims2:extensionField>
<ims2:fieldName>eckid</ims2:fieldName>
<ims2:fieldType>String</ims2:fieldType>
<ims2:fieldValue>ECK-id value is hidden</ims2:fieldValue>
</ims2:extensionField>
<ims3:extension>

Please get in touch with itslearning support in the Netherlands in case of any questions.