Kravspecifikation UB60 - Registreringsverifikat Batch Webbadress https://projekt.ladokenheten.umu.se/ /UPP T-02 Registreringsverifikat/krav Projektnamn Projekt 723 - Registreringsverifikat Fastställt av Dokumentansvarig Bengt Reinholdsson Dokumentidentitet UPP-07-T-02 Krav_best Datum 2007-08-203 Status
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 2 (21) Ändringshistorik Revision Datum Av Kommentar Granskare Godkännare 1.01 2009-03-09 Jenny Sandqvist Lagt till information om det nya valalternativet Kompletterande verifikat i radiogruppen i UB60A01G. 2016-02-17 Maria Vännman Kompletterat frystkontrollen med sökning mot OUFRYST.TYP
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 3 (21) Innehållsförteckning 1 INLEDNING... 4 1.1 SYFTE... 4 1.2 BESKRIVNING... 4 1.2.1 Batchhantering... 5 1.2.2 Delfunktioner... 6 1.3 BEHÖRIGHET/PREFSTYRNINGAR... 6 1.3.1 Behörighet... 6 1.3.2 Preferensstyrningar... 6 1.4 TABELLER... 6 1.4.1 Tabeller som läses... 6 1.4.2 Tabellbeskrivningar... 7 2 FUNKTIONELLA KRAV... 8 2.1 KRAVLISTA... 8 2.2 DETALJERAD BESKRIVNING AV KRAVEN... 8 2.3 KONTROLLER... 11 2.4 MEDDELANDEN... 12 3 ICKE FUNKTIONELLA KRAV... 13 3.1 ANVÄNDBARHET... 13 3.2 UNDERHÅLLBARHET... 13 4 DESIGN... 15 4.1.1 Granskningslista... 15 4.1.2 Normal körning av verifikat... 16 4.1.3 Kompletterande verifikatkörning... 16 4.1.4 Borttag av körning... 16 4.1.5 Fält: Välj alternativ... 17 4.1.6 Fält: Begränsa utsökningen... 18 4.1.7 Knappar... 19 5 SAMMANFATTNING KRAV... 20 5.1 FÖRTECKNING... 20
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 4 (21) 1 Inledning 1.1 Syfte Projektet skall skapa en funktion/delfunktion som gör det möjligt att uppfylla de krav som revisorerna ställer på de verifikationer som skall finnas vad gäller underlag för beräkning av antalet helårsstudenter. Att på enklast möjliga sätt uppfylla de krav som ställs på verifikationer av antalet helårsstudenter vid högskolan. 1.2 Beskrivning Denna funktion består av tre funktioner/tjänster. Först finns batchfunktionen som möjliggör att förhandsgranska eller skapa verifikat på kursregistreringar för en viss termin. Batchfunktionen består av två delar. Först finns sdelen där man bestämmer när batchen ska köras samt vilka villkor som ska gälla. Den delen har ett grafiskt gränssnitt och heter UB60 som saknar delfunktioner och därför öppnas sformuläret direkt. Detta formulär är ett standardformulär, GB01A00G, som ger möjlighet att: Lägga till batchar Stryka batchar Kontrollera status Lägga in inställningar (via en knapp som öppnar ett standardformulär) Lägga till villkor via knapp som är funktionsspecifik Hämta resultatfiler Villkoren är funktionsspecifika varför utveckling av detta redovisas separat under avsnitt 4 och kan delas upp i tre möjliga alternativ: 1. Granskningslista, en lista som innehåll preliminära poster utan att verifikatnummer sätts. Ingående parametrar: Termin, 2. Nytt verifikat på nya registreringar, ingående parametrar: Termin. 3. Kompletterande verifikat, ingående parametrar: Termin 4. Ta bort verifikat, ingående parametrar: tidigare batchkörning. Andra delen är själva batchkörningen (som denna specifikation beskriver) som söker ut poster, sorterar dem och sätter verifikatnummer på varje anmälningsalternativ och registreringstyp på personnivå. Sedan finns en administratörs funktion, SY11, som ger möjlighet att publicera och frysa körningar. Denna funktion finns redan och därför behövs den inte specificeras i UB60. Slutligen finns det möjlighet att ta ut två olika utskrifter efter denna batchkörning. Dessa listor tas ut med hjälp av uppföljningstjänsterna på webben, LW09. I denna tjänst finns möjlighet att välja körning, institution, typ av utskrift detaljlista och/eller arkivlista. Den sistnämnda ska skrivas under av ansvarig prefekt på institutionen
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 5 (21) 1.2.1 Batchhantering Användaren öppnar startformulåret från MENYA00G Nouveau Inställningar GB01A02G Beställning batch UB60A00G (GB01A00G) Villkor för batch UB60A01G Hämtar filer Läser och uppdaterar e-post Läser och uppdaterar batch Läser och uppdaterar villkoren Databas BATINST ANVIP BATCHJOB BATFIL BATVILL Ja Finns batinst post Nej Läser om det finns något att starta Uppdaterar med status och ev filnamn Javaklient DEMON Startar Läser/ uppdatrar Hämta e-post adress Läser in villkoren Läser UB60_JAVA Databas Ladok db Se spec vilka tabeller som läses och uppdateras
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 6 (21) 1.2.2 Delfunktioner Inga delfunktioner finns i funktionen 1.3 Behörighet/prefstyrningar 1.3.1 Behörighet Användaren ska vara etablerad i Ladok och ha behörighet till funktionen. 1.3.2 Preferensstyrningar Funk Nr Vad vill man styra Nyckelord Värde: Resultat Default Typ 1 ) 1 Lägg till/ta bort/ ändra andras ar 3 Bestämmer hur stående ska hanteras i bilden SUPER EJSTAENDE J: Visar alla ar N: Endast användarens ar J: Stående visas ej N: Stående visas N J A S Figur 1 Behörighet/prefstyrning (Tabell) 1) Typ betyder: S: SYSTPREF, A: ANVPREF, P: PERSPREF 2) Sätts inte DEFAULTTID till något sätts aktuell tid plus en timme som defaultvärde när läggs upp Ändring: 1.4 Tabeller 1.4.1 Tabeller som läses Tabeller Läser Uppdaterar BATCHJOB X X BATFIL X BATINST X X BATVILL X X OUFRYST X VERHUV X TERMIN X
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 7 (21) 1.4.2 Tabellbeskrivningar,FK1,FK1,I1,FK1,FK1,FK1,FK1,I1,FK1,FK1 I1 FK1 FK1 BATFIL ANVKOD FUNKTION BETECKN RADNR FILNR BATINST TERMIN FILNAMN ANVKOD FUNKTION BETECKN RADNR INSTNR INSTALLN FROMTERM TOMTERM UNDFROM UNDTOM STARTV SLUTV TERMIN5 TREGTOM FUNK TERMIN,I1,FK1 FK1 FK1 FK1 FK1 BATCHJOB ANVKOD FUNKTION BETECKN RADNR DATUM TID FASTJOBB VILLKOR KORDMARK SPARAS KORDDAT INSTALLN STARTTID SLUTTID OUFRYST FUNK TERMIN ANVKOD FRYST PUBLIK TYP INST KURS ANMKOD REGTYP I1,FK1,FK1,I1,FK1,FK1 VERHUV BATVILL TERMIN INST KURS ANMKOD REGTYP VERNR BESKRIVN TOTANTAL ANTWREG STARTTER KURSTAKT KURSTID UNDFORM ORT KURSOMG FINFORM IDATUM ITID ANVKOD FUNKTION BETECKN RADNR VILLNR VILLKOR
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 8 (21) 2 Funktionella krav 2.1 Kravlista Krav Prioritet Länk Startformuläret Batch Beställning Batch Öppning och stängning av funktionen Villkor Fel! Hittar inte referenskälla. Granskningslista Bör Granskningslista Verifikatkörning Verifikat körning Ta bort körning Borttag av körning Publicera/ ta bort publicering Bör Fel! Hittar inte referenskälla. Begränsning på terminer Fält: Termin E-postmeddelande Bör Se separat dokument Ändringhistorik: 2.2 Detaljerad beskrivning av kraven Batch Under detta krav finns alla krav som tillhör funktionalitet som finns i Nouveau. Generellt gäller att batchfunktionen GB01 ska användas för inläggning av batch. - Beställningsformuläret ska vara GB01A00G. Detta formulär finns redan och specificeras därför inte i detta projekt. - Funktionen saknar delfunktioner och därför startar det generella sformuläret i GB01 när man väljer funktionen. Ändringhistorik:
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 9 (21) Menyalternativ i UB60 I UB60 ska de generella menyalternativen fungera som i övriga Ladok. Ändringhistorik: Öppning och stängning av funktionen Öppning Funktionen ska ligga under funktionsgrupp Utdata övrigt. Funktionen ska öppna det generella batchsformuläret GB01A00G. Inga speciella system- eller andra preferenser är nödvändiga än de som sätts som standard, se 1.4.2.Preferensstyrningar Stängning När funktionen avslutas ska det göras enligt S&G. Det vill säga när stängning av formulären görs kontrolleras om någon inläggning/ändring gjorts utan uppdatering, i så fall ska meddelande/dialogruta visas enligt S&G. Ändringhistorik:
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 10 (21) Uppdatering Godkänt Uppdatera BATCHJOB och BATVILL Uppdatering: BATVILL: Ny post skapas (första tre fälten hämtas från BATCHJOB) ANVKOD=Användarkod FUNKTION=funktion BETECKN= beteckning Nytt VILLNR för varje villkor VILLNR= n fältet VILLKOR Granskningslista TYP=G BESKRIV=[ex mer beskrivande om körningen] TERMIN = [ex 20041] PUBLIC=J [Alltid publik] Nytt verifikat TYP=V BESKRIV=[ex mer beskrivande om körningen] TERMIN = [ex 20041] PUBLIC=J Kompletterande verifikat TYP=R BESKRIV=[ex mer beskrivande om körningen] TERMIN = [ex 20041] PUBLIC=J Ta bort TYP=B TERMIN = [ex 20041] BATCHJOB: Om inte fältet VILLKOR är lika med J för aktuell batch skall fältet uppdateras med ett J
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 11 (21) Efter uppdatering ska det läggas ut ett meddelande på hur uppdatering gick. Om uppdatering gick bra - ADM_001- Uppdatering klar Annars - ADM_002 Ingen ändring gjord Ändringhistorik: 2007-06-08: Ändrat typ till G,V och B samt tagit bort alternativ 4 2009-03-13: Lagt till nya alternativet Kompletterande verifikat 2.3 Kontroller Kontroll körstatus Godkänt Kontrollera att om körstatus: - om status är lika med "Pågår" ska alla fält i villkorsformuläret dimmas och meddelande ADM_210 Körningen har ändrats till PÅGÅR, uppdatering är inte tillåtet - om status är lika med "Klar" ska alla fält i villkorsformuläret dimmas och meddelande ADM_211 Körningen har ändrats till KLAR, uppdatering är inte tillåtet Ändringhistorik: Kontroll termin Läs tabellen OUFRYST med data från termin och UB60. Beroende på val i radiogrupp ska kontrollen hantera frågan på olika sätt. Om radiogruppen är markerad: Alternativ 1 eller 2 så får post får finnas i OUFRYST under förutsättning att posten inte är fryst. Är den inte det ges ett varningsmeddelande om typ = V Alternativ 3 så o måste post finnas i tabellen OUFRYST. Om inte kommer meddelande: UB60_002 ("Det finns inget att komplettera eftersom tidigare verifikatkörning saknas.") Alternativ 4 så o måste post finnas i tabellen OUFRYST. Om inte kommer meddelande: ADM_566 ( Posten saknas i registret. ) o Om posten är fryst i OUFRYST får inte posten tas bort UB60_001 Ändringhistorik: 2009-03-13: Lagt till information om alternativ 3 (Kompletterande verifikat)
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 12 (21) 2.4 Meddelanden ADM_001 Uppdatering klar ADM_002 Ingen ändring gjord ADM_152 Termin saknas ADM_210 Körningen har ändrats till PÅGÅR, uppdatering är inte tillåtet ADM_211 Körningen har ändrats till KLAR, uppdatering är inte tillåtet ADM_566 Posten saknas i registret ADM_600 Termin ska anges i formen TÅÅ, där T = V eller T = H ADM_604 Angiven termin är större än innevarande ADM_673 Posten finns redan UB60_001 Verifikatkörningen är fryst och kan ej tas bort UB60_002 Det finns inget att komplettera eftersom tidigare verifikatkörning saknas.
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 13 (21) 3 Icke funktionella krav 3.1 Användbarhet Designstandard Utkast All utveckling av program med grafiskt layout, det vill säga formulär och utskrifter, ska följa Standard & Guidelines (S&G) version 8.02 som gäller för Uniface - utveckling. 3.2 Underhållbarhet Programmerings standard Utkast De delar som utvecklas i Uniface ska följa programmeringsstandarden som gäller för verktyget. Utvecklaren ska kommentera koden på sådant sätt att det är lätt att förstå vad som händer i programmet.
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 14 (21) Dokumentation Utkast Följande dokument ska finnas vid leverans av funktionen. Dokument Kravspecifikation Testplan Funktionsbeskrivning Teknisk dokumentation Slutrapport Slutrapport test Ansvar Kravsamordnare/Kravspecifikatör Testare Kravsamordnare Utvecklare Uppdragsansvarig Testare Avgränsningar Utkast Ej prioriterat Ändringar som kan beröra andra funktioner eller rutiner inom Studiedokumentation ska inte göras inom ramen av projektet. Anpassningar i andra funktioner Utkast Ej prioriterat Inga andra anpassningar i andra funktioner är nödvändiga. Testning Utkast Ej prioriterat Alla testfall ska sparas i Quality Center och efter leverans ska dessa vara tillgängliga för underhållet.
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 15 (21) 4 Design 4.1.1 Granskningslista Granskningslista Bör Detta alternativ gör det möjligt att förhandsgranska vilka poster som kommer att få verifikat vid en normal körning. Fält som är tillgängliga: termin, beskrivning och uppdatera knappen Denna körning ska alltid vara publik.
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 16 (21) 4.1.2 Normal körning av verifikat Verifikat körning Detta alternativ gör det möjligt att sätta verifikat på kurser och anmälningsalternativ samt typ av registrering under visst tidsintervall. Fält som är tillgängliga: Termin, Beskrivning, Publicera och uppdatera knappen. Denna typ av körning ska användaren få möjlighet att bestämma om körningen ska vara publik eller inte. 4.1.3 Kompletterande verifikatkörning Kompletterande verifikat Detta alternativ gör det möjligt att i efterhand komplettera en redan tidigare genomförd verifikatkörning på kurser och anmälningsalternativ samt typ av registrering under visst tidsintervall. Man behöver således inte göra om hela verifikatkörningen. Fält som är tillgängliga: Termin, Beskrivning, Publicera och uppdatera knappen. Denna typ av körning ska användaren få möjlighet att bestämma om körningen ska vara publik eller inte. 4.1.4 Borttag av körning Borttag av körning Bör Detta alternativ gör det möjligt att ta bort en tidigare körning. Fält som är tillgängliga: Termin och uppdatera knappen Uppgifter om körningen läses upp i formuläret.
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 17 (21) 4.1.5 Fält: Välj alternativ Radiogrupp: välj alternativ Radiogrupp ger möjlighet att välja delfunktion. Obligatoriskt: Ja Typ: Radiogrupp Alternativ Granskningslista Normal körning av verifikat Kompletterande verifikat Borttag av körning Hjälptext: Välj alternativ Defaultvärde: Andra alternativet ( Normal körning av verifikat ) Typ av värde: 1. Granskningslista 2. Normal körning av verifikat 3. Kompletterande verifikat 4. Borttag av körning Alternativ 2, 3 och 4 ger möjlighet att välja specifik verifikat eller serie av verifikat
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 18 (21) 4.1.6 Fält: Begränsa utsökningen Fält: Termin Utkast Tabell: Ledtext: Obligatoriskt: Längd: Hjälptext: Defaultvärde: Sökknapp: Sökmönster: Villkor: TERMIN Termin Ja, om alternativ 1, 2, 3 eller 4 i radiogruppen valts 3 tkn (ska kunna inrymma V99 ) Termin, 3 tkn. Form: TÅÅ, där T = V (vår) och T = H (höst). Blankt Nej Nej Blåmålning av felaktigt värde, markören kvar i fältet vid: 1. Termin ska finnas definierad i TERMIN. 2. Tidigare eller innevarande termin får anges Vid alternativ 1 och 2 Vid alternativ 1 eller 2 får post finnas i OUFRYST under förutsättning att posten inte är fryst. Är den det ges ett varningsmeddelande. Se kontroll Kontroll Vid alternativ 3 och 4 Körning måste finnas i databasen. Se kontroll Kontroll Felmeddelande: Vid felaktig inmatning eller dylikt: ADM_600 Termin ska anges i formen TÅÅ, där T = V eller T = H Vid fel mot villkor 1: ADM_152 Termin saknas Vid termin senare än innevarande termin villkor 2 ADM_604 - Angiven termin är större än innevarande Vid felaktig inmatning eller dylikt: Se kontroll Kontroll Kommentar: - Om alternativ 4 i radiogruppen valts ska systemet läsa upp vald körning med beskrivning, termin, och eventuella publiceringar eller frysningar Ändringhistorik:
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 19 (21) Fält: Beskrivning Utkast Ledtext: Obligatoriskt: Längd: Hjälptext: Defaultvärde: Sökknapp: Sökmönster: Benämningsfält: Beskrivning Ja, om alternativ 1 3 i radiogruppen valts 20 tkn (ska kunna inrymma 20st W ) Verifikatkörning, max 20 tkn. Blankt Nej Nej Nej Checkbox: Publicering Godkänt Obligatoriskt: Nej. Typ: Checkbox Ledtext: Publicera Hjälptext: Genom att markera detta fält gör du körning publik i LPW Defaultvärde: blank, (ej markerad) Typ av värde: F= Falskt (0) eller T = Sant, markerad (1) Ingen uppdatering av värdet ska göras i databasen om den är blank. Ändringhistorik: 4.1.7 Knappar Knapp Uppdatera Ledtext Karaktär Uppdatera Boilerplate
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 20 (21) Obligatorisk Ja Hjälptext (F1) Lagrar val i databasen Längd Enligt S&G Defaultmarkerad Nej Villkor: - Knappen skall alltid vara valbar under förutsättning att körstatus inte är "Klar" eller "Pågår". - Alla obligatoriska fält och andra villkor måste vara uppfyllda. - Knappen byter namn till "OK" om körning är "Pågår" eller "Klar". Vid aktivering: - Kontrollera att alla obligatoriska fält är korrekt ifyllda. Om kontrollen hittar felaktighet ska markören ställa sig på aktuellt fält och blåmarkera - Kontrollera om det finns körningar eventuella under aktuell tidsintervall i OUFRYST. Fryst körning kan ej köras över. Om det finns tidigare körning ska fråga komma som frågar om tidigare batch ska tas bort eller inte. Detta gäller vid val 2 i radiogruppen och om typ.oufryst=v. Se övrigt Uppdatering. Ändringhistorik: 5 Sammanfattning krav 5.1 Förteckning BATCHBESTÄLLNING... 8 MENYALTERNATIV I UB60... 9 ÖPPNING OCH STÄNGNING AV FUNKTIONEN... 9 UPPDATERING... 10 KONTROLL KÖRSTATUS... 11 KONTROLL TERMIN... 11 DESIGNSTANDARD... 13 PROGRAMMERINGS STANDARD... 13 DOKUMENTATION... 14 AVGRÄNSNINGAR... 14
Bengt Reinholdsson 2016-02-17 UPP-07-T-02 Krav_best 21 (21) ANPASSNINGAR I ANDRA FUNKTIONER... 14 TESTNING... 14 GRANSKNINGSLISTA... 15 VERIFIKAT KÖRNING... 16 KOMPLETTERANDE VERIFIKAT... 16 BORTTAG AV KÖRNING... 16 RADIOGRUPP: VÄLJ ALTERNATIV... 17 FÄLT: TERMIN... 18 FÄLT: BESKRIVNING... 19 CHECKBOX: PUBLICERING... 19 KNAPP UPPDATERA... 19