Edurep:Metadata/Rating Aggregatie: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
 
(3 tussenliggende versies door een andere gebruiker niet weergegeven)
Regel 38: Regel 38:
 
{{:Edurep:SAD}}
 
{{:Edurep:SAD}}
 
== Schema.org ==
 
== Schema.org ==
{{:Standaarden:Schema.org/AggregateRating}}
+
{{:Standaarden:Schema.org/schema:AggregateRating}}
  +
== Zoeken ==
  +
In de schema.org representaties ([[Edurep:Zoekopdracht/recordSchema|recordSchema jsonld]] en [[Edurep:Jsonsearch|Jsonsearch]]) wordt de rating aggregatie automatisch meegenomen in de response records.
  +
Voor de NL LOM representaties moet het [[Edurep:Zoekopdracht/recordSchema|recordSchema smbAggregatedData]] expliciet worden meegegeven:
  +
{{EdurepQuery|query=chewbacca|xschema=smbAggregatedData}}
  +
  +
Er kan ook op individuele waarden worden gezocht, bijvoorbeeld:
  +
{{EdurepQuery|query=nederland AND smbAggregatedData.averageNormalizedRating>3 AND smbAggregatedData.numberOfRatings>2}}
  +
{{EdurepJsonsearchQuery|query=nederland AND schema:aggregateRating.schema:ratingValue>3 AND schema:aggregateRating.schema:ratingCount>2}}
  +
  +
== See Also ==
  +
{{:Edurep:SeeAlso|use=[[Edurep:Metadata]]|related=[[Edurep:Veldenlijst]] • [[Edurep:Metadata/Beoordeling]]}}

Huidige versie van 15 nov 2021 om 21:53

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