SOAP-grensesnittet

Grep tilbyr også et SOAP-grensesnitt. URL for endepunktet for dette grensesnittet er http://data.udir.no/kl06/soap. Det ligger en online dokumentasjon av soap-endepunktet på denne adressen ved direkte oppslag. Wsdl/kontrakten for denne tjenesten kan hentes ut på følgende URL: http://data.udir.no/kl06/soap?wsdl. Kontrakten inneholder tjenestekontrakten og alle relevante datatyper.

SOAP-grensesnittet tilbyr følgende metoder for å finne og hente informasjon fra Grep.

Metode Beskrivelse Teknisk dokumentasjon
FinnPlaner Finner læreplaner basert på søkekriterier. Se teknisk dokumentasjon for detaljer rundt parametere SOAP-grensesnitt
FinnFagkoder Finner fagkoder basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnProgramomraader Finner programområder basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnUtdanningsprogram Finner utdanningsprogram basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnMerknader Finner merknader basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnMerkelapper Finner merkelapper basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnFagomraader Finner fagområder basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnFagkategorier Finner fagkategorier basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnKompetansemaal Finner kompetansemål basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnOpplaeringsfag Finner opplæringsfag basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
FinnAarstrinn Finner årstrinn basert på søkekriterier. Se teknisk dokumentasjon for detaljer SOAP-grensesnitt
HentPlanFraKode Returnerer en læreplan basert på læreplanens kode SOAP-grensesnitt
HentPlanFraPsi Returnerer en læreplan basert på læreplanens PSI (id) SOAP-grensesnitt
HentFagkodeFraKode Returnerer en fagkode basert på fagets kode SOAP-grensesnitt
HentFagkodeFraPsi Returnerer en fagkode basert på fagets PSI (id) SOAP-grensesnitt
HentProgramomraadeFraKode Returnerer et programområde basert på programområdets kode SOAP-grensesnitt
HentProgramomraadeFraPsi Returnerer et programområde basert på programområdets psi SOAP-grensesnitt
HentUtdanningsprogramFraKode Returnerer et utdanningsprogram basert på utdanningsprogrammets kode SOAP-grensesnitt
HentUtdanningsprogramFraPsi Returnerer et utdanningsprogram basert på PSI (id) SOAP-grensesnitt
HentMerknadFraPsi Returnerer en merknad basert på merknadens psi SOAP-grensesnitt
HentMerknadFraKode Returnerer en merknad basert på merknadens kode SOAP-grensesnitt
HentMerkelapperFraPsi Returnerer en merkelapp basert på merkelappens psi SOAP-grensesnitt
HentMerkelapperFraKode Returnerer en merkelapp basert på merkelappens kode SOAP-grensesnitt
HentKompetansemaalFraPsi Returnerer et kompetansemål basert på kompetansemålets psi SOAP-grensesnitt
HentKompetansemaalFraKode Returnerer et kompetansemål basert på kompetansemålets kode SOAP-grensesnitt
HentFagomraadeFraPsi Returnerer et fagområde basert på kompetansemålets psi SOAP-grensesnitt
HentFagomraadeFraKode Returnerer et fagområde basert på kompetansemålets kode SOAP-grensesnitt
HentFagkategoriFraPsi Returnerer en fagkategori basert på kompetansemålets psi SOAP-grensesnitt
HentFagkategoriFraKode Returnerer en fagkategori basert på kompetansemålets kode SOAP-grensesnitt
HentOpplaeringsfagFraPsi Returnerer et opplæringsfag basert på opplæringsfagets psi SOAP-grensesnitt
HentOpplaeringsfagFraKode Returnerer et opplæringsfag basert på opplæringsfagets kode SOAP-grensesnitt
HentAarstrinmFraPsi Returnerer et årstrinn basert på årstrinnets psi SOAP-grensesnitt

Språkvalg i soap

For alle metoder er det mulig å legge inn språkvalg. Språket angis i henhold til ISO 639-2. Dersom det ikke finnes oversettelser på det valgte språket, vil tekstfeltene vises som tom verdi og i tillegg vil default verdien komme med. Dersom en ikke angir noe språk, vil en få ut alle tilgjengelige oversettelser for angitt element. Og om en vil hente ut elementet på «hovedspråk», som i hovedsak varierer mellom nynorsk og bokmål, settes valgt språk lik «default».

Eksempel 1: Uthenting av MAT1-03 på engelsk.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://psi.udir.no/kl06/2013/11"> <soapenv:Header/> <soapenv:Body> <ns:HentPlanFraKode> <!--Optional:--> <ns:kode> <!--Optional:--> <ns:Kode>mat1-03</ns:Kode> <!--Optional:--> <ns:valgt-spraak>nob</ns:valgt-spraak> </ns:kode> </ns:HentPlanFraKode> </soapenv:Body> </soapenv:Envelope>

Eksempel 2: Uthenting av MAT1-03 på hovedspråk.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://psi.udir.no/kl06/2013/11"> <soapenv:Header/> <soapenv:Body> <ns:HentPlanFraKode> <!--Optional:--> <ns:kode> <!--Optional:--> <ns:Kode>mat1-03</ns:Kode> <!--Optional:--> <ns:valgt-spraak>default</ns:valgt-spraak> </ns:kode> </ns:HentPlanFraKode> </soapenv:Body> </soapenv:Envelope>