FSWS StudInfo

StudInfo er en web-tjeneste som leverer samme uttrekk som rapport FS200.040.

Tjenesten er SOAP-basert og bruker "stil" document/literal.

For formell definisjon av tjenesten, se lenke til WSDL og XML-skjema p� hovedsiden.

Parameterangivelser

Noen av operasjonene gir forskjellig funksjonalitet avhengig av hvilke parametre som
er satt (tilsvarer forskjellige varianter i FS200.040 for samme type informasjon).
"Satt" betyr i denne sammenheng reelle verdier, i motsetning til dummyverdier:
    String : -
    Integer: -1

Parameterm�nsteret for hver FS200.040-variant angis slik:

Parametre	Datatype	Beskrivelse	Var.1: ...	Var.2: ...	Var.3: ...
parameter1	Datatype	Beskrivelse	reell/dummy	reell/dummy	reell/dummy
parameter2	Datatype	Beskrivelse	reell/dummy	reell/dummy	reell/dummy
.....	.....	.....	.....	.....	.....

Operasjonene

getEmneSI

Returnerer emneinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse	Var.1: Enkeltemne	Var.2: Emner ved Sted
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr	reell	reell
emnekode	String	12-tegns emnekode	reell	-
versjonskode	String	3-tegns versjonskode	reell	-
faknr	Integer	2-sifret fakultets-/avdelingsnr	-1	reell
instituttnr	Integer	2-sifret institutt-/seksjonsnr	-1	reell
gruppenr	Integer	2-sifret gruppenr	-1	reell
arstall	Integer	4-sifret �rstall	reell	reell
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)	reell	reell
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)	reell	reell

getEksamenSI

Returnerer eksamensinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr
faknr	Integer	2-sifret fakultets-/avdelingsnr
instituttnr	Integer	2-sifret institutt-/seksjonsnr
gruppenr	Integer	2-sifret gruppenr
arstall	Integer	4-sifret �rstall
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)

getKursSI

Returnerer kursinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr
faknr	Integer	2-sifret fakultets-/avdelingsnr
instituttnr	Integer	2-sifret institutt-/seksjonsnr
gruppenr	Integer	2-sifret gruppenr
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)

getUndervisningSI

Returnerer undervisningsinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse	Var. 1: Undervisning	Var. 2: Underv. for emne*	Var. 3: Ledig kapasitet
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr	reell	reell	reell
faknr	Integer	2-sifret fakultets-/avdelingsnr	reell	-1	reell
instituttnr	Integer	2-sifret institutt-/seksjonsnr	reell	-1	reell
gruppenr	Integer	2-sifret gruppenr	reell	-1	reell
arstall	Integer	4-sifret �rstall	reell	reell	reell
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)	reell	reell	reell
emnekode	String	12-tegns emnekode	-	reell	-
versjonskode	String	3-tegns versjonskode	-	reell	-
fraStudieNiva **	Integer	Brukes til test-uttrekk, m/defaultverdi 0 (usynlig i bestillingsbildet for rapporten)	-1	-1	reell
tilStudieNiva**	Integer	Brukes til test-uttrekk, m/defaultverdi 999 (usynlig i bestillingsbildet for rapporten)	-1	-1	reell
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)	reell	reell	reell

* Ikke tilgjengelig i bestillingsbildet for FS200.040

** Parametre som er usynlige i bestillingsbildet for rapporten (Brukes til testuttrekk, med defaultverdi hhv. 0 og 999)

getStudieprogramSI

Returnerer studieprograminformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse	Var.1: Enkeltstudieprogram	Var.2: St.programmer v/sted
arstall	Integer	4-sifret �rstall	reell	reell
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)	reell	reell
medUPinfo	Integer	Inkluderer utdanningsplan: 0 (Nei) / 1 (Ja)	reell	reell
studieprogramkode	String		reell	-
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr	-1	reell
faknr	Integer	2-sifret fakultets-/avdelingsnr	-1	reell
instituttnr	Integer	2-sifret institutt-/seksjonsnr	-1	reell
gruppenr	Integer	2-sifret gruppenr	-1	reell
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)	reell	reell

getStudieretningSI

