Edurep:Metadata/Rating Aggregatie

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

Specificatie

(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