Engångsbatch för att skapa kurstillfällen för kurser inom program med terminsregistrering 2016-02-19
Thom Jönsson 2016-02-19 2 (13) Ändringshistorik Datum Av Kommentar Godkänd av 2014-11-26 Thom Jönsson Första versionen - 2015-02-16 Thom Jönsson Utökad information om resultatlistan - 2015-02-19 Thom Jönsson Möjlighet att ange parametrar för program som tillhör en lokal klass inom en lokal serie. - 2015-06-17 Anna-Carin Wiklund Lagt till kontroll på att kurspoäng inte får överstiga 99,9 för poster som ska skapas upp. 2016-02-19 PerLindgren Nytt kapitel för kända problem enkelt går att åtgärda
Thom Jönsson 2016-02-19 3 (13) Innehållsförteckning 1 INLEDNING... 4 1.1 SYFTE... 4 1.2 BESKRIVNING... 4 1.3 KÄNDA PROBLEM... 5 1.3.1 Ett till synes obegripligt felmeddelande i listningen... 5 2 BATCHBESTÄLLNING... 6 2.1 PARAMETRAR... 6 2.1.1 Obligatoriska parametrar... 6 2.1.2 Frivilliga parametrar... 6 2.2 EXEMPEL PÅ BATCHBESTÄLLNING... 9 3 RESULTATLISTA...10 3.1 SAMMANFATTNING AV KÖRNINGEN...10 3.2 FELMEDDELANDE...10 3.2.1 Om anmälningskoden uppnår högsta tillåtna värde...11 3.3 DETALJRADER...12
Thom Jönsson 2016-02-19 4 (13) 1 Inledning 1.1 Syfte Ladok3 kommer att kräva att det finns kurstillfällen med anmälningskoder för samtliga förstagångsregistreringar. För att inte utöka den redan stora komplexiteten i informationskonverteraren är det en fördel att skapa kurstillfällen i nuvarande Ladok. För program med terminsregistrering finns det i nuvarande Ladok katalogdata som kan användas för att skapa dessa kurstillfällen. Eftersom dessa kurstillfällen inte behövs i nuvarande Ladok kan det vara en fördel att lagra dem i nya tabeller, förslagsvis KTILL3 och KTFORT3. 1.2 Beskrivning Programmet läser i första hand tabellerna KTILLP, PROGPLK och PROGPLH för den termin som angetts i beställningen. Utifrån dessa tabeller skapas kurstillfällen som saknas i KTILL2 och KTFORT2 för att sedan läggas in i KTILL3 och KTFORT3. Övriga egenskaper hos EB47 Inspektionsläge eller uppdateringsläge kan väljas. Batchen går att köra mer än en gång. Efter körningen skapas en resultatfil med sammanfattning och detaljer om körningen. En sammanfattning skickas även via mail till beställaren.
Thom Jönsson 2016-02-19 5 (13) 1.3 Kända problem Här listas kända problem som vi hittat längs vägen och som det går att lösa på ett enkelt sätt. 1.3.1 Ett till synes obegripligt felmeddelande i listningen Åtgärd: https://jira.its.umu.se/browse/ladok-20529 Så här kan det se ut: Nedanstående KTILLP-poster har inte behandlats på grund av parametervalet STANDARDVÄRDEN=N.kurs='VFVD02', startter='19982', progr='dskdi', proginr=' _', termordk=' 1'kurs='VLED01', startter='19982', progr='dskdi', proginr=' _', termordk=' 1' Det här visade sig bero på att det fanns avvikande parameter inlagt via KA24 på kurstakt men övriga tre parametrar var inte inlagda. Löses genom att lägga in alla parametrar.
Thom Jönsson 2016-02-19 6 (13) 2 Batchbeställning 2.1 Parametrar I RB70 anges EB47 som engångsprogram. 2.1.1 Obligatoriska parametrar Nedanstående parametrar måste anges som villkor för den aktuella beställningen. UPPDATERA måste anges för att bestämma om batchen skall köras i Inspektionsläge eller Uppdateringsläge. Anges UPPDATERA=N kommer ingen uppdatering att genomföras. Inspektionsläge. Anges UPPDATERA=J sker uppdatering. Uppdateringsläge. INLEDANDETECKEN bestämmer det första tecknet i de anmälningskoder som används för nya kurstillfällen som skapas av batchen. Exempel: INLEDANDETECKEN=A innebär att nya kurstillfällen får anmälningskoderna A0001, A0002, A0003 o.s.v. TERMIN måste anges som beställningsvillkor och bestämmer vilken termin som batchen skall arbeta med. Exempel: TERMIN=H12 innebär att kurstillfällen som saknas för höstterminen 2012 kommer att skapas. 2.1.2 Frivilliga parametrar Nedanstående parametrar kan vid behov användas som villkor för den aktuella beställningen. STANDARDVÄRDEN kan användas för att förhindra att EB47 skapar kurstillfällen med standardvärden i de fall där relevant data inte hittas i databasen.
Thom Jönsson 2016-02-19 7 (13) Tillåts EB47 skapa kurstillfällen med standardvärden ska denna parameter inte anges. Anges STANDARDVÄRDEN=N skapas inga poster med standardvärden. Vid beställningen kan specifika program tilldelas värden för KURSTAKT, KURSTID, UNDFORM, ORT eller FINFORM (avser KURSTYP i kurstillfällestabellerna KTILL3 och KTFORT3). De valda värdena kommer då att användas för de kurstillfällen som ingår i dessa program när de skapas, under förutsättning att batchen inte redan har hittat och kopierat data från tabellen PROGPLH. Formatet som används är: <PROGRAMKOD>_<KOLUMN>=<VÄRDE> Exempel: LGRTA_UNDFORM=ITD LGRTA_ORT=1280 LGRTA_FINFORM=_ ger samtliga kurstillfällen som skapas och ingår i programmet LGRTA värdena ITD och 1280 för UNDFORM respektive ORT. Om FINFORM inte skall tilldelas något värde används understreck enligt exemplet ovan. Detta kommer sedan att läggas in i databasen som blankunderscore ( _ ). Om ett flertal program skall tilldelas samma värde för KURSTAKT, KURSTID, UNDFORM, ORT eller FINFORM kan parametrar anges för program som tillhör en lokal klass inom en lokal serie. Kurstillfällen som tillhör program i specificerad serie och klass tilldelas då det angivna värdet, under förutsättning att batchen inte redan har hittat och kopierat data från tabellen PROGPLH. Formatet som används är: SERIE_<SERIE>_KLASS_<KLASS>_<KOLUMN>=<VÄRDE> Exempel: SERIE_EB47ORT_KLASS_MALMÖ_ORT=1280 Ovanstående parameter skulle tilldela ortkoden 1280 till kurstillfällen som tillhör program inom serien EB47ORT och klassen MALMÖ. För att detta skall fungera måste lokal klassning av program först ha skapats i KA09 enligt exemplet i Figur1.
Thom Jönsson 2016-02-19 8 (13) Figur 1. Programmen KAKYM och VAFHÄ har lagts till den lokala serien EB47ORT och klassen MALMÖ. Som följd av detta kommer kurstillfällen tillhörande dessa program att tilldelas ortkoden 1280 om parametern SERIE_EB47ORT_KLASS_MALMÖ_ORT=1280 anges vid beställningen.
Thom Jönsson 2016-02-19 9 (13) 2.2 Exempel på batchbeställning Exempel på beställning av EB47: Figur 1. EB47 kommer att köras i inspektionsläge för Höstterminen 2012 med K som inledande tecken för nya anmälningskoder. Eftersom parametern STANDARDVÄRDEN inte anges kommer kurstillfällen med standardvärden att kunna skapas.
Thom Jönsson 2016-02-19 10 (13) 3 Resultatlista En lista skapas som redovisar resultatet av körningen. Överst i resultatlistan visas en sammanfattning av körningen inklusive eventuella fel som har hittats. Under sammanfattningen i resultatlistan visas mer utförlig information om eventuella fel, samt de kurstillfällen som har skapats under körningen. För att underlätta sökning i resultatfiler med många rader matchas varje summeringsrad i sammanfattningen med tillhörande detaljrubrik genom en gemensam siffra till vänster om raderna. Exempel på en summeringsrad och detaljrubrik som matchar varandra med hjälp av en gemensam siffra till vänster om raderna: (5) Antal poster som inte kan behandlas på grund av att POANG saknas i tabellen KURS: 1. (5) Nedanstående PROGPLK-Poster kan inte behandlas på grund av att POANG saknas i tabellen KURS. progr='plkbb', proginr=' _', termin='30001', kurs='plk02' 3.1 Sammanfattning av körningen En sammanfattning skrivs både i mailet till beställaren och överst i resultatlistan. Exempel på sammanfattning i inspektionsläge: (1) Antal poster som kommer att läggas in i tabellen KTILL3 vid skarp körning: 832. (2) Antal poster som kommer att läggas in i tabellen KTFORT3 vid skarp körning: 53. 3.2 Felmeddelande Ett felmeddelande genereras i resultatlistan om något av följande inträffar: En KTILLP-post som behandlas saknar värde i kolumnen POANG. Standardvärden för startvecka och slutvecka behöver kopieras från tabellen TERMIN, men saknas.
Thom Jönsson 2016-02-19 11 (13) Värdet i kolumnen POANG i tabellen KURS behöver kopieras, men saknas. Värdet i kolumnen POANG i tabellen KURS behöver kopieras men överstiger 99,9 poäng. En KTILLP-post som behandlas saknar förväntad post med lägre värde i kolumnen TERMORDK. Ett komplett kurstillfälle kan inte skapas på grund av parametervalet STANDARDVÄRDEN=N. Anmälningskoden med valt tecken (INLEDANDETECKEN) har uppnått högsta tillåtna värde (ex. A9999). En FORTKURS-post kan inte behandlas eftersom tillhörande post saknas i FFGKURS. Ett fortsättningstillfälle kan inte skapas på grund av någon av följande anledningar: o Alltför komplex uppbyggnad i KTILLP där samma kurs förekommer på olika program och med olika antal fortsättningsterminer. o Det råkar finnas en post i KTILL2 eller KTILL2/KTFORT2 sedan tidigare. Detta kan göra att ingenting skapas utifrån KTILLP trots att poängfördelningen eller antalet terminer skiljer. o EB47 skapar poster med kurstyp = blankunderscore. Två orsaker till detta är: Alla berörda poster i FFGKURS har något annat än blankunderscore i kurstyp. Detta går att lösa genom att lägga in parametrar för detta i RB70 vid beställning av batchen. De berörda posterna i FFGKURS har både blankunderscore och något annat i kurstyp. Detta går inte att lösa med parametrar i RB70. o EB48 och EB50 kommer att hantera de fortsättningstillfällen som inte kan skapas av EB47. Exempel på felmeddelanden när två KTILLP-poster saknar värde i POANG, och en förväntad post med lägre TERMORDK saknas: Antal KTILLP-poster som inte kan behandlas på grund av att de saknar värde i kolumnen POANG: 2. Antal poster som inte kan behandlas på grund av att post med lägre TERMORDK saknas i KTILLP eller inte heller har kunnat behandlas: 1. 3.2.1 Om anmälningskoden uppnår högsta tillåtna värde Om värdet som följer det inledande tecknet uppnår 9999 kommer inga ytterligare kurstillfällen att skapas under pågående batchkörning. Körningen kommer istället att avslutas med följande meddelande överst i resultatlistan: Högsta tillåtna värde för anmälningskod i KTILL3 har uppnåtts för valt INLEDANDETECKEN.
Thom Jönsson 2016-02-19 12 (13) Välj nytt INLEDANDETECKEN och kör EB47 igen för att skapa återstående kurstillfällen. Eventuella kurstillfällen som redan har skapats under körningen kommer att behandlas som om batchen slutförts normalt, d.v.s. dessa kommer att läggas in i KTILL3 och KTFORT3 om batchen körts i Uppdateringsläge. 3.3 Detaljrader Under sammanfattningen visas detaljer om eventuella fel samt de poster som har skapats och lagts in i KTILL3 och KTFORT3. Exempel på detaljrader i inspektionsläge när en post med TERMORDK=1 saknas för kursen FBF05 och poäng saknas i KURS för kursen PLKBB: Nedanstående KTILLP-poster kan inte behandlas på grund av att post med lägre TERMORDK saknas i KTILLP eller inte heller har kunnat behandlas. kurs='fbf05', startter='20121', progr='progf', proginr='inr5', termordk=' 2' kurs='fbf05', startter='20121', progr='progf', proginr='inr5', termordk=' 3' Nedanstående PROGPLK-Poster kan inte behandlas på grund av att POANG saknas i tabellen KURS. progr='plkbb', proginr=' _', termin='20121', kurs='plk02' Nedanstående poster skulle ha lagts in i KTILL3 vid skarp körning KURSKOD;STARTTER;KURSTAKT;KURSTID;UNDFORM;ORT;KURSOMG;KURSTYP;FFGPOANG;KOD;STARTV;SLUTV;L OK1;LOK2;PLANTAL;ANTALORD;ANTALRES;VALUTA;KONVERT;AVGFRI; AAA01; 20121;80;SEN;ONL;1212;1; _;0.5;Q2001;2001201;201223;;;;;;;;; Nedanstående poster skulle ha lagts in i KTFORT3 vid skarp körning KURSKOD;STARTTER;KURSTAKT;KURSTID;UNDFORM;ORT;KURSOMG;KURSTYP;TERMORDN;FORPOANG;KOD;TERMI N;STARTV;SLUTV;LOK1;LOK2;VALUTA;KONVERT; AAA01;20121;80;SEN;ONL;1212;1; _; 2;3.0;Q2001;20122;201232;201250;;;;; AAA01;20121;80;SEN;ONL;1212;1; _; 3;7.5;Q2001;20131;201302;201324;;;;; Exempel på när fortsättningstillfälle inte skapats Nedanstående fortsättningstillfällen kunde av någon anledning inte skapas. Se funktionsbeskrivningen för mer information. Under varje KTFORT3-post som inte kunde skapas visas antalet poster i FORTKURS som på grund av detta fortfarande saknar post i KTFORT3.
Thom Jönsson 2016-02-19 13 (13) kurskod='fms041', startter='20002', kurstakt='100', kurstid='dag', undform='nml', ort='1281', kursomg='1', kurstyp=' _', termordn=' 2', termin='20011' Antal poster i FORTKURS: 3