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

Transkript

1 Kravspecifikation för överföring av katalogdata mellan Ladok och CSN Version: Beteckning: 1.05 Ändringshistorik Revision Datum Av Kommentar Granskare Godkännare Jörgen Sondell Först utkastet - - 0, Jörgen Sondell Andra Utkastet Jörgen Sondell -Ändrat algoritmen för avvikande terminstider Lagt till kontroll om att terminstider sak finnas definierade Lagt till att man ska lägga till tecken som fyller ut till full postlängd. Lagt in besvarade frågor Lagt till Kontroll1 och

2 Lagt till hur läsningen mot registreringstabellerna ska ske på övergripande nivå Jörgen Sondell - Separerat funktionerna och gjort en egen spec av endast katalogdatadelen Jörgen Sondell - Tagit bort dominerande utbildnngsområde Jörgen Sondell - Lagt till kontroller på summeringen i slutposten Jörgen Sondell -Ändrat utseendet i mailet man får efter körning. -Ändrat filnamnet Per Lindgren - Startv o slutv o Tagit bort hänvisningar till KTFORT2 under 4.3 katalogpost kurstillfällen Ulrik Sandgren Tagit bort referenser till Annan utbildning David Andersson Lagt till hantering av kurser med mer än 10 er. 1 Inledning 1.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. 1.2 Syfte Syftet med arbetet är att ersätta dagens UC05, UC25 och UC30 samt avveckling av manuell rutin för leverans av terminstider. 1.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 2 Startvillkor UB20 Batch program

3 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_B AND datum = [dagens datum] AND tid = [server tid] Om post hittas och villkor (=J) finns måste utsökning också göras i tabellen BATVILL. SELECT r.* FROM utc.batvill r, utc.batchjob h WHERE r.anvkod = h.anvid AND r.funktion = h.funktion AND r.beteckn = h.beteckn AND r.lopnr = h.lopnr Läs villkoret i varje rad och spara undan det. Observera att: Det måste finnas minst en post i BATVILL där TERMIN=XXXXX. Finns inte post ska felmeddelande skrivas ut på fellogg och uppdatera BATCHJOB.KORDMARK med A (avbruten). Krav 2 Ändra status på beställningen När utläsning är gjord ska statusen i BATCHJOB.KORDMARK sättas till P (dvs Körning pågår) Man skall även spara undan den tid som batchen startade i en variabel. Denna sparas sedan om batchen godkänns i fältet för faktisk starttid i tabellen BATCHJOB STARTTID.BATCHJOB Krav 3 Läsning av tabeller: HSK Läs upp information för start och slutpost: SELECT * FROM utc.egenhsk (endast en post ska finnas) KOD och BENAMN är de fält som används senare PTILL Läs upp information om programtillfälle: SELECT * FROM utc.ptill WHERE termin = inskickad termin men endast program som inte är nedlagda skall tas med SELECT * FROM utc.linje WHERE nedlagd!= J Alla poster används senare för inläggning i fil. Räkna även antalet poster eftersom det ska användas i slutposten. KTILL2 Läs upp information om kurstillfälle: SELECT * FROM utc.ktill2 WHERE startter = inskickad termin Alla poster används senare för inläggning i fil. Räkna även antalet poster eftersom det ska användas i slutposten. Ta endast med kurtillfällen som har NEDLAGD.KURS!= J. KTFORT2 Läs upp information om Kurstillfälle - ng SELECT * FROM utc.ktfort2 WHERE termin = inskickad termin Alla poster används senare för inläggning i fil. Räkna även antalet poster eftersom det ska användas i slutposten. Ta endast med kurtillfällen som har NEDLAGD.KURS!= J. Krav 4 Skrivning av katalogdata till fil:

4 Kör Kontroll 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 Tidsmarkering ska innehålla tid och datum. Formatet skall vara ÅÅ-MM-DD-HH Högskolebenämning innehåller högskolansbenämning. Hämtas från definition av den egna högskola. BENAMN.EGENHSK. Kontroll 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. Kontroll 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 FK Tidmärkning 11 Markering av id i formatet ÅÅ- MM-DD-HH Högskolebenämninbenämning 80 Högskole- EGENHSK Högskolekod 4 Högskolekod EGENHSK Värdet Katalogpost program:

5 I beställningen av batchen anges vilken termin kataloguppgifterna avser Posten ska innehålla information om att det är kataloguppgifter för program. (posttyp 05=kataloguppgift program) Högskolekod innehåller högskolekoden. Hämtas från definition av egna högskola. KOD.EGENHSK Termin, format Terminen väljs i beställningen och här returneras den termin som finns i anmälningsalternativet för program. TERMIN.PTILL Anmälningskod innehåller programmets anmälningskod från programtillfället. Lagras med 6 tecken i Ladok fyll ut med blanka efter. ANMKOD. PTILL Anmälningskodens ursprung. Värdet LA ska användas (Kan ha värdet LA=Ladok eller VH=VHS, men det är endast Ladok som är intressant för detta projekt) Ladoks programkod. Programkod för programtillfället PROGR.PTILL Ladoks programbenämning i klartext. BENAMN.LINJE för programmet. (Om det är 12.0 poäng skrivs det 0120) POANG.LINJE Eventuell inriktningskod. Om programmet har inriktning anges inriktningskoden. PROGINR.PTILL Inriktningsbenämning. Inriktning i klartext. BENAMN.LINJEINR för inriktningen. POANG.LINJEINR.

6 Ort där undervisning ges. Ort som anges i programtillfället. ORT.PTILL Programfart. Studietakten för programmet. PROGTAKT.PTILL. Rensa bort allt som inte är siffror (det kan av misstag kommit in tex. % eller_) (Lägg in inledande nollor om mindre än 100) Lokalt begrepp. Lägg in blanka tecken här Finansieringsform. Om programmet har finansieringsform anges koden. FINFORM.PTILL Stödberättigad utbildning. I Ladok anges om utbildningen berättigar till studiesstöd eller inte. Slå i tabellen ETYPBEN med FINFORM.PTILL = KOD.ETYPBEN med aktuell finanseiringsform. Om FINFORM.PTILL är blank sätt J. Om J i tabellen sätt J annars sätt N CSNBER.ETYPBEN Startvecka för antagningstermin. Antagningsterminen anges i tabellen PTILL. Läs STARTV i tabellen TERMTIDP slå med PROGR, PROGINR och TERMIN från PTILL samt med TERMORDN = 1 (antagningsterminen)om post saknas läs upp serien som är satt som sytempreferens för avvikande terminstider. Slå i tabellen Systpref med RUTIN = UB20 och använd SYSTPREF.STYRINFO när man läser mot LOKKPROG. SYSTPREF.STYRINFO = SERIE.LOKPROG, använd sedan LOKKOD för att läsa i tabellen TERMTID. Läs i tabellen TERMTID med LOKKOD och aktuell termin, om träff ta STARTV från LOKPROG annars tas STARTV från tabellen TERMIN Antagningsterminen anges i tabellen PTILL Slutvecka för antagningstermin. Antagningsterminen anges i tabellen PTILL. Läs SLUTV i tabellen TERMTIDP slå med PROGR, PROGINR och TERMIN från PTILL samt med TERMORDN = 1 (antagningsterminen)om post saknas läs upp serien som är satt som sytempreferens för avvikande terminstider. Slå i tabellen Systpref med RUTIN = UB20 och använd SYSTPREF.STYRINFO när man läser mot LOKKPROG. SYSTPREF.STYRINFO = SERIE.LOKPROG, använd sedan LOKKOD för att läsa i tabellen TERMTID. Läs i tabellen TERMTID med LOKKOD och aktuell termin, om träff ta SLUTVV från LOKPROG annars tas SLUTV från tabellen TERMIN Antagningsterminen anges i tabellen PTILL. Katalogposter för programtillfället: Källa PTILL: Pos Term Defalt Längd Beskrivning Ur. tabell Krav 1-2 Posttyp 05 2 tkn Katalogpost för programtillfälle 3-6 Högskola 4 tkn Ex: EGENHSK MH,LU,VXU 7-11 Termin 5 tkn Ex: PTILL Anmälningskod 8 tkn PTILL 4.2.4

7 Pos Term Defalt Längd Beskrivning Ur. tabell Krav Anmälningskod Ursprung LA 2 tkn Alltid LA=Ladok Programkod 5 tkn PTILL Programbenämning 60 tkn LINJE Poäng program 4tkn (999V9) LINJE Ev. inriktningskod 4 tkn PTILL Inriktningsbenämnin 60 tkn LINJEINR tkn för inriktning, LINJEINR format 999V9 Ortskod 4 tkn Ort där undervisning sker, ej säkert numerisk PTILL Programfart 3 tkn Format 999, med PTILL inledande nollor 166 Lokalt begrepp 7 tkn Finansieringsform 3 tkn PTILL Stödberättigad 1 tkn ETYPBEN utbildning Startvecka antagningstermin 6 tkn Format ÅÅÅÅVV TERMTIDP/TER MTID/TERMIN Slutvecka antagningstermin 6 tkn Format ÅÅÅÅVV TERMTIDP/TER MTID/TERMIN Katalogpost kurstillfällen: I beställningen av batchen anges vilken termin kataloguppgifterna avser. Man börjar med att läsa upp posterna som finns i KTILL2 och lägga in data från den tabellen i filen därefter läser och skriver man data från KTFORT2. Det måste finnas en motsvarande post för startterminen i KTILL2. Man läser då upp poster där STARTTER = inskickad termin och NEDLAGD.KURS!= J Posten ska innehålla information om att det avser kataloguppgifter för kurstillfällen. (posttyp 06=kataloguppgift kurs) 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 egna högskola. KOD.EGENHSK Termin, format Terminen väljs i beställningen och här returneras den starttermin som finns i anmälningsalternativet för kursen. STARTTER.KTILL2

8 4.3.4 Anmälningskod innehåller anmälningskoden för kurstillfället. Lagras med 5 tecken i Ladok. CSN vill 8 tecken. KOD.KTILL Anmälningskodens ursprung. Värdet LA ska användas (Kan ha värdet LA=Ladok eller VH=VHS, men det är endast Ladok som är intressant för detta projekt) Ladoks kurskod. Den kurskod som kopplas till kurstillfället. KURSKOD.KTILL Kursbenämning. Ladoks kursbenämning i klartext. BENAMNS.KURS. Om den är lägre än 58 tecken läggs bara de 58 första tecknen in Kursens poängomfattning. POANG.KURS Poäng denna termin. Det antal poäng som ges kursens starttermin (poäng för FFG-registrering). Antalet poäng för FFG-registrering och FO-registrering anges i kurstillfället. FFGPOANG.KTILL Kurstakt. Kod för kurstillfällets kurstakt. KURSTAKT.KTILL2. Rensa bort allt som inte är siffror (det kan av misstag kommit in tex. % eller_) Fyll på med inledande 0:or Kurstid. Kod för kurstillfällets kurstid. KURSTID.KTILL Undervisningform. Kod för kurstillfällets undervisningsform. UNDFORM.KTILL Kursort. Ort där undervisningen sker. ORT.KTILL Kursomgång. Den omgång på startterminen som kursen ges. Anges i kurstillfället. KURSOMG.KTILL Lokalt begrepp. Här framgår inte vad posten innehåller Termin för ng. Om kursen går över fler terminer så ska en ng göras för var och en av terminerna. Den eller de terminer som kursen har ng anges i tabellen KTFORT2. Det kan finnas flera terminer i tabellen för ett kurstillfälle och de skiljs åt via termin i ordning (inom kursen). TERMIN.KTFORT Terminspoäng för ng. Det antal poäng som avser kursens ng den aktuella terminen. FORPOANG.KTFORT2

9 Termin för ng och terminspoäng upprepas vid behov upp till 9 gånger. Se och Gå igenom alla poster som finns på det aktuella kurstillfället och titta på TERMORDN.KTFORT2 den anger vilken termin i ordningen som avses. Eftersom KTFORT2-tabellen har utrymme för 99 er och CSN endast kan ta emot 10 (se överföringsformatet under ) görs en trunkering av datat från KTFORT2. Detta innebär att endast de 10 första (sorterat på KTFORT2.TERMIN) erna kommer med i resultatfilen. Om sådan trunkering inträffar skrivs även ett varningsmeddelande ut i mailet till användaren som beskriver vilken kurs som påverkats och hur många poster som trunkerats Finansieringsform. Om kursen är märkt med finansieringsform anges koden. KURSTYP.KTILL Stödberättigad utbildning. I Ladok anges om utbildningen berättigar till studiestöd eller inte. Detta knyts till finansieringsform. CSNBER.ETYPBEN Startvecka för antagningstermin. Start och slutvecka för undervisning på terminen anges vid definition av terminstider. 1. I första hand från STARTV.KTILL2, finns inget här se p2. 2. Läs i tabellen SYSTPREF för att hämta STYRINFO.SYSTPREF. Nyckel = UB20_B. Använd värdet i STYRINFO för att läsa LOKKURS. LOKKURS.KURS = aktuell kurs, SERIE.LOKKURS = STYRINFO.SYSTPREF. Använd LOKKOD.LOKKURS + aktuell termin för att läsa TERMTID. Hämta STARTV här. Misslyckas p2 se p3. 3. Hämta STARTV i STARTV.TERMIN. Misslyckas detta så lägg blankt i STARTV, Skriv en notis i körloggen om detta Slutvecka för antagningstermin. Start och slutvecka för undervisning på terminen anges vid definition av terminstider. 1. I första hand från SLUTV.KTILL2, finns inget här se p2. 2. Läs i tabellen SYSTPREF för att hämta STYRINFO.SYSTPREF. Nyckel = UB20_B. Använd värdet i STYRINFO för att läsa LOKKURS. LOKKURS.KURS = aktuell kurs, SERIE.LOKKURS = STYRINFO.SYSTPREF. Använd LOKKOD.LOKKURS + aktuell termin för att läsa TERMTID. Hämta SLUTV här. Misslyckas p2 se p3. 3. Hämta SLUTV i STARTV.TERMIN. Misslyckas detta så lägg blankt i SLUTV. Skriv en notis i körloggen om detta. Slutet på posten skiljer sig åt mellan Kataloguppgifterna för kurstillfället vad gäller UC05, UC25 och CSN:s dokumentation. Se mer under frågor. Katalogpost för kurstillfälle Källa: KTILL2 och KTFORT2 Pos Term Default Längd Beskrivning Ur. tabell Krav 1-2 Posttyp 06 2 tkn 06=kurstilfälle Högskolekod 4 tkn EGENHSK Termin 5 tkn Format KTILL

10 20042=HT04, 20051=HV Anmälningskod 8 tkn KTILL Anmälningskod ursprung LA 2 tkn Kurskod 6 tkn Ladoks KTILL kurskod Kursbenämning 58 tkn Ladoks KURS kursbenämnin g tkn Poängomfattni KURS ng för kurs, format 999V Poäng denna 3 tkn Format 99V9 KTILL termin Kurstakt 3 tkn Format 999 KTILL Kurstid 3 tkn KTILL Undervisnings- 3 tkn KTILL form 102 Ortskod 4 tkn Ort där KTILL undervisning sker, ej säkert numerisk 106 Kursomgång 1 tkn Siffra KTILL Lokalt begrepp 7 tkn Lägg blanktecken tkn Termin 1 för KTFORT tkn Format 99V9 KTFORT tkn Termin 2 för KTFORT tkn Termin 3 för KTFORT tkn Termin 4 för KTFORT tkn Termin 5 för KTFORT

11 Finansieringsfor m Stödberättigad utbildning 198 Startvecka 203 antagnings termin Slutvecka antagningstermin 5 tkn Termin 6 för KTFORT tkn Termin 7 för KTFORT tkn Termin 8 för KTFORT tkn Termin 9 för KTFORT tkn Termin 10 för KTFORT tkn Format 99V9 KTFORT tkn tkn ETYPBEN tkn Format ÅÅÅÅVV 6 tkn Format ÅÅÅÅVV TERMIN TERMIN OBS! Pos kan vara blank, beroende på om det finns er och hur många det finns. KTFORT2 kan innehålla mer än 10 terminer vilket innebär att trunkering av data från KTFORT2 kan inträffa. 4.5 Slutpost: Slutsposten är generell och används för alla de olika filtyperna. Det som varierar är typkoden.

12 4.5.1 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 FK Tidsmarkering ska innehålla tid och datum. Där skiljer sig formatet mellan Ladoks tekniska programdokumentation och CSN:s Rutin mellan CSN och högskolor som använder Ladok Högskolebenämning innehåller högskolansbenämning. Hämtas från definition av den egna högskola. BENAMN.EGENHSK Totala antalet poster av programtillfällen Kontroll Totala antalet poster av kurstillfällen Kontroll Används inte längre Slutpost: Pos Term Default Längd Beskrivning Ur.Tabell Krav 1-2 Posttyp 99 2 tkn 99=slutpost Filler 20 tkn Blankt, används ej Bearbetningstyp FK 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 Krav 5 Filen som sparas ner på servern ska heta UB20_B_CSN_ högskoleförkortning _ datum och tid Krav 6 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

13 Beställning gjord på termin: XXXX Antal programtillfällen: 56 Antal kurstillfällen: 98 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. Beställning gjord på termin: XXXX Antal programtillfällen: 56 Antal kurstillfällen: 98 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 Fyll ut fältet med blanka efter om antalet tecken inte fyller hela innehållet. Kontroll 3 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.