Kravlista och Kravspecifikation RV03

Transkript

1 Kravlista och Kravspecifikation RV

2 Bengt Reinholdsson (20) Ändringshistorik Datum Av Kommentar Godkännare Bengt Reinholdsson Marita Nilsson Hooshmand Shadman Mona Karlsson Första versionen av kravspecifikation för RV03. Lagt in Monas kommentarer och versionshanterat i ClearCase.

3 Bengt Reinholdsson (20) Innehållsförteckning ÄNDRINGSHISTORIK... 2 INNEHÅLLSFÖRTECKNING... 3 BAKGRUND... 5 DIREKTIV... 5 BEFINTLIG DOKUMENTATION /REFERENSMATERIAL... 5 KRAVLISTA - SAMMANSTÄLLNING... 5 KRAVLISTA - BESKRIVNING... 7 KRAV 1 SÖKNING KURSKOD PROVKOD BETYGSSKALA BETYG DATUMINTERVALL SÖK... 9 KRAV 2 PRESENTATION AV SÖKRESULTAT RESULTAT FÖR PROV RESULTAT FÖR KURSEN GRIDENS INNEHÅLL MARKERA RAD KRAV 3 ERSÄTT MARKERA RAD NY BETYGSSKALA KURS PROV BENÄMING BETYGSSKALA SOM KOMMER ATT BYTAS UT ANTAL POSTER SOM KOMMER ATT BYTAS UT KRAV 4 UPPDATERING ENBART KURS KURS OCH PROV MEDDELANDE DATAFIL UPPDATERA KRAV 5 UTSKRIFT SKAPA DATAFIL RUBRIKRAD FÄLT SOM BEGRÄNSATS PÅ SKA FINNAS MED I DATAFILEN POSTER: ENBART POSTERNA SOM VALTS, SKA VISAS I UTSKRIFTEN Enbart kurs Kurs och prov Poster:... Fel! Bokmärket är inte definierat. 5.5 E xempel: Kurs och prov KRAV 6 GUI... 17

4 Bengt Reinholdsson (20) 6.1 STARTLÄGE TABBORDNING UPPDELNING KRAV 7 ÖVRIGT BILAGOR DATABASFÖRÄNDRING FRÅGOR... 20

5 Bengt Reinholdsson (20) Bakgrund Direktiv Beskrivning: En av de vanligaste anledningarna att använda SQL är när det visat sig att man fått in en felaktig betygsskala för en kurs eller ett prov. Det räcker då inte att ändra i KA16, man måste också ändra betygsskalan för varje post i GODKPROV och/eller GODKKURS. I arbetet med registervård inför Ladok3 har det visat sig att flera lärosäten har ett stort antal poster där betyget inte finns med i den aktuella betygsskalan. Dessa poster kan inte IK:n (Informations kvonverterare) hantera, de måste rättas manuellt. Eftersom det inte finns någon funktionalitet för att göra detta måste man använda SQL Förslag på åtgärd: En ny funktion behövs där man kan ange kurskod (med möjlighet att ange del av kod), ev provkod, befintlig betygsskala och ny betygsskala. Eventuellt kan möjlighet att ange lokal serie och klass vara intressant. Den nya funktionaliteten ska finansieras av Ladok3-projektet Befintlig dokumentation /referensmaterial Dokument Författare Datum Kravlista - sammanställning Krav Nr Krav Beskrivning Prio Typ Kommentar Nr 1) 1 Sökning 1.1 Kurskod Måste 1.2 Provkod Skall 1.3 Betygsskala Bör 1.4 Betyg Bör 1.5 Datumintervall Bör 1.6 Sök knapp Måste Lokal serie och klass Önskas Ej aktuellt i första leverans

