Tjänstebeskrivning T22

Transkript

1 Tjänstebeskrivning T22 Hjälptjänst Ladok på webb

2 Ändringshistorik Datum Av Kommentar Granskare Godkännare Matilda Östling Första versionen Therese Hermansson Lagt till deltjänster för utsökning av institution samt uppdaterat felmeddelandehanteringen Johan Forssell Lagt till deltjänst för utsökning av institution mha. delkod Johan Forssell Lagt till deltjänst för utsökning av högskolor Johan Forssell Förtydligad information om söktermer i findhsk() Anders Bergström Åtgärd 16423: Uppdaterat felmeddelanden Kristoffer From Åtgärd 13672: Sök person på del av personnummer Magnus Uddstal Tilläg av metod för att hämta nuvarande termin och nästa Andreas Hed Tillägg av metod för hämtning av kurstillfällen och hämtning av kursinformation Namnbyte på dokumentet från hämta_namn till katalogtjänst Erik Andersson Tillägg av metod för hämtning av prov tillhörande kurs Magnus Uddstål Tillägg av metod för att hämta alla Orter från ORT som inte är nedlagda Magnus Uddstål Tillägg av metod för att hämta alla institutioner Magnus Uddstål Tillägg av metod för att hämta adressuppgifter för ett antal personer Thom Jönsson Tillägg av metoder för utsökning av personer på del av personnummer eller namn tehn Rikard Skelander Uppdaterat beskrivningen av metoden för att hämta innevarande termin som nu också returneras start- och slutdatum för undervisning Thom Jönsson Korrigerad information i kapitel 16.

3 Håkan Lindgren Lagt till metod för att hämta huvudområde och fördjupning för given kurskod Thom Jönsson Lagt till metod för att hämta provuppsättningsterminer och sortera in prov efter dessa.

4 Matilda Östling, Johan Forssell (49) Innehållsförteckning 1 INLEDNING SYFTE MÅLGRUPP BESKRIVNING Deltjänster HÄMTA NAMN MED KONTROLLER BESKRIVNING Flödesbeskrivning Tabellförändringar BEHÖRIGHETSANALYS TABELLER SOM ANVÄNDS AV TJÄNSTEN EXPONERADE METODER INDATA Kontroller UTDATA FELHANTERING HÄMTA INSTITUTION SYFTE BESKRIVNING Inställningar KRAVLISTA INDATA UTDATA Felhantering SÖK INSTITUTION MED DEL AV INSTITUTIONSKOD SYFTE BESKRIVNING Inställningar KRAVLISTA INDATA UTDATA Felhantering SÖK INSTITUTION MED BENÄMNING SYFTE BESKRIVNING Inställningar KRAVLISTA Krav 1 Sök institutioner INDATA UTDATA Felhantering SÖK INSTITUTION MED ENGELSK BENÄMNING SYFTE BESKRIVNING... 18

5 Matilda Östling, Johan Forssell (49) Inställningar Sorteringsordning KRAVLISTA Krav 1 Sök institutioner INDATA UTDATA Felhantering HÄMTA HÖGSKOLOR SYFTE BESKRIVNING Sorteringsordning METODER KRAVLISTA Krav 1 Hämta högskolor Krav 2 Sök högskolor efter kod Krav 3 Sök högskolor efter benämning Krav 4 Sök högskolor efter engelsk benämning INDATA UTDATA Felhantering SÖK PERSON PÅ DEL AV PERSONNUMMER SYFTE BESKRIVNING Flödesbeskrivning Tabellförändringar METODER BEHÖRIGHETSANALYS KRAVLISTA Krav 1 Kontrollera att användaren har rätt behörighet Krav 2 - Kontrollera att personnumret är korrekt Krav 3 Sök studenter baserade på personnumret INDATA Kontroller UTDATA Felhantering HÄMTA INNEVARANDE TERMIN SYFTE BESKRIVNING KRAVLISTA EXPONERADE METODER INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA KURSTILLFÄLLEN SYFTE BESKRIVNING Flödesbeskrivning Tabellförändringar METODER BEHÖRIGHETSANALYS... 27

6 Matilda Östling, Johan Forssell (49) 10.5 KRAVLISTA EXPONERADE METODER INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA KURSINFORMATION SYFTE BESKRIVNING Flödesbeskrivning Tabellförändringar METODER BEHÖRIGHETSANALYS KRAVLISTA EXPONERADE METODER INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA PROV SYFTE BESKRIVNING Inställningar Metoder KRAVLISTA INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA ORT SYFTE BESKRIVNING Inställningar Metoder KRAVLISTA INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA ALLA INSTITUTIONER SYFTE BESKRIVNING Inställningar Metoder KRAVLISTA INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA ADRESSUPPGIFTER SYFTE BESKRIVNING Inställningar Metoder... 37

7 Matilda Östling, Johan Forssell (49) 15.3 KRAVLISTA INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN HÄMTA KURS PÅ INSTITUTION SYFTE BESKRIVNING Inställningar Metoder KRAVLISTA INDATA UTDATA TJÄNSTESPECIFIKA FELMEDDELANDEN SÖK PERSON PÅ DEL AV PERSONNUMMER ELLER NAMN SYFTE BESKRIVNING Sökning med asterisk Flödesbeskrivning Tabellförändringar BEHÖRIGHET EXPONERADE METODER INDATA Utsökning av student på grund- och avancerad nivå Utsökning av forskarstudent Begränsa antalet sökträffar UTDATA Felhantering TJÄNSTESPECIFIKA FELMEDDELANDEN GENERELLA FELMEDDELANDEN HÄMTA HUVUDOMRÅDE OCH FÖRDJUPNING SYFTE BESKRIVNING METODER INDATA UTDATA Felhantering HÄMTA PROVUPPSÄTTNINGSTERMINER SYFTE BESKRIVNING METODER INDATA UTDATA Felhantering... 49

