UB03 Körloggsstatistik

Transkript

1 UB03 Körloggsstatistik

2 Bengt Reinholdsson (23) Ändringshistorik Datum Av Kommentar Godkännare Bengt Reinholdsson PerLindgren Specen fanns bara som pdf-dokument på ladok.se. Jag har konverterat till word men det blir inte så snyggt PerLindgren Åtgärderna Se eget kapitel Andreas Hed Uppdaterat med krav R7 för hur datum ska överföras till batchar frö rensning och överföring för LPW och PING

3 Bengt Reinholdsson (23) Innehållsförteckning 1 BATCHKÖRNING FÖR UB03_B BATCHKÖRNING FÖR UB03_C UTSKRIFT PÅ SKRIVARE UB03_C KONTROLLER TILLÄGG FÖR NY HANTERING AV RENSNING I TABELLERNA PINGLOGG O LPWLOGG BESTÄLLNINGSFORMULÄR: ÖVERFÖRING AV KÖRLOGG BATCH: ÖVERFÖRING AV KÖRLOGG Ladok LPW Ping BESTÄLLNINGSFORMULÄR: UTTAG AV KÖRLOGGSSTATISTIK BATCH: UTTAG AV KÖRLOGGSSTATISTIK KRAVFÖRTECKNING... 23

4 Bengt Reinholdsson (23) 1 Batchkörning för UB03_B Batch UB03_B (FUNK:389) Godkänd Skall 6.14 Utifrån de villkor som finns i BATVILL.VILLKOR VILLKOR="DATUM=ÅÅÅÅ-MM- DD" VILLKOR="FIL=T/F" VILLKOR="LADOK=T/F" VILLKOR="LPW=T/F" skall: Om "LADOK=T" - ska summering av poster i KORLOGG göras och sparas i KORLOGGA. Se krav "Systemdel UB03_B - LADOK - JAVA:435" Om "LPW= T"- ska summering av poster i LPWLOGG göras och sparas i LPWLOGGA. Se krav "Systemdel UB03_B - LPW - JAVA:434" Batchstart (FUNK:370) Avbrott i batchkörning (FUNK:393) Systemdel UB03_B - LADOK (FUNK:435) Systemdel UB03_B - LPW (FUNK:434) Batchstart (CTRL:862) Uppdatering (FUNK:368) Systemdel UB03_B - LADOK (FUNK:435) Godkänd Skall 6.8 Om LADOK = T i BATVILL.VILLKOR skall: alla poster i KORLOGG summeras på: o antalet träffar per funktion och o månad för o respektive användare där poster är o mindre eller lika med DATUM= ÅÅÅÅ-MM-DD. Finns poster sedan tidigare i en viss period skall de ny posterna adderas till de tidigare. Resultatet skall sparas i tabellen KORLOGGA exempel

5 Bengt Reinholdsson (23) Anvkod Datum Rutin Antal qqqqqq 0807 RG qqqqqq 0808 RG zzzzzzzz 0808 RS Batchstart (FUNK:370) Avbrott i batchkörning (FUNK:393) Kontroll systemdel (FUNK:395) Batch UB03_B (FUNK:389) Batchstart (CTRL:862) Uppdatering (FUNK:368) Systemdel UB03_B - LPW (FUNK:434) Godkänd Bör 6.15 Om LPW = T i BATVILL.VILLKOR skall: Summering ske på alla poster i LPWLOGG på antalet träffar per o Tjänst samt o delfunktion och o månad för o respektive användare 1) och typ 2) där poster är o mindre eller lika med DATUM=ÅÅÅÅ-MM-DD. Resultatet skall sparas i tabellen LPWLOGGA exempel Tjanst Metod Period Anvid Typ Antal LW06 Testmetod 0708 xxxx 1 10 LW06 Testmetod 0708 yyyy ) I förstahand skall ANVID.LPWLOGG användas. Finns inget där skall PNR.LPWLOGG användas och slutligen om inget data hittats i de båda tidigare fälten skall "Okänd" läggas in i ANVID.LPWLOGGA 2) När det gäller fältet TYP.LPWLOGG är 1 = student, 2 = Personal Om fältet är blankt skall värdet sättas till 2 = personal Avbrott i batchkörning (FUNK:393) Batchstart (FUNK:370) Batch UB03_B (FUNK:389) Batchstart (CTRL:862) Uppdatering (FUNK:368) Utskrift: Resultatfil UB03_B (FUNK:391) Godkänd Skall 9.4