Returnerer studieretningsinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse	Var.1: Enkeltstudieretning	Var.2: St.retninger v/sted
arstall	Integer	4-sifret �rstall	reell	reell
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)	reell	reell
studieretningkode	String		reell	-
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr	-1	reell
faknr	Integer	2-sifret fakultets-/avdelingsnr	-1	reell
instituttnr	Integer	2-sifret institutt-/seksjonsnr	-1	reell
gruppenr	Integer	2-sifret gruppenr	-1	reell
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)	reell	reell

getStedSI

Returnerer stedinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr
faknr	Integer	2-sifret fakultets-/avdelingsnr
instituttnr	Integer	2-sifret institutt-/seksjonsnr
gruppenr	Integer	2-sifret gruppenr
arstall	Integer	4-sifret �rstall
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)

getKodeSI

Returnerer kodeinformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse	Var.1: Andre koder	Var.2: NUS-koder
arstall	Integer	4-sifret �rstall	reell	-1
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)	reell	-
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)	reell	-

getFagpersonSI

Returnerer fagpersoninformasjon som XML (se XML-skjema)

Parametre	Datatype	Beskrivelse	Var.1: Fagperson	Var.2: Fagpersoner
arstall	Integer	4-sifret �rstall	reell	reell
terminkode	String	4-tegns terminkode (V�R/V�T/VIT/SOM/H�ST/H�T)	reell	reell
fodselsdato	Integer	6-sifret f�dselsdato (DDMMYY)	reell	-1
personnr	Integer	5-sifret personnummer	reell	-1
institusjonsnr	Integer	Normalt 3- eller 4-sifret institusjonsnr	-1	reell
faknr	Integer	2-sifret fakultets-/avdelingsnr	-1	reell
instituttnr	Integer	2-sifret institutt-/seksjonsnr	-1	reell
gruppenr	Integer	2-sifret gruppenr	-1	reell
sprak	String	1-tegns spr�kkode: B(okm�l) / N(ynorsk) / E(ngelsk)	reell	reell

.Parametre som brukes i mange operasjoner:

sprak:
B(okmål)
N(ynorsk)
E(ngelsk)

faknr/instituttnr/gruppenr:
faktisk verdi (tosifret tallkode)
-1 (jokertegn = "alle koder")

Eksempel

Operasjonen getEmneSI returnerer et resultat p� formen:

<?xml version="1.0" encoding="ISO-8859-1"?>
<fs-studieinfo xmlns="http://fsws.usit.no/schemas/studinfo">
    <emne sprak="BOKM�L">
        <emneid>
            <institusjonsnr>185</institusjonsnr>
            <emnekode>ANATO</emnekode>
            <versjonskode>U</versjonskode>
        </emneid>
        <emnenavn>Anatomi</emnenavn>
        <emnenavn_en>Anatomi</emnenavn_en>
        <studiepoeng>45</studiepoeng>
        <status-privatist>N</status-privatist>
        <studieniva>LN</studieniva>
        <status_oblig>N</status_oblig>
        <emnetype>VURDERING</emnetype>
        <periode-eks>
            <forstegang>2008V</forstegang>
        </periode-eks>
        <periode-und>
            <forstegang>2006V</forstegang>
        </periode-und>
        <inngar-i-studieprogram>
            <studieprogramkode>ALM</studieprogramkode>
        </inngar-i-studieprogram>
        <inngar-i-fag>
            <fagkode>MEDISIN</fagkode>
        </inngar-i-fag>
        <sted type="fagansvarlig">
            <institusjonsnr>185</institusjonsnr>
            <fakultetsnr>13</fakultetsnr>
            <instituttnr>0</instituttnr>
            <gruppenr>0</gruppenr>
            <navn>Det medisinske fakultet, UiO</navn>
            <avdnavn>Det medisinske fakultet, UiO</avdnavn>
        </sted>
        <sted type="adminansvarlig">
            <institusjonsnr>185</institusjonsnr>
            <fakultetsnr>13</fakultetsnr>
            <instituttnr>0</instituttnr>
            <gruppenr>0</gruppenr>
            <navn>Det medisinske fakultet, UiO</navn>
            <avdnavn>Det medisinske fakultet, UiO</avdnavn>
        </sted>
    </emne>
    ...
<fs-studieinfo>

Oppdatert 11.08.2011