Edurep:Metadata/Rating Aggregatie: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
(first something)
 
 
(4 tussenliggende versies door een andere gebruiker niet weergegeven)
Regel 1: Regel 1:
  +
Dit omvat de geaggregeerde informatie over ratings en reviews die aan een record zijn gekoppeld.
   
  +
== Elementen ==
  +
{| class="wikitable"
  +
! 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 ==
−  
  +
{{: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 20: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:Veldenlijst • Edurep:Metadata/Beoordeling
Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=Edurep:Metadata/Rating_Aggregatie&oldid=11936"