Edurep:Zoekopdracht: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
(add sortering)
Regel 27: Regel 27:
   
 
== See Also ==
 
== See Also ==
{{:Edurep:SeeAlso|related=[[Edurep:Veldenlijst]]}}
+
{{:Edurep:SeeAlso|use=[[Edurep:Jsonsearch]] - [[Edurep:LOM_SearchRetrieve]]|related=[[Edurep:Veldenlijst]]}}
 
[[Category:Edurep]]
 
[[Category:Edurep]]

Versie van 20 okt 2021 09:20

Query

In Edurep kan er worden gezocht op AND/OR/NOT combinaties van trefwoorden, binnen de totale set of binnen specifieke velden.

  • fiets AND pomp
  • kasteel AND (ridder OR ridders)
  • vis AND walvis NOT potvis
  • breuken AND vak=wiskunde
  • breuken AND (titel=werkblad OR titel=taak)

Afhankelijk van de gebruikte zoekinterface zijn er verschillende zoekvelden beschikbaar, bekijk de veldenlijst voor een overzicht.

Voorbeelden:

/edurep/sruns: query=fiets AND pomp
/smo/sruns: query=smo.hReview.info exact "http://wikiwijs.samendelen.nl/get/smpid:5585/DS1"
Catalogus Service: query=Title=techniek AND Price<500
/jsonsearch: query=fiets AND schema:name="werkblad"

Beperkingen:

  • De waarde van het query argument mag maximaal 4096 tekens zijn, na urldecoding.
  • De zoekwoorden kunnen alleen letters en cijfers bevatten. Vanwege het indexatieproces zijn speciale karakters als # en $ zijn niet doorzoekbaar.
  • Wildcard zoeken is beperkt mogelijk. Zoeken op fiets* is wel mogelijk maar *fiets niet. De fiets* is mogelijk met minimaal 2 karakters. Het zoeken met het wildcard teken in een string (infix) is ook mogelijk, ook met minimaal 2 voorloopkarakters. Er mag maximaal 1 * voorkomen per trefwoord.

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

Sortering

Er zijn is Edurep verschillende velden waarop gesorteerd kan worden. Standaard wordt de sortering van de zoekmachine aangehouden, en dat is op de door de zoekmachine bepaalde relevantie. Per veld kan er ascending of descending gesorteerd worden.

SRU

Het SRU/SRW protocol (versie 1.1) gebruikt het argument sortKeys om een gewenste sortering door te geven. Het is vervolgens mogelijk om in de implementatie aan te geven of het veld oplopend of aflopend wordt gesorteerd. Dit gebeurt door een boolean met de waarde 0 of 1.

Oplopend:

/edurep/sruns: query=beatrix&sortKeys=lom.lifecycle.contribute.publisherdate,,0

Aflopend:

/edurep/sruns: query=beatrix&sortKeys=lom.lifecycle.contribute.publisherdate,,1

Jsonsearch

In de jsonsearch worden sorteerbare velden met het sort argument meegegeven. De sorteringsrichting wordt als volgt opgegeven: 'veldnaam' voor oplopend, en '-veldnaam' voor aflopend. Meerdere sorteervelden kunnen met meerdere "sort" parameters worden opgegeven of met "," gescheiden.

Oplopend:

/jsonsearch: query=dinosaurus&sort=schema:datePublished

Aflopend:

/jsonsearch: query=dinosaurus&sort=-schema:datePublished

recordSchema

Nl.gif Nederlands En.gif 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)


See Also

Gebruikt in Edurep:Jsonsearch - Edurep:LOM_SearchRetrieve
Vergelijkbaar met -
Gerelateerd aan Edurep:Veldenlijst