WWM:Wikiwijs arrangement zoeken: verschil tussen versies
k |
|||
(15 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, die je vervolgens in je eigen systeem wilt importeren, dan kan je dat doen door een query te stellen tegen de Edurep API. Arrangementen zijn beschikbaar in het open formaat IMS Content Package. 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): |
||
+ | ==Achtergrond: metadata stroom== |
||
− | <syntaxhighlight lang="php" 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 |
||
− | </syntaxhighlight> |
||
+ | [[File:WWM_metadata_stroom.png|thumb|400px|right|Metadata uit Wikiwijs Maken]] |
||
− | Deze query zoekt specifiek op materiaal in Edurep dat ook beschikbaar is als IMS Content packages. Op dit moment betreft dit alleen maar Wikiwijs Arrangementen. Natuurlijk kan de query worden uitgebreid met het zoeken op een bepaalde uitgever (bv. VO-Content), leerniveau en vak. Hiervoor verwijzen we weer naar de [[Edurep:Hoofdpagina|Edurep Developers Wiki]] voor meer details hierover. |
||
+ | 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. |
||
− | Het resultaat van deze query is een verzameling van zogenaamde [[Standaarden:NL_LOM|LOM records]]. |
||
+ | 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== |
||
− | == Ophalen IMS Content package == |
||
+ | 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}} |
||
− | De URL van de IMS Content Package halen van een Wikiwijs Arrangement kan je uit een LOM record uit Edurep halen. Een voorbeeld van de verwijzing naar een IMS Content Package in een LOM record is te zien in deze snippet uit een LOM record: |
||
+ | 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]]. |
||
− | <syntaxhighlight lang="xml" enclose="div"> |
||
− | <czp:relation> |
||
− | <czp:kind> |
||
− | <czp:source> |
||
− | <czp:langstring xml:lang="x-none"> |
||
− | http://purl.edustandaard.nl/relation_kind_nllom_20131211 |
||
− | </czp:langstring> |
||
− | </czp:source> |
||
− | <czp:value> |
||
− | <czp:langstring xml:lang="x-none"> |
||
− | hasformat |
||
− | </czp:langstring> |
||
− | </czp:value> |
||
− | </czp:kind> |
||
− | <czp:resource> |
||
− | <czp:description> |
||
− | <czp:langstring xml:lang="x-none"> |
||
− | application/x-imscp+zip |
||
− | </czp:langstring> |
||
− | </czp:description> |
||
− | <czp:catalogentry> |
||
− | <czp:catalog> |
||
− | URI |
||
− | </czp:catalog> |
||
− | <czp:entry> |
||
− | <czp:langstring xml:lang="x-none"> |
||
− | http://arrangeren.wikiwijs.nl/45035/Geloven___Hindoe_sme___kastenstelsel?p=imscp |
||
− | </czp:langstring> |
||
− | </czp:entry> |
||
− | </czp:catalogentry> |
||
− | </czp:resource> |
||
− | </czp:relation> |
||
− | </syntaxhighlight> |
||
+ | 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]]. |
||
− | In dit voorbeeld is de locatie van het IMS Content Package: |
||
+ | |||
− | <syntaxhighlight lang="xml" enclose="div"> |
||
+ | Om specifiek te zoeken in Edurep naar IMS Content Packages kan je de volgende Edurep zoekopdracht gebruiken: |
||
− | http://arrangeren.wikiwijs.nl/45035/Geloven___Hindoe_sme___kastenstelsel?p=imscp |
||
+ | |||
− | </syntaxhighlight> |
||
+ | {{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 08:51
Achtergrond: metadata stroom
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.