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

Transkript

1 Kravspecifikation för överföring av meritdata mellan Ladok och CSN Version: Beteckning: 1.09

2 Sida 2(14) Ändringshistorik Revision Datum Av Kommentar Granskare Jörgen Sondell Först utkastet Jörgen Sondell Andra utkastet 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 Jörgen Sondell - Lagt till hantering av poängberäkning för totalpoängen Jörgen Sondell - Ändrat utseendet i mailet man får efter körning. - Ändrat filnamnet Jörgen Sondell - Ändrat poängberäkningen för Godkprov och godkkurs - Ändrat så poängberäkningen så att ubindbg räknas med alltid 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 Ulrik Sandgren Tagit bort referenser till Annan utbildning

3 Sida 3(14) Innehållsförteckning 1. INLEDNING Bakgrund Syfte Uppdelning av funktionen STARTVILLKOR Inledningspost: Meritposter Slutpost: Katalogpost för ingående program:... 12

4 Sida 4(14) 1. Inledning 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 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)

5 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 * * Bearbettyp 2 tkn MF = meritfråga * * Timestamp 11 tkn YYYYMMDD-HH * * 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 * * Fromdat-1 8 tkn ÅÅÅÅMMDD * * Tomdat-1 8 tkn ÅÅÅÅMMDD * * 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 * * Bearbtyp 2 tkn se startpost * * Timestamp 11 tkn YYYYMMDD-HH * * Leverantör 3 tkn CSN * * Summa 7 tkn Antal poster i filen * * exkl start och slutposter * * 46- Filler Blankt *

6 Sida 6(14) * * * PÅ FILEN TILL CSN SKRIVS 3 SORTERS POSTER.* * * * OBS Start- och stoppdatum per månad ej giltigt efter år 2020 * Inledningspost: Inledningsposten är generell och används för alla de olika filtyperna. Det som varierar är typkoden Posten ska innehålla information om att det är en inledningspost. ( posttyp 01=startpost) Därefter följer ett blankt fält 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 Tidsmarkering ska innehålla tid och datum. Formatet skall vara ÅÅ-MM-DD-HH Högskolebenämning innehåller högskolan benämning. Hämtas från definition av den egna högskola. BENAMN.EGENHSK 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 Lägg in värdet 0 Startpost: Pos Term DEF. L Beskrivning Ur. tabell Krav 1-2 Posttyp 01 2 Inledningspost Blank, Används ej Typkod FM Tidmärkning 11 Markering av id I formatet ÅÅ

7 Sida 7(14) Pos Term DEF. L Beskrivning Ur. tabell Krav MM-DD-HH Högskolebenämninbenämning 80 Högskole- EGENHSK Högskolekod 4 Högskolekod EGENHSK Värdet Meritposter I beställningsfilen anges vilka personer merituppgifterna avser Posten ska innehålla information om att det är meritposter. (posttyp 21=meritposter) 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 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 Lägg in vilken typ det är P=Program, K=Kurs B=Basårsutbildning märkta med angiven finansieringsform 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., 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 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.

8 Sida 8(14) 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 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.

9 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 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 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) Här läggs poängen för kursen eller provet som avses i ut Poängen hämtas från KURS eller PROV Fromdatum 1 från frågefilen

10 Sida 10(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 Pnr 10 tkn ÅÅMMDDNNNN NAMN Högskola 4 tkn Ex: MH,LU,VXU EGENHSK Typ av utbildning 1 tkn P=Program, K=Kurs Utbildning 5 tkn Programkod eller för kurs och basår K plus fyra blanka Starttidpunkt 8 tkn YYYYMMDD Kurstyp1 3 tkn Finform för Program Typ av kurs för kurser Kurstyp2 3 tkn Typ av kurs för kurser om flera Kurstyp3 3tkn Typ av kurs för kurser om flera Kurstyp4 3 tkn Typ av kurs för kurser om flera Poäng 4 tkn Summa poäng under beviljningsperioden. Fromdatum-1 - Tomdatum-1 format 999V Summa poäng 4 tkn Summa poäng under tiden Fromdat-2 tom Tomdatum-1 format 999V Poäng totalt 4 tkn Summa poäng på programmet eller på kurser totalt format 999V Datum-1 8 tkn 1:a datum med poäng efter tomdat- 1 tom kördatum Poäng-1 3 tkn 99V9 Poäng för 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

11 Sida 11(14) Pos 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 Tom-datum-1 8 tkn Från frågefilen Slutpost: Slutsposten är generell och används för alla de olika filtyperna. Det som varierar är typkoden Posten ska innehålla information om att det är en slutpost. ( posttyp 99=slutpost) Därefter följer ett blankt fält 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 Tidsmarkering ska innehålla tid och datum. Formatet ÅÅ-MM-DD-HH Högskolebenämning innehåller högskolan benämning. Hämtas från definition av den egna högskola. BENAMN.EGENHSK Totala antalet poster av programtillfällen Totala antalet poster av kurstillfällen Används inte längre Slutpost: Pos Term Default Längd Beskrivning Ur.Tabell Krav

12 Sida 12(14) 1-2 Posttyp 99 2 tkn 99=slutpost Filler 20 tkn Blankt, används ej Bearbetningstyp FM 2 tkn FK=katalog Timestamp 11 tkn Datum och klockslag ÅÅ-MM-DD-HH Högskolebenämning 80 tkn Levererande EGENHSK högskola Summa 7 tkn Antal poster typ Summa 7 tkn Antal poster typ Summa 7 tkn Antal poster typ 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 Posten ska innehålla information om att det är en katalogpost. ( posttyp 07=katalogpostpost) 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 Termin. Fyll fältet med 0:or Anmärkning. Fyll med blanka Anmärkning. Fyll med blanka Programmets programkod som hämtas från KOD.LINJE Programbenämning som hämtas från BENAMN.LIJE 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

13 Sida 13(14) 3-6 Högskolekod 4 tkn Ex: MH,LU,VXU EGENHSK tkn Lägg 0:or Termin, används ej Anmärkning KOD Anmärkning KODUR 8 tkn Lägg blanka tkn Lägg blanka Program 5 tkn Ladoks programkod Benämning 60 tkn Ladoks programbenämning Poäng 3 tkn Format:999 Tex 120, 080 LINJE LINJE LINJE 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

14 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.