Kravspecifikation för överföring av meritdata mellan Ladok och CSN

Kravspecifikation för överföring av meritdata mellan Ladok och CSN 2011-06-21 Version: Beteckning: 1.09

Sida 2(14) Ändringshistorik Revision Datum Av Kommentar Granskare 0.01 2006-04-18 Jörgen Sondell Först utkastet - 1.00 2006-05-03 Jörgen Sondell Andra utkastet - 1.04 2006-06-02 Jörgen Sondell - Lagt in hur frågefilen från CSN ser ut - Lagt till info om hurresultatfilen skall namnsättas. - Lagt till info om hur mailet efter körning ser ut. 1.05 2006-06-12 Jörgen Sondell - Lagt till hantering av poängberäkning för totalpoängen. 1.06 2006-06-14 Jörgen Sondell - Ändrat utseendet i mailet man får efter körning. - Ändrat filnamnet 1.07 2006-08-29 Jörgen Sondell - Ändrat poängberäkningen för Godkprov och godkkurs - Ändrat så poängberäkningen så att ubindbg räknas med alltid. 1.08 2009-05-04 Jenny H Svensson Ändrat så att hämtning av merituppgifter tar hänsyn till villkorsformuläret som avgör vilka fristående kurser som ska klassas som basårskurser. 1.09 2011-06-21 Ulrik Sandgren Tagit bort referenser till Annan utbildning

Sida 3(14) Innehållsförteckning 1. INLEDNING... 4 2. 4 2.1 Bakgrund... 4 2.2 Syfte... 4 2.3 Uppdelning av funktionen... 4 3. STARTVILLKOR... 4 3.1 4.1 Inledningspost:... 6 3.2 4.2 Meritposter... 7 3.3 4.5 Slutpost:... 11 3.4 4.6 Katalogpost för ingående program:... 12

Sida 4(14) 1. Inledning 2. 2.1 Bakgrund Det är bestämt sedan tidigare att alla Cobol program ska ersättas med annan teknik. Dessa batchar kommer att utvecklas med både Uniface formulär och Java. I projekt 114 skapades generella formulär (GB01) i Uniface som ska kunna användas alla batch beställningar oavsett typ av batch. Projektet kommer att utnyttja så mycket som möjligt av GB01:s funktionalitet eftersom vi kommer att köra dessa funktioner som de är. Däremot måste projektet revidera formuläret för vilka villkor som finns i respektive delfunktion. Batchen kommer att skrivas i Java. 2.2 Syfte Syftet med arbetet är att ersätta dagens UC05, UC25 och UC30 samt avveckling av manuell rutin för leverans av terminstider. 2.3 Uppdelning av funktionen Funktionen UB20 delas upp i tre delfunktioner: UB20_B Hämtning av kataloguppgifter till CSN UB20_C Hämtning av registreringsuppgifter UB20_D Hämtning av meritdata 3. Startvillkor 4.2.2 UB20 Batchprogram Krav 1 Utläsning av Batchtabeller Sök i tabellen BATCHJOB om det finns någon batch som ska köras. SELECT * FROM utc.batchjob WHERE funktion = UB20_D AND datum = [dagens datum] AND tid = [server tid] Kontroll 5 Krav 2 Ändra status på beställningen När utläsning är gjord ska statusen i BATCHJOB.KODMARK sättas till P (dvs Körning pågår) När utläsning är gjord ska statusen i BATCHJOB.KODMARK sättas till P (dvs Körning pågår)

Sida 5(14) Man skall även spara undan den tid och datum som batchen startade i en variabel. Dessa sparas sedan om batchen godkänns i fältet för faktisk starttid i tabellen BATCHJOB STARTTID.BATCHJOB KORDDAT.BATCHJOB Krav 3 Läsning av tabeller: Läs in frågefilen och börja med att se till att endast de personer som finns i tabellen NAMN går vidare för läsning. (Alla studenter i Sverige finns i filen). Krav 4 Skrivning av meritdata till fil Utseendet på frågefilen från CSN är: * STARTPOST FRÅN CSN TILL LADOK * * POS INNEHÅLL * * 1-2 Posttyp 2 tkn Startpost=01 * * 3-22 Filler 20 tkn Blankt * * 23-24 Bearbettyp 2 tkn MF = meritfråga * * 25-35 Timestamp 11 tkn YYYYMMDD-HH * * 36-38 Leverantör 3 tkn CSN * * 39- Filler - Blankt * * * * FRÅGEPOST FRÅN CSN TILL LADOK * * POS INNEHÅLL * * * * 1-2 Posttyp 2 tkn 61 = Studieresfråga * * 3-6 Högskola 4 tkn Används inte * * 7-8 Pnr, sekel 2 tkn 19 eller 20 * * 9-18 Pnr 10 tkn ÅÅMMDDX999 * * 19-26 Fromdat-1 8 tkn ÅÅÅÅMMDD * * 27-34 Tomdat-1 8 tkn ÅÅÅÅMMDD * * 35-42 Fromdat-2 8 tkn ÅÅÅÅMMDD * * 43- Filler Blankt * * * * * * SLUTPOST FRÅN CSN TILL LADOK * * POS INNEHÅLL * * 1-2 Posttyp 2 tkn 99 = slutpost * * 3-22 Filler 20 tkn Blankt * * 23-24 Bearbtyp 2 tkn se startpost * * 25-35 Timestamp 11 tkn YYYYMMDD-HH * * 36-38 Leverantör 3 tkn CSN * * 39-45 Summa 7 tkn Antal poster i filen * * exkl start och slutposter * * 46- Filler Blankt *

Sida 6(14) * * * PÅ FILEN TILL CSN SKRIVS 3 SORTERS POSTER.* * * * OBS Start- och stoppdatum per månad ej giltigt efter år 2020 * 3.1 4.1 Inledningspost: Inledningsposten är generell och används för alla de olika filtyperna. Det som varierar är typkoden. 4.1.1 Posten ska innehålla information om att det är en inledningspost. ( posttyp 01=startpost) 4.1.2 Därefter följer ett blankt fält. 4.1.3 Typkod. I CSN:s dokument kallas det för Bearbetningstyp och kan ha följande värden. FK=katalog, KK=extra katalog, FA=antagning (gäller inte detta projekt), FR=registrering, FM=meriter. Typkoden varierar beroende på om inledningsposten avser kataloguppgifter, registreringar eller merituppgifter. Eftersom det är meriter så ska posttypen vara FM 4.1.4 Tidsmarkering ska innehålla tid och datum. Formatet skall vara ÅÅ-MM-DD-HH 4.1.5 Högskolebenämning innehåller högskolan benämning. Hämtas från definition av den egna högskola. BENAMN.EGENHSK. 4.1.6 Högskolekod innehåller högskolekoden. Koden lagras i Ladok med 3 tecken, men CSN vill ha 4 positioner för högskolekod. Hämtas från definition av den egna högskola. KOD.EGENHSK. 4.1.7 Lägg in värdet 0 Startpost: Pos Term DEF. L Beskrivning Ur. tabell Krav 1-2 Posttyp 01 2 Inledningspost - 4.1.1 3-22 Blank, Används 20-4.1.2 ej 23-24 Typkod FM 2-4.1.3 25-35 Tidmärkning 11 Markering av id I formatet ÅÅ- - 4.1.4

Sida 7(14) Pos Term DEF. L Beskrivning Ur. tabell Krav MM-DD-HH 36-115 Högskolebenämninbenämning 80 Högskole- EGENHSK 4.1.5 116-119 Högskolekod 4 Högskolekod EGENHSK 4.1.6 120 Värdet 0 0 1 4.1.7 3.2 4.2 Meritposter I beställningsfilen anges vilka personer merituppgifterna avser. 4.2.1 Posten ska innehålla information om att det är meritposter. (posttyp 21=meritposter) 4.2.2 Personnummer innehåller det personnummer som kom i frågefilen. Det förutsätter att personen finns på den aktuella högskolan. Kontroll görs mot NAMN för att endast få med de i filen som finns på den egna högskolan. 4.2.3 Högskolekod innehåller högskolekoden. Koden lagras i Ladok med 3 tecken, men CSN vill ha 4 positioner för högskolekod. Hämtas från definition av den egna högskola. KOD.EGENHSK. 4.2.4 Lägg in vilken typ det är P=Program, K=Kurs B=Basårsutbildning märkta med angiven finansieringsform. 4.2.5 Om det är resultat på program lägg in P i fältet Om det är fristående kurs lägg in K i fältet, är det däremot basårsutbildning lägger man in B i fältet. För att veta vilka fristående kurser som är basårskurser, dvs ges på gymnasienivå ska villkor i BATVILL kontrolleras för aktuell beställning., 6 4.2.6 Om det är program är det det första resultatdatumet på programmet som finns i GODKPROV eller GODKKURS för det aktuella programmet. Det är det tidigaste datumet av dessa två som gäller. Är det inte inom program så är det tidigaste datumet för kurser utan program som gäller. 4.2.7 Här läggs finansieringsformen för programmet in. Hämtas från ANTLIN Om det är kurs läggs blanka in. Om det är fristående kurs hämtas ingen finansieringsform alls. Lägg in blanka istället. Kontrollera om finansieringsform är densamma som finns angiven i BATVILL för aktuell beställning. Är det så se behandling för poängräkning.

Sida 8(14) 4.2.8 Här summeras poängen ihop för programmet från fromdatum1 tomdatum1 i indatafilen. Summeringen görs på så sätt att man först tar alla poster inom datumintervallet som finns i GODKKURS och summerar dessa. De godkända prov som ingår i kursen som ligger utanför datumintervallet måste subtraheras från poängtalet. Därefter läser man alla poster inom datumintervallet i GODKPROV som inte finns i GODKKURS och adderar på dessa poäng till totalen. Poängen för kurserna finns i tabellen KURS och poängen för prov finns i tabellen PROV. Finns prov i GODKPROV med något värde i TGPOANG.PROV skall dessa inte räknas med i summeringen. Hämta sedan också resultat från UBINDBG använd nycklarna på de poster man får träff på och slå i UBINDRG för att få fram vilken poäng som gäller för den posten. Detta adderas på övriga poäng. Om det finns flera program så skapas en post per program Om det är tomt i programfältet är det fristående kurs. En läsning ska ske mot FFGKURS för att kontrollera finansieringsform för kursen. Saknar posten finansieringsform eller om den är skild från den/de finansieringsformer som är angivna i BATVILL för aktuell beställning räknas kursen som en fristående kurs. Fristående kurser summeras till en post i filen, typ K (pos 17). Summering av poäng går till som beskrivet ovan. Upptäcker man vid kontrollen av FFGKURS att finansieringsformen är densamma som finna angiven i BATVILL för aktuell beställning räknas kursen som en basårsutbildning. Basårsuppgifter summeras till en post i filen, typ B (pos 17). Summering av poäng går till som beskrivet ovan. 4.2.9 Här summeras poängen ihop för programmet från fromdatum2 tomdatum1 i indatafilen. Summeringen görs på så sätt att man först tar alla poster inom datumintervallet som finns i GODKKURS och summerar dessa. De godkända prov som ingår i kursen som ligger utanför datumintervallet måste subtraheras från poängtalet. Därefter läser man alla poster inom datumintervallet i GODKPROV som inte finns i GODKKURS och adderar på dessa poäng till totalen. Poängen för kurserna finns i tabellen KURS och poängen för prov finns i tabellen PROV. Finns prov i GODKPROV med något värde i TGPOANG.PROV skall dessa inte räknas med i summeringen. Hämta sedan också resultat från UBINDBG använd nycklarna på de poster man får träff på och slå i UBINDRG för att få fram vilken poäng som gäller för den posten. Detta adderas på övriga poäng Om det finns flera program så skapas en post per program. Om det är tomt i programfältet är det fristående kurs. En läsning ska ske mot FFGKURS för att kontrollera finansieringsform för kursen. Saknar posten finansieringsform eller om den är skild från den/de finansieringsformer som är angivna i BATVILL för aktuell beställning räknas kursen som en fristående kurs. Fristående kurser summeras till en post i filen, typ K (pos 17). Summering av poäng går till som beskrivet ovan.

Sida 9(14) Upptäcker man vid kontrollen av FFGKURS att finansieringsformen är densamma som finna angiven i BATVILL för aktuell beställning räknas kursen som en basårsutbildning. Basårsuppgifter summeras till en post i filen, typ B (pos 17). Summering av poäng går till som beskrivet ovan. 4.2.10 Här summeras poängen ihop för programmet oberoende av datum. Summeringen görs på så sätt att man först tar alla poster inom datumintervallet som finns i GODKKURS och summerar dessa. De godkända prov som ingår i kursen som ligger utanför datumintervallet måste subtraheras från poängtalet. Därefter läser man alla poster inom datumintervallet i GODKPROV som inte finns i GODKKURS och adderar på dessa poäng till totalen. Poängen för kurserna finns i tabellen KURS och poängen för prov finns i tabellen PROV. Finns prov i GODKPROV med något värde i TGPOANG.PROV skall dessa inte räknas med i summeringen. Hämta sedan också resultat från UBINDBG använd nycklarna på de poster man får träff på och slå i UBINDRG för att få fram vilken poäng som gäller för den posten. Detta adderas på övriga poäng Om det finns flera program så skapas en post per program Om det är tomt i programfältet är det fristående kurs. En läsning ska ske mot FFGKURS för att kontrollera finansieringsform för kursen. Saknar posten finansieringsform eller om den är skild från den/de finansieringsformer som är angivna i BATVILL för aktuell beställning räknas kursen som en fristående kurs. Fristående kurser summeras till en post i filen, typ K (pos 17). Summering av poäng går till som beskrivet ovan. Upptäcker man vid kontrollen av FFGKURS att finansieringsformen är densamma som finna angiven i BATVILL för aktuell beställning räknas kursen som en basårsutbildning. Basårsuppgifter summeras till en post i filen, typ B (pos 17). Summering av poäng går till som beskrivet ovan. 4.2.11 Datum för godkänd kurs och prov. Om det finns godkända kurser och prov efter tomdatum1 så lägger vi in dessa i datumföljd här ända upp till 20 poster kan läggas in. Lägg in alla godkprov efter tomdat1 där ((provet - ev. tgpoang) > 0.)) Lägg in godkkurs efter tomdat1 där (poäng.godkkurs (ingående prov - ev. tgpoang) > 0). 4.2.12 Här läggs poängen för kursen eller provet som avses i 4.2.11 ut Poängen hämtas från KURS eller PROV 4.2.13 Fromdatum 1 från frågefilen

Sida 10(14) 4.2.14 Tomdatum 1 från frågefilen Poster för merituppgifter: Källa GODKPROV, GODKKURS, FFGKURS: Pos Term DEFA LT Längd Beskrivning Ur. tabell Krav 1-2 Posttyp 21 2 tkn Merituppgifter - 4.2.1 3-12 Pnr 10 tkn ÅÅMMDDNNNN NAMN 4.1.2 13-16 Högskola 4 tkn Ex: MH,LU,VXU EGENHSK 4.2.3 17 Typ av utbildning 1 tkn P=Program, - 4.2.4 K=Kurs 18-22 Utbildning 5 tkn Programkod eller 4.2.5 för kurs och basår K plus fyra blanka 23-30 Starttidpunkt 8 tkn YYYYMMDD 4.2.6 31-33 Kurstyp1 3 tkn Finform för 4.2.7 Program Typ av kurs för kurser 34-36 Kurstyp2 3 tkn Typ av kurs för 4.2.7 kurser om flera 37-39 Kurstyp3 3tkn Typ av kurs för 4.2.7 kurser om flera 40-42 Kurstyp4 3 tkn Typ av kurs för 4.2.7 kurser om flera 43-46 Poäng 4 tkn Summa poäng 4.2.8 under beviljningsperioden. Fromdatum-1 - Tomdatum-1 format 999V9 47-50 Summa poäng 4 tkn Summa poäng 4.2.9 under tiden Fromdat-2 tom Tomdatum-1 format 999V9 51-54 Poäng totalt 4 tkn Summa poäng på 4.2.10 programmet eller på kurser totalt format 999V9 55-62 Datum-1 8 tkn 1:a datum med 4.2.11 poäng efter tomdat- 1 tom kördatum 63-65 Poäng-1 3 tkn 99V9 Poäng för 4.2.12 264-271 datum-1 SÅ HÄR HÅLLER DET PÅ TOM DATUM-20 Datum-20 8 tkn 20:e datum med poäng efter tomdat- 1 tom kördatum 4.2.11

Sida 11(14) Pos 272-274 275-282 283-290 Term DEFA LT Längd Beskrivning Ur. tabell Krav Poäng-20 3 tkn 99V9 Poäng för datum-20 From-datum-1 8 tkn Från frågefilen 19-26 Tom-datum-1 8 tkn Från frågefilen 27-34 4.2.12 4.2.13 4.2.14 3.3 4.5 Slutpost: Slutsposten är generell och används för alla de olika filtyperna. Det som varierar är typkoden. 4.5.1 Posten ska innehålla information om att det är en slutpost. ( posttyp 99=slutpost) 4.5.2 Därefter följer ett blankt fält. 4.5.3 Typkod. I CSN:s dokument kallas det för Bearbetningstyp och kan ha följande värden. FK=katalog, KK=extra katalog, FA=antagning (gäller inte detta projekt), FR=registrering, FM=meriter. Typkoden varierar beroende på om inledningsposten avser kataloguppgifter, registreringar eller merituppgifter. Skall här vara FM. 4.5.4 Tidsmarkering ska innehålla tid och datum. Formatet ÅÅ-MM-DD-HH 4.5.5 Högskolebenämning innehåller högskolan benämning. Hämtas från definition av den egna högskola. BENAMN.EGENHSK. 4.5.6 Totala antalet poster av programtillfällen 4.5.7 Totala antalet poster av kurstillfällen 4.5.8 Används inte längre Slutpost: Pos Term Default Längd Beskrivning Ur.Tabell Krav

Sida 12(14) 1-2 Posttyp 99 2 tkn 99=slutpost 4.5.1 3-22 Filler 20 tkn Blankt, används ej 4.5.2 23-24 Bearbetningstyp FM 2 tkn FK=katalog 4.5.3 25-35 Timestamp 11 tkn Datum och klockslag ÅÅ-MM-DD-HH 4.5.4 36-115 Högskolebenämning 80 tkn Levererande EGENHSK 4.5.5 högskola 116-122 Summa 7 tkn Antal poster typ 4.5.6 05 123-129 Summa 7 tkn Antal poster typ 4.5.7 06 130-136 Summa 7 tkn Antal poster typ 15 4.5.8 3.4 4.6 Katalogpost för ingående program: Här hämtas kataloguppgifter för de poster som ingår i filen. Endast uppgifter om program hämtas. Katalogposten omsluts alltid av en start och slutpost som har bearbetningstyp= KK 4.6.1 Posten ska innehålla information om att det är en katalogpost. ( posttyp 07=katalogpostpost) 4.6.2 Högskolekod innehåller högskolekoden. Koden lagras i Ladok med 3 tecken, men CSN vill ha 4 positioner för högskolekod. Hämtas från definition av den egna högskola. KOD.EGENHSK. 4.6.3 Termin. Fyll fältet med 0:or 4.6.4 Anmärkning. Fyll med blanka 4.6.5 Anmärkning. Fyll med blanka 4.6.6 Programmets programkod som hämtas från KOD.LINJE 4.6.7 Programbenämning som hämtas från BENAMN.LIJE 4.6.8 Poängen för programmet som hämtas från POANG.LINJE Pos Term Default Längd Beskrivning Ur.Tabell Krav 1-2 Posttyp 07 2 tkn 07=meritpost 4.6.1

Sida 13(14) 3-6 Högskolekod 4 tkn Ex: MH,LU,VXU EGENHSK 4.6.2 5 tkn Lägg 0:or 4.6.3 7-11 Termin, används ej 12-19 Anmärkning KOD 20-21 Anmärkning KODUR 8 tkn Lägg blanka 4.6.4 2 tkn Lägg blanka 4.6.5 22-26 Program 5 tkn Ladoks programkod 27-86 Benämning 60 tkn Ladoks programbenämning 87-89 Poäng 3 tkn Format:999 Tex 120, 080 LINJE 4.6.6 LINJE 4.6.7 LINJE 4.6.8 Krav 6 När batchen är klar sparas det ner i tabellen BATCHJOB att körningen är klar och kördatum och starttid, och sluttid sparas ner. Har batchen avbrutits sparas endast värdet A i fältet KORDMARK.BATCHJOB. Krav 7 Filen som sparas ner på servern ska heta UB20_D_CSN_ högskoleförkortning _ datum och tid Krav 8 Mailet som man får efter avslutad körning skall innehålla följande info: --------------------------------------------- Körningen påbörjades Datum och tid och avslutades Datum och tid Lästa personer från frågefilen : 3841 Antal meritposter till CSN : 601 Antal katalogposter till CSN : 49 Körningsresultat: KLAR eller AVBRUTEN --------------------------------------------- Om körningen går fel (AVBRUTEN)skickas relevant felinformation med i mailet istället för de nedanstående uppgifterna. Lästa personer från frågefilen : 3841 Antal meritposter till CSN : 601 Antal katalogposter till CSN : 49 Kontroller: Kontroll 1 Börja med att kontrollera om start och slutvecka finns definierad i TERMIN, avbryt körningen och lämna meddelande om att dessa saknas i tabellen TERMIN. Finns start och slutvecka kan dessa sparas undan för att användas senare

Sida 14(14) Fyll ut fältet med blanka efter om antalet tecken inte fyller hela innehållet. Lägg inledande nollor på fältet om det inte fylls ut av innnehållet. Kontroll 4 Fyll ut fältet med 0:or efter om antalet tecken inte fyller hela innehållet. Kontroll 5 Gör kontroll om det finns ett senaste kördatum och en senaste starttid (KORDAT, STARTTID)för batchen i tabellen BATCHJOB. Saknas det avbryt batchen och lämna meddelande om att dessa värden saknas. Kontroll 6 Vid hämtning av meriter där villkor finns angivet i BATVILL ska en kontroll ske för fristående kurser mot FFGKURS. I villkorsformuläret finns specificerat en eller flera finansieringsformer som motsvarar basår på högskolan. Villkoret ser ut som BASAR=BAS; G. Där koderna BAS och G motsvarar olika finansieringsformer i FFGKURS (FFGKURS.KURSTYP). När meritpost läses ska kontroll ske om kursen som merit är tagen inom, motsvaras av en basårskurs. Det görs genom att jämföra FFGKURS.KURSTYP mot den/de finansieringsformer som är angivna som villkor i BATVILL. Finns aktuell finansieringsform upptagen som villkor ska Utbtyp i filen bytas från K till B. Är aktuell finansieringsform inte upptagen i BATVILL ska K behållas som utbtyp i filen. Summering ska ske för att poster av typen K och separat summering för postera av typen B. Enbart en post av K och B ska skickas per person, däremot kan en person ha flera P poster i samma fil.