Spørretjenesten

Fra GrepWiki

(Forskjell mellom revisjoner)
Gå til: navigasjon, søk
(Eksisterende grensesnitt)
Linje 2: Linje 2:
== Eksisterende grensesnitt ==
== 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 xtm, xml og json. Lister(REST) leveres som regel som json, xml eller atom. Læreplaner leveres også som odf, pdf, doc og rtf.
+
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)===
=== Adresser (endpoints)===
Linje 16: Linje 16:
Følgende data kan hentes via spørretjenesten:
Følgende data kan hentes via spørretjenesten:
-
Tilgjengelig i 2013/04-versjonen:
+
Tilgjengelig i 2013/11-versjonen:
* Liste over læreplaner
* Liste over læreplaner
* Hver enkelt læreplan (inkl. tilhørende hovedområder, etc)
* Hver enkelt læreplan (inkl. tilhørende hovedområder, etc)
Linje 35: Linje 35:
* Liste over fagområder
* Liste over fagområder
* Hvert enkelt fagområde
* Hvert enkelt fagområde
-
 
-
Nytt i 2013/11-versjonen ([[medium:Endringer_i_eksterne_tjenester_for_kontrakt_2013_11.pdf | Alle endringer i spørretjenesten for kontrakt 2013/11]]):
 
* Liste over opplæringsfag
* Liste over opplæringsfag
* Hvert enkelt opplæringsfag
* Hvert enkelt opplæringsfag
-
* Mindre informasjon i refererte elementer
 
* Liste over årstrinn
* Liste over årstrinn
* Hvert enkelt årstrinn
* Hvert enkelt årstrinn
Linje 45: Linje 42:
* Mulighet til å hente forrige versjon av datafilene i REST/Odata
* Mulighet til å hente forrige versjon av datafilene i REST/Odata
-
Se forøvrig [[Medium:Brukermanual_for_Grep_soap_odata_rest.pdf | brukermanual for spørretjenesten]] for ytterligere beskrivelse av elementene og hvordan du velger språk eller versjon.
+
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ørringers 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
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
Linje 51: Linje 55:
== Under utvikling ==
== Under utvikling ==
* Eget SPARQL-endpoint(under testing)
* Eget SPARQL-endpoint(under testing)
-
* Direkteoppslag hovedområder
+
* Direkteoppslag på underelementer i læreplanen: programfag, hovedområder,kompetansemålsett
-
* Direkteoppslag kompetansemålsett
+
-
* Periodeangivelse i koblinger; gitt fagkode eller programområde, vis relevante lenker for et gitt tidspunkt.
+
== Eldre grensesnitt som er faset ut ==
== Eldre grensesnitt som er faset ut ==
 +
'''Utfasede versjoner av spørretjenesten'''<br/>
 +
* ''2013/04'' (stengt 19. august 2016)
 +
'''[[Spørretjeneste for fagkoder | Fagkoder]] (stengt 22. april 2013)'''
'''[[Spørretjeneste for fagkoder | Fagkoder]] (stengt 22. april 2013)'''
''Webservice (SOAP/XML)''<br />
''Webservice (SOAP/XML)''<br />

Revisjonen fra 19. aug 2016 kl. 06:07

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)

Dokumentasjon

Oversikt over tilgjengelige elementer

Følgende data kan hentes via spørretjenesten:

Tilgjengelig i 2013/11-versjonen:

Nytt i 2016/11-versjonen:

Se forøvrig https://www.gitbook.com/book/kl06-doc/kl06-public for ytterligere beskrivelse av elementene, hvilke spesialspørringers 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

Eldre grensesnitt som er faset ut

Utfasede versjoner av spørretjenesten

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.

Personlige verktøy
Navnerom
Varianter
Handlinger
Navigasjon
Verktøy