8 Matilda Östling, Johan Forssell (49) 1 Inledning 1.1 Syfte Detta dokument skall, på en teknisk nivå, beskriva hjälptjänsten katalogtjänst. Med denna hjälptjänst kan man hämta diverse kataloguppgifter från Ladok. Fullständigt namn och status för student. Namn och information på institution. Namn och kod på högskolor. Hämtning av aktuell termin samt nästa. Kursinformation givet kurskod. Kurstillfällen givet kurskod. Prov givet kurskod Orter Adressuppgifter 1.2 Målgrupp Dokumentet vänder sig till kravansvariga, portalutvecklare och driftspersonal på universitet och högskolor. 1.3 Beskrivning Med denna tjänst kan enklare uppgifter hämtas ur Ladoks databas, såsom namn på en student, institution eller högskola Deltjänster Varje deltjänst motsvarar ett anrop till systemet. Krav Nr Deltjänst Målgrupp Prio Status 1 Hämta namn (med kontroller) Personal 0 Levererad 2 Hämta institution Personal 0 Levererad 3 Sök institution med benämning Personal 0 Levererad 4 Sök institution med engelsk benämning Personal 0 Levererad 5 Hämta högskolor Student 0

9 Matilda Östling, Johan Forssell (49) Krav Nr Deltjänst Målgrupp Prio Status 6 Sök högskola på kod Studenter 0 7 Sök högskola på benämning Studenter 0 8 Sök högskola på engelsk benämning Studenter 0 9 Sök person på del av personnummer Personal 0 10 Hämta innevarande termin Studenter,Pe rsonal 11 Hämta kurstillfällen Personal, Studenter 12 Hämta kursinformation Personal, Studenter 13 Hämta prov Personal, Studenter 14 Hämta orter Personal Studenter 15 Hämta institutioner Personal, Studenter 16 Sök kurser på institution Personal, Studenter 17 Sök person på del av personnummer eller namn 18 Hämta huvudområde och fördjupning Personal, Studenter Personal, Studenter 19 Hämta provuppsättningsterminer Personal, Studenter 0

10 Matilda Östling, Johan Forssell (49) 2 Hämta namn med kontroller 2.1 Beskrivning Denna deltjänst hämtar för- och efternamn utifrån angivet personnummer samtidigt som kontroller av personnumret görs samt studentens status fastställs. Formatkontroll av personnumret: Längden exakt 10 tecken. Samtliga positioner utom sjunde ska innehålla en siffra. Kontrollerar att sex första positionerna är ett giltigt datum. Kontrollsiffran (sista siffran) kontrolleras med hjälp av checksumma. Status av studenten: Kontrollerar om studenten har bytt personnummer. Kontrollerar om studenten är individuellt gallrad. Kontrollerar om studenten är gallrad. Kontrollerar om studenten är avliden Flödesbeskrivning Exempel på hur flödet kan se ut i hjälptjänsten hämta_namn: 1. Studenten/läraren väljer tjänsten i högskolans portal 2. Portalen anropar hjälptjänsten hämta_namn. 3. Om portalanvändaren är en student personnumret kontrolleras och status hämtas vartefter resultatet visas av portalen. Om portalanvändaren är en lärare - läraren får ange ett personnummer som sedan kontrolleras. Status och namn på studenten visas sedan av portalen Tabellförändringar Tjänsten innebär inga tabellförandringar. 2.2 Behörighetsanalys Studenten måste vara etablerad i Ladok och kan endast se sin egen information. Läraren måste vara behörig och utföra uppslagningar om olika studenter.

11 Matilda Östling, Johan Forssell (49) 2.3 Tabeller som används av tjänsten För att se vilka tabeller som tjänsten använder sig av se dokument Tabellsäkerhet.doc, Kravlista Beskrivning Tabell Prio 1 2 Kontrollera att personnumret är korrekt. 0 Kontrollera om personen bytt personnummer GAMMALNY Kontrollera om personen är individuellt gallrad Kontrollera om personen är gallrad (samt hämta namn) Hämta namn samt kontrollera om personen är avliden IGALLRAD 0 GALLRAD 0 NAMN 0 Samtliga krav är utvecklade. 2.4 Exponerade metoder UtilityNamnVO findnamebypnr(uservo uvo, UtilityNamnVO unamnvo) 2.5 Indata Värdeobjekt Data Kontroll Kommentar UserVO uvo Se dokumentet generell indata UtilityNamnVO unamnvo Kontroll av pnr Personnumret i UtilityNamnVO måste sättas av portalen.

12 Matilda Östling, Johan Forssell (49) Kontroller 1. Formatkontroll, exakt 10 tecken. 2. Alla tecken siffror, utom eventuellt på sjunde position. 3. Första sex positionerna ett korrekt datum. 4. Kontrollsiffran (sista siffran) korrekt. 2.6 Utdata Värdeobjekt Data Format Kommentar UtilityNamnVO valid messages Information tillhörande studenten. True/False Om denna är falsk finns det felmeddelanden i messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc pnr C(10) Innehåller det pnr som skickats in i tjänsten. Om personen bytt pnr innehåller denna parameter det nya pnr:et. tnamn C(25) Förnamnet. enamn C(25) Efternamnet. hasnewpnr Boolsk Personen har bytt personnummer. igallrad Boolsk Personen är individuellt gallrad. gallrad Boolsk Personen är gallrad. igallraddatum C(10) gallraddatum C(10) 2.7 Felhantering Datumet för individuell gallring. Datumet för gallring. inladok Boolsk Personen finns i LADOK:s namntabell. avliden Boolsk Personen är avliden. Om det angivna personnumret som inparameter inte är korrekt sätts valid till false och ett meddelande finns i Message. Detta inträffar om personnumret har fel format eller inte är logiskt korrekt. Felmeddelandet sätts i UtilityNamnVO som returneras. För information om felmeddelandena se Message.doc

13 Matilda Östling, Johan Forssell (49) 3 Hämta institution 3.1 Syfte I denna tjänst hämtas en institution givet en institutionskod. 3.2 Beskrivning Tjänsten hämtar benämning, gatuadress, postnummer, ort, telefon samt engelsk benämning givet en institutionskod. Följande kontroller görs på koden Ej null Ej blank Ej längre än 4 tecken Inställningar Inga. 3.3 Kravlista Hämta all information om institutionen från tabellen INST 3.4 Indata UtilityInstitutionVO Parameter Format Kontroll Tvättning Kod C(4) Ej null, ej blank, maxlängd Utdata UtilityInstitutionVO Parameter Format Kommentar Kod C(4) Innehåller den institutionskod som är unik för varje institution. Benamn C(40) Institutionens benämning Gatadr C(30) Institutionens gatuadress Postnr C(6) Institutionens postnummer

