Edurep:Metadata/Rating Aggregatie

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken

Edurep-symbol.png Edurep: Metadata/Rating Aggregatie

Info.gif Vanwege de aankomende release zijn we bezig het voorbereiden van de wiki. Met name de informatie rondom schema.org en de jsonsearch is nog niet bruikbaar op productie.


Dit omvat de geaggregeerde informatie over ratings en reviews die aan een record zijn gekoppeld.

Elementen

naam # type omschrijving
aantal reviews 1 getal Het aantal reviews (niet SMO's) bij dit record.
aantal ratings 1 getal Het aantal ratings bij dit record.
aantal tags 1 getal Het aantal tags bij dit record.
gemiddelde rating 1 getal De gemiddelde genormaliseerde rating van dit record (tussen 0 en 5), default 0.
gewogen rating 1 getal Gewogen ranking van dit record (tussen 0 en 5), default 2.50.

smbAggregatedData

Dit schema kan op verzoek worden uitgeleverd bij elk LOM record.

<sad:smbAggregatedData xmlns:sad="http://xsd.kennisnet.nl/smd/sad">
  <sad:numberOfReviews>3</sad:numberOfReviews>
  <sad:numberOfRatings>10</sad:numberOfRatings>
  <sad:numberOfTags>2</sad:numberOfTags>
  <sad:averageNormalizedRating>4.3</sad:averageNormalizedRating>
  <sad:bayesianRanking>3.9</sad:bayesianRanking>
</sad:smbAggregatedData>

Schema.org

Bullet book.png Specificatie En.gif (leidend)

Een AggregateRating type gebruikt in het schema:aggregateRating attribuut.

{
  "@context": {
    "schema": "https://schema.org/",
    "edurep": "https://purl.edurep.nl/terms/"
  },
  "schema:aggregateRating": {
    "@type": "schema:AggregateRating",
    "edurep:bayesianRanking": 2.1,
    "edurep:tagCount": 0,
    "schema:ratingCount": 2,
    "schema:ratingValue": 1.5,
    "schema:reviewCount": 0
  }
}

Zoeken

In de schema.org representaties (recordSchema jsonld en Jsonsearch) wordt de rating aggregatie automatisch meegenomen in de response records. Voor de NL LOM representaties moet het recordSchema smbAggregatedData expliciet worden meegegeven:

/edurep/sruns: query=chewbacca&x-recordSchema=smbAggregatedData

Er kan ook op individuele waarden worden gezocht, bijvoorbeeld:

/edurep/sruns: query=nederland AND smbAggregatedData.averageNormalizedRating>3 AND smbAggregatedData.numberOfRatings>2
/jsonsearch: query=nederland AND schema:aggregateRating.schema:ratingValue>3 AND schema:aggregateRating.schema:ratingCount>2

See Also

Gebruikt in Edurep:Metadata
Vergelijkbaar met -
Gerelateerd aan Edurep:VeldenlijstEdurep:Metadata/Beoordeling