WWM:Wikiwijs arrangement zoeken: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
k
 
(27 tussenliggende versies door 2 gebruikers niet weergegeven)
Regel 1: Regel 1:
  +
[[Category:Wikiwijs Maken]]
Als je vanuit je systeem automatisch wil zoeken op Wikiwijs arrangementen dan kan je dat doen door een query te stellen tegen de Edurep API.
 
   
  +
==Achtergrond: metadata stroom==
Om specifiek te zoeken in Edurep naar IMS Content Packages kan je de volgende Edurep zoekopdracht gebruiken. Deze query geeft de eerste 10 records die hieraan voldoen (in de [[Edurep:Hoofdpagina|Edurep Developers Wiki]] wordt uitgelegd hoe je meer resultaten krijgt):
 
   
  +
[[File:WWM_metadata_stroom.png|thumb|400px|right|Metadata uit Wikiwijs Maken]]
<syntaxhighlight lang="http" enclose="div">
 
  +
http://wszoeken.edurep.kennisnet.nl:8000/edurep/sruns?operation=searchRetrieve&version=1.2&recordPacking=xml&query=edurep+and+lom.relation.resource.description=%22application/x-imscp+zip%22
 
  +
Arrangementen uit Wikiwijs Maken zijn vindbaar omdat de metadata ervan wordt gedeeld via het Edurep platform. In het diagram hiernaast staat de stroom van metadata geschetst.
</syntaxhighlight>
 
  +
  +
In Wikiwijs Maken vullen auteurs van arrangementen metadata in om het materiaal vindbaar te maken. Daarnaast kunnen ze ook detail metadata invoeren, dit detailniveau betreft dan aparte metadata voor iedere sectie en toets in een arrangement. Deze metadata komt dan vervolgens alleen terug in de IMS Content Package versie van een arrangement, een apart uitvoerformaat van arrangementen.
  +
  +
==Zoeken vanuit Edurep==
 
Als je vanuit je systeem automatisch wil zoeken naar Wikiwijs arrangementen dan kan je dat doen door een query te stellen tegen de Edurep API.
  +
  +
{{EdurepQuery|query=about.repository=wikiwijsmaken}}
  +
  +
Het resultaat van deze query is een verzameling van zogenaamde [[Standaarden:NL_LOM|LOM records]]. Deze query hierboven geeft de eerste 10 LOM records uit Wikiwijs Maken. In de [[Edurep:LOM_SearchRetrieve|Edurep interface specificatie]] wordt uitgelegd hoe je meer resultaten terugkrijgt. Natuurlijk kan de query worden uitgebreid met het zoeken op een bepaalde uitgever (bv. VO-Content), leerniveau en/of vak. Hiervoor verwijzen we weer naar de [[Edurep:Hoofdpagina|Edurep Developers Wiki]] voor meer details, in het bijzonder naar de [[Edurep:Leermateriaal_Metadata_Opvragen|sectie over het opvragen van metadata uit Edurep]].
  +
  +
Is je doel de informatie uit de arrangementen (inhoud en detail metadata) in je eigen systeem te importeren? Dan is het handig te weten dat Wikiwijs Maken zijn arrangementen aanbiedt in het open formaat IMS Content Package. De link naar de IMS Content Package versie van een arrangement staat vermeld in het [[Standaarden:NL_LOM/lom.relation#Uitvoerformaten|relation veld]] in elk record. Voor meer informatie over hoe dit open formaat er uit ziet en wat je ermee kan verwijzen we naar de sectie op deze wiki over het [[WWM:Wikiwijs_arrangement_importeren|importeren van Wikiwijs arrangement]].
  +
 
Om specifiek te zoeken in Edurep naar IMS Content Packages kan je de volgende Edurep zoekopdracht gebruiken:
  +
  +
{{EdurepQuery|query=lom.relation.resource.description="application/x-imscp+zip"}}
  +
  +
Op dit moment betreft dit alleen maar Wikiwijs Arrangementen. Toch raden we aan te zoeken op de repository "wikiwijsmaken" om zeker te weten dat het om Wikiwijs arrangementen betreft en dat de opbouw en data in de pakketten conform de informatie in deze wiki is.
  +
  +
[[Categorie:Wikiwijs Maken]]
  +
[[Categorie:Handleiding]]

Huidige versie van 3 sep 2015 om 09:51


Achtergrond: metadata stroom

Metadata uit Wikiwijs Maken

Arrangementen uit Wikiwijs Maken zijn vindbaar omdat de metadata ervan wordt gedeeld via het Edurep platform. In het diagram hiernaast staat de stroom van metadata geschetst.

In Wikiwijs Maken vullen auteurs van arrangementen metadata in om het materiaal vindbaar te maken. Daarnaast kunnen ze ook detail metadata invoeren, dit detailniveau betreft dan aparte metadata voor iedere sectie en toets in een arrangement. Deze metadata komt dan vervolgens alleen terug in de IMS Content Package versie van een arrangement, een apart uitvoerformaat van arrangementen.

Zoeken vanuit Edurep

Als je vanuit je systeem automatisch wil zoeken naar Wikiwijs arrangementen dan kan je dat doen door een query te stellen tegen de Edurep API.

/edurep/sruns: query=about.repository=wikiwijsmaken

Het resultaat van deze query is een verzameling van zogenaamde LOM records. Deze query hierboven geeft de eerste 10 LOM records uit Wikiwijs Maken. In de Edurep interface specificatie wordt uitgelegd hoe je meer resultaten terugkrijgt. Natuurlijk kan de query worden uitgebreid met het zoeken op een bepaalde uitgever (bv. VO-Content), leerniveau en/of vak. Hiervoor verwijzen we weer naar de Edurep Developers Wiki voor meer details, in het bijzonder naar de sectie over het opvragen van metadata uit Edurep.

Is je doel de informatie uit de arrangementen (inhoud en detail metadata) in je eigen systeem te importeren? Dan is het handig te weten dat Wikiwijs Maken zijn arrangementen aanbiedt in het open formaat IMS Content Package. De link naar de IMS Content Package versie van een arrangement staat vermeld in het relation veld in elk record. Voor meer informatie over hoe dit open formaat er uit ziet en wat je ermee kan verwijzen we naar de sectie op deze wiki over het importeren van Wikiwijs arrangement.

Om specifiek te zoeken in Edurep naar IMS Content Packages kan je de volgende Edurep zoekopdracht gebruiken:

/edurep/sruns: query=lom.relation.resource.description="application/x-imscp+zip"

Op dit moment betreft dit alleen maar Wikiwijs Arrangementen. Toch raden we aan te zoeken op de repository "wikiwijsmaken" om zeker te weten dat het om Wikiwijs arrangementen betreft en dat de opbouw en data in de pakketten conform de informatie in deze wiki is.