14 Matilda Östling, Johan Forssell (49) Ort C(24) Institutionens ort Telefon C(12) Institutionens telefon Benamne C(40) Institutionens engelska namn valid boolsk Om denna är false finns felmeddelande i messages Messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc Felhantering Konstant utility.institutionnotfound Nivå Kommentar Error Institutionen kunde inte hittas. Det kan även förekomma generella felmeddelanden från t ex validering och autenticering. Se dokumentet Message.doc för information om dessa.

15 Matilda Östling, Johan Forssell (49) 4 Sök institution med del av institutionskod 4.1 Syfte I denna tjänst hämtas en eller flera institutioner givet del av institutionskod. 4.2 Beskrivning Tjänsten hämtar benämning, gatuadress, postnummer, ort, telefon samt engelsk benämning givet institutionskod eller del av institutionskod. Angiven delkod används som start på det sökord som slår i databasen. Delkod 35 kommer t.ex. att hitta instutionskod 350. En array av träffar returneras. Följande kontroller görs på koden Ej null Ej blank Ej längre än 4 tecken Inställningar Inga. 4.3 Kravlista Hämta all information om institutionen från tabellen INST 4.4 Indata UtilityInstitutionVO Parameter Format Kontroll Tvättning Kod C(4) Ej null, ej blank, maxlängd Utdata UtilityInstitutionVO[] Parameter Format Kommentar Kod C(4) Innehåller den institutionskod som är unik för varje institution. Benamn C(40) Institutionens benämning

16 Matilda Östling, Johan Forssell (49) Gatadr C(30) Institutionens gatuadress Postnr C(6) Institutionens postnummer Ort C(24) Institutionens ort Telefon C(12) Institutionens telefon Benamne C(40) Institutionens engelska namn valid boolsk Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc Felhantering Konstant utility.institutionnotfound Nivå Kommentar Error Institutionen kunde inte hittas. Det kan även förekomma generella felmeddelanden från t ex validering och autenticering. Se dokumentet Message.doc för information om dessa.

17 Matilda Östling, Johan Forssell (49) 5 Sök institution med benämning 5.1 Syfte I denna tjänst söks institutioner fram på dess svenska benämning 5.2 Beskrivning Tjänsten hämtar benämning, gatuadress, postnummer, ort, telefon samt engelsk benämning givet en sträng som matchas mot institutionernas svenska benämning. En array av träffar returneras Inställningar Inga. 5.3 Kravlista Krav 1 Sök institutioner Sök institutioner från INST givet en söksträng som matchas benamn 5.4 Indata UtilityInstitutionVO Parameter Format Kontroll Tvättning Benamn C(40) Utdata UtilityInstitutionVO[] Parameter Format Kommentar Kod C(4) Innehåller den institutionskod som är unik för varje institution. Benamn C(40) Institutionens benämning Gatadr C(30) Institutionens gatuadress Postnr C(6) Institutionens postnummer

18 Matilda Östling, Johan Forssell (49) Ort C(24) Institutionens ort Telefon C(12) Institutionens telefon Benamne C(40) Institutionens engelska namn valid boolsk Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc Felhantering Konstant utility.institutionnotfound Nivå Kommentar Error Institutionen kunde inte hittas. Det kan även förekomma generella felmeddelanden från t ex validering och autenticering. Se dokumentet Message.doc för information om dessa. 6 Sök institution med engelsk benämning 6.1 Syfte I denna tjänst söks institutioner fram på dess engelska benämning 6.2 Beskrivning Tjänsten hämtar benämning, gatuadress, postnummer, ort, telefon samt engelsk benämning givet en sträng som matchas mot institutionernas engelska benämning. En array av träffar returneras Inställningar Inga Sorteringsordning Inga. 6.3 Kravlista Krav 1 Sök institutioner Sök institutioner från INST givet en söksträng som matchar benamne

19 Matilda Östling, Johan Forssell (49) 6.4 Indata UtilityInstitutionVO select * from INST where upper(benamne) like upper( %pharmacy% ); Parameter Format Kontroll Tvättning Benamne C(40) Utdata UtilityInstitutionVO[] Parameter Format Kommentar Kod C(4) Innehåller den institutionskod som är unik för varje institution. Benamn C(40) Institutionens benämning Gatadr C(30) Institutionens gatuadress Postnr C(6) Institutionens postnummer Ort C(24) Institutionens ort Telefon C(12) Institutionens telefon Benamne C(40) Institutionens engelska namn valid boolsk Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc Felhantering Konstant utility.institutionnotfound Nivå Kommentar Error Institutionen kunde inte hittas. Det kan även förekomma generella felmeddelanden från t ex validering och autenticering. Se dokumentet Message.doc för information om dessa.

20 Matilda Östling, Johan Forssell (49) 7 Hämta högskolor 7.1 Syfte I denna tjänst hämtas uppgifter om högskolor. 7.2 Beskrivning Tjänsten hämtar kod, benämning och engelsk benämning på högskolor från tabellen ALLAHSK. Det är möjligt att söka på kod, benämning eller engelsk benämning. En array av träffar returneras Sorteringsordning Sorteringsordningen sker på de termer som angivits i sökningen. Anges flera termer sorteras resultaten efter kod. Anges inga termer sorteras resultatet efter benämning. 7.3 Metoder /** * Hämtar högskolor från ALLAHSK. uvo För autentisering och auktorisering search_terms Fyll i kod, benämning eller engelsk benämning. * Det är möjligt att söka med flera termer samtidigt. Lista med högskolor. */ public UtilityHskVO[] findhsk(uservo uvo, UtilityHskVO search_terms) 7.4 Kravlista Tjänsten beskrivs av följande krav Krav 1 Hämta högskolor Hämta alla högskolor från ALLAHSK sorterade på benämning Krav 2 Sök högskolor efter kod Hämta vissa högskolor begränsade på kod, sorterade på kod. Det går bra att ange del av kod, och den är inte skiftlägeskänslig Krav 3 Sök högskolor efter benämning Hämta vissa högskolor från ALLAHSK sorterade på benämning. Det går bra att ange del av benämning, och den är inte skiftlägeskänslig.

