Edurep:Identifiers

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken

Edurep-symbol.png Edurep: Identifiers

Identifiers kunnen worden gebruikt om entiteiten uniek te identificeren. In de Edurep context zijn dit de volgende entiteiten in de volgende velden. Er zal in dit artikel stilgestaan worden bij het gebruik van object identifiers:

  • leerobjecten: /lom/general/catalogentry
  • sociale metadata: /smo/smoId

en metadata identifiers:

  • leerobject metadata: /lom/metametadata/catalogentry
  • leerobject metadata: /searchRetrieveResponse/records/record/recordIdentifier

Naast identificatie worden de identifiers ook gebruikt voor de persistente koppeling van verschillende informatie entiteiten.

Object Identifier

Bullet book.png Specificatie Nl.gif (leidend)

Het /lom/general/catalogentry veld is niet bedoeld om de locatie van het leerobject weer te geven maar om het leerobject uniek te kunnen identificeren. In tegenstelling tot de technical location, wordt de catalogentry niet gewijzigd als de fysieke locatie van het leerobject verandert. Deze moet dan ook worden gebruikt als basis voor de koppeling met sociale metadata.

Liever dus, wordt in de catalogentry niet de fysieke locatie van het object gehanteerd maar een andere unieke waarde, en deze als URI genoteerd. Een metadata koppeling kan alleen gemaakt worden met een URI. Als definitie van een URI wordt RFC 2396 gehanteerd. Aangezien catalogentry meerdere keren mag voorkomen, mag een URI definitie naast andere definities voorkomen.

Er kan bijvoorbeeld gekozen worden voor een formele URN naamgeving wanneer deze beschikbaar is.

<!-- De urn notatie van een ISBN heeft de voorkeur vanwege de koppelmogelijkheden. -->
<catalogentry> 
  <catalog>URI</catalog>
  <entry> 
    <langstring xml:lang="x-none">urn:isbn:0-395-36341-1<langstring>
  <entry>
</catalogentry> 
<catalogentry> 
  <catalog>ISBN</catalog>
  <entry> 
    <langstring xml:lang="x-none">0-395-36341-1<langstring>
  <entry>
</catalogentry>

Wanneer er geen formeel URN schema is, kan ook een eigen schema worden gebruikt in de URI. Het eigengemaakte schema mag dan niet 1 van de bekende URI schema's zijn.

<catalogentry> 
  <catalog>URI</catalog>
  <entry> 
    <langstring xml:lang="x-none">lesidee:138<langstring>
  <entry>
</catalogentry> 
<catalogentry> 
  <catalog>LESIDEE.NL</catalog>
  <entry> 
    <langstring xml:lang="x-none">138<langstring>
  <entry>
</catalogentry>

Metadata Identifier

Een metadata record kan ook uniek geïdentificeerd worden met een identifier. Zo'n identifier kan (optioneel) worden aangeleverd door aanbieder in het meta catalogentry veld. Edurep heeft van elk record echter altijd een identifier die binnen Edurep uniek is.

Deze identifier bestaat uit de aanbieder oai identifier geprefixt met de collectie identfier. Deze identifier is te vinden in de sru/srw respons van Edurep, bijvoorbeeld:

<srw:recordIdentifier>Teleblik:oai:vp-core.snkn.nl:19026</srw:recordIdentifier>

Aangezien dit een metadata identifier is, kan deze niet gebruikt worden om de uniciteit van een object te bepalen. Om te bepalen of een gevonden record uit Metaplus komt, dient men te kijken of de collectieprefix gelijk is aan "metaplus". Bijvoorbeeld de Metaplus versie van het bovenstaande record:

<srw:recordIdentifier>metaplus:Teleblik:oai:vp-core.snkn.nl:19026</srw:recordIdentifier>

Koppeling

De relatie tussen leerobjecten en sociale (en prijs) metadata wordt vastgelegd middels een identifier. De koppeling wordt in Edurep gerealiseerd door een match te maken tussen de leerobject-identifier en de gerelateerde identifier in een SMO of CPI. Zo'n koppeling kan alleen gemaakt worden met URI's.

Gegeven een leerobject met het volgende catalogentry als leerobjectidentifier:

<general> 
  ...
  <catalogentry> 
    <catalog>URI</catalog>
    <entry> 
      <langstring xml:lang="x-none">urn:uuid:554fa894-bb2e-4531-aa62-c1341edd32d3<langstring>
    <entry>
  </catalogentry> 
  ...
</general>

Een SMO wordt gekoppeld aan dit leerobject indien in de /smo/hReview/info dezelfde URI is ingevuld:

<hReview> 
  ...
  <info>urn:uuid:554fa894-bb2e-4531-aa62-c1341edd32d3</info>
  ...
</hReview>

Een CPI wordt gekoppeld aan dit leerobject indien in de /contentPrijsInfo/contentIdentifier dezelfde URI is ingevuld:

<contentPrijsInfo> 
  ...
  <contentIdentifier>urn:uuid:554fa894-bb2e-4531-aa62-c1341edd32d3</contentIdentifier>
  ...
</contentPrijsInfo>