Kravspecifikation. Uppdatering RG_UPPDAT (RG01, RG02, RG03)

Transkript

1 Kravspecifikation Uppdatering RG_UPPDAT (RG01, RG02, RG03)

2 Bengt Reinholdsson (21) Ändringshistorik Datum Av Kommentar Godkännare Bengt reinholdsson Brutit ut detta från gamla kravlistan för RG01 RG Eva L Simu Kompletterat med BEHBESL mm Eva L Simu Eva L Simu Flödesschema är inte uppdaterad vid tidigare förändringar och en genomgång bör göras. Avvaktar åtgärd NOUVSD-8751 Kompletterat dokumentationen i samband med åtgärd NOUVSD Fellista skrivs ut om något gått snett i RG_UPPDAT. En fellista som även kan skrivas ut till skrivare. Kompletterat dokumentationen i samband med åtgärd NOUVSD I samband med att formuläret körs görs nu en sista kontroll på att studenten är behörig till studier på aktuell kurs och eventuellt program/inriktning. Detta gäller både utbildning på grund- och avancerad nivå. NOUVSD-8795 I samband med att tabellen ANTINR ska uppdateras läggs ett nytt meddelande ut om registrering redan finns på program men på annan inriktning Anna-Carin Wiklund STU T-3101 Studieavgifter. Uppdaterar kravspec med nytt kapitel 3 som beskriver de kontroller som görs gällande studieavgifter. Dessa kontroller finns med i kravspecarna för RG01 RG03,men förtydligar med de kontroller som ligger i RG_UPPDAT.

3 Bengt Reinholdsson (21) Innehållsförteckning 1 INLEDNING ALLMÄNT FORMULÄR SOM ANROPAR ELLER ANROPAS AV RG_UPPDAT ÖVERSIKT AV UPPDATERING FÖR TERMINSREGISTRERING ÖVERSIKT AV UPPDATERING FÖR KURSREGISTRERING TABELLER SOM LÄSES OCH UPPDATERAS UTSKRIFT AV FEL-/VARNINGSLISTA I RG-UPPDAT FUNKTIONELLA KRAV RG_UPPDAT ALLMÄNT RG_UPPDAT TERMINSREGISTERING FFG-registrering OM-registrering RG_UPPDAT KURSREGISTRERING FFG - registrering på kurs med hjälp av anmälningskod FFG - registrering på vald kurs inom program med terminsregistrering FO - registrering på kurs OM - registrering på kurs STUDIEAVGIFTER VID UPPDATERING AV FFG-REGISTRERING FÖR TERMINSREGISTERING VID UPPDATERING AV FFG-REGISTRERING FÖR KURSREGISTERING FFG - REGISTRERING PÅ VALD KURS INOM PROGRAM MED TERMINSREGISTRERING ICKE FUNKTIONELLA KRAV UNDERHÅLLBARHET... 21

4 Bengt Reinholdsson (21) 1 Inledning 1.1 Allmänt Detta program anropas av tre funktioner, nämligen RG01, RG02 samt RG Formulär som anropar eller anropas av RG_UPPDAT

5 Bengt Reinholdsson (21) 1.3 Översikt av uppdatering för terminsregistrering Uppdatering - terminsregistering Typ!= om FFG registrering Omregistering OMREGLIN (2.2.2) FFGLIN (2.2.1) ANTLIN ANTINR Finns inr? UPPLIN (2.2.1) FFG Typ!= om OM VALDKURS OM Typ!= om FFG EJUPPLIN (2.2.2) KTILLP (2.2.1) Uppdatera Felretur RETUR OK

6 Bengt Reinholdsson (21) Kontroll görs även om behörighetsposter i BEHBESL ska skapas i samband med uppdatering.

7 Bengt Reinholdsson (21) 1.4 Översikt av uppdatering för kursregistrering Kursregistrering 1 RG01 FF RG02 FFGA/ FFGS J FFGT FFGKURS termreg (2.3.2) FFGKURS (2.3.1) Program ANTLIN RG01: 1,2 3 RG02: FFGA, FFGS,FFGT, FO, OM Finns inr? ANTINR Nej LANTKURS FO/2 Ja FOKURS (2.3.3) OM/3 OMKURS (2.3.4) Grupp? GRUPPHUV Uppdatera