21 Matilda Östling, Johan Forssell (49) Krav 4 Sök högskolor efter engelsk benämning Hämta vissa högskolor från ALLAHSK sorterade på engelsk benämning. Det går bra att ange del av benämning och den är inte skiftlägeskänslig. 7.5 Indata UtilityHskVO Parameter Format Kontroll Tvättning kod C(3) 1-3 tecken benamn C(45) Högskolans benämning benamne C(60) Högskolans engelska benämning 1. Det går att söka på del av kod, del av benämning och del av engelsk benämning. 2. Om mindre än 3 tecken anges för koden så kommer angivna tecken att matchas mot början av koden. 3. Inga söktermer är skiftlägeskänsliga. 4. Om inga parametrar sätts så kommer alla poster från ALLAHSK att returneras. a. Om kod är satt så kommer endast matchning mot kod att ske. b. Om benamn är satt (men inte kod) så kommer matchning mot benamn att ske. c. Om benamne är satt (men varken kod eller benamn) så kommer matchning mot benamne att ske. 7.6 Utdata UtilityHskVO[] Parameter Format Kommentar kod C(3) Kod unik för varje högskola benamn C(45) Högskolans benämning benamne C(60) Högskolans engelska namn valid boolsk Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc

22 Matilda Östling, Johan Forssell (49) Felhantering Konstant utility.allahskempty Nivå Kommentar Fatal Ingen data hittades i ALLAHSK. Det kan även förekomma generella felmeddelanden från t ex validering och autenticering. Se dokumentet Message.doc för information om dessa. 8 Sök person på del av personnummer 8.1 Syfte I denna tjänst kan personal söka student på delvis känt personnummer. 8.2 Beskrivning Denna deltjänst hämtar personnummer samt för- och efternamn utifrån angiven del av personnummer samtidigt som kontroller av indata görs samt studenternas status fastställs. Formatkontroll av personnumret: Längden skall max vara 10 tecken utöver bindestreck. Samtliga positioner utom eventuellt sjunde ska innehålla en siffra. Sjunde positionen skall innehålla en siffra eller bokstaven T. Tillåter ett (1) bindestreck, i.e. ÅÅMMDD-XXXX Kontrollsiffran (sista siffran) kontrolleras med hjälp av checksumma. Status av studenten: Kontrollerar om studenten har bytt personnummer. Kontrollerar om studenten är individuellt gallrad. Kontrollerar om studenten är gallrad. Kontrollerar om studenten är avliden.

23 Matilda Östling, Johan Forssell (49) Flödesbeskrivning Exempel på hur flödet kan se ut i hjälptjänsten Sök person på del av personnummer : 1. Studenten/läraren väljer tjänsten i högskolans portal 2. Portalen anropar hjälptjänsten Sök person på del av personnummer. 3. Om portalanvändaren är en student neka åtkomst till tjänsten Om portalanvändaren är en lärare - läraren får ange början av ett personnummer som sedan kontrolleras. En lista av namn på matchande studenter visas sedan av portalen Tabellförändringar Tjänsten innebär inga tabellförändringar. 8.3 Metoder /** * Hämtar information om de studenter vars personnummer matchar söksträngen * i UtilityNamnVO uservo För autentisering och auktorisering unamnvo Innehåller söksträng som personnummer Lista med matchande studenter. */ public UtilityNamnListVO getnamebypartpnr(uservo uservo, UtilityNamnVO unamnvo) 8.4 Behörighetsanalys Läraren måste vara behörig och utföra uppslagningar om olika studenter. 8.5 Kravlista Tjänsten beskrivs av följande krav Krav 1 Kontrollera att användaren har rätt behörighet Endast personal får använda söktjänsten Krav 2 - Kontrollera att personnumret är korrekt Sökning genomförs endast om träffar kan existera Krav 3 Sök studenter baserade på personnumret Hämta de studenter från NAMN vars personnummer matchar söksträngen.

24 Matilda Östling, Johan Forssell (49) 8.6 Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata UtilityNamnVO unamnvo Kontroll av pnr Personnumret i UtilityNamnVO måste sättas av portalen Kontroller 5. Formatkontroll, det skall max vara 10 tecken utöver bindestreck. 6. Alla tecken är siffror, utom eventuellt på sjunde position. 7. Sjunde positionen skall innehålla en siffra eller bokstaven T. 8. Tillåter ett (1) bindestreck, i.e. ÅÅMMDD-XXXX 9. Kontrollsiffran (sista siffran) är korrekt. 8.7 Utdata Värdeobjekt Data Format Kommentar UtilityNamnListVO Information tillhörande studenter valid True/False Om denna är falsk finns det felmeddelanden i messages messages Message[] names Felhantering Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc UtilityNamnVO[] En array med information om de studenter som matchar söksträngen Om det angivna personnumret som inparameter inte är korrekt sätts valid till false och ett meddelande finns i Message. Detta inträffar om personnumret har fel format eller inte är logiskt korrekt. Felmeddelandet sätts i UtilityNamnListVO som returneras. För information om felmeddelandena se Message.doc

25 Matilda Östling, Johan Forssell (49) 9 Hämta innevarande termin 9.1 Syfte I denna deltjänst visas innevarande termin och terminen som kommer efter innevarande termin samt start- och slutdatum för undervisning för dessa. Den termin som studenten väljer används sedan som indata till nästa steg. 9.2 Beskrivning Systemet läser upp/räknar fram o Innevarande termin samt dess start- och slutdatum för undervisning o Terminen efter innevarande samt dess start- och slutdatum för undervisning Den termin som studenten väljer används av systemet i nästa deltjänst för att hämta förslag på termins- och kursregistreringar. I normala fall rör det sig om innevarande termin. 9.3 Kravlista Krav Nr Beskrivning Tabell/Vy Prio 1. Visa innevarande termin samt räkna ut nästkommande termin EGENHSK 0 Alla krav är utvecklade. 9.4 Exponerade metoder getcurrandnextsemester (UserVO uvo) 9.5 Indata Värdeobjekt Data Format Kontroll Kommentar UserVO uvo Se dokumentet Generell indata 9.6 Utdata Utdata utgörs av innevarande och nästkommande termin samt deras start- och stopdatum för undervisning som är satta i värdeobjektet UtilitySemesterVO

