Kravspecifikation Service Skapa Nouveau STU T-0107 Studieavgifter 2012-01-31 Status:
Jenny H Svensson 2012-01-31 2 (13) Ändringshistorik Datum Av Kommentar Godkännare 2010-10-21 Jenny H Svensson Första utkast - 2010-12-01 Jenny H Svensson Lagt till info om LOKANTLB 2011-02-02 Maria Vännman Lägger till Kontroll 3-2011-02-07 Jenny H Svensson Lagt till kontroll 4. 2011-03-09 Jenny H Svensson Förtydligat vad som händer vid borttag av antagning/återbud beroende på betalstatus. 2012-01-27 PerLindgren STUT-2101 avgifter 2013-01-31 Anna-Carin Wiklund kompletterat med kontroll per program STU T-3101 Studieavgifter Lagt till text om att ett nytt kontrollpaket är skapat som kontrollerar om ett utbildningstillfälle är avgiftsbefriat eller avgiftsbelagt.
Jenny H Svensson 2012-01-31 3 (13) Innehållsförteckning 1 INLEDNING... 4 1.1 SYFTE... 4 1.2 BESKRIVNING... 4 1.2.1 Händelseflöden... 4 1.3 BEHÖRIGHET/PREFSTYRNINGAR... 5 1.4 FÖRKLARINGAR... 5 1.4.1 Förklaringar av terminologi... 5 1.5 REFERENSER... 5 2 SERVICE SKAPA BETALNINGSUNDERLAG... 6 2.1 KONTROLLER... 11 2.2 MEDDELANDEN... 13 3 ÖPPNA OCH OBESVARADE FRÅGOR... 13 3.1 BESVARADE FRÅGOR... 13 4 KRAVFÖRTECKNING... 13 4.1 KONTROLLFÖRTECKNING... 13
Jenny H Svensson 2012-01-31 4 (13) 1 Inledning 1.1 Syfte Projektet STU-0107 ska göra det möjligt att hantera studieavgifter i Ladoksystemet. 1.2 Beskrivning När en antagning eller uppflyttning sker av en avgiftsskyldig student ska systemet skapa som gör det möjligt för lärosätet och systemet att kontrollera att avgiftsskyldig student har betalt sin studieavgift innan registrering kan ske. Betalningsunderlag skapas som motsvarar poster som läggs upp i LANTKURS respektive VALDKURS. Betalningsunderlag tas bort när motsvarande poster försvinner ur LANTKURS och VALDKURS. Undantaget om avgiften har status betald, är avgiften betald kan inte borttagning/återbud ske utan då måste underlagsposten hanteras först. Vid antagning ska även villkor läggas upp i underlagstabellerna LANTKURS och LOKANTLB för att garantera att ingen betalningsskyldig blir registrerad utan att studieavgifter har betalats. Denna funktionalitet kommer att används på flera ställen i systemet bland annat i SA02, SA03, SA33 och SA41. Därför utvecklas en service så att skapas på samma sätt oavsett var användaren befinner sig i systemet. Kraven ändras enbart på ett ställe. I den tekniska dokumentationen är det möjligt att se vilka funktioner som anropar denna service. 1.2.1 Händelseflöden Kontrollpaketet check avgift konstaterar att en student är avgiftsskyldig Om studenten är avgiftsskyldig ska vi med check_utbtillf_avgift kontrollera om utbildningstillfället är avgiftsfritt eller avgiftsbelagt och utifrån det skapa upp underlag i avgfritabellerna eller avg-tabellerna. Antagning sker villkor läggs till och underlag skapas upp. Uppflyttning sker underlag skapas upp. Antagning tas bort av administratör underlag raderas om status är ej betald eller återbetald Student tackar nej till antagning underlag raderas om status är ej betald eller återbetald Borttagning eller återbud när studieavgift är betald meddelande fås och användaren blir stoppad. Student blir ändrad från avgiftsskyldig till avgiftsbefriad lärosätet får själva korrigera befintliga.
Jenny H Svensson 2012-01-31 5 (13) Student blir ändrad från avgiftsbefriad till avgiftsskyldig lärosätet får själva korrigera berintliga. 1.3 Behörighet/prefstyrningar 1.4 Förklaringar 1.4.1 Förklaringar av terminologi Ord Avgiftsbefriad Avgiftsskyldighet Studieavgift Förklaring Personer kan vara avgiftsbefriade om de har medborgarskap inom EES eller Schweiz, eller uppehållstillstånd i något av dessa länder. Då behöver ingen anmälnings- eller studieavgift betalas vid studier i Sverige. Har personen ett medborgarskap kommer den uppgiften aldrig att kontrolleras igen utan gäller för all framtid. Personer som kommer från tredje land och saknar uppehållstillstånd anses avgiftsskyldiga och ska betala anmälningsavgift och studieavgift. Personer från tredje land som påbörjar studier from H11 ska betala en studieavgift till det lokala lärosätet som ska täcka kostnaderna för de studier som studenten bedriver. 1.5 Referenser Beskriv vilka ev. beroende som finns till andra dokument eller funktioner.
Jenny H Svensson 2012-01-31 6 (13) 2 Service Skapa R1 Kontroll av avgiftsskyldighet För att avgöra om en student är avgiftsskyldig inför den antagning som ska ske används kontrollen check_avgift i samband med att personnummer anges. Är personen avgiftsbefriad sker antagning utan att några poster skapas i avgiftsunderlagstabellerna. Blir svaret att personen är avgiftsskyldig ska kontroll mot check_utbtillf_avgift göras för att avgöra om utbidlningstillfället är avgiftsfritt eller avgiftsbelagt och utifrån det svaret ska poster för skapas i databasen. R2 Antagning till program När antagning sker till början av program ska för betalningsskyldiga studenter som antas till ett programtillfälle som är klassat som avgiftsbelagt ett studieavgiftsvillkor läggas till i LOKANTLB. Villkoret läggs i första lediga villkorsfält när övriga villkor har lagts till. Är alla villkorsfält använda ska villkor av typen Ö övrigt villkor tas bort och studieavgiftsvillkor läggas till. Kontroll C5 för att hitta studieavgiftsvillkor. Kontroll C6 för att hitta övrigt villkor Vid antagning till senare del av program kan inget villkor skapas då tabellen LOKANTLS inte innehåller villkor. Kontroll C4. R3 Uppdatering av VALDKURS/AVGTERM När antagning till eller uppflyttning inom ett program med terminsregistrering (LINJE.LINJEREG=J) sker för en student som är skyldig att betala studieavgifter ska ytterligare en kontroll göras genom kontrollpaketet check_utbtillf_avgift. Om svaret därifrån är att utbildningstillfället är avgiftsbelagt ska ett skapas i tabellen AVGTERM. Annars om svaret är att utbildningstillfället är avgiftsbefriat et skapas i tabellen AVGFRITE. För varje post som skapas i VALDKURS ska motsvarande skapas även i AVGTERM/AVGFRITE. AVGTERM 1. Pnr, termin, kurskod, program, termin i ordning.
Jenny H Svensson 2012-01-31 7 (13) 2. Betalt sätts till N=ej betalt avgift. 3. Fritext sätts till blank 4. Idatum blir dagens datum 5. Itid sätts till aktuell tid för uppdateringen 6. Ianv sätts till anvkod för användare som antar studenten. AVGFRITE 1. Pnr, termin, kurskod, program, termin i ordning. 2. Fritext sätts till blank 3. Idatum blir dagens datum 4. Itid sätts till aktuell tid för uppdateringen 5. Ianv sätts till anvkod för användare som antar studenten. Kontroll C1 R4 Borttagning från VALDKURS/AVGTERM/AVGFRITE Om studenten är avgiftsskyldig enligt check_avgift och antagningen till programmet tas bort eller om studenten tackar nej till sin antagning eller uppflyttning tas bort ska även underlagsposterna för betalning tas bort. Förutsatt att status i AVGTERM= N eller R. o Om borttag sker i VALDKURS: ta bort aktuell post i AVGTERM VALDKURS.PNR=AVGTERM.PNR VALDKURS.TERMIN=AVGTERM.TERMIN VALDKURS.KURS=AVGTERM.KURS VALDKURS.PROGR=AVGTERM.PROGR meddelande Posten borttagen. Posterna för underlag till registrering och studieavgift har också tagits bort.. Nytt meddelandenr ADM_1013. Kontroll C2 o Om borttag sker i AVGTERM på betald kurs: stoppa borttagningen. AVGTERM.BETALD = J
Jenny H Svensson 2012-01-31 8 (13) Kontroll C3. R5 Uppdatering av LANTKURS/AVGKURS När antagning sker till program med kursregistrering, terminsregisterering med anmkod eller fristående kurs för en student som är skyldig att betala studieavgifter ska ytterligare en kontroll göras genom kontrollpaketet check_utbtillf_avgift. Om svaret därifrån är att utbildningstillfället är avgiftsbelagt ska kurserna märkas upp med studieavgiftsvillkor i LANTKURS samt ett skapas i tabellen AVGKURS. Annars om svaret är att utbildningstillfället är avgiftsbefriat ska inget studieavgiftsvillkor läggas in i LANTKURS och et skapas i tabellen AVGFRIKU. För varje post som skapas i LANTKURS, oavsett om det är inom program med terminsregistrering, kursregistrering eller fristående kurs ska följande post skapas i AVGKURS, om utbildningstillfället är avgiftsbelagt, annars ska det skapas i AVGFRIKU. AVGKURS 1. Pnr, termin, anmkod 2. Om kursen läses inom ett program ska programkoden in i progr annars null. 3. Betalt sätt till N=ej betalt avgift 4. Fritext sätts till blank 5. Idatum blir dagens datum 6. Itid sätts till aktuell tid för uppdateringen 7. Ianv sätts till anvkod för användare som antar studenten AVGFRIKU 1. Pnr, termin, anmkod 2. Om kursen läses inom ett program ska programkoden in i progr annars null. 3. Fritext sätts till blank 4. Idatum blir dagens datum 5. Itid sätts till aktuell tid för uppdateringen 6. Ianv sätts till anvkod för användare som antar studenten
Jenny H Svensson 2012-01-31 9 (13) 1. Post i LANTKURS får studieavgiftsvillkor i det första lediga villkorsfältet: villkor, villkor2 eller villkor3 om utbildningstillfället är avgiftsbelagt. Kontroll C1 Kontroll C5 Studieavgiftsvillkor R6 Borttag av LANTKURS/AVGKURS/AVGFRIKU Vid borttag av programantagningen eller återbud ska vi även städa bort det som eventuellt lagts in i LANTKURS eller lägga in svar(svar=n). Gäller det en avgiftsskyldig student (kontroll vid pnr med hjälp av check_avgift)ska även motsvarande poster i AVGKURS tas bort. Förutsatt att status i AVGKURS= N eller R. Följande villkor gäller: Kontroll C2. Kontroll C3. o Om borttag sker i LANTKURS: ta bort aktuell post i AVGKURS LANTKURS.PNR=AVGKURS.PNR LANTKURS.TERMIN=AVGKURS.TERMIN LANTKURS.ANMALT=AVGKURS.ANMKOD meddelande Posten borttagen. Posterna för underlag till registerering och studieavgift har också tagits bort. Nytt meddelandenr ADM_1013. o Om borttag sker i AVGKURS på betald kurs: stoppa borttagningen. AVGKURS.BETALD = J
Jenny H Svensson 2012-01-31 10 (13) R7 Uppdatering av LOKANTLB/LOKANTLS/AVGPROGR När antagning sker till program sker för en student som är skyldig att betala studieavgifter ska kurserna märkas upp med studieavgiftsvillkor i LOKANTLB samt ett skapas till tabellen AVGPROGR/AVGFRIPR. Fråga 1 i check_avgift ska användas. Om svaret från check_avgift är att en student är avgiftsskyldig ska kontroll mot check_utbtillf_avgift göras för att avgöra om utbildningstillfället är avgiftsfritt eller avgiftsbelagt och utifrån det svaret ska poster för skapas i databasen. I AVGPROGR för avgiftsbelagda tillfällen och i AVGFRIPR för avgiftsbefriade tillfällen. För varje post som skapas i LOKANTLB/LOKANTLS, ska följande post skapas i AVGPROGR/AVGFRIPR. För eventuella tillhörande kursantagningar som skapas så ska dessa behandlas enligt kraven för kursantagningar. AVGPROGR Tas från/värde Kommentar PNR TERMIN PROGR BETALT FRITEXT IDATUM ITID IANV aktuellt pnr aktuell termin aktuellt program sätts till N blankt dagens datum aktuell tid vid inläggning aktuell användare AVGFRIPR Tas från/värde Kommentar PNR aktuellt pnr TERMIN aktuell termin PROGR aktuellt program FRITEXT blankt IDATUM dagens datum ITID aktuell tid vid inläggning IANV aktuell användare
Jenny H Svensson 2012-01-31 11 (13) Om utbildningstillfället är avgiftsbelagt ska posten i LOKANTLB får studieavgiftsvillkor i den första lediga villkorskolumnen: villkor1, villkor2 eller villkor3. LOKANTLS saknar villkorskolumner. Kontroll C1 Kontroll C5 Studieavgiftsvillkor R8 Borttag av LOKANTLB/LOKANTLS/AVGPROGR/AVGFRIPR + eventuella tillhörande kursantagningar Vid borttag av programantagning i LOKANTLB/LOKANTLS eller återbud(svar=n). observera att tillhörande kursantagningar/ också ska kollas. Kontroll C2. Kontroll C3. Om borttaget har gått bra: meddelande Posten borttagen. Posterna för underlag till registrering och studieavgift har också tagits bort. Nytt meddelandenr ADM_1013. 2.1 Kontroller C1 Befintlig post vid inläggning Om det vid uppdatering redan finns motsvarande post i AVGKURS eller AVGTERM eller AVGPROGR ska felmeddelande visas och uppdatering avbrytas. Uppdatering kan inte ske, underlag för avgift finns redan. Kontakta systemansvarig (ADM_1012). Antagningen går inte vidare. Detta gäller enbart om det är exakt samma post som användaren försöker lägga in. Lägger användaren in en programantaning som har samma inledande kurs som studenten redan har antagning till som fristående kurs ska antagning gå igenom och posten i LANTKURS och AVGKURS ska uppdateras med programkod. Inget meddelande visas. C2 Post saknas vid borttag
Jenny H Svensson 2012-01-31 12 (13) Om det vid borttag av en post saknas motsvarande post i AVGKURS eller AVGTERM eller AVGPROGR ska borttag ändå fortsätta av poster i LANTKURS eller VALDKURS eller LOKANTLB/LOKANTLS. C3 Betald post får ej tas bort Betald kurs får ej tas bort eftersom för att inte förstöra underlaget till migrationsverket. Om försök till borttag av en betald kurs ska uppdatering stoppas och felmeddelande skrivas ut. Nytt meddelande Antagningen kan inte tas bort då studieavgift är betald. / Återbud kan inte ske då studieavgift är betald. C4 Antagning till fristående kurs och kurs inom program Finns en antagning till fristående kurs för en student och antagning görs till program där samma kurs ingår som inledande kurs ska den befintliga antagningen i LANTKURS/VALDKURS samt underlaget i AVGKURS/AVGTERM uppdateras med programmärkning. C5 Kontrollera att studieavgiftsvillkor för aktuell termin finns i databasen För att säkerställa att studieavgiftsvillkoret finns i databasen ska vi innan vi lägger in det slå mot tabellen NYAMEDD. Denna tabell har ingen katalogfunktion och den fylls endast på när antagningsresultaten överförs från antagningssystemet. Detta ställer till problem vid antagning i Ladok innan överföringen är gjord. Läs NYAMEDD NYAMEDD.TERMIN=aktuell termin NYAMEDD.MEDDTYP= S Om träff Använd NYAMEDD.MEDDID som studieavgiftsvillkor( i skrivande stund =SV) Om bom ADM_xxxx Studieavgiftsvillkor saknas för aktuell termin. Kontakta systemansvarig! C6 Hitta villkor av typen Ö- övriga meddelanden för aktuell termin finns i databasen Läs NYAMEDD NYAMEDD.MEDDID=aktuellt villkor NYAMEDD.TERMIN=aktuell termin
Jenny H Svensson 2012-01-31 13 (13) Om träff och NYAMEDD.MEDDTYP = Ö har vi hittat rätt meddelande 2.2 Meddelanden ADM_1012 Uppdatering kan inte ske, underlag för avgift finns redan. Kontakta systemansvarig 3 Öppna och obesvarade frågor 3.1 Besvarade frågor 4 Kravförteckning R1 KONTROLL AV AVGIFTSSKYLDIGHET... 6 R2 ANTAGNING TILL PROGRAM... 6 R3 UPPDATERING AV VALDKURS/AVGTERM... 6 R4 BORTTAGNING FRÅN VALDKURS/AVGTERM/AVGFRITE... 7 R5 UPPDATERING AV LANTKURS/AVGKURS... 8 R6 BORTTAG AV LANTKURS/AVGKURS/AVGFRIKU... 9 R7 UPPDATERING AV LOKANTLB/LOKANTLS/AVGPROGR... 10 R8 BORTTAG AV LOKANTLB/LOKANTLS/AVGPROGR/AVGFRIPR + EVENTUELLA TILLHÖRANDE KURSANTAGNINGAR... 11 4.1 Kontrollförteckning C1 BEFINTLIG POST VID INLÄGGNING... 11 C2 POST SAKNAS VID BORTTAG... 11 C3 BETALD POST FÅR EJ TAS BORT... 12 C4 ANTAGNING TILL FRISTÅENDE KURS OCH KURS INOM PROGRAM... 12 C5 KONTROLLERA ATT STUDIEAVGIFTSVILLKOR FÖR AKTUELL TERMIN FINNS I DATABASEN... 12 C6 HITTA VILLKOR AV TYPEN Ö- ÖVRIGA MEDDELANDEN FÖR AKTUELL TERMIN FINNS I DATABASEN... 12