6 Bengt Reinholdsson (23) Om reslutatfil skall sparas (dvs FIL=T) skall filen: namnsättas enligt namnstandard: Ladok: BATCH_UB03_C_LADOK_ååååmmdd_hhmm.txt LPW: BATCH_UB03_C_LPW_ååååmmdd_hhmm.txt sparas som en datafil (simikolonseparerd) och ska innehålla följande information (se S&G kap 8.2.4) se nedan efter avslutad körning och FIL= T skall o ny post skapas i BATFIL med resultatfilens namn o filen sparas på arena på servern för att användaren sedan kan hämta hem. Layout: Identifikation, t ex: UB03; ÅÅÅÅ-MM-DD; HH:MM; [användare]; Resultatfil överföring av körloggsstatistik För Classic och Nouveau gäller följande: Fältnamn, t ex: ANVKOD;RUTIN;DATUM;TID;SYSTEM Värden, t ex: IRMA; UB03; ; 1000; NOV För LPW gäller följande: Fältnamn, t ex: ANVID;PNR;TJÄNST;METOD;DATUM;TID;TYP;KOMMENT;SYSTEM Värden, t ex: IRMA; ; T01; getname; ; 11:11:11.111; 1; OK; LPW IRMA; ; T01; getname; ; 11:11:11.111; 1; OK; LPW Utskrift av resultatfil (FUNK:371) Efter avslutad körning UB03_B (FUNK:392) Godkänd Skall 3.18 Efter avslutad körning (dvs allt har fungerat) skall: tabellen BATCHJOB uppdaras KORDMARK = J poster som är mindre eller lika med DATUM i BATVILL raders från o tabellen KORLOGG om LADOK= T o tabellen LPWLOGG om LPW=T Efter avslutad körning ska e-postmeddelande skickas till den eller de adresser som angivits i BATINST. oom ingen e-post adress angivits i BATINST ska e-post adressen hämtas från ANVIP.EPOSTADR för användaren som lagt upp batchbeställningen.

7 Bengt Reinholdsson (23) Skulle e-post adress saknas i ovanstående tabell kan inget mail skickas. Avbrott i batchkörning (FUNK:393) E-postmeddelande (FUNK:399)

8 Bengt Reinholdsson (23) 2 Batchkörning för UB03_C Batch UB03_C. Batchstart UB03_C (FUNK:390) Godkänd Måste 7.13 Utifrån de villkor som finns i BATVILL.VILLKOR skall en sammaställning göras på den datafil. Sammanställning ska enbart göras på poster som är större eller lika med PERIOD_FROM= ÅÅMM och mindre eller lika med PERIOD_TOM= ÅÅMM. Summering skall göras på: o Totalt antal användare som öppnat funktionen o Totalt antal gånger funktionen har öppnats Om systemdelen är: o CL ska rutinens benämning hämtas från tabellen RUTIN o NOV ska funktionens benämning hämtas från tabellen NOVFUNK o LPW ingen benämning kan hämtas varför detta får lämnas blankt. Efter sammaställning ska det gå att ta ut vilka funktioner som inte används. Avbrott i batchkörning (FUNK:393) Batchstart (FUNK:370) Batchstart (CTRL:862) Efter avslutad körning UB03_C (FUNK:398) Godkänd Måste 4.17 Efter avslutad körning (dvs allt har fungerat) skall: tabellen BATCHJOB uppdaras KORDMARK = J e-postmeddelande skickas till den eller de adresser som angivits i BATINST. o Om ingen e-post adress angivits i BATINST ska e-post adressen hämtas från ANVIP.EPOSTADR för användaren som lagt upp batchbeställningen. Skulle e-post adress saknas i ovanstående tabell kan inget mail skickas. Avbrott i batchkörning (FUNK:393) E-postmeddelande (FUNK:399) Systemdel Ladok (FUNK:550) Utskrift: Datafil per funk UB03_C (FUNK:478)