6 Bengt Reinholdsson (20) Krav Nr Krav Beskrivning Prio Typ Kommentar Nr 1) 2 Presenation av sökresultat 2.1 Resultat för prov Skall 2.2 Resultat för kurs Skall 2.3 Gridens innehåll Skall 2.4 Markerad rad Skall 3 Post som är markerad 3.1 Markerad rad Måste 3.2 Ny betygsskala Måste Visningsfält Skall 4 Uppdatering 4.1 Enbart kurs Skall 4.2 Kurs och prov Skall 4.3 Meddelanden Skall Utskrift vid uppdatering Skall 4.5 Uppdatera Måste 5 Utskrift 5.1 Skapa datafil Måste 5.2 Rubrikrad Skall 5.3 Utsöknings och begränsingsrader Skall 5.4 Poster Måste 1) Koppling till ev. andra krav??? 2) Inbördes prioriteringar finns.

7 Bengt Reinholdsson (20) Kravlista - beskrivning Krav 1 Sökning Användaren måste kunna söka ut poster som har felaktig betygsskala med hjälp av Kurskod i första hand och ytterligare sökfält kan begränsa antalet framsökta poster i resultattabellerna GODKKURS och GODKPROV. 1.1 Kurskod Sökningen ska utgå ifrån kurskod i första hand. Kurskoden används mot sökning i GODKKURS och GODKPROV (via vy: V_GODKPROV01). Ledtext: Kurs Obligatoriskt: Ja Längd: 6 Text (ska kunna inrymma WWWWWW ) Hjälptext: Kurskod, 6 tkn. Defaultvärde: Blankt Sökknapp: Ja Sökmönster: Nej Villkor: Kurskod ska finnas i tabellen KURS Felmeddelande: Angiven kurskod saknas. Kommentar: - Kursen benämning läggs ut i separat fält till höger om sökknappen. - Kurs som är nedlagd (NEDLAGD=J) stoppar ej, men meddelande visas. - Byte av kurs tömmer grid och eventuell post som är markerad i högra delen av formuläret förutom Ny betygsskala. Begränsningsfälten är inte nödvändigt att tömma. 1.2 Provkod Anges provkod tas denna med i sökningen mot GODKPROV (via vy: V_GODKPROV01). Ledtext: Prov Obligatoriskt: Nej Längd: 4 Text (ska kunna inrymma WWWW ) Hjälptext: Provkod, 5 tkn. Defaultvärde: Blankt Sökknapp: Nej Sökmönster: Ja Villkor: Inga felkontroller görs av inmatad provkod. (Skriver användaren en felaktig eller en kod som inte finns resulterar det endast i avsaknad

8 Bengt Reinholdsson (20) Felmeddelande: Kommentar: av sökträffar.) 1.3 Betygsskala Anges betygsskala tas denna med i sökningen mot GODKPROV (via vy: V_GODKPROV01). Ledtext: Befintlig betygsskala Obligatoriskt: Nej Längd: 2 Text (ska kunna inrymma WW ) Hjälptext: Befintlig betygsskala, 2 tkn. Defaultvärde: Blankt Sökknapp: Nej Sökmönster: Ja Villkor: Felmeddelande: Kommentar: Inga felkontroller görs av inmatad betygsskala. (Skriver användaren en felaktig eller en kod som inte finns resulterar det endast i avsaknad av sökträffar.) 1.4 Betyg Anges betyg tas denna med i sökningen mot GODKPROV (via vy: V_GODKPROV01). Ledtext: Befintlig betyg Obligatoriskt: Nej Längd: 2 Text (ska kunna inrymma WW ) Hjälptext: Befintligt betyg, max 2 tkn. Defaultvärde: Blankt Sökknapp: Nej Sökmönster: Ja Villkor: Felmeddelande: Kommentar: Inga felkontroller görs av inmatad betyg. (Skriver användaren en felaktig eller en kod som inte finns resulterar det endast i avsaknad av sökträffar.)