26 Matilda Östling, Johan Forssell (49) Värdeobjekt Data Format Kontroll Kommentar UtilitySemest ervo currentsemester C(3) TÅÅ - Innevarande termin currentsemesterundervisn ingfrom currentsemesterundervisn ingtom ÅÅÅÅ-MM-DD - ÅÅÅÅ-MM-DD - nextsemester C(3) TÅÅ - nextsemesterundervisning ÅÅÅÅ-MM-DD From nextsemesterundervisning Tom ÅÅÅÅ-MM-DD Innevarande termin, startdatum för undervisning Innevarande termin, slutdatum för undervisning Kommande termin, startdatum för undervisning Kommande termin, slutdatum för undervisning valid Boolsk Om denna är falsk finns det felmeddelanden i messages messages Message[] - Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message 9.7 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc.

27 Matilda Östling, Johan Forssell (49) 10 Hämta kurstillfällen 10.1 Syfte Denna tjänst är till för att hämta alla tillfällen en kurs går givet kursens kurskod Beskrivning Systemet slår upp informationen från databasen samt returnerar en sorterad lista med det äldsta kurstillfället sist Flödesbeskrivning Exempel på hur flödet kan se ut i hjälptjänsten Hämta kurstillfällen : 1. Studenten/läraren väljer tjänsten i högskolans portal 2. Portalen anropar hjälptjänsten Hämta kurstillfällen. 3. Studenten/Läraren anger en exakt kurskod. 4. En lista av tillfällen som kursen ges visas sedan av portalen Tabellförändringar Tjänsten innebär inga tabellförändringar Metoder /** * Listar tillfällen som kursen "kurskod" går, data läses från KTILL2 andreas.hed uservo kurskod kurskod en lista av tillfällen kursen går/har gått */ public UtilityKursTillFListVO getkurstillfbykod(uservo uservo,string kurskod) 10.4 Behörighetsanalys Giltig student eller lärare räcker Kravlista Krav Nr Beskrivning Tabell/Vy Prio 1. Hämta alla tillfällen då kursen går KTILL2

28 Matilda Östling, Johan Forssell (49) 10.6 Exponerade metoder getkurstillfbykod (UserVO uvo, String kurskod) 10.7 Indata Värdeobjekt Data Format Kontroll Kommentar UserVO Se dokumentet Generell indata String kurskod C(6) KursKod.check() Kurskod 10.8 Utdata Utdata utgörs av en lista på kurstillfällen för den angivna kursen eller en tom lista om kursen ej finns. Värdeobjekt Data Format Kontroll Kommentar UtilityKursTillFListVO callstatusimpl CallStatus - Medelandehantering ktfl List<UtilityKurs TillFVO> UtilityKursTillFVO kurskod C(6) - - En lista av kurstillfällen startter C(5) ÅÅÅÅT - Tillfälle kursen ges kurstakt C(3) - kurstid C(3) - undform C(3) - ort C(4) - kursomg C(1) - kurstyp C(3) - ffgpoang DEC(3.1) - kod C(5) - startv C(6) - slutv C(6) - dep1 DEC(3.1) - dep2 DEC(3.1) - lok1 DEC(3.1) - lok2 DEC(3.1) - plantal Int(4) - antalord Int(4) - antalres Int(4) valuta C(1)

29 Matilda Östling, Johan Forssell (49) konvert C(1) 10.9 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc.

30 Matilda Östling, Johan Forssell (49) 11 Hämta kursinformation 11.1 Syfte Denna tjänst är till för att hämta all information om en kurs givet kursens kurskod Beskrivning Systemet slår upp informationen från databasen Flödesbeskrivning Exempel på hur flödet kan se ut i hjälptjänsten Hämta kursinformation : 1. Studenten/läraren väljer tjänsten i högskolans portal 2. Portalen anropar hjälptjänsten Hämta kursinformation. 3. Studenten/Läraren anger en exakt kurskod. 4. Informationen för kursen visas sedan av portalen Tabellförändringar Tjänsten innebär inga tabellförändringar Metoder /** * Hämtar data rörande en kurs givet en kurskod andreas.hed uservo kurskod kurskod en UtilityKursVO innehållande information om kursen */ public UtilityKursVO getkursbykod(uservo uservo,string kurskod) 11.4 Behörighetsanalys Giltig student eller lärare räcker Kravlista Krav Nr Beskrivning Tabell/Vy Prio 1. Hämta information om kursen KURS Alla krav är utvecklade.

31 Matilda Östling, Johan Forssell (49) 11.6 Exponerade metoder getkursbykod (UserVO uvo, String kurskod) 11.7 Indata Värdeobjekt Data Format Kontroll Kommentar UserVO uvo Se dokumentet Generell indata String kurskod C(6) KursKod.check() Kurskod C(6) 11.8 Utdata Utdata utgörs av en mappning av informationen från aktuell tabell KURS, metoden returnerar NULL om kursen inte finns. Värdeobjekt Data Format Kontroll Kommentar UtilityKursVO kod C(6) benamns C(120) benamne C(120) poang DEC(4.1) inst C(4) bskala C(2) lkurs C(1) ekurs C(1) kagrpscb C(3) knivauha C(1) friv C(1) nedlagd C(1) djup C(1) examin C(1) ectsp DEC(4.1) idatum C(10) ianv C(6) utbniva C(1) valuta C(1) urspoang DEC(4.1) konvert C(1) isvalid Boolean FALSE=ingen träff i DB CallStatus callstatusimpl Message hantering