8 Bengt Reinholdsson (21) Kontroll görs även om behörighetsposter i BEHBESL ska skapas i samband med uppdatering. 1.5 Tabeller som läses och uppdateras Läses Uppdateras ANTINR X X ANTLIN X X BEHBESL X X EJUPPLIN X FFGKURS X X FFGLIN X X FORTKURS X X GRUPPHUV X X GRUPPRAD X X KTILL2 X KTILLP X LANTKURS X X LOKANTLB X X LOKANTLS X X OMKURS X X OMREGLIN X X OVERKURS X PROGPLH X PTILL X UPPLIN X X VALDKURS X X VALDINR X X V_LOKANTLB03 X 1.6 Utskrift av fel-/varningslista i RG-UPPDAT Kommer man in från RG01 och något fel upptäcks i RG_UPPDAT blir man stoppad och felmeddelandet skickas tillbaka till anropande RG01 formulär i en sträng. Kommer man in från RG02 eller RG03 skrivs en fel-/varningslista ut (RG02A02G/P) i RG_UPPDAT. Studenten skrivs ut på listan om det gäller en överlappande kurs och studenten har en tidigare registrering på den överlappande kursen. Uppdatering görs i detta fall. behörighetspost ska skapas i RG_UPPDAT men något går snett. Behörighetspost ska skapas om tidigare behörighetspost inte finns i BEHBESL och systempreferensen AUTOBEH=J finns samt om det gäller studier på avancerad nivå (KURS.UTBNIVA = 2 eller LINJE.TILTNIVA=2) och villkor finns i LOKANTLB och/eller i LANTKURS. Uppdatering görs i detta fall.

9 Bengt Reinholdsson (21) det gäller kursregistrering på program och ingen antagning (ANTLIN) till program finns eller skapas. det gäller kursregistrering på program med inriktning och ingen antagning finns alternativt skapas i ANTINR alt VALDINR, är studenten redan registrerad på annan inriktning skrivs meddelande ut om vilken inriktning studenten är registrerad på. någon av de generella kontrollerna slår in här, se vidare RG_FFGREG, RG_FOREG, RG_OMREG gpa_store går snett när man försöker spara till någon tabell. FFGKURS, FORTKURS, OMKURS, ANTLIN, ANTINR, VALDINR, LOKANTLB, LOKANTLS, LANTKURS, BEHBESL, GRUPPHUV och GRUPPRAD. studenten inte är behörig till kurs eller program/inriktning. Bearbetningen avbryts för aktuell student.

10 Bengt Reinholdsson (21) 2 Funktionella krav 2.1 RG_UPPDAT Allmänt Funktionen finns i ett formulär RG_UPPDAT och anropas med följande parametrar: (OBS i denna ordning) new_instance "RG_UPPDAT","RG_UPPDAT" activate "RG_UPPDAT".exec(funktion,varden,program,kurser,status) RG01: RG_UPPDAT anropas från följande formulär i RG01: - RG01B00G - RG01C00G (F00G, G00G) - RG01D00G - RG01E00G - RG01H00G Indata Funktion Varden Program Kurser Utdata: Status RG01_B, RG01_C, RG01_D, RG01_E eller RG01_H PNR, TERMIN, FORM ( form = formulär) TYP, PTERMIN, PROGR; PROGINR, URTABELL, SOKALT, EB_SKAPA_BEHBESL Typ = FFG, OM TYP, KURS, PROGR, PROGINR, ANMKOD, TAKT, KURSTID, UNDFORM, ORT, OMG, FINFORM, URTABELL, SOKALT, URTABELL2, GRUPP, EB_SKAPA_BEHBESL Typ = FFG, FO, OM returkod om uppdatering gått bra OK om det gått bra EJ_OK om något gått snett och inget felmeddelande skapats Har felmeddelande skapats vid någon kontroll i RG_UPPDAT visas det på meddelanderaden i anropande formulär. Finns något i PROGRAM ska uppdatering ske via Terminsregistrering Finns något i KURS ska uppdatering ske via Kursregistrering