9 Bengt Reinholdsson (20) 1.5 Datumintervall Ett datumintervall kan anges för att begränsa sökningen mot GODKPROV (via vy: V_GODKPROV01). Två fält: Fr o m datum och T o m datum Ledtext: Fr o m datum T o m datum Obligatoriskt: Nej Längd: 10 Text (ska kunna inrymma ÅÅÅÅ-MM-DD ) Hjälptext: Datum, 6 eller 10 tkn. Form: ÅÅMMDD eller ÅÅÅÅ-MM-DD Defaultvärde: Blankt Sökknapp: Nej Sökmönster: Nej Villkor: Fälten ska följa riktlinjena i S&G Felmeddelande: Standard meddelanden för datumfält Kommentar: 1.6 Sök Ledtext: Sök Knapp Hjälptext: Sök efter godkända enligt angivna kriterier. Defaultmarkerad: Nej Villkor: Kurskod är angivet Felmeddelande: Kurskod måste anges Kommentar: Sökning sker med kurskod och med eventuella begränsningar i avanstående fält i GODKKURS och GODKPROV (via vy: V_GODKPROV01).

10 Bengt Reinholdsson (20) Krav 2 Presentation av sökresultat Resultatet av sökningen visas i en grid. 2.1 Resultat för prov Har sökning gjorts på en specifik provkod visas endast en rad i griden. Har andra sökparametrar angivits som ger fler träffar visas proven i en lista, sorterad på provkod. Kurskoden visas alltid tillsammans med provet. Provets benämning hämtas från PROV. Antal godkända räknas ihop från GODKPROV via vyn V_GODKPROV Resultat för kursen För en kurs visas en rad överst i sökresultatet utan något i kolumnen för prov. Kursens benämning hämtas från benämningsfältet i sökrutan. Antal godkända räknas ihop från GODKKURS. 2.3 Gridens innehåll Griden innehåller följande kolumner: Kurskod, provkod, provets eller kursens benämning, betygsskala samt en summering av hur många godkända det finns. 2.4 Markera rad Användaren markerar post genom att klicka på viss rad alternativ att tabba sig till griden. Innehållet på raden ska visas i Ersätt rutan till höger om griden. Byte av post skall innehållet ändras under Ersätt. Se krav 3.

11 Bengt Reinholdsson (20) Krav 3 Ersätt Posten som är markerad i griden (krav 2) visas i fälten under rubrik Ersätt i formulärets högra del. Alla fält utom att ange ny betygsskala är visningsfält och kan inte ändras. 3.1 Markera rad Användaren markerar post genom att klicka på viss rad alternativ att tabba sig till griden. Innehållet på raden ska visas i: a. Kurs b. Prov c. Benämning d. Betygsskala som kommer att bytas ut e. Antalet poster som kommer att uppdateras 3.2 Ny betygsskala Ledtext: Ny betygsskala Obligatoriskt: Ja Längd: 2 Text (ska kunna inrymma WW ) Hjälptext: Ersättande betygsskala, 2 tkn. Defaultvärde: Blankt Sökknapp: Nej Sökmönster: Nej Villkor: Ny betygsskala skall finnas i tabellen BETSKALA Felmeddelande: Angiven betygsskala saknas Kommentar: Fältet är obligatorisk vid uppdatering. - Vid byte av kurskod eller vid uppdatering ska inte detta fält rensas

12 Bengt Reinholdsson (20) 3.3 Kurs Ledtext: Kurs Obligatoriskt: Nej Längd: 6 Text (Enbart visningsfält) 3.4 Prov Ledtext: Prov Obligatoriskt: Nej Längd: 4 Text (Enbart visningsfält) 3.5 Benäming Ledtext: Benämning Obligatoriskt: Nej Längd: 120 Text (Enbart visningsfält) 3.6 Betygsskala som kommer att bytas ut Ledtext: Betygsskala som kommer att bytas ut Obligatoriskt: Nej Längd: 2 Text (Enbart visningsfält) 3.7 Antal poster som kommer att bytas ut Ledtext: Antal poster som kommer att bytas ut Obligatoriskt: Nej Längd: 5 Text (Enbart visningsfält) Numersikt högerställt

