Edurep:Zoekopdracht: verschil tussen versies
k |
(add drilldown) |
||
Regel 9: | Regel 9: | ||
=== Jsonsearch === |
=== Jsonsearch === |
||
{{:Edurep:Zoekopdracht/Paginering/Jsonsearch}} |
{{:Edurep:Zoekopdracht/Paginering/Jsonsearch}} |
||
− | |||
== Drilldown == |
== Drilldown == |
||
+ | {{:Edurep:Zoekopdracht/Drilldown}} |
||
− | |||
+ | === SRU === |
||
+ | {{:Edurep:Zoekopdracht/Drilldown/SRU}} |
||
+ | === Jsonsearch === |
||
+ | {{:Edurep:Zoekopdracht/Drilldown/Jsonsearch}} |
||
== recordSchema == |
== recordSchema == |
||
{{:Edurep:Zoekopdracht/recordSchema}} |
{{:Edurep:Zoekopdracht/recordSchema}} |
Versie van 19 okt 2021 07:12
Deze pagina is nog in ontwikkeling, en waarschijnlijk niet volledig. |
Query
Paginering
Edurep resultaten worden gepagineerd aangeboden. Standaard worden de eerste 10 teruggegeven, en het is met parameters mogelijk om de verschillende pagina's van de totale resultatenset op te halen (tot een maximum van 4000). Bij een startRecord hoger, wordt een foutmelding meegegeven, maar wordt de laatste pagina getoond (alsof de startRecord gelijk is aan 4000).
SRU
Paginering in SRU werkt met de volgende argumenten:
- startRecord
- maximumRecords
Met maximumRecords kan het aantal resultaten per pagina worden ingesteld, en met startRecord wordt aangegeven wat het eerste record van de resultatenset is.
/edurep/sruns: query=feest&maximumRecords=20&startRecord=21 |
Catalogus Service: query=rekenen&maximumRecords=20&startRecord=21 |
Jsonsearch
Paginering in jsonsearch werkt via de volgende argumenten:
- page
- page-size
Met page-size kan het aantal resultaten per pagina worden ingesteld, en met page wordt aangegeven welke pagina van de totale resultatenset wordt teruggegeven.
/jsonsearch: query=*&page-size=20&page=2 |
Drilldown
Met een optionele term drilldown worden alle waarden van een bepaald veld cumulatief geteld over alle zoekresultaten. Dit kan slechts op een beperkt aantal velden. Er kunnen meerdere term drilldowns gedaan worden per search request door de velden te scheiden met een komma.
Het gewenste aantal resultaten in de drilldown kan worden aangegeven door ":<nummer>" aan de drilldown term toe te voegen. Als je ":0" toevoegt worden alle drilldown resultaten getoond.
De volgorde van de termen met een gelijk aantal kan verschillen per zoekopdracht. De sortering komt namelijk voort uit hoe het drilldown algoritme werkt. Voor elementen met dezelfde waarde is geen volgorde gedefinieerd omdat dit efficiënter is en weinig toegevoegde waarde heeft.
SRU
Een drilldown kan in SRU met het x-term-drilldown argument worden meegegeven.
/edurep/sruns: query=oostenrijk&x-term-drilldown=lom.general.language:5,lom.technical.format |
/smo/sruns: query=leuk&x-term-drilldown=smo.supplierId |
Catalogus Service: query=aardrijkskunde&x-term-drilldown=Supplier |
Response
<dd:drilldown xmlns:dd="http://meresco.org/namespace/drilldown"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://namespace.meresco.org/drilldown http://namespace.drilldown.org/xsd/drilldown.xsd">
<dd:term-drilldown>
<dd:navigator name="lom.educational.context.value">
<dd:item count="921">VO</dd:item>
<dd:item count="319">BVE</dd:item>
<dd:item count="221">PO</dd:item>
<dd:item count="33">primaire onderwijs</dd:item>
<dd:item count="26">beroepsonderwijs en volwasseneneducatie</dd:item>
<dd:item count="26">speciaal onderwijs</dd:item>
<dd:item count="24">voortgezet onderwijs</dd:item>
<dd:item count="16">speciaal basisonderwijs</dd:item>
<dd:item count="13">wetenschappelijk onderwijs</dd:item>
<dd:item count="12">VVE</dd:item>
</dd:navigator>
<dd:navigator name="lom.rights.cost">
<dd:item count="1160">no</dd:item>
<dd:item count="38">yes</dd:item>
</dd:navigator>
<dd:navigator name="lom.technical.format"/>
</dd:term-drilldown>
</dd:drilldown>
naam | # | type | omschrijving |
---|---|---|---|
term-drilldown | 1 | container | De term-drilldown container. |
navigator | 1+ | container | De navigator container. Bevat alle facets voor het betreffende veld. |
item | 0+ | tekst | De naam van de facet. Het aantal staat in het count attribuut. |
Jsonsearch
Een drilldown kan in Jsonsearch met het facet argument worden meegegeven.
/jsonsearch: query=*&facet=schema:license |
recordSchema
Nederlands | English |
In Edurep bestaan verschillende representaties en perspectieven van een record. Deze worden opgevraagd middels een recordSchema argument.
- Sommige recordSchema's representeren verschillende formaten van een stuk leermiddel-metadata,
- andere beschrijven andere sets data die zijn gekoppeld aan een leermiddel-metadata record.
- Afhankelijk van het gebruikte protocol zijn er verschillende opties beschikbaar.
SRU
In SRU kunnen 2 argumenten worden gebruikt om een recordSchema op te halen:
- recordSchema: het primaire schema
- x-recordSchema: meerdere andere recordSchema's kunnen worden opgehaald
/edurep/sruns: query=struisvogel&recordSchema=oai_dc&x-recordSchema=meta |
recordSchema | omschrijving |
---|---|
lom (default) | Record in de LOM IMS binding. |
LOMv1.0 | Record in de LOM IEEE binding. |
oai_dc | Record in Dublin Core formaat. |
smo | Eventueel gekoppelde SMO's bij een record, maximaal 10, op volgorde van datum, de laatst toegevoegde bovenaan. |
smbAggregatedData | De geaggregeerde sociale metadata bij een record. |
original | Het origineel ingeschoten record. |
about | Meta informatie over het record |
jsonld | Record in Jsonld formaat |
jsonld-plus | Record in Jsonld formaat plus gekoppelde reviews (max 10) |
Jsonsearch
Met de jsonsearch kan het recordSchema argument worden gebruikt om een ander recordSchema op te halen.
recordSchema | omschrijving |
---|---|
jsonld (default) | Record in Jsonld formaat |
jsonld-plus | Record in Jsonld formaat plus gekoppelde reviews (max 10) |