32 Matilda Östling, Johan Forssell (49) 11.9 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc. 12 Hämta prov 12.1 Syfte I denna tjänst hämtas prov tillhörande en kurs givet kurskod Beskrivning Tjänsten hämtar lista med prov givet en kurskod Inställningar Inga Metoder /** * Hämtar prov tillhörande kurs * eikaon02 uservo kurskod en {@link UtilityProvVO} innehållande tillhörande prov till kursen */ public UtilityProvVO getprovbykurskod(uservo uservo, String kurskod); 12.3 Kravlista Hämta prov från tabellen PROV Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata String kurskod Kod för kursen.

33 Matilda Östling, Johan Forssell (49) 12.5 Utdata Värdeobjekt Data Format Kommentar UtilityProvVO valid Omslutande värdeobjekt för lista med ProvVO True/False Om denna är falsk finns det felmeddelanden i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc Names ProvVO[] En array med de prov som matchar kurskoden ProvVO är en mappning av information från tabellen PROV. Värdeobjekt Data Format Kommentar ProvVO kurs C(6) Kurskod prov C(4) Provkod benamn C(60) Benämning på provet benamne C(60) Engelsk benämning bskala C(2) Betygskala endaprov C(1) Godkänt prov=godkänd kurs projarb C(1) Projektarbete inst C(4) Ansvarig inst (om ej samma som kursansv) idatum C(10) Senaste ändringsdatum ianv C(6) Användarkod ectsp DEC(4.1) ECTS-credit poang DEC(4.1) Poäng på provet 12.6 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc.

34 Matilda Östling, Johan Forssell (49) 13 Hämta Ort 13.1 Syfte I denna tjänst hämtas alla ej nedlagda orter från tabellen ORT Beskrivning I denna tjänst hämtas alla ej nedlagda orter från tabellen ORT Inställningar Inga Metoder /** * Hämtar data rörande orter i systemet. * maud0002 * uservo Användaren som utför anropet. En {@link UtilityOrtVO}[] innehållande alla Orter * */ public UtilityOrtVO[] findallplaces(uservo uservo); 13.3 Kravlista 13.4 Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata 13.5 Utdata Värdeobjekt Data Format Kommentar UtilityOrtVO[] valid True/False Om denna är falsk finns det felmeddelanden i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc

35 Matilda Östling, Johan Forssell (49) kod benamn Ortskod benämning Om inga poster hittas returneras en Array som är 0 stor Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc. 14 Hämta alla institutioner 14.1 Syfte I denna tjänst hämtas alla institutioner som inte är nedlagda Beskrivning I denna tjänst hämtas alla institutioner som inte är nedlagda Inställningar Inga Metoder /** * Hämtar data rörande institutioner i systemet. * maud0002 * uservo Användaren som utför anropet. En {@link UtilityInstitutionVO}[] innehållande alla Institutioner */ public ladok.lpw.service.utility.vo.utilityinstitutionvo[] findallinstitutions(uservo uservo);

36 Matilda Östling, Johan Forssell (49) 14.3 Kravlista 14.4 Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata 14.5 Utdata UtilityInstitutionVO[] Parameter Format Kommentar Kod C(4) Innehåller den institutionskod som är unik för varje institution. Benamn C(40) Institutionens benämning Gatadr C(30) Institutionens gatuadress Postnr C(6) Institutionens postnummer Ort C(24) Institutionens ort Telefon C(12) Institutionens telefon Benamne C(40) Institutionens engelska namn valid boolsk Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc 14.6 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc.