13 Bengt Reinholdsson (20) Krav 4 Uppdatering 4.1 Enbart kurs Utsökta poster i tabellen GODKKURS uppdateras med ny betygsskala. 4.2 Kurs och prov Utsökta poster i tabellen GODKPROV uppdateras med ny betygsskala. 4.3 Meddelande Efter uppdatering ska meddelande om hur uppdatering gått skrivas ut på meddelande raden. Om updatering gått bra skrivs Uppdatering klar.. I annat fall skall meddelande om att uppdaering misslyckades skrivas ut. 4.4 Datafil Vid uppdatering skall en datafil skapas automatiskt på de poster som har uppdaterats. 4.5 Uppdatera Ledtext: Uppdatera Knapp Hjälptext: Uppdaterar databasen. Defaultmarkerad: Nej Villkor: 1. Att det finns en post markerad i listboxen och i Ersätt området. 2. Ny betskala måste vara ifylld och skall finnas i tabellen BETSKALA Felmeddelande: 1. Finns ingen post att uppdatera. 2. Betygsskala måste anges Kommentar: - Vid uppdatering ges meddelande enligt S&G. se Efter uppdatering töms formuläret förutom utsökningsdelen och Ny betygsskala

14 Bengt Reinholdsson (20) Krav 5 Utskrift Utskrift kan ske på 2 olika sätt. Den ena är sk inspektionsläge som ska skrivas ut innan uppdatering sker. Den har till avsikt att visa vilka poster som kommer att uppdateras. Medan den andra utskriften är efter uppdatering och skrivs ut automatiskt. Den har till avsikt att visa vilka poster som blev uppdaterade. 5.1 Skapa datafil Ledtext: Skapa datafil Knapp Hjälptext: Skapa datafil. Defaultmarkerad: Nej Villkor: 1. Att det finns en post markerad i listboxen och i Ersätt området. 2. Ny betygsskala måste vara ifylld och skall finnas i tabellen BETSKALA Felmeddelande: 1. Finns inget att skriva till datafil. 2. Betygsskala måste anges Kommentar: Klickar använderan på avbryt när filen spars, kommer filen inte sparas 5.1 Rubrikrad Raden ska bestå av: a. Funktion b. Datum c. Tid d. Användare e. Funktionsbenämning f. Typ av datafil: a. INSPEKTIONSLÄGE. Dessa poster kommer att uppdateras. b. UPPDATERING HAR GENOMFÖRTS. Dessa poster har uppdaterats. 5.2 Fält som begränsats på ska finnas med i datafilen Filhuvud. Kurs: kod + benämning Prov: Befintlig betygsskala: Befintligt betyg: Datum intervall: fromdatum - tomdatum Antal poster: nn (Enbart posterna som valts/sökts ut, ska visas i utskriften) Ersättande betygsskala:

15 Bengt Reinholdsson (20) 5.3 Poster: Enbart posterna som valts, ska visas i utskriften Enbart kurs Från GODKKURS hämtas: Pnr;kurs;datum;betyg;larare;bskala;progr;proginr;Linst;Listnr;ectsbet;ut;idatum;itid;ianv; Kurs och prov Från GODKPROV hämtas: pnr;kurs;prov;provdat;betyg;intres;tgpoang;progr;proginr;bskala;listnr; ectsbet;idatum;itid;ianv;valuta;urspoang;konvert Poster: 5.4 E xempel: Kurs och prov Exempel Inspektionsläge: RV03; ;09:12;[User];Byte av betygsskala; INSPEKTIONSLÄGE. Dessa poster kommer att uppdateras. KURS: EF252 Funktionell programmering Prov: LAB1 Befintlig betygsskala: TP Befintligt betyg: G Datum intervall: Antal poster: 105 Ersättande betygsskala: TH pnr;kurs;prov;provdat;betyg;intres;tgpoang;progr;proginr;bskala;listnr; ectsbet;idatum;itid;ianv;valuta;urspoang;konvert ;EF252;LAB1; ;G;030;;D; _;TP;;; ;170000;KONV; H;; ;EF252;LAB1; ;G;030;;D; _;TP;;; ;170000;KONV; H;; Exempel Uppdatering: RV03; ;09:12;[User];Byte av betygsskala; UPPDATERING HAR GENOMFÖRTS. Dessa poster har uppdaterats. KURS: EF252 Funktionell programmering Prov: LAB1 Utbytt betygsskala: TP Befintligt betyg: G

