Tjänstespecifikation T33 Resultatrapportering, prov Ladok på webb Ändringshistorik Av Kommentar 2011-08-01 Anders Bergström Leveransversion 2012-02-09 2012-05-28 2012-10-09 2012-12-18 2013-02-14 Anders Bergström Jenny Sandqvist Jenny Sandqvist Jenny Sandqvist Rikard Skelander Mindre korrigeringar efter samtal med HJ Lagt in nya felmeddelanden angående betygsdatumet. Lagt till info om att hela listan tas bort om den klarmarkeras tom. LADOK-13722. Lagt till info om kontroll av terminsregistrering. Lagt till information om hur provdatum kan skickas med vid skapande av lista.
2013-03-07 Rikard Skelander 2013-06-17 2013-09-05 Sara Asplund Rikard Skelander Uppdaterade information om giltighetskontroller för inresande utbytesstudent. Lägger in information om tabellen projtxt2(titel vid projektarbete). La till information om att tabellen PROVTENK påverkas om man lägger till studenter från ett anonymt tillfälle. La till information om de två nya deltjänsterna Visa/söka tentamenstillfälle och Söka tentamensanmälningar. 2015-01-14 Håkan Lindgren Lagt till information om att hämta registrerade studenter från FFGKURS och UBINDRG. Nytt felmeddelande när det ej finns något ledigt ID för provlistan.
Innehållsförteckning 2017-04-27 3 (30) 1 INLEDNING... 5 1.1 SYFTE... 5 1.2 MÅLGRUPPER... 5 1.3 SKILLNADER MOT T06... 5 2 ÖVERSIKT... 6 2.1 BESKRIVNING... 6 2.1.1 Flödesbeskrivning... 6 2.2 BEHÖRIGHETSANALYS... 7 3 VISA LISTOR MÖJLIGA ATT RAPPORTERA PÅ... 8 3.1 SYFTE... 8 3.2 BESKRIVNING... 8 3.3 KONTROLLER... 8 3.4 EXPONERADE METODER... 8 3.5 INDATA... 8 3.5.1 Kontroller... 8 2.5 UTDATA... 9 3.5.2 Tjänstespecifika felmeddelanden... 10 4 VISA EN RAPPORTERINGSLISTA... 11 4.1 SYFTE... 11 4.2 BESKRIVNING... 11 4.3 KONTROLLER... 11 4.4 EXPONERADE METODER... 11 4.5 INDATA... 11 4.5.1 Kontroller... 12 4.6 UTDATA... 12 4.6.1 Tjänstespecifika felmeddelanden... 13 5 SPARA BEARBETAD LISTA... 14 5.1 SYFTE... 14 5.2 BESKRIVNING... 14 5.2.1 Beskrivning av kontroller... 15 5.3 KRAVLISTA... 16 5.3.1 Kontroller... 16 5.4 EXPONERADE METODER... 17 5.5 INDATA... 17 5.5.1 Kontroller... 17 5.6 UTDATA... 18 5.6.1 Tjänstespecifika felmeddelanden... 19 6 SKAPA LISTA... 21 6.1 SYFTE... 21 6.2 BESKRIVNING... 21 6.3 KONTROLLER... 21 6.4 EXPONERADE METODER... 21 6.5 INDATA... 21 6.6 UTDATA... 22 6.6.1 Tjänstespecifika felmeddelanden... 22 7 SKAPA ARKIVLISTA... 23
2017-04-27 4 (30) 7.1 SYFTE... 23 7.2 BESKRIVNING... 23 7.3 KONTROLLER... 23 7.4 EXPONERADE METODER... 23 7.5 INDATA... 23 7.6 UTDATA... 23 7.6.1 Tjänstespecifika felmeddelanden... 24 8 HÄMTA REGISTRERADE STUDENTER... 25 8.1 SYFTE... 25 8.2 BESKRIVNING... 25 8.3 BEHÖRIGHETSANALYS... 25 8.4 EXPONERADE METODER... 25 8.4.1 Hämta terminer... 25 8.4.1.1 Indata... 25 8.4.1.2 Utdata... 25 8.4.2 Hämta studenter... 26 8.4.2.1 Indata... 26 8.4.2.2 Utdata... 26 9 VISA/SÖKA TENTAMENSTILLFÄLLEN... 27 9.1 SYFTE... 27 9.2 BESKRIVNING... 27 9.2.1 Fri sökning... 27 9.2.1.1 Frivilliga begränsningar... 27 9.3 BEHÖRIGHETSANALYS... 27 9.4 INDATA... 28 9.4.1 Kontroller... 28 9.5 EXPONERADE METODER... 28 UTDATA... 28 10 SÖKA TENTAMENSANMÄLNINGAR... 30 10.1 SYFTE... 30 10.2 BESKRIVNING... 30 10.2.1 Fri sökning... 30 10.3 BEHÖRIGHETSANALYS... 30 10.4 INDATA... 30 10.5 EXPONERADE METODER... 30 UTDATA... 30
2017-04-27 5 (30) 1 Inledning 1.1 Syfte Syftet med dokumentet är att beskriva tjänsten T33 för de olika intressegrupperna. 1.2 Målgrupper et vänder sig till tre målgrupper 1. Allmänt intresserade 2. Verksamhetspersonal 3. Utvecklare 1.3 Skillnader mot T06 Tjänsten T33 kommer att ersätta T06 som utgår i och med första leveransen 2012. T33 har ett utökat verksamhetsmässigt innehåll, genom ytterligare två exponerade metoder. Dessa används för att skapa provrapporteringslistor och arkivlistor för utskrift. Den funktionalitet som saknas från T06 är stöd för ECTS-betyg. ECTS är något som ska fasas ut från Ladok.
2017-04-27 6 (30) 2 Översikt Med denna tjänst ska målgruppen lärare/institutionspersonal kunna rapportera provresultat, samt skriva ut en arkivlista för en färdig rapporteringslista. 2.1 Beskrivning Denna tjänst består av sex deltjänster: Krav Nr Beskrivning 1. Visa listor möjliga att rapportera på Målgrupp Lärare/institutionspersonal 2. Visa rapporteringslista Lärare/institutionspersonal 3. Spara bearbetad rapporteringslista Lärare/institutionspersonal 4 Skapa ny lista Lärare/institutionspersonal 5 Skapa arkivlista Lärare/institutionspersonal 6 Visa/söka tentamenstillfällen Lärare/institutionspersonal 7 Söka tentamensanmälningar Lärare/institutionspersonal 2.1.1 Flödesbeskrivning Exempel på flödet i tjänsten: 1. Läraren väljer tjänsten Rapportera provresultat i portalen 2. Portalen skickar in institutionskod till LPW-tjänsten Visa rapporteringslistor (ifall läraren inte använder en institutionssida där institutionskoden är hårdkodad måste institution anges i ett extra steg) 3. Systemet kontrollerar (m h a BKS) att användaren är behörig på institutionen. Alla listor som är öppna för rapportering i PROVHUV hämtas m h a kurskoder (via institutionskod i KURS). 4. Portalen presenterar alla rapporteringsbara listor för institutionen. 5. Användaren väljer en befintlig lista att rapportera på eller väljer att skapa en ny lista med Skapa ny lista. Befintliga listor måste vara öppna för webbrapportering vilket kan ställas in i RS01.
2017-04-27 7 (30) 6. Portalen anropar lpw-tjänsten Visa rapporteringslista (skickar in institutionskod och idnr för listan) 7. Systemet kontrollerar (m h a BKS) att användaren är behörig på institutionen. Listan läses upp från PROVHUV och PROVRAD' 8. Portalen anropar lpw-tjänsten Visa/söka tentamenstillfällen. 9. Portalen presenterar listan på tentamenstillfällen samt rapporteringslistan för läraren 10. Läraren väljer att lägga till studenter från ett tentamenstillfälle på listan. 11. Portalen anropar lpw-tjänsten Söka tentamensanmälda och provlistan uppdateras med studenter som är anmälda på tentamenstillfället. 12. Portalen anropar lpw-tjänsten Spara bearbetad rapporteringslista (skickar in institutionskod och idnr för listan) 13. Läraren för in t ex betyg och skrivningspoäng för personerna i listan och trycker uppdatera. 14. Portalen anropar lpw-tjänsten Spara bearbetad rapporteringslista (skickar in institutionskod och idnr för listan) 15. Systemet kontrollerar (m h a BKS) att användaren är behörig på institutionen. De nya uppgifterna sparas i PROVHUV och PROVRAD 16. För att användaren ska kunna skriva ut en arkivlista måste denne först klarmarkera listan. I och med detta blir listan icke editerbar längre, vilket även markeras med ett K i kolumnen KOMPPROV i PROVHUV. Om listan som klarmarkerat skulle vara tom (sakna personer) tas den bort från tabellen vid klarmarkering. (Ett sätt att städa felaktiga listor.) 2.2 Behörighetsanalys Läraren måste vara behörig på den institution som är ansvarig för provet. Detta gäller alla deltjänster. Tjänsten använder det rollbaserade behörighetssystemet. Användaren måste inneha rollen: Role.Administrator eller Role.Teacher.
3 Visa listor möjliga att rapportera på 3.1 Syfte 2017-04-27 8 (30) Syftet med deltjänsten är att målgruppen lärare ska kunna se vilka rapporteringslistor som är möjliga att rapportera på. 3.2 Beskrivning Deltjänsten hämtar alla listor i PROVHUV där kursen eller provet är märkt på den angivna institutionen (hämtas via KURS och PROV). Dessutom måste listan i PROVHUV vara märkt för webbrapportering (kompprov=j). Listan med listor sorteras på kurskod och provkod. 3.3 Kontroller 1. Behörighetskontroll - institutionskod och användaridentitet. 3.4 Exponerade metoder getresrapphuv(uservo user, ResRappVO rvo) 3.5 Indata Systemet kräver att institutionskod skickas in till tjänsten på grund av behörighetskontrollen. Institutionskoden hämtas från ResRappVO och identiteten hämtas från UserVO. Värdeobjekt Data Format Kontroll Kommentar ResRappVO inst C(4) 1, 2 Instkod (för BKS) 3.5.1 Kontroller 1. Formatkontroll på instkod 2. Instkod obligatorisk uppgift
2.5 Utdata 2017-04-27 9 (30) För uppgifter om rapporteringslistan finns två motsvarande värdeobjekt till tabellerna PROVHUV och PROVRAD. I varje lista, ProvHuvVO[], finns personer, ProvRadVO[]. I detta steg behöver systemet bara läsa upp listhuvudet, d v s PROVHUV. Värdeobjekt Data Format Kontroll Kommentar ResRappVO provhuvuden ProvHuvVO[] inst - Instkod (för BKS) valid Boolsk Om denna är falsk finns det felmeddelanden i Messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message ProvHuvVO[] idnr C(5) kurskod reskod kursbenamn kursbenamne provkod provbenamn provbenamne antal antalbetyg provdatum webbstatus C(6) C(6) C(120) C(120) C(5) C(60) C(60) DEC(4) DEC(4) C(10) ÅÅÅÅ- MM-DD C(1) J/K/bl provrader ProvRadVO[] Tom anonymiserat C(1)J/bl examin C4 Examinatorskod
examinnamn 2017-04-27 10 (30) Examinatorsnamn projarbete boolean Rör listan projektarbete linst String Examinators institution 3.5.2 Tjänstespecifika felmeddelanden För generella felmeddelanden se dokumentet Message och Java Doc. Konstant provrapp.instnotrequiredlength Kommentar Institutionskod innehåller fel antal tecken
4 Visa en rapporteringslista 4.1 Syfte 2017-04-27 11 (30) Syftet med deltjänsten är att läraren ska kunna läsa upp innehållet i en rapporteringslista som tagits fram av institutionssekreteraren i RS01. Denna läsning görs som försteg till Spara bearbetad lista. 4.2 Beskrivning Listan läses upp från PROVHUV och PROVRAD med hjälp av inskickat idnr. Villkor för uppläsningen är att listan är öppen (komprov = J/K) och att användaren är behörig på den aktuella institutionen. Listan med personer sorteras på namn (kolumnen innehåller både efternamn och förnamn). Vid uppläsningen görs inga kontroller, t ex om personerna har registrering och/eller resultat (fältet kommentar i RS01). Det är inte möjligt att använda funktionaliteterna Förvalt betyg och Generellt betygsdatum som finns i RS01. Det är upp till portalen att bestämma vilka av fälten Betyg, Skrivningspoäng och Betygsdatum som ska vara möjliga för användaren att uppdatera (genom att erbjuda inmatningsfält). Systemet läser alltid upp de betyg som är giltiga för provets betygskala. På det viset kan läraren se vilka betyg som är möjliga att lägga in. Läraren får bara bearbeta eller titta på listor som är kopplade till lärarens institution. Eftersom endast en rapporteringslista är aktuell här kan systemet hämta aktuell institution från KURS/PROV istället för i inkommande värdeobjekt. 4.3 Kontroller 1. Behörighetskontroll - Användaren måste vara behörig på den institution som provet/kursen ges på. 4.4 Exponerade metoder getresrapprad(uservo uvo, ResRappVO rvo) 4.5 Indata Värdeobjekt Data Format Kontroll Kommentar ResRappVO provhuvude n ProvHuvV O[] Lista med ett listhuvud. ProvHuvVO idnr C(5) 1, 2
2017-04-27 12 (30) 4.5.1 Kontroller 1. Formatkontroll 2. Obligatorisk uppgift 4.6 Utdata Värdeobjekt Data Format Kontroll Kommentar ResRappVO provhuvuden ProvHuvV O[] betskala BetskalaV O[] - valid Boolsk Om denna är falsk finns det felmeddelanden i Messages messages Message[] Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message ProvHuvVO[] provrader ProvRadV O[] I övrigt som Visa listor som är möjliga att rapportera på ProvRadVO[] pnr C(10) - betyg C(2) - betygsdatum C(10) ÅÅÅÅ- MM-DD namn C(40) - skrpoang C(5) - program C(5) - programinr C(4) - antterm C(3) - - -
2017-04-27 13 (30) BetskalaVO[] anonymkod C(10) Pnr/Namn rensas bort om anonymkod finns. projtitels String Projekttitel svenska projtitele String Projekttitel engelska 4.6.1 Tjänstespecifika felmeddelanden För generella felmeddelanden se dokumentet Message och Java Doc. Konstant provrapp.provhuvudnotvalid Kommentar Listan är inte giltig.
2017-04-27 14 (30) 5 Spara bearbetad lista 5.1 Syfte Syftet med deltjänsten är att målgruppen lärare/institutionspersonal ska kunna spara betyg m.fl. uppgifter i de rapporteringslistor som användaren själv skapat eller institutionssekreteraren arbetar med i RS01. Som försteg till deltjänsten används Visa rapporteringslista vilka ger läraren möjlighet att bearbeta rapporteringslistan. 5.2 Beskrivning Systemet uppdaterar tabellerna PROVHUV och PROVRAD med resultatuppgifter. I deltjänsten är det möjligt för läraren att utföra följande uppgifter: - Uppdatera resultatuppgifter på befintliga personer listan - Lägga till nya personer på listan (inklusive deras resultatuppgifter) - Ta bort befintliga personer från listan Alla krav kan utföras i ett och samma anrop till systemet, d v s när listan sparas. Följande resultatuppgifter kan läggas in för varje person: - Betyg - Skrivningspoäng - Enskilt betygsdatum Dessa värden sparas alltid i den aktuella posten i PROVRAD. Om portalen inte vill erbjuda uppdatering av ett av värdena kan inmatningsfältet dimmas. Portalen får i det läget skicka in det värde som lästs upp i steget innan. Det är också möjligt att lägga till nya personer på listan, d v s nya poster i PROVRAD. Villkor för att studenten ska läggas in är att personen är etablerad och inte finns med på listan sedan tidigare. Systemet uppdaterar i detta läge även idnr, pnr, namn och programinriktning i PROVRAD. Idnr och personnummer skickas in av portalen, namn hämtas från tabellen NAMN Personer kan även markeras så att de tas bort från PROVRAD. För säkerhetskull kontrollerar systemet även personer som lagts till temporärt på listan och som ska läggas in i PROVRAD. Att ta bort personer som temporärt lagts till på listan är funktionalitet som enkelt kan erbjudas av portalen. Detta innebär vidare att institutionssekreteraren inte nödvändigtvis behöver spara om listan i RS01. Förutom PROVRAD uppdaterar systemet kolumnerna antbetyg (antal betyg i listan), aktdatum (senaste ändringsdatum) och kompprov (listans status) i PROVHUV. Uppgifterna antbetyg och aktdatum tar systemet fram medan kompprov skickas in av portalen. När ett prov är av typen projektarbete kan projektitel skickas med och sparas då i PROJTXT2. Läraren kan m a o ändra listans status, från öppen (J) till klar (K) men inte tvärtom.
2017-04-27 15 (30) Läraren får bara spara listor som är kopplade till lärarens institution. Liksom i deltjänsten Visa en rapporteringslista är bara en lista aktuell här vilket innebär att systemet kan hämta institutionskoden från KURS/PROV istället för att den skickas in från portalen. Om man populerar provlistan automatiskt från ett tentamenstillfälle och det tillfället är anonymt skapas en post i tabellen PROVTENK som kopplar provhuvudet till tentamenstillfället. 5.2.1 Beskrivning av kontroller Sammanfattning av kontroller och den ordning de utförs i: Formatkontroller och tvättning ( ytliga kontroller av indata) - Personnummer är obligatoriskt (vid anonyma tentamen används anonymkod) - Idnr är obligatoriskt - Betygsdatum är obligatoriskt - Skrivningspoäng får inte anges om betyg saknas - Fältlängd för varje parameter får inte vara längre än antal positioner i databaskolumnen - Betyg sparas alltid med versaler - Webbstatus är obligatorisk - Webbstatus kan bara ha värden J/K Giltighetskontroller (kontroller sker med hjälp av databasen) - Studenten måste finnas i NAMN. - Studenten måste ha en registrering på kursen i FFGKURS (UBINDRG för inresande utbytesstudent). - Om kursen ingår i ett program med terminsregistrering måste studenten ha en giltig registrering i FFGLIN eller OMREGLIN, alternativt ett täckande uppehåll i UPPHLIN eller ett avbrott på programmet före provdatumet (AVBRLIN). - Nya studenter får inte ha ett godkänt resultat på provet. - Studenten kontrolleras så de inte har en avstängning som löper under betygsdatum. - Betyget måste vara giltigt, d v s betyget måste finnas i provets betygsskala i BETSKALA - Betygsdatum måste vara giltigt, d v s det får inte ligga före startdatumet för personens första registreringstermin (FFGKURS) eller efter dagens datum. - Om tentamen är anonym får man inte ändra betygsdatum. Undantag: Om raden markerats för borttagning så kontrolleras bara att idnr och personnummer är angivna. De utgör obligatoriska indata vid borttagning.
2017-04-27 16 (30) Om användaren fastnar i någon kontroll kommer hela uppdateringen att stoppas/rullas tillbaka. Meddelande om vad som gick fel skickas ut till portalen. 5.3 Kravlista Krav Nr Beskrivning 1. Spara bearbetad rapporteringslista 1.1 Spara betyg, skrivningspoäng och betygsdatum för befintliga personer på listan 1.2 Spara betyg, skrivningspoäng, betygsdatum samt andra, obligatoriska, uppgifter för nya personer på listan 1.3 Ta bort personer från listan 1.4 Spara antal, antal betyg och senaste ändringsdatum Kontroll 1 3, 4,5, 8 2, 3, 4, 5, 6, 7 5.3.1 Kontroller 1. Behörighetskontroll se tidigare deltjänster. 2. Personnummer måste finnas i NAMN (gäller både vid nyinläggning och när man sparar påbörjad lista). 3. Betyget måste vara giltigt, d v s betyget måste finnas i provets betygsskala (detta gäller förstås inte om posten ska tas bort, d v s parametern innehåller ett streck). 4. Nya studenter får inte ha en avstängning som löper under betygsdatumet. (gäller både vid nyinläggning och när man sparar påbörjad lista). 5. Nya studenter måste ha en registrering på kursen i FFGKURS. 6. Nya studenter får inte ha ett godkänt resultat på provet. 7. Om tentamen är anonym får man inte ändra betygsdatum.
2017-04-27 17 (30) 5.4 Exponerade metoder updateresrapp(uservo uvo, ResRappVO rvo) 5.5 Indata Värdeobjekt Data Format Kontroll Kommentar ResRappVO tentillfidnr C(7) Tentamenstillfällets id provhuvuden ProvHuvV O[] - ProvHuvVO[] idnr C(5) 1, 2 Listans id. webbstatus C(1) 1, 2 Indikerar om listan är öppen för webbuppdatering. provrader ProvRadV O[] ProvRadVO[] ny C(1) J/bl 1 Indikerar att posten är ny i listan och skall läggas till. pnr C(10) 1, 2 betyg C(2) 1, 5 betygsdatum C(10) ÅÅÅÅ- MM-DD 1, 2, 3 skrpoang C(5) 1, 4 markedforrem oval anonymkod boolean C(10) Sätt till true om raden ska raderas. projtitels String Projekttitel svenska projtitele String Projekttitel engelska 5.5.1 Kontroller 1. Formatkontroll (webbstatus kan vara i format J/K/bl) 2. Obligatorisk uppgift (vid inläggning, uppdatering och borttagning)
3. Får inte anges om betyg saknas 4. Sparas med versaler i databasen (tvättas om gemener) 5.6 Utdata ResRappVO En bekräftelse på att uppdatering/inläggningen/borttagning gått bra. 2017-04-27 18 (30) Värdeobjekt Data Format Kontroll Kommentar ResRappVO provhuvuden ProvHuvV O[] - valid Boolsk Om denna är falsk finns det felmeddelanden i Messages messages Message Se tjänstespecifika felmeddelanden, samt dokumenten Generell indata och Message ProvHuvVO[] idnr C(5) Listans id. webstatus C(1) Indikerar om listan är öppen för webbuppdatering. provrader ProRradV O[] examin C(4) Examinatorskod ProvRadVO[] ny C(1) J/bl Indikerar att posten är ny i listan och skall läggas till. pnr betyg betygsdatum skrpoang C(10) C(2) C(10) ÅÅÅÅ- MM-DD C(5) valid boolean Sätt till false om ett fel upptäcks på raden messages Message Eventuellt felmeddelande anonymkod C(10)
2017-04-27 19 (30) projtitels String Projekttitel svenska projtitele String Projekttitel engelska 5.6.1 Tjänstespecifika felmeddelanden För generella felmeddelanden se dokumentet Message och Java Doc. För felmeddelanden där personnummer inkluderas byts dessa ut mot anonymkod om tentamen är anonymiserad. Konstant (felmeddelanden vid formatkontrollen) provrapp.provhuvudnotvalid provrapp.webstatusnotvalid provrapp.pnrnotrequiredlength provrapp.pnrcontainsinvalidcharacters provrapp.listcotainserrors provrapp.datenotvalid provrapp.datetooearly provrapp.futuredate provrapp.datemissing provrapp.gradenotvalid provrapp.skrpoangnotvalid provrapp.skrpoang.dependsongrade Kommentar Listan är inte giltig. Webbrapporteringstatus är inte giltig (J/K) Personnummer innehåller fel antal tecken Personnummer innehåller felaktiga tecken Listan {0} kunde inte uppdateras. Den inneh\u00e5ller felaktiga poster. Betygsdatumet har fel format. Betygsdatumet kan inte ligga före startdatum för personens första registreringstermin. Betygsdatumet kan inte vara efter dagens datum. saknas. Betyget är inte giltig Skrivningspoäng är inte giltig Skr får inte anges om inte betyg är angivet (felmeddelanden vid uppdateringen) provrapp.isanonymous provrapp.removefailed provrapp.gradenotvalid Betygsdatum kan inte ändras. Studentens tentamen är anonym. Borttagning av person på listan misslyckades. Hela transaktionen rullas tillbaka. Det personnummer som misslyckades finns i parametern values i message. Betyget ingår inte i provets betygsskala. Hela transaktionen rullas tillbaka. Det personnummer som misslyckades finns i parametern values i message. provrapp.addfailed Inläggning av en person misslyckades. Hela transaktionen rullas tillbaka. Det personnummer som misslyckades finns i parametern values i message.
2017-04-27 20 (30) Konstant provrapp.updatefailed provrapp.namenotfound provrapp.student.is.suspended provrapp.studentnotregistered provrapp.studentalreadypassed provrapp.hasnewpnr provrapp.studentalreadyinlist provrapp.nosemesterregistration Kommentar Uppdateringen av en person misslyckades. Hela transaktionen rullas tillbaka. Det personnummer som misslyckades finns i parametern values i message. Personen finns inte i tabellen NAMN. Hela transaktionen rullas tillbaka. Det personnummer som misslyckades finns i parametern values i message. Studenten är avstängd under betygsdatumet. Studenten har ingen registrering på kursen. Studenten har redan godkänt resultat på provet. Studenten har lagts till med nytt personnummer. Studenten finns redan i listan. Studenten har ingen terminsregistrering.
2017-04-27 21 (30) 6 Skapa lista 6.1 Syfte Syftet med deltjänsten är att målgruppen lärare/institutionspersonal ska kunna skapa en ny provrapporteringslista. 6.2 Beskrivning En ny lista kan skapas för en viss kombination av kurskod och provkod samt provdatum eller en resultatkod samt provdatum. Tjänsten skapar en ny post i PROVHUV. 6.3 Kontroller 1. Behörighetskontroll - institutionskod och användaridentitet. 6.4 Exponerade metoder createresrapphuv(uservo user, ResRappVO rvo) 6.5 Indata Systemet kräver att institutionskod skickas in till tjänsten p g a behörighetskontrollen. Identiteten hämtas från UserVO. ResRappVO inst String Institutionskod provhuvude n List<ProvHuvV O> Kurskod, provkod eller resultatkod på första elementet i listan. Om provdatum är valt skickas det också med. valid Boolsk Om denna är falsk finns det felmeddelanden på ERROR eller FATAL nivå i messages messages List<Messages> Se funktionsspecifika felmeddelanden, samt dokumenten Generell indata och Message
6.6 Utdata 2017-04-27 22 (30) ResRappVO inst String Institutionskod provhuvude List<ProvHuvV Ett tomt listhuvud med idnr. n O> valid Boolsk Om denna är falsk finns det felmeddelanden på ERROR eller FATAL nivå i messages messages List<Messages> Se funktionsspecifika felmeddelanden, samt dokumenten Generell indata och Message 6.6.1 Tjänstespecifika felmeddelanden För generella felmeddelanden se dokumentet Message och Java Doc. provrapp.kursnotfound = Kursen {0} finns inte. provrapp.reskodmissing = Listan {0} saknar resultatkod. provrapp.provkodmissing = Listan {0} saknar provkod. common.idnr.noavailableid = Det finns inget ledigt id för {0}.
2017-04-27 23 (30) 7 Skapa arkivlista 7.1 Syfte Syftet med deltjänsten är att målgruppen lärare/institutionspersonal ska kunna skriva ut en arkivlista för en klarmarkerad provrapporteringslista. 7.2 Beskrivning Deltjänsten returnerar en arkivlista som en pdf för det list-id som skickas in som indata. 7.3 Kontroller 1. Behörighetskontroll - institutionskod och användaridentitet. 7.4 Exponerade metoder createarkivlista(uservo user, ArkivlistaParamsVO params) 7.5 Indata Identiteten hämtas från UserVO. Värdeobjekt Data Format Kommentar ArkivlistaPar amsvo examinator String Namn på examinator assisterande String Namn på assisterande lärare idnr String Provrapporteringslistans id. valid Boolsk Om denna är falsk finns det felmeddelanden på ERROR eller FATAL nivå i messages messages List<Messa ges> Se funktionsspecifika felmeddelanden, samt dokumenten Generell indata och Message 7.6 Utdata Värdeobjekt Data Format Kommentar ArkivlistaVO pdf Byte[] Pdf som bytearray valid Boolsk Om denna är falsk finns det felmeddelanden på ERROR eller FATAL nivå i messages
2017-04-27 24 (30) messages List<Messages> Se funktionsspecifika felmeddelanden, samt dokumenten Generell indata och Message 7.6.1 Tjänstespecifika felmeddelanden För generella felmeddelanden se dokumentet Message och Java Doc. provrapp.datenotvalid = \u00e4r inte giltigt, {0}. provrapp.gradenotvalid = Betyget \u00e4r inte giltigt, {0}. provrapp.instnotfound = Institutionen {0} hittades inte i databasen. provrapp.instnotrequiredlength = Institutionskod inneh\u00e5ller fel antal tecken, {0}. provrapp.kurskodmissing provrapp.kursnotfound provrapp.listcontainserrors felaktiga poster. provrapp.listhasvalidationerrors provrapp.namenotfound = Listan {0} saknar kurskod. = Kursen {0} finns inte. = Listan {0} kunde inte uppdateras. Den inneh\u00e5ller = Listan inneh\u00e5ller valideringsfel. = Namnet hittades inte i databasen. provrapp.provhuvudnotvalid = Listan \u00e4r inte giltig, {0}. provrapp.provnotfound provrapp.removefailed provrapp.reskodmissing provrapp.student.is.suspended provrapp.studentalreadypassed provet. provrapp.studentnotregistered provrapp.nosemesterregistration = Provet {0} finns inte. = Borttagningen misslyckades. = Listan {0} saknar resultatkod. = Studenten {0} \u00e4r avst\u00e4ngd. = Studenten {0} har redan ett godk\u00e4nt resultat p\u00e5 = Studenten {0} har ingen registrering p\u00e5 kursen. = Studenten har ingen terminsregistrering.
8 Hämta registrerade studenter 8.1 Syfte 2017-04-27 25 (30) Syftet med deltjänsten är att lärare/institutionspersonal ska kunna hämta studenter som är registrerade men inte godkända på kurs/prov. 8.2 Beskrivning Tjänsten hämtar studenter från FFGKURS och UBINDRG som är registrerade men ännu inte godkända på kurs/prov, baserat på given kurs och provkod eller på resultatkod. 8.3 Behörighetsanalys Målgrupperna är behöriga att läsa alla uppgifter från tabellen. Portalen kan, genom att sätta villkor, begränsa visningen. 8.4 Exponerade metoder 8.4.1 Hämta terminer För att hämta terminer används metoden o getsemesterswithcourseregistrations(uservo uservo, String inst, String kurskod, String provkod, String reskod) 8.4.1.1 Indata Identiteten hämtas från UserVO. Data Format Kommentar Inst String Institution för given kurs Kurskod String Kurskoden för den kurs som avses. Sätts inte om reskod är satt. Provkod String Provkoden för det prov som avses Sätts inte om reskod är satt. Reskod String Resultatkod för den resultatkod som avses. Sätts inte om kusrkod och provkod är satt. 8.4.1.2 Utdata Terminerna skickas ut i en lista av värdeobjektet ProvRappPersonVO, där termin är satt. Se utdata för hämta studenter för mer detaljer angående ProvRappPersonVO.
8.4.2 Hämta studenter För att hämta studenter används metoden 2017-04-27 26 (30) o getregisteredstudents(uservo uservo, String inst, String kurskod, String provkod, String reskod, String termin) 8.4.2.1 Indata Identiteten hämtas från UserVO. Data Format Kommentar Inst String Institution för given kurs Kurskod String Kurskoden för den kurs som avses. Sätts inte om reskod är satt. Provkod String Provkoden för det prov som avses Sätts inte om reskod är satt. Reskod String Resultatkod för den resultatkod som avses. Sätts inte om kusrkod och provkod är satt. Termin String Terminen som man vill hämta studenter för. 8.4.2.2 Utdata Studenterna skickas ut i en lista av värdeobjektet ProvRappPersonVO. Värdeobjekt Data Format Kommentar ProvRappPersonVO Termin String Den registrerade terminen. Pnr String Personnumret för studenten. Tnamn String Förnamnet på studenten. Enamn String Efternamnet på studenten.
9 Visa/söka tentamenstillfällen 9.1 Syfte 2017-04-27 27 (30) Syftet med deltjänsten är att lärare/institutionspersonal ska kunna se vilka tentamenstillfällen som finns inlagda i katalogtabellen TENTILLF. Detta kan användas för att senare kunna leta fram anmälda studenter på valt tentamenstillfälle (se deltjänsten Söka tentamensanmälningar). 9.2 Beskrivning Tjänsten läser upp de tentamenstillfällen som finns sparade i TENTILLF. Listan med tentamenstillfällen är sorterad på provdatum, kurskod, provkod. Närmast förestående tillfällen visas först. 9.2.1 Fri sökning För sökning av tentamenstillfällen används metoden o gettentillf(uservo, tentamenvo) Dessa begränsningar används vid fri sökning eller som försteg vid t ex ändring och borttagning. 9.2.1.1 Frivilliga begränsningar Det är möjligt att begränsa visning/sökning på följande parametrar: Parameter Typ Kommentar provdatfrom Text Provdatum fr.o.m. detta datum provdattom Text Provdatum t.o.m. detta datum. 9.3 Behörighetsanalys Målgrupperna är behöriga att läsa alla uppgifter från tabellen. Portalen kan, genom att sätta villkor, begränsa visningen.
9.4 Indata 2017-04-27 28 (30) Det är möjligt att sätta antingen katalog- eller studentspecifika begränsningar enligt tabellen nedan. Värdeobjekt Data Format Kontroll TentamenVO Anmald Boolean Anmtid ProvResultat KursResultat CheckProvUpps Boolean Boolean Boolean Boolean InstKod String 1 Provdatfrom String 1, 2 Provdattom String 1, 2 TentillfVO - - TentillfVO idnr String 1 kurs String 1 kurspoang kursbenamn provkod provpoang resultatkod BigDecimal String String BigDecimal String ortvo.kod String 1 9.4.1 Kontroller 1. Formatkontroll 2. Logisk kontroll att from.-datum är mindre än tom.-datum om båda angetts 9.5 Exponerade metoder gettentillf(uservo, tentamenvo) Utdata Tentamenstillfällesuppgifter skickas ut i TentillfVO. Kompletterande uppgifter om resultatkod skickas ut i ReskodVO.
2017-04-27 29 (30) Parametern noofpeoplewithresult i TentillfVO talar om hur många av personerna anmälda på tentamenstillfället som redan har resultat.
10 Söka tentamensanmälningar 10.1 Syfte 2017-04-27 30 (30) Syftet med deltjänsten är att lärare/institutionspersonal ska kunna se vilka studenter som är anmälda på ett tentamenstillfälle i katalogtabellen TENTANM. 10.2 Beskrivning Tjänsten läser upp de tentamensanmälningar för ett givet tentamenstillfälle som finns sparade i TENTANM givet ett tentamenstillfälle-id. 10.2.1 Fri sökning För sökning av tentamenstillfällen används metoden o gettentanm(uservo, tentamenvo) 10.3 Behörighetsanalys Målgrupperna är behöriga att läsa alla uppgifter från tabellen. Portalen kan, genom att sätta villkor, begränsa visningen. 10.4 Indata Värdeobjekt Data Format Kontroll TentillfVO Idnr String 10.5 Exponerade metoder gettentanm(uservo, tentamenvo) Utdata Tentamensanmälnings-uppgifter skickas ut i TentanmVO.