37 Matilda Östling, Johan Forssell (49) 15 Hämta adressuppgifter 15.1 Syfte I denna tjänst hämtas adress och epostuppgifter för alla personer som skickas in 15.2 Beskrivning I denna tjänst hämtas adress och epostuppgifter för alla personer som skickas in Inställningar Inga Metoder /** * Hämtar Personuppgifter innehållande bland annat address och epost. * uservo Användaren som utför anropet. personids array med personnummer Ett {@link UtilityPersonsVO}} * */ public UtilityPersonsVO fetchadrinfo(uservo uservo, String[] personids) { 15.3 Kravlista 15.4 Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata String[] personids De personnummer man vill hämta data för 15.5 Utdata UtilityPersonsVO Värdeobjekt Data Format Kontroll Kommentar PersonVO[] personvo - - Innehåller personens namn och kontaktuppgifter

38 Matilda Östling, Johan Forssell (49) Värdeobjekt Data Format Kontroll Kommentar PersonVO enamn C(25) - tnamn C(25) - tgatadr C(40) - t... = Tidsbegränsad adress tcoadr C(25) - tpostnr C(12) - tort C(35) - tland C(20) - fgatadr C(40) - f... = Folkbokföringsadress fcoadr C(25) - fpostnr C(12) - fort C(35) - fland C(20) - fromdat tomdat C(10) ÅÅÅÅ- MM-DD C(10) ÅÅÅÅ- MM-DD telnr C(70) - sms C(70) - adr C(70) - - Visar från vilket datum den tidsbegränsade adressen gäller - Visar vilket datum den tidsbegränsade adressen upphör att gälla 15.6 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc.

39 Matilda Östling, Johan Forssell (49) 16 Hämta kurs på institution 16.1 Syfte 16.2 Beskrivning I denna tjänst hämtas kurser som hör till en specifik institution Inställningar Inga Metoder /** * Hämtar alla kurser kopplade till en specifik institution. * uservo inst institution en UtilityKursVO array innehållande information om kurserna. */ public UtilityKursProvVO[] getkursbyinst(uservo uservo, String inst) { 16.3 Kravlista 16.4 Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata String inst Den aktuella institutionen Utdata UtilityKursProvVO Värdeobjekt Data Typ Kommentar UtilityKursProvVO kod String Kurskod benamns String Svensk benämning benamne String Engelsk benämning

40 Matilda Östling, Johan Forssell (49) Värdeobjekt Data Typ Kommentar ProvVo poang BigDecimal Poängomfattning inst String Kursansvarig institution bskala String Betygskala lkurs String Kurs inom program (J/N) ekurs String Fristående kurs (J/N) kagrpscb String SCB-ämnesklass knivauha String Av UHÄ fastställd nivå friv String Frivillig kurs (J/N) nedlagd String Nedlagd kurs (J/blank) djup String Djup examin String Examinator ectsp BigDecimal ectsp-credit idatum String Inläggningsdatum (ÅÅÅÅ-MM-DD) ianv String Användarkod utbniva String Utbildningsnivå valuta String Valuta urspoang BigDecimal Ursprungspoäng konvert String Konverteringsmarkering (J/blank) isvalid Boolean prov ProvVo[] kurs String Kurskod prov String Provkod benamn String Svensk benämning bskala String Betygskala endaprov String Godkänt prov = godkänd kurs (J/N) benamne String Engelsk benämning projarb String Projektarbete (J/blank) inst String Institution idatum String Inläggningsdatum (ÅÅÅÅ-MM-DD) ianv String Användarkod ectsp BigDecimal ectsp-credit

41 Matilda Östling, Johan Forssell (49) Värdeobjekt Data Typ Kommentar poang BigDecimal Poäng urspoang BigDecimal Ursprungspoäng konverterad boolean Konverteringsmarkering 16.6 Tjänstespecifika felmeddelanden Inga tjänstespecifika meddelanden. För generella felmeddelanden se dokumentet Message eller Java Doc.

42 Matilda Östling, Johan Forssell (49) 17 Sök person på del av personnummer eller namn 17.1 Syfte I denna deltjänst kan personal söka studenter eller forskarstudenter på helt eller delvis känt personnummer, tilltalsnamn eller efternamn. Utsökningen kan också begränsas på helt eller delvis känd kurskod, programkod eller institution för studenter, respektive på helt eller delvis känt forskarutbildningsämne för forskarstudenter. Vid utsökningen kontrolleras också studenternas status Beskrivning Denna deltjänst hämtar personers personnummer, tilltalsnamn och efternamn utifrån angivna sökvillkor. För studenter på grund- och avancerad nivå hämtas också: Förstagångsregistreringar på kurs (från tabellen FFGKURS) Förstagångsregistrering inom program (från tabellen ANTLIN). För forskarstudenter hämtas också: Forskarutbildningsämnen (från tabellen FOANT2). Utöver detta hämtas också datum för eventuell gallring eller igallring, samt om personen är avliden Sökning med asterisk Vid utsökning med delvis kända sökord ska en asterisk (*) användas för att representera de okända delarna av sökordet. Exempel: Anges * som Personnummer kommer utsökningen att hitta personer vars personnummer inleds med dessa siffror. Anges *dersso* som Efternamn kommer utsökningen att hitta personer som någonstans i sitt efternamn har denna kombination av bokstäver Flödesbeskrivning Exempel på hur flödet kan se ut i deltjänsten: 1. Personal med behörighet till tjänsten som innefattar utsökning av studenter på grund- eller avancerad nivå eller forskarstudenter väljer denna i högskolans portal.

43 Matilda Östling, Johan Forssell (49) 2. Helt eller delvis känt personnummer, tilltalsnamn eller efternamn måste ange. Sökningen kan ytterligare begränsas genom att ange helt eller delvis känd kurskod, programkod eller institution för studenter, samt helt eller delvis känt forskarutbildningsämne för forskarstudenter. 3. En lista av matchande studenter på grund- och avancerad nivå eller forskarstudenter visas i portalen Tabellförändringar Tjänsten innebär inga tabellförändringar Behörighet Endast personal har behörighet till deltjänsten Exponerade metoder Nedanstående metoder används för att söka studenter på grund- och avancerad nivå respektive forskarstudenter. Studenter på grund- och avancerad nivå UtilityGrundStudentVO[] getgrundstudenterbysearchcriterias(uservo uservo, UtilitySearchCriteriaGrundVO searchcriteriavo) Forskarstudenter UtilityForskarstudentVO[] getforskarstudenterbysearchcriterias(uservo uservo, UtilitySearchCriteriaForskarstudenterVO searchcriteriavo) 17.5 Indata UserVO Värdeobjektet UserVO används för att autentisera användaren av tjänsten. För ytterligare information, se dokumentet Generell In- och Utdata LPW.doc Utsökning av student på grund- och avancerad nivå UtilitySearchCriteriaGrundVO I värdeobjektet UtilitySearchCriteriaGrundVO sätts parametrarna som ska användas vid utsökningen.

44 Matilda Östling, Johan Forssell (49) Minst en av parametrarna pnr, enamn eller tnamn måste innehålla något tecken för att sökningen skall genomföras. Om samtliga av dessa parametrar är tomma kommer ett felmeddelande att genereras och ingen sökning genomförs. Max ett (1) bindestreck får användas i ett helt eller delvis specificerat personnummer. Parameter Datatyp Kommentar pnr String Personnummer eller del av personnummer enamn String Efternamn eller del av efternamn tnamn String Tilltalsnamn eller del av tilltalsnamn kurs String Kurskod eller del av kurskod progr String Programkod eller del av programkod inst String Institutionskod eller del av institutionskod Utsökning av forskarstudent UtilitySearchCriteriaForskarstudenterVO I värdeobjektet UtilitySearchCriteriaForskarstudenterVO sätts parametrarna som ska användas vid utsökningen. Minst en av parametrarna pnr, enamn eller tnamn måste innehålla något tecken för att sökningen skall genomföras. Om samtliga av dessa parametrar är tomma kommer ett felmeddelande att genereras och ingen sökning genomförs. Max ett (1) bindestreck får användas i ett helt eller delvis specificerat personnummer. Parameter Datatyp Kommentar pnr String Personnummer eller del av personnummer enamn String Efternamn eller del av efternamn tnamn String Tilltalsnamn eller del av tilltalsnamn amne String Forskarutbildningsämne eller del av forskarutbildningsämne

45 Matilda Östling, Johan Forssell (49) Begränsa antalet sökträffar Det maximala antalet träffar som returneras vid utsökningen begränsas av MAX_TRÄFFAR i Nouveaus systempreferenser i tabellen SYSTPREF Utdata Metoderna returnerar en array av värdeobjektet UtilityGrundStudentVO vid utsökning av studenter på grund- och avancerad nivå, samt en array av UtilityForskarstudentVO vid utsökning av forskarstudenter. UtilityGrundStudentVO Parameter Datatyp Kommentar pnr String Personnummer enamn String Efternamn tnamn String Tilltalsnamn gallraddatum String Datum för eventuell gallring igallraddatum String Datum för eventuell igallring avliden boolean true om personen är avliden program List<AntlinVO> Förstagångsregistreringar på kurs, sorterade efter termin kurser List<FfgkursVO> Förstagångsregistreringar inom program, sorterade efter termin valid boolean Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumentet Message.doc Värdeobjektet UtilityGrundStudentVO Förutom set- och getmetoder för värdeobjektets parametrar finns metoder för att hämta senaste registrering på kurs eller program: getlatestkurs() och getlatestprogram(). Metoder finns också för att kontrollera om studenten är gallrad eller igallrad: isgallrad() och isigallrad().

46 Matilda Östling, Johan Forssell (49) UtilityForskarstudentVO Parameter Datatyp Kommentar pnr String Personnummer enamn String Efternamn tnamn String Tilltalsnamn gallraddatum String Datum för eventuell gallring igallraddatum String Datum för eventuell igallring avliden boolean Anger om personen är avliden amne List<UtilityFoamneVO> Forskarutbildningsämnen, sorterade efter termin valid boolean Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumentet Message.doc Förutom set- och getmetoder för värdeobjektets parametrar finns en metod för att hämta senaste forskarutbildningsämne: getlatestamne() Metoder finns också för att kontrollera om studenten är gallrad eller igallrad: isgallrad() och isigallrad() Felhantering Om något fel uppstår vid utsökningen sätts valid i returobjektet till false och ett meddelande skapas. Detta kan kontrolleras i ett returnerat värdeobjekt genom att anropa metoderna isvalid() och getmessages() Tjänstespecifika felmeddelanden Tjänstespecifika felmeddelanden genereras om något av följande inträffar: Samtliga av parametrarna pnr, enamn och tnamn är tomma i ett värdeobjekt som används som indata. Ett helt eller delvis angivet personnummer innehåller fler än ett (1) bindestreck. Utsökningen resulterar i fler träffar än vad som angivits som begränsning i Nouveaus systempreferenser (i tabellen SYSTPREF).

47 Matilda Östling, Johan Forssell (49) Konstant utility.too_few_criterias utility.multiple_hyphens utility.too_many_hits Nivå Kommentar Error Sökkriterier saknas. Minst ett av fälten för personnummer och namn måste vara ifyllt. Error Högts ett (1) bindestreck är tillåtet i personnumret. Error För många träffar. Begränsa sökningen ytterligare Generella felmeddelanden För generella felmeddelanden, se dokumentet Messages.doc. 18 Hämta huvudområde och fördjupning 18.1 Syfte I denna tjänst hämtas uppgifter om huvudområde och fördjupning för en given kurskod Beskrivning Tjänsten hämtar kod, benämning och engelsk benämning på huvudområde och fördjupning från tabellen KURSHOMR, HUVUDOMR och FORDJUP för given kurskod. Varje träff läggs i ett värdeobjekt och läggs i en lista Metoder /** * Hämtar huvudområde och fördjupning KURSHOMR, HUVUDOMR och FORDJUP. uvo För autentisering och auktorisering kurskod Ange kurskod för den aktuella kursen. Lista med information om huvudområde och fördjupning. */ public UtilityHuvudomrFordjupningVO[] findkurshomrbykurskod(uservo uvo, String kurskod); 18.4 Indata Värdeobjekt Data Kontroll Kommentar UserVO uservo Se dokumentet generell indata

48 Matilda Östling, Johan Forssell (49) String Kurskod Kurskod för den aktuella kursen Utdata Metoden returnerar en lista av värdeobjektet UtilityHuvudomrFordjupningVO vid utsökning av huvudområde och fördjupning för given kurskod. UtilityHuvudomrFordjupningVO Parameter Typ Kommentar huvudomr String Kod för huvudområdet huvudomrbenamns String Huvudområdets svenska namn huvudomrbenamne String Huvudområdets engelska namn fordjupning String Kod för fördjupning fordjupningbenamns String Fördjupningens svenska namn fordjupningbenamne String Fördjupningens engelska namn valid Boolean Om denna är false finns felmeddelande i messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message.doc Felhantering Det kan förekomma generella felmeddelanden från t ex validering och autenticering. Se dokumentet Message.doc för information om dessa. 19 Hämta provuppsättningsterminer 19.1 Syfte Denna tjänst hämtar provuppsättningsterminer för specificerade prov och sorterar in proven efter funna terminer Beskrivning Tjänsten hämtar terminer från tabellen PROVUPPS med hjälp av provens kurskod och provkod. Proven returneras sedan i listor insorterade efter de funna terminerna.

49 Matilda Östling, Johan Forssell (49) 19.3 Metoder /** * Hämtar specificerade provs provuppsättningsterminer och returnerar proven insorterade efter termin. UserVO uvo För autentisering och auktorisering ProvVO[] tests Lista med ProvVO innehållande kurskod och provkod. ProvBySemesterVO[] Lista med proven insorterade i de provuppsättningsterminer de tillhör. */ public ProvBySemesterVO[] getprovorderedbysemester(uservo uservo, ProvVO[] tests); 19.4 Indata Parameter Typ Kommentar uservo UserVO Se dokumentet generell indata tests ProvVO[] Proven vars provuppsättningsterminer skall eftersökas. Måste minst innehålla kurskod och provkod Utdata Observera att ingen kontroll utförs på indatat. Metoden returnerar en lista av värdeobjektet ProvBySemesterVO där varje objekt innehåller en funnen termin och en lista med de prov (ProvVO) som tillhör denna termin. ProvBySemesterVO Parameter Typ Kommentar termin String Provuppsättningstermin provlist List<ProvVO> Lista med de prov som tillhör ovanstående provuppsättningstermin callstatusimpl CallStatusAsCollection Innehåller statusinformation/felmeddelanden Felhantering Det kan förekomma generella felmeddelanden från t ex validering och autentisering. Se dokumentet Message.doc för information om dessa.