16 Bengt Reinholdsson (20) Datum intervall: Antal poster: 105 Ersättande betygsskala: TH pnr;kurs;prov;provdat;betyg;intres;tgpoang;progr;proginr;bskala;listnr; ectsbet;idatum;itid;ianv;valuta;urspoang;konvert ;EF252;LAB1; ;G;030;;D; _;TP;;; ;170000;KONV; H;; ;EF252;LAB1; ;G;030;;D; _;TP;;; ;170000;KONV; H;;

17 Bengt Reinholdsson (20) Krav 6 GUI Detta avsnitt behandlar GUIt som helhet, de ingående komponenterna beskrivs separat i övriga krav. 6.1 Startläge När formuläret öppnas står markören i Kurskods-fältet. 6.2 Tabbordning Kurskod indexknapp Provkod Befintlig betygsskala Befintligt betyg From datum Tom Datum Sök Grid Ny Betygsskala Skapa datafil Uppdatera Kurskod Eller tvärt om. 6.3 Uppdelning Formuläret delas in i 3 områden. Se ovan. 2. Utsökning och begränsing (sök). Består av ett antal fält. Se krav 1. a. Kursfält med benämning (obligatoriskt) Valfria/begränsande fält b. Prov c. Befintlig betygsskala d. Befintligt betyg e. Fr.o.m och T.o.m datum f. Sökknapp 3. Utsökningsresultat: Datagrid: Se krav 2. kurs, prov benämning, betygsskala och Antal godkända. Markerad post ska visas i Ersätt delen. 4. Ersätt information (Ersätt). Består av ett antal fält a. Ny betygsskala (ändringsbar)

18 Bengt Reinholdsson (20) Visningsfält b. Kurs c. Prov d. Benämning e. Betygsskala som kommer att bytas ut f. Antalet poster som kommer att uppdateras Övrigt finns två knappar, en för att skriva ut en datafil innan uppdatering samt uppdateringsknapp Krav 7 Övrigt

19 Bengt Reinholdsson (20) Bilagor Databasförändring En ny vy har skapats för att underlätta utsökningen. Personnummer, kurskod, provkod, betyg och betygsskalan för posten tas ur GODKPROV. Provets benämning och provets betygsskala hämtas från PROV. Namn: Bastabeller: Innehåll: V_GODKPROV01 GODKPROV, PROV Vyn läser vissa data från GODKPROV och katalogdata från PROV för aktuellt prov. Kolumn Pos Nyckel Beskrivning Format Ursprung PNR 10 * Personnummer Char(10) GODKPROV.PNR GKKURS 6 * Kurskod char(6) GODKPROV.KURS GKPROV 4 * Provkod char(4) GODKPROV.PROV GKDATUM 10 Datum för godkänt prov char(10) GODKPROV.PROVDAT GKBETYG 2 Betyg på godkänt prov char(2) GODKPROV.BETYG GKBSKALA 2 Aktuell betygsskala char(2) GODKPROV.BSKALA BENAMNS 60 Svensk benämning char(60) PROV.BENAMN PBSKALA 2 Provets aktuella betygsskala char(2) PROV.BSKALA SQL: create view v_godkprov01 (gkkurs, gkprov, gkdatum, gkbetyg, gkbskala, benamns, pbskala) as select gp.kurs as gkkurs, gp.prov as gkprov, gp.provdat as gkdatum, gp.betyg as gkbetyg, gp.bskala as gkbskala, p.benamn as benamns, p.bskala as pbskala from godkprov as gp, prov as p where gp.kurs = p.kurs and gp.prov = p.prov;

20 Bengt Reinholdsson (20) Frågor 1. Kan det finnas prov i GODKPROV som inte finns i PROV? Det skulle innebära att man inte får träff på dessa via vyn. (Eller?) Svar: 2. Ska man kunna söka utan att ange en kurskod? (Komplicerar utsökningen en hel del i nuläget.) Svar: Nej!Kurskod måste alltid anges. Däremot ska man kunna begränsa på t ex prov, betygsskala, datum.