Se også liste over egenskaper for alle grep-typer (side under arbeid)

Nedenfor har vi listet opp alle typene (klassene) i Greps datamodell (se tabellen nedenfor). Når du slår opp en forekomst av en type, for eksempel https://data.udir.no/kl06v201906/laereplaner-lk20/NOR01-06, vil du se at den har en egenskap som heter "grep-type" med verdien "http://psi.udir.no/ontologi/kl06/laereplan_lk20" (legg merke til at verdien her er en URI (identifikator) og ikke en URL (locator) foreløpig. Vi har en oppgave på at disse URIene skal kunne resolve, men vi har ingen dato for når vi kan levere dette).

I vestre kolonne i tabellen neenfor finner du liste over REST-dokumentasjon av alle grep-typene. Disse dokumentene er organisert slik at vi har beskrevet alle attributtene i en tabell med attributtbeskrivelse, inkludert informasjon om multiplisitet. Der REST-objektene har underobjekter, har vi beskrevet disse i egne tabeller under hovedtabellen, men for det vi har kalt spesielle datatyper, fellesklasser og regler, lenker vi til en egen side for dette. Vi tenker dette forenkler lesingen av dokumentene, men om du har forslag til en enda bedre måte å organisere denne dokumentasjonen på, er vi takknemlig om du tar kontakt med oss.

I SPARQL-endepunktet vårt, har vi nå laget et repo i Beta-miljøet vårt med et utkast til ontologi for Grep. Her finner du blant annet oversikt over alle klasser og egenskaper, samt beskrivelse/definisjon av disse. Gå til https://sparql-beta-data.udir.no/sparql, og velg repositoriet "Ontologi", og kjør denne spørringen etter at du har lest Greps SPARQL-wiki-artikkel Ontologi for Grep.

I den midtre kolonnen i tabellen nedenfor har vi også lenket opp alle typene med lenke til liste over forekomster av den aktuelle typen. URLene er etter formen https://data.udir.no/kl06/v201906/[plural av navnet på grep-typen]. En gitt forekomst av en type vil da få URL etter formen https://data.udir.no/kl06/v201906/[plural av navnet på grep-typen]/[koden til forekomsten], f.eks.: https://data.udir.no/kl06/v201906/laereplaner-lk20/NOR01-06.

En annen ting det kan være verdt å merke seg, er at arrayet av en type viser bare noen av egenskapene for hver type – ikke alle. I hovedsak vises først de identifiserende egenskapene

• id
• kode
• uri
• url-data

og videre språkversjonert tittel, og til slutt et knippe annen vital informasjon det kan være verdt å sortere på i søk, slik som

• grep-type
• status
• sist-endret
• gyldig-fra (for de typene som har denne egenskapen) og
• gyldig-til (for de typene som har denne egenskapen)

For å få fram alle dataene til en forekomst, må du følge/slå opp/traversere URLen til verdien til egenskapen 'url-data' hvis du bruker det vanlige REST APIet. For de som bruker RDF/SPARQL, bruk 'uri' til det samme formålet.

Vi har ingen list of lists i APIet vårt, men vi har hardkodet en som du finner i kodebiblioteket her i dette github-repoet. Se fila lol.json. Dette er altså en liste over alle lister av alle forekomster pr. grep-type.
Men ta da også hensyn til det siste avsnittet under forrige overskrift – dette med å bruke 'url-data' for å parse videre hvis du vil få ut alt pr. type. Det som kan være praktisk med denne lista, er at den viser forskjellen på URIen til 'grep-type' og liste-URLen (verdien til 'url-data' i json-dokumentet).

(røde lenker = artikkelenen er ikke skrevet ennå)