Spørretjenesten
Fra GrepWiki
Direktoratet tilbyr i dag grensesnitt for spørringer på deler av databasen.
Innhold |
Eksisterende grensesnitt
Grep-data kan hentes via våre ulike tjenester, som hver har sine adresser (endpoints). Det er flere formater å velge mellom: i dag kan data leveres som xml og json. Lister(REST) leveres som regel som json, xml eller atom. Læreplaner leveres også som odf, pdf, doc og rtf. Grunnet lav etterspørsel er ikke xtm-støtte videreført i den nyeste versjonen av tjenesten (2016/04).
Adresser (endpoints)
- Soap: http://data.udir.no/kl06/soap?wsdl
- REST: http://data.udir.no/kl06/<kode>.<format>
- OData: http://data.udir.no/kl06/odata/
Dokumentasjon
- Brukermanual for alle tjenestene: brukermanual for spørretjenesten
- Oversikt over SOAP-tjenesten, med beskrivelse av metoder og typer: http://data.udir.no/kl06/soap
Oversikt over tilgjengelige elementer
Følgende data kan hentes via spørretjenesten:
Tilgjengelig i 2013/11-versjonen:
- Liste over læreplaner
- Hver enkelt læreplan (inkl. tilhørende hovedområder, etc)
- Liste over fagkoder
- Hvert enkelt fagkode (inkl. tilhørende vurderingsordninger, etc)
- Liste over utdanningsprogram
- Hvert enkelt utdanningsprogram
- Liste over programområder
- Hvert enkelt programområde
- Liste over merknader
- Hver enkelt fag- og vitnemålsmerknad
- Liste over merkelapper
- Hver enkelt merkelapp
- Liste over kompetansemål
- Hvert enkelt kompetansemål
- Liste over fagkategorier
- Hver enkel fagkategori
- Liste over fagområder
- Hvert enkelt fagområde
- Liste over opplæringsfag
- Hvert enkelt opplæringsfag
- Liste over årstrinn
- Hvert enkelt årstrinn
- Mulighet til å velge språk
- Mulighet til å hente forrige versjon av datafilene i REST/Odata
Nytt i 2016/11-versjonen:
- Merking av kryssløp i tilbudsstrukturen (kobling mellom programområder)
- Utvidet informasjon om programområder. Opplæringssted, læretid (opplæringstid + verdiskapingstid), yrkestittel, sluttkompetanse.
- Gyldighetsperiode angitt på koblinger mellom fagkoder, opplæringsfag, læreplaner og programområder.
- Mulighet til å angi tidspunkt som parameter på en rekke spørringer (se hvilke fagkoder eller læreplaner som var aktuelle for et programområde forrige år eller neste år)
- Restrukturert læreplan for å kunne gjengi læreplaner som dekker flere programfag, som ikke har hovedområder, eller hovedområder i hierarki uten å måtte benytte egne fritekstfelt for hovedområde-/beskrivelse av programfag-kapittel.
Se forøvrig https://www.gitbook.com/book/kl06-doc/kl06-public for ytterligere beskrivelse av elementene, hvilke spesialspørringer som finnes og hvordan du velger språk eller versjon.
Vi har også laget en versjon av wsdl (beskrivelse av soap api) myntet på mennesker, med kommentarer til felter, m.v., som kan være til hjelp for å få oversikt over de forskjellige datatypene og feltene: http://data.udir.no/kl06/soap
Under utvikling
- Eget SPARQL-endpoint(under testing)
- Direkteoppslag på underelementer i læreplanen: programfag, hovedområder,kompetansemålsett
Eldre grensesnitt som er faset ut
Utfasede versjoner av spørretjenesten
- 2013/04 (stengt 19. august 2016)
Fagkoder (stengt 22. april 2013)
Webservice (SOAP/XML)
http://lkt.udir.no/eksport/fagkoder.asmx
Denne tjenesten ble i sin tid utviklet for PAS/PGS, men hadde en del begrensninger og ytelsesproblemer, og ble lagt ned i april 2013. En bedre løsning for fagkoder ble lagt ut våren 2012, som en del av det nye grensesnittet for spørringer (se http://data.udir.no/kl06/fagkoder.xml eller http://data.udir.no/kl06/soap?wsdl).
Kompetansemål (stengt 22. april 2013)
Feed/filer (ATOM/RDF)
http://lkt.udir.no/Eksport/rdf.mvc/laereplan
Kompetansemål, presentert per læreplan. Leveret som ATOM-feed med liste over læreplaner, hver læreplan presentert som RDF/XML. Hver fil representerte struktur for kompetansemålene i læreplanen, inkludert navn på hovedområder og årstrinn, men ikke tekstlig innhold, og få knytninger mot øvrig læreplanverk.
Denne tjenesten hadde en del begrensninger og vi la den i april 2013.