9 Bengt Reinholdsson (23) Godkänd Skall 10.2 Datafilen skall sparas enligt: namnsättas enligt namnstandard, BATCH_UB03_C_FUNK_ååååmmdd_hhmm.txt Sammanställning per funktion och period utan hänsyn till användare, se nedan Identifikation, t ex: UB03; ÅÅÅÅ-MM-DD; HH:MM; [användare]; Körningsstatistik per funktion Totalt antal funktioner: nnn Totalt antal funktionsanrop: nnnnnn Fältnamn : FUNKTION;PERIOD;ANTAL;SYSDEL Värden, t ex: RG01;;0605;100;NOV AA10;;0605;10;CLA SQL- funktion och antal öppningar (SQL:482) Utskrift: Datafil Funktion+användare UB03_C (FUNK:407) Godkänd Skall 11.2 Datafilen skall sparas enligt: namnsättas enligt namnstandard, BATCH_UB03_C_ANV_FUNK_ååååmmdd_hhmm.txt Sammanställning per användare och funktion per period, se nedan Identifikation, t ex: UB03; ÅÅÅÅ-MM-DD; HH:MM; [användare]; Sammanställning uttag av körloggsstatistik per användare och funktion Totalt antal användare: antal funktioner: Totalt antal funktionsanrop: nnn Totalt nnn nnnnnn Fältnamn : ANVÄNDARE;FUNKTION;PERIOD;ANTAL;SYSDEL Värden, t ex: XXXVVV;RG01;0505;10;NOV QQQWWW;RG01;0505;5;NOV XXXVVV;AA11;0505;1;CLA

10 Bengt Reinholdsson (23) SQL lpw - Funktion, användare, antal öppnigar (SQL:493) SQL-Funktion, användare, antal öppnigar (SQL:486) Utskrift: Datafil Använda funk UB03_C (FUNK:479) Utkast Bör 4.6 Datafilen skall sparas enligt: namnsättas enligt namnstandard, BATCH_UB03_C_FUNKLIST_ååååmmdd_hhmm.txt vilka funktioner som används respektive inte används i respektive systemdel (gäller ej LPW tjänster) Sortering på funktion i stigande ordning Identifikation, t ex: UB03; ÅÅÅÅ-MM-DD; HH:MM; [användare]; Lista över använda/ej använda funktioner Fältnamn : FUNKTION;BENÄMNING;ANVÄNDS;SYSDEL; Värden, t ex: RG01;Registrering;J;NOV AA10;Diarieföring, mängdrutin;n;cla SQL använda funktioner (SQL:480) SQL ej använda funktioner (SQL:481) Systemdel LPW (FUNK:551) Utskrift:Datafil per tjänst (FUNK:552) Godkänd Måste 3.4 Datafilen skall sparas enligt: namnsättas enligt namnstandard, BATCH_UB03_C_TJANST_ååååmmdd_hhmm.txt Sammanställning per tjänst och period utan hänsyn till användare, se nedan Identifikation, t ex: UB03; ÅÅÅÅ-MM-DD; HH:MM; [användare]; Körningsstatistik per tjänst Totalt antal tjänster: nnn Totalt antal anrop: nnnnnn Fältnamn : Sysdel; Tjänst; Period; Antal Värden,t ex: LPW; IMS01; 502; 16 LPW; LW01; 502; 4 LPW; LW01; 503; 4

11 Bengt Reinholdsson (23) SQL lpw- Per tjänst (SQL:489) Utskrift:Datafil per deltjänst (FUNK:559) Godkänd Måste 5.5 Datafilen skall sparas enligt: namnsättas enligt namnstandard, BATCH_UB03_C_DELTJANST_ååååmmdd_hhmm.txt Sammanställning per tjänst och period utan hänsyn till användare, se nedan Identifikation, t ex: UB03; :29; AAAA; Körningsstatistik per deltjänst(metod) Totalt antal tjänster: nnn Totalt antal anrop: nnnnnn Fältnamn : Sysdel; Tjänst; Deltjänst; Period; Antal Värden,t ex: LPW; IMS01; getstudentsbycourseinstances; 502; 16 LPW; LW01; getalllokalcodesandserie; 502; 2 LPW; LW01; getalllokalcodesandserie; 503; 1 LPW; LW01; getalllokalcodesandserie; 505; 5 Utskrift:Datafil per per tjänst och användare (FUNK:560) Godkänd Måste 4.4 Datafilen skall sparas enligt: Namnsättas enligt namnstandard, BATCH_UB03_C_TJANST_ANV_ååååmmdd_hhmm.txt Sammanställning per användare och tjänst per period, se nedan Identifikation, t ex: UB03; :29; AAAA; Körningsstatistik per tjänst och användare. Totalt antal tjänster: nnn Totalt antal användare: nnn Fältnamn : Sysdel; Tjänst; Anvid; Period; Antal Värden,t ex: LPW; T01; ; 502; 1 LPW; T03; ; 502; 1 LPW; T24;