11 Bengt Reinholdsson (21) RG02: RG_UPPDAT anropas från följande formulär i RG02: - RG02A01G Indata Funktion Varden Program Kurser Utdata: Status RG02 TYP, KURS, TERMIN, TAKT, TID, UNDFORM, ORT, OMGANG Typ = FFGA, FFGT, FO, OM blank PNR,PROGR,PROGINR,KURSTYP,URTAB,URTAB2, EB_SKAPA_BEHBESL returkod är PNR Finns något i KURS ska uppdatering ske via Kursregistrering RG03: RG_UPPDAT anropas från följande formulär i RG03: - RG03A02G Indata Funktion Varden Program Kurser Utdata: Status FLERA TYP, PTERMIN, PROGR; PROGINR, TERMIN Typ = FFG, OM URTABELL, PROGR, PNR, EB_SKAPA_BEHBESL blank returkod är PNR. Finns något i PROGRAM ska uppdatering ske via Terminsregistrering

12 Bengt Reinholdsson (21) 2.2 RG_UPPDAT Terminsregistering FFG-registrering Här förutsätts att bearbetning i RG_TERMREG (FFG) avsnitt samt att kontroll TREG i RG_GEN_KONTR är gjord. Resultat av uppdateringen: - En post i FFGLIN skapas alltid. Fälten PNR, PROGR, TERMORDN, TERMIN och PROGINR tas från fälten pnr, progr, progterm, termin resp proginr från bearbetningen i RG_TERMREG. Loggningsfälten IDATUM och ITID sätts till aktuella värden på datum och klockslag (det räcker med en avläsning av serverklockan för en hel lista i RG03). IANV sätts till aktuell inloggad användare. - En post i ANTLIN skapas om urtabellen är: o LOKANTLB med följande data: PNR, PROGR och ANTTERM tas från pnr, progr resp termin enligt RG_TERMREG. RESTLIN sätts till blank och KULL till samma värde som ANTTERM. KVOTGRP tas från LOKANTLB.URVGRP (slå upp med pnr, termin och sokalt som nycklar i LOKANTLB). LINFART, KURSTID, UNDFORM och ORT tas från aktuell post i PROGPLH om värden finns, annars från aktuell post i PTILL. FINFORM tas alltid från PTILL. o LOKANTLS med följande data: PNR, PROGR och ANTTERM tas från pnr, progr resp termin enligt RG_TERMREG. RESTLIN sätts till J. KULL tas från aktuell post i LOKANTLS (kan vara blank!). KVOTGRP sätts till blank. LINFART, KURSTID, UNDFORM och ORT tas från aktuell post i PROGPLH om värden finns, annars från aktuell post i LOKANTLS. FINFORM tas alltid från LOKANTLS. - En post i ANTINR skapas om proginr har ett värde från bearbetningen i RG_TERMREG och ingen sådan post finns förut. PNR, PROGR, PROGINR och TERMIN tas från pnr, progr, proginr resp termin i RG_TERMREG. - En post i FFGKURS skapas för varje post i VALDKURS där PNR, TERMIN, PROGR, PROGINR och TERMORDN stämmer med pnr, termin, progr, proginr resp progterm från RG_TERMREG - bearbetningen och där GENREG=J och där kontrollerna KREG uppfylls. KURSTAKT, KURSTID, UNDFORM och ORT tas från motsvarande fält i aktuell PROGPLH-post om sådana finns, annars från ANTLIN. KURSTYP tas från VALDKURS om det finns, annars från ANTLIN. OMGANG sätts alltid till 1 (ett). IDATUM, ITID och IANV fylls på samma sätt som i FFGLIN, VERNR sätts till blank. - En post i FORTKURS skapas för varje post i KTILLP där den striktare varianten av kontroller enligt RG_FFGREG uppfylls (dvs terminerna ska stämma) och GENREG=J. KURSTAKT, KURSTID, UNDFORM, ORT och OMGANG tas från aktuell post i FFGKURS. - Slutligen sätts REG till J i relevanta tabeller av UPPLIN, LOKANTLB, LOKANTLS och VALDKURS.

13 Bengt Reinholdsson (21) - En post skapas i BEHBESL om EB_SKAPA_BEHBESL=J. Kontroll har gjorts i anropande formulär om det är ett avancerat program (LINJE.TILTNIVA=2) om villkor finns i LOKANTLB, samt om behörighet saknas till programmet och om användaren har (AUTOBEH=J). - En sista behörighetskontroll göras innan uppdatering (mha gpa_kolla_beh) och om studenten saknar behörighet till kurs eller program avbryts bearbetningen för studenten. - Se kapitel 3 för hantering av studieavgifter OM-registrering Här förutsätts att bearbetning i RG_TERMREG avsnitt samt att kontroll TREG i RG_GEN_KONTR är gjord. Resultat av uppdateringen: - En post i OMREGLIN skapas alltid. Fälten PNR, PROGR, TERMORDN, TERMIN och PROGINR tas från fälten pnr, progr, progterm, termin respektive proginr från bearbetningen enligt Loggningsfälten IDATUM och ITID sätts till aktuella värden på datum och klockslag (det räcker med en avläsning av serverklockan för en hel lista i RG03). IANV sätts till aktuell inloggad användare. - En post i ANTINR skapas om proginr har ett värde från bearbetningen i och ingen sådan post finns förut. PNR, PROGR, PROGINR och TERMIN tas från pnr, progr, proginr resp termin i En post i FFGKURS skapas för varje post i VALDKURS där PNR, TERMIN, PROGR, PROGINR och TERMORDN stämmer med pnr, termin, progr, proginr resp progterm från bearbetningen och där GENREG=J och där kontrollerna KREG och KRIP uppfylls. KURSTAKT, KURSTID, UNDFORM och ORT tas från ANTLIN i alla lägen. KURSTYP tas från VALDKURS om det finns, annars från ANTLIN. OMGANG sätts alltid till 1 (ett). IDATUM, ITID och IANV fylls på samma sätt som i FFGLIN, VERNR sätts till blank. - Slutligen sätts REG till J i relevanta tabeller av EJUPPLIN och VALDKURS.

14 Bengt Reinholdsson (21) 2.3 RG_UPPDAT Kursregistrering FFG - registrering på kurs med hjälp av anmälningskod. Här förutsätts att registreringen bygger på ett förslag enligt avsnitt RG_FFGREG eller, om användaren själv angett anmälningskoden, att samma kontroller som i RG_FFGREG har genomförts. I det senare fallet måste dessutom kontroller på kursens eventuella programtillhörighet ha genomgåtts. Dessa beskrivs inte här. Resultat av uppdateringen: - En ny post skapas i FFGKURS. Tabellfälten PNR, KURS, PROGR, PROGINR, TERMIN, KURSTAKT, KURSTID, UNDFORM, ORT och OMGANG tas från motsvarande uppgifter i registreringsförslaget. KURSTYP i tabellen är detsamma som finansieringsform i förslaget. IDATUM sätts till körningsdatum (ISO-formatet), ITID till aktuellt klockslag (anropa gp_srvtime så att klockslaget är färskt, vid listuppdatering i RG02/RG03 räcker det med ett anrop innan listan börjar uppdateras) och IANV till inloggad Ladokanvändare. VERNR lämnas blankt (alltså inte NULL!). - Om ursprungstabellen är LOKANTLB ska en post skapas i ANTLIN. Slå upp aktuell post i LOKANTLB (med hjälp av pnr, termin och sokalt från förslaget) och aktuell post i PTILL (med hjälp av sokalt som PTILL.ANMKOD). Mappning av fälten i ANTLIN: Fält PNR PROGR ANTTERM RESTLIN LINFART KVOTGRP ORT UNDFORM FINFORM KULL KURSTID Ursprung Personnummer Program Aktuell registreringstermin <Blankt> (sic! Grön 2 är otydlig!) PTILL.PROGTAKT LOKANTLB.URVGRP PTILL.ORT PTILL.UNDFORM PTILL.FINFORM Aktuell registreringstermin PTILL.KURSTID Om PTILL.PROGINR har ett värde ska dessutom en ny post skapas i ANTINR:

15 Bengt Reinholdsson (21) Fält PNR PROGR PROGINR TERMIN Ursprung Personnummer Program PTILL.PROGINR Aktuell registreringstermin - Om ursprungstabellen är LOKANTLS ska en post skapas i ANTLIN. Slå upp aktuell post i LOKANTLS (med hjälp av pnr, termin och program som LOKANTLS.LINJE). Mappning av fälten i ANTLIN: Fält PNR PROGR ANTTERM RESTLIN LINFART KVOTGRP ORT UNDFORM FINFORM KULL KURSTID Ursprung Personnummer Program Aktuell registreringstermin "J" LOKANTLS.LINFART Lämnas blank LOKANTLS.ORT LOKANTLS.UNDFORM LOKANTLS.FINFORM LOKANTLS.KULL om den har ett värde, annars aktuell registreringstermin LOKANTLS.KURSTID Om LOKANTLS.INRIKT har ett värde ska dessutom en ny post skapas i ANTINR: Fält PNR PROGR PROGINR TERMIN Ursprung Personnummer Program LOKANTLS.INRIKT Aktuell registreringstermin

16 Bengt Reinholdsson (21) - Om proginr har ett värde i förslaget och ingen post för denna inriktning finns i ANTINR ska en ny sådan post skapas: Fält PNR PROGR PROGINR TERMIN Ursprung Personnummer Program Programinriktning Aktuell registreringstermin - En post skapas i BEHBESL om EB_SKAPA_BEHBESL=J. Kontroll har gjorts i anropande formulär om det är ett avancerat program/kurs (LINJE.TILTNIVA=2 alt KURS.UTBNIVA=2) om villkor finns i LOKANTLB eller LANTKURS, samt om behörighet saknas till programmet/kursen och om användaren har (AUTOBEH=J). Behörighetspost till program i BEHBESL uppdateras enligt följande: Fält PNR TERMIN LOPNR TYP OMFATTN KOD1 KOD2 DIARENR ANTECKN Ursprung Personnummer Aktuell registreringstermin Löpnummer under terminen I P UTBNIVA 2 Program (se ANTLIN) Programinriktning (se ANTINR annars blank) Blank FUNKTION;ANVKOD;DAGENS DATUM;KLOCKSLAG Behörighetspost till kurs i BEHBESL uppdateras enligt följande: Fält PNR TERMIN Ursprung Personnummer Aktuell registreringstermin

17 Bengt Reinholdsson (21) LOPNR TYP OMFATTN KOD1 KOD2 DIARENR ANTECKN Löpnummer under terminen I K UTBNIVA 2 Kurs Blank Blank FUNKTION;ANVKOD;DAGENS DATUM;KLOCKSLAG - Kontroll görs om kurs finns i OVERKURS.KURS1 eller OVERKURS.KURS2. Finns kurs så görs kontroll om studenten har en registrering (FFGKURS) på den överlappande kursen. - Till sist ska aktuella poster i underlagstabellerna uppdateras med REG=J. Värdena i urtabell och urtabell2 i förslaget visar vilka tabeller som är aktuella att uppdatera. LANTKURS ska dessutom uppdateras även då användaren själv angett anmälningskoden om en sådan post finns i LANTKURS. Tabell LOKANTLB LOKANTLS LANTKURS Värden för nyckelfält Pnr, termin och sokalt Pnr, termin och program Pnr, termin och anmalt - Se kapitel 3 för hantering av studieavgifter.

18 Bengt Reinholdsson (21) FFG - registrering på vald kurs inom program med terminsregistrering. Här förutsätts att registreringen bygger på ett förslag enligt RG_FFGREG, alt C eller, om användaren själv angett kurskoden, att samma kontroller som i RG_FFGREG C har genomförts (Glöm inte de generella kontrollerna KREG och KRIP). I det senare fallet måste dessutom kontroller på kursens eventuella programtillhörighet ha genomgåtts. Dessa beskrivs inte här. Resultat av uppdateringen: - En ny post skapas i FFGKURS. Tabellfälten PNR, KURS, PROGR, PROGINR, TERMIN, KURSTAKT, KURSTID, UNDFORM, ORT och OMGANG tas från motsvarande uppgifter i registreringsförslaget. KURSTYP i tabellen är detsamma som finansieringsform i förslaget. IDATUM sätts till körningsdatum (ISO-formatet), ITID till aktuellt klockslag (anropa gp_srvtime så att klockslaget är färskt, vid listuppdatering i RG02/RG03 räcker det med ett anrop innan listan börjar uppdateras) och IANV till inloggad Ladokanvändare. VERNR lämnas blankt (alltså inte NULL!). - Uppgifter i ANTLIN och ANTINR kan aldrig bli aktuella här, eftersom den gjorda terminsregistreringen redan har ombesörjt dessa uppdateringar. - Slutligen ska REG-fältet i VALDKURS sättas till "J" för aktuella poster. - Se kapitel 3 för hantering av studieavgifter FO - registrering på kurs. Här förutsätts att registreringen bygger på ett förslag enligt avsnitt RG_FOREG och att samma kontroller som i RG_FOREG har genomförts. Resultat av uppdateringen: - En ny post skapas i FORTKURS. Samtliga tabellfält tas från motsvarande uppgifter i registreringsförslaget (jfr avsnitt 2.3.1). Observera formatet på fältet TERMORDN: Högerjusterat med inledande blank för värden under 10. IDATUM sätts till körningsdatum (ISO-formatet), ITID till aktuellt klockslag (anropa gp_srvtime så att klockslaget är färskt, vid listuppdatering i RG02/RG03 räcker det med ett anrop innan listan börjar uppdateras) och IANV till inloggad Ladokanvändare. VERNR lämnas blankt (alltså inte NULL!). Inga följduppdateringar är aktuella och inte heller några REG-markeringar.

19 Bengt Reinholdsson (21) OM - registrering på kurs. Här förutsätts att registreringen bygger på ett förslag enligt avsnitt RG_OMREG och att samma kontroller som i RG_OMREG har genomförts. Resultat av uppdateringen: - En ny post skapas i OMKURS. Personnummer, kurs och termin tas från motsvarande uppgifter i förslaget. Inga loggningsfält förekommer. Inga följduppdateringar är aktuella och inte heller några REG-markeringar.

20 Bengt Reinholdsson (21) 3 Studieavgifter I de RG-funktioner man kan få upp förslag på registeringar görs en kontroll av betalningsunderlaget mot kontrollpaketet för studieavgifter(mf_check_fee). Underlaget kan ligga i LOKANTLB, LOKANTLS, UPPLIN, VALDKURS eller LANTKURS. Om svaret från kontrollpaketet är att betalning inte är gjord ska inget förslag läggas ut för underlaget. 3.1 Vid uppdatering av FFG-registrering för terminsregistering För att det ska vara möjligt att skapa en FFGKURS post för befintlig VALDKURS post måste vi först kontrollera att alla villkor som rör studieavgifter är uppfyllda. Kontrollera detta genom att anropa kontrollpaketet check_fee med förfrågan 4 och med sökvärden från VALDKURS. Om returkoden säger att allt är ok (Se kravspec check_fee för detaljerade returkoder) ska underlaget som finns i AVGTERM uppdateras med BETALT=J samt att det är ok att skapa upp post i FFGKURS. Om returkoden säger att det inte är ok ska ingen FFGKURS post skapas och felmeddelande ska visas. Är det så att det inte finns något underlag sedan tidigare och direktregistering görs så skapas betalningsunderlag upp i AVGTERM. 3.2 Vid uppdatering av FFG-registrering för kursregistering Vid uppdatering och LANTKURS uppdateras med REG=J kontrollera så det inte ligger kvar något studieavgiftsvillkor i något av villkorsfälten. Om det finns ett så ska det tas bort. Om uppdatering av LANTKURS gått bra ska betalningsunderlaget i AVGKURS uppdateras med BETALT=J alternativt saknas underlag så ska det skapas upp. 3.3 FFG - registrering på vald kurs inom program med terminsregistrering. Vid uppdatering och LOKANTLB uppdateras med REG=J kontrollera så det inte ligger kvar något studieavgiftsvillkor i något av villkorsfälten. Om det finns ett så ska det tas bort. För mer ingående krav se kravspec för varje RG-funktion och för kontrollpaketet check_fee.

21 Bengt Reinholdsson (21) 4 Icke funktionella krav 4.1 Underhållbarhet Programmeringsstandard Status: Godkänt Beskrivning: Prioritet: Måste 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. Beroenden: Ändringhistorik: