Funktionsbeskrivning EB20 Batch för konvertering av tillgodoräknaden för forskare 2008-11-20 Version: Beteckning: 1
Torgny Fridlund 2008-11-20 2 (8) Innehållsförteckning 1 ALLMÄNT... 3 2 FÖRBEREDELSER... 3 3 BESKRIVNING... 3 4 KONTROLLER OCH MEDDELANDEN... 4 5 BESTÄLLNING... 7 6 BEHÖRIGHETSANALYS... 7 7 PREFERENSSTYRNING... 7 8 UTSKRIFTER... 7 9 AVVIKELSER FRÅN S & G... 8 10 FORMULÄR OCH HJÄLPTEXTER... 8
Torgny Fridlund 2008-11-20 3 (8) 1 Allmänt Detta dokument beskriver batchen EB20. EB20 är ett engångsprogram och har som syfte att göra en flyttning/konvertering av gamla tillgododata för forskare till nya tillgododata. EB20 körs via RB70. RB70 är en generell batchbeställningsfunktion som används för att starta ett av användaren givet program. EB20 kan köras i inspektionsläge eller skarpt läge. Inspektionsläge innebär normalt att databasen inte uppdateras, men att listor skrivs ut som beskriver vad som har hänt, vilka felaktiga poster som finns etc. Uppdatering av databasen sker normalt endast om programmet körs i skarpt läge. EB20 fungerar dock litet annorlunda än andra batch-program. Se nedan Beskrivning. Funktionen består av en beställningsdel utvecklad i Uniface och en batchdel utvecklad i Java. En mera generell beskrivning av RB70 finns tillgänglig på Ladok-webben under Funktionsbeskrivningar. 2 Förberedelser Innan något skarpt arbete med konverteringen påbörjas är det viktigt att en back-up tas av tabellerna DOKKURS2 och DOKOMK för att kunna backa om något går snett. 3 Beskrivning Programmet läser alla poster i tabellen DOKKURS2. De poster som har data <> i fälten HSK eller UTLHSK och LAND räknas som tillgodoräknanden. Posten i DOKKURS2 jämförs med motsvarande post i tabellen DOKOMK. Om posten finns i DOKOMK och inga fel upptäcks (se nedan) flyttas data från DOKOMK till den nya tabellen FORSKTG och data från DOKKURS2 flyttas till den nya tabellen FTGGRUND. Nya löpnummer skapas för de nya tabellerna. För tabellutseenden se tabellbeskrivningar på Ladok-webben. Programmet kan köras i inspektionsläge (MODE=INSPEKTION) eller i skarpt läge (MODE= SKARP) då uppdatering av databasen sker. Om man kör i inspektionsläge skapas nya poster i tabellerna FORSKTG och FTGGRUND, men inga poster tas bort från DOKKURS2 och DOKOMK. Om man kör i skarpt läge skapas nya poster i tabellerna FORSKTG och FTGGRUND och poster som berörs i DOKKURS2 och DOKOMK tas bort från dessa tabeller. Programmet rensar automatiskt alltid bort alla poster i de nya tabellerna innan någon flyttning av data sker. Detta innebär att man kan köra EB20 i inspektionsläge flera gånger, men endast en gång i skarpt läge. Det ger högskolorna en möjlighet att innan den skarpa konverteringen gå igenom sin databas och kontrollera vilka fel mm som finns och därefter, om så önskas, göra vissa justeringar.
Torgny Fridlund 2008-11-20 4 (8) 4 Kontroller och meddelanden Följande kontroller genomförs: 1. Om det finns mer än en post i DOKOMK för motsvarande post i DOKKURS2 ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: För många poster i DOKOMK 2. Om en post i DOKKURS2 saknar motsvarande post i DOKOMK ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: Post saknas i DOKOMK 3. Om DOKKURS2.HSK saknas i tabellen ALLAHSK ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: Angiven kod för svensk högskola saknas i ALLAHSK 4. Om DOKKURS2.UTLHSK/LAND saknas i tabellen UTLHSK ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: Angiven kod för utländsk högskola saknas i UTLHSK 5. Om DOKKURS2.LAND saknas i tabellen LAND ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: Angiven kod för land saknas i LAND 6. Om DOKOMK.FOAMNE saknas i tabellen FOAMNE ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: Kod för forskarämne saknas i FOAMNE 7. Om DOKOMK.HANDLED/INST saknas i tabellen HANDLED ska personnummer och löpnummer skrivas ut på fellistan tillsammans med följande meddelande: Kod för handledare saknas i HANDLED Poster som berörs av fel enligt kontroll 1 och 2 förs aldrig över till de nya tabellerna (och tas aldrig bort från de gamla tabellerna). Dessa poster bör kontrolleras extra noga och ändras där det så är möjligt. För övriga fel gäller att de bör åtgärdas om det är möjligt och rimligt att göra det. Det bör bli många fel enligt kontroll 7 eftersom handledare ofta flyttar mellan institutioner. Denna typ av fel kan man i de flesta fall låta passera utan åtgärd.
Torgny Fridlund 2008-11-20 5 (8) Data flyttas (kopieras) enligt följande: Från: Till: DOKKURS2.PNR FORSKTG.PNR löpnr (beräknas maskinellt) FORSKTG.LOPNR 1 FORSKTG.RADNR DOKKURS2.FKURSKOD FORSKTG.FOKURS DOKOMK.OMPOANG FORSKTG.UTBPOANG DOKOMK.BESDATUM FORSKTG.BESDATUM DOKOMK.HANDLED FORSKTG.HANDLED DOKOMK.INST FORSKTG.INST FORSKTG.BENAMNS FORSKTG.BENAMNE FORSKTG.DIARIENR DOKOMK.FOAMNE FORSKTG.FOAMNE 3 FORSKTG.UTBNIVA DOKOMK.VALUTA FORSKTG.VALUTA DOKOMK.URSPOANG FORSKTG.URSPOANG DOKOMK.KONVERT FORSKTG.KONVERT DOKOMK.IDATUM FORSKTG.IDATUM DOKOMK.ITID FORSKTG.ITID DOKOMK.IANV FORSKTG.IANV
Torgny Fridlund 2008-11-20 6 (8) Från: DOKKURS2.PNR FORSKTG.LOPNR Till: FTGGRUND.PNR FTGGRUND.LOPNR 1 FTGGRUND.RADNR DOKKURS2.SPEC1+SPEC2 1) DOKKURS2.SPECE1+SPECE2 2) DOKKURS2.POANG DOKKURS2.DATUM DOKKURS2.URSPREX DOKKURS2.HSK DOKKURS2.UTLHSK DOKKURS2.LAND H /3 3) DOKKURS2.VALUTA DOKKURS2.URSPOANG DOKKURS2.KONVERT DOKKURS2.IDATUM DOKKURS2.IANV FTGGRUND.KURS FTGGRUND.BENAMNS FTGGRUND.BENAMNE FTGGRUND.BETYG FTGGRUND.BSKALA FTGGRUND.ANTECKN FTGGRUND.POANG FTGGRUND.DATUM FTGGRUND.EXAMINAT FTGGRUND.HSK FTGGRUND.UTLHSK FTGGRUND.LAND FTGGRUND.ECTSBET FTGGRUND.TYP FTGGRUND.UTBNIVA FTGGRUND.VALUTA FTGGRUND.URSPOANG FTGGRUND.KONVERT FTGGRUND.IDATUM FTGGRUND.IANV 1) Slå samman SPEC1 och SPEC2 (med blank emellan om så behövs). 2) Slå samman SPECE1 och SPECE2 (med blank emellan om så behövs). 3) I beställningsvillkoren kan eller 3 väljas för utbildningsnivå
Torgny Fridlund 2008-11-20 7 (8) 5 Beställning Följande uppgifter ska anges i RB70 för att starta program EB20. Program EB20 Beställningsvillkor Betydelse MODE=INSPEKTION Kontroller sker. Uppdatering av nya tabeller sker men ingen uppdatering av gamla tabeller MODE=SKARP Kontroller sker. Uppdatering av nya och gamla tabeller UTBNIVA=BLANK Utbildningsnivå sätts automatiskt till blank (default) i FTGGRUND UTBNIVA=3 Utbildningsnivå sätts automatiskt till 3 i FTGGRUND Observera att programmet är tänkt att bara köras en gång i skarpt läge. Det är därför viktigt att programmet körs i inspektionsläge först och att ev fel rättas till innan den skarpa körningen sker. Programmet rensar automatiskt alltid bort alla poster i de nya tabellerna innan någon flyttning av data sker. Till leveransen i november 2008 levererades endast möjligheten att köra i inspektionsläge. Iom leveransen i februari 2009 är det möjligt att även köra i skarpt läge. 6 Behörighetsanalys Användaren ska finnas i Ladok. Behörighetsklass styr behörighet till funktionen. 7 Preferensstyrning För engångsprogrammet finns inga preferenser, däremot för RB70. Se dokumentation för den funktionen. 8 Utskrifter Efter körningen är avslutad, oavsett om körningen gått bra eller inte, meddelas via mail resultatet av körningen. Mail går till de e-postadresser som angivits i inställningsformuläret enligt standard. För varje körning skrivs det ut en fellista och en statistiklista om hur många poster i DOKKURS2 som har behandlats.
Torgny Fridlund 2008-11-20 8 (8) Exempel på layout för statistiklista: Tabellnamn Antal lästa poster Antal flyttade och borttagna poster DOKKURS2 14504 14493 9 Avvikelser från S & G Inga avvikelser från S&G. 10 Formulär och hjälptexter Se funktionsbeskrivning för RB70. Formulär och hjälptexter finns inte för javabatchar.