12 Bengt Reinholdsson (23) ; 502; 1 LPW; T24; ; 508; 15 Utskrift:Datafil pe rtyp (FUNK:561) Godkänd Måste 2.4 Datafilen skall sparas enligt: namnsättas enligt namnstandard, BATCH_UB03_C_TYP_ååååmmdd_hhmm.txt Sammanställning per tjänst och period samt typ av användare, se nedan Identifikation, t ex: UB03; ÅÅÅÅ-MM-DD; HH:MM; [användare]; Körningsstatistik per typ av användare Totalt antal tjänster: nnn Totalt antal anrop: nnnnnn Fältnamn : Sysdel; Tjänst; Period; Typ;Antal Värden,t ex: LPW; IMS01; 502; 1; 16 LPW; LW01; 502; 2; 4 LPW; LW01; 503; 1; 4 SQL lpw- Per tjänst (SQL:489) 2.1 Utskrift på skrivare UB03_C Utskrift på skrivare UB03_C. Utskrift: skrivare UB03_C (FUNK:408) Godkänd Önskas 2.7 Det ska gå att skriva ut sammanställning på skrivare. Utskriften ska gå att få i olika utförande: 1. Summering av körstatistik per funktion, gäller både Ladok och LPW 2. Summering av körstatistik per användare och funktion, gäller både Ladok och LPW 3. Summering av körstatistik per funktion och användare, gäller både Ladok och LPW 4. Sammanställning på använda respektive ej använda funktioner, gäller enbart Ladok

13 Bengt Reinholdsson (23) Utskrift per funktion Ladok (FUNK:409) Godkänd Önskas 2.8 Summering ska ske per funktion. Ingen summering på totalen är nödvändig FUNKTION ANTAL RG01 50 RG Utskrift per anv och funktion Ladok (FUNK:410) Godkänd Önskas 2.8 Summering ska ske per användare och funktion samt antalet funktioner som öppnats ANV FUNKTION ANTAL XXXQQQ RG01 50 XXXQQQ RG Antal funktioner 170 Utskrift per funktion och anv Ladok (FUNK:411) Godkänd Önskas 2.8 Summering ska ske per funktion och användare och samt antalet användare som öppnats funktionen FUNKTION ANV ANTAL RG01 XXXQQQ 50 RG01 XXXTTT 120 Antal användare 2 Utskrift använd/ejanvända funk Ladok (FUNK:412) Godkänd Önskas 2.8 Räckna upp funktionerna med funktionskod och benämning. Börja först med använda och därefter ej använda funktioner.

14 Bengt Reinholdsson (23) Vilken eller vilka listor som ska skrivas ut beror på vad som valts i villkorsformuläret i UB03 och hur villkret ser ut i VILLKR.BATVILL. LISTA ÖVER ANVÄNDA RUTINER FUNKTION BENÄMNING UT30 Antagna/reserver till kurs UT31 Förväntade deltagare i kurs UT32 Registrerade på kurs/inst UT33 Val av kurser - utskrift LISTA ÖVER OANVÄNDA RUTINER FUNKTION BENÄMNING KG03 KG12 KG20 KG21 KG22 Ortskoder Institutioner Utbildningsområden Ämnesgrupper Djup

15 Bengt Reinholdsson (23) 2.1 Kontroller Kontroller för alla batchar. Batchstart (FUNK:370) Status: Godkänd Prioritet: Måste Version: 1.13 Kontrollera att det finns villkor i tabellen BATVILL. Om det saknas ska inte batchen starta. Mail ska skickas med status AVBRUTEN och beställning sätts till A i BATCHJOB Batch UB03_B (FUNK:389) Batchstart UB03_C (FUNK:390) Systemdel UB03_B - LADOK (FUNK:435) Systemdel UB03_B - LPW (FUNK:434) Utskrift av resultatfil (FUNK:371) Godkänd Måste 3.4 Kontrollera om villkoret "LOGGFIL=" i BATVILL är T (Sant). (gäller enbart vid körning av UB03_B) Utskrift: Resultatfil UB03_B (FUNK:391)

16 Bengt Reinholdsson (23) 3 Tillägg för ny hantering av rensning i tabellerna PINGLOGG o LPWLOGG 3.1 Beställningsformulär: överföring av körlogg R1 Datum överför ladok Typ: Ledtext: Inmatningsfält datum Ange till vilken dag statistiken ska tas med Placering Format: Kontroller datum Får vara blankt Vanliga datumkontroller +

17 Bengt Reinholdsson (23) ADM_nnn Angivet datum får inte vara senare än dagens datum F1-hjälp: Till och med datum som statistiken tas med, 6 eller 10 tecken. Form: ÅÅMMDD eller ÅÅÅÅ- MM-DD R2 Månad överför lpw Typ: Ledtext: Inmatningsfält 4 tecken Ange till vilken månad statistiken ska tas med Placering Format: Kontroller AAMM Får vara blankt Korrekt angivet: År(AA) mellan Månad(MM) mellan 1-12 ADM_832 Period ska anges i formen ÅÅMM Angiven månad(aamm) får inte vara >= aktuell månad(aamm) UB03_nnn Angiven månad får inte vara lika med eller större än aktuell månad F1-hjälp: Till och med månad som statistiken tas med för lpw, 4 tecken. Form ÅÅMM R3 Månad rensa lpw Typ: Ledtext: Inmatningsfält 4 tecken Ange till vilken månad rensning ska göras Placering Format: Kontroller AAMM Får vara blankt Korrekt angivet: År(AA) mellan Månad(MM) mellan 1-12 ADM_832 Period ska anges i formen ÅÅMM

18 Bengt Reinholdsson (23) Angiven månad(aamm) får inte vara >överför.lpw.månad(aamm) om värde finns UB03_nnn Angiven månad får inte vara större än angiven månad för överföring Om överför.lpw.månad är blankt och rensa.lpw.månad <> blank Läs i tabellen LPWLOGGA och sök fram det högsta värdet i LPWLOGGA.PERIOD Angiven månad(aamm) får inte vara > LPWLOGGA.PERIOD Eller om poster helt saknas i LPWLOGGA UB03_nnn Det går inte att rensa data som inte är överfört F1-hjälp: Till och med månad som statistiken ska rensas för lpw, 4 tecken. Form ÅÅMM R4 Månad överför ping Typ: Ledtext: Inmatningsfält 4 tecken Ange till vilken månad statistiken ska tas med Placering Format: Kontroller AAMM Får vara blankt Korrekt angivet: År(AA) mellan Månad(MM) mellan 1-12 ADM_832 Period ska anges i formen ÅÅMM Angiven månad(aamm) får inte vara >= aktuell månad(aamm) UB03_nnn Angiven månad får inte vara lika med eller större än aktuell månad F1-hjälp: Till och med månad som statistiken tas med för ping, 4 tecken. Form ÅÅMM R5 Månad rensa ping Typ: Ledtext: Inmatningsfält 4 tecken Ange till vilken månad rensning ska göras Placering Format: Kontroller AAMM Får vara blankt Korrekt angivet: År(AA) mellan Månad(MM) mellan 1-12

19 Bengt Reinholdsson (23) ADM_832 Period ska anges i formen ÅÅMM Angiven månad(aamm) får inte vara >överför.ping.månad(aamm) om värde finns UB03_nnn Angiven månad får inte vara större än angiven månad för överföring Om överför.ping.månad är blankt och rensa.ping.månad <> blank Läs i tabellen PINGLOGA och sök fram det högsta värdet i PINGLOGA.PERIOD Angiven månad(aamm) får inte vara > PINGLOGA.PERIOD Eller om poster helt saknas i PINGLOGA UB03_nnn Det går inte att rensa data som inte är överfört F1-hjälp: Till och med månad som statistiken ska rensas för lpw, 4 tecken. Form ÅÅMM R6 Uppdatera Om uppdatera väljs och inga datum/perioder angivits: skriv felmedd och uppdateringen ska inte genomföras. R7 Namnsättning av parametrar till batch För att göra beställningar av rensning och överföring av statistik för LPW och PING används följande VILKOR i BATVIL. ÅÅMM representerar år och månad, batchen lägger till sista datum i vald månad för körning, t ex 1202 => LPW Överföring av statistik till och med datum: LPWLOGGTOMDATUM=ÅÅMM Rensning av statistik till och med datum: LPWRENSATOMDATUM=ÅÅMM PING Överföring av statistik till och med datum: PINGLOGGTOMDATUM=ÅÅMM Rensning av statistik till och med datum: PINGRENSATOMDATUM=ÅÅMM

20 Bengt Reinholdsson (23) 3.2 Batch: överföring av körlogg Ladok I ladokdelen fortsätter man med att rensa KORLOGG efter överföring till KORLOGGA LPW Om överföring är begärd(överför.lpw.månad <> blank) Läs in högsta värdet i LPWLOGGA.PERIOD. Är det högsta värdet 1112 ska aggregering starta from Sedan måste man även hålla koll på överför.lpw.månad (AAMM). Står det 1212 så tar man med data tom Fyll på med data i LPWLOGGA Om rensning är begärd(rensa.lpw.månad <> blank) Gör samma kontroller som i beställningsformuläret innan start av rensning. Om överför.lpw.månad <> blank Om rensa.lpw.månad > överför.lpw.månad Avbryt batchen och meddela i svarsmailet att beställningsformuläret skickar felaktiga data. Om överför.lpw.månad är blankt och rensa.lpw.månad <> blank Läs i tabellen LPWLOGGA och sök fram det högsta värdet i LPWLOGGA.PERIOD Rensa.lpw.månad får inte vara > högsta värdet i LPWLOGGA.PERIOD Eller om poster helt saknas i LPWLOGGA Avbryt batchen och meddela i avbrottssmailet att beställningsformuläret skickar felaktiga data Om kontrollerna passerats: rensa tom begärd månad(rensa.lpw.månad)

21 Bengt Reinholdsson (23) Ping Om överföring är begärd(överför.ping.månad <> blank) Läs in högsta värdet i PINGLOGA.PERIOD. Är det högsta värdet 1112 ska aggregering starta from Sedan måste man även hålla koll på överför.ping.månad (AAMM). Står det 1212 så tar man med data tom Fyll på med data i PINGLOGA Om rensning är begärd(rensa.ping.månad <> blank) Gör samma kontroller som i beställningsformuläret innan start av rensning. Om överför.ping.månad <> blank Om rensa.ping.månad > överför.ping.månad Avbryt batchen och meddela i svarsmailet att beställningsformuläret skickar felaktiga data. Om överför.ping.månad är blankt och rensa.ping.månad <> blank Läs i tabellen PINGLOGA och sök fram det högsta värdet i PINGLOGA.PERIOD Rensa.ping.månad får inte vara > högsta värdet i PINGLOGA.PERIOD Eller om poster helt saknas i PINGLOGA Avbryt batchen och meddela i avbrottssmailet att beställningsformuläret skickar felaktiga data. Om kontrollerna passerats: rensa tom begärd månad(rensa.ping.månad)

22 Bengt Reinholdsson (23) 3.3 Beställningsformulär: Uttag av körloggsstatistik 3.4 Batch: uttag av körloggsstatistik Ändringar för att ta hand om PINGLOGA. Eventuell begränsning på egen högskola för ping tas om hand. Ta emot ny parameter endast loggdata från egen hsk för ping.

23 Bengt Reinholdsson (23) 4 Kravförteckning R1 DATUM ÖVERFÖR LADOK R2 MÅNAD ÖVERFÖR LPW R3 MÅNAD RENSA LPW R4 MÅNAD ÖVERFÖR PING R5 MÅNAD RENSA PING R6 UPPDATERA R7 NAMNSÄTTNING AV PARAMETRAR TILL BATCH... 19