Kontrollpaket check_utbtillf_avgift 2013-04-08 Beteckning: Ändringshistorik Datum Av Kommentar Godkännare 2013-04-08 PerLindgren Leverans från STU T 3101 studiavgifter
Per Lindgren 2013-04-08 2 (15) Innehållsförteckning 1 ÖVERSIKT... 3 1.1 NAMNSÄTTNING... 3 1.1.1 Uniface... 3 1.1.2 Java... 3 2 INPARAMETRAR... 4 3 UTPARAMETRAR... 4 4 ANVÄNDNING... 5 4.1 FRISTÅENDE KURS (KRAV R10 HITTA KTILL2)... 5 4.2 FÖRSTA TERMIN PÅ PROGRAM (R11 HITTA PTILL FÖRSTA TERMIN)... 5 4.3 KURS INOM PROGRAM (R13 HITTA PTILL FÖR KURS INOM PROGRAM/UPPFLYTTNING TERMINSREG)... 5 4.4 UPPFLYTTNING TILL NÄSTA TERMIN PÅ PROGRAM INOM TERMINSREG (R13 HITTA PTILL FÖR KURS INOM PROGRAM/UPPFLYTTNING TERMINSREG)... 6 4.5 SENARE DEL PÅ PROGRAM(R12 HITTA PTILL SENARE DEL PROGRAM)... 6 5 BEARBETNING... 7 5.1 KONTROLLERA INPARAMETRAR... 7 5.2 VAD SKA KONTROLLERAS... 7 6 KRAVFÖRTECKNING... 15
Per Lindgren 2013-04-08 3 (15) 1 Översikt Kontrollpaketet kollar om ett utbildningstillfälle är avgiftsfritt/avgiftsbelagt. Både kurstillfällen och programtillfällen kan kontrolleras. För kurs inom program görs koll utifrån antagning/registrering och aktuellt pnr behövs då. I vissa lägen kan vi inte bestämma om programmet har avgift eller inte. I dessa fall skickas svaret avgiftsbelagd + en varning. 1.1 Namnsättning Kravet används av både uniface och java. Namnsättningen är som följer: 1.1.1 Uniface I uniface hänvisas till mp_check_fee_utf 1.1.2 Java I java hänvisas till:
Per Lindgren 2013-04-08 4 (15) 2 Inparametrar Följande parametrar kan skickas in: P.PNR P.PROGR P.ANMKOD.KTILL2 (Tas från KTILL2.KOD) P.ANMKOD.PTILL (Tas från PTILL.ANMKOD) P.TERMIN P.KULL (används vid antagning senare del program) 3 Utparametrar Följande svar skickas tillbaka till anropande program: SVAR=AVGIFTSFRI/AVGIFTSBELAGD VARNING=TRUE/FALSE (default=false: TRUE sätts om någon tveksamhet finns. I dessa lägen är SVAR alltid = AVGIFTSBELAGD FELAKTIGA_PARAMETRAR=TRUE/FALSE(default=FALSE: TRUE sätts om felaktiga parametrar skickats in
Per Lindgren 2013-04-08 5 (15) 4 Användning 4.1 Fristående kurs (krav R10 Hitta KTILL2) När det gäller fristående kurs ska parametrarna P.TERMIN och P.ANMKOD.KTILL2 finnas inskickade. Denna variant används vid: Reservantagning Antagning registrering 4.2 Första termin på program (R11 Hitta PTILL första termin) När det gäller första termin på program ska parametrarna P.TERMIN och P.ANMKOD.PTILL finnas inskickade. Denna variant används vid: Reservantagning Antagning registrering 4.3 Kurs inom program (R13 Hitta PTILL för kurs inom program/uppflyttning terminsreg) När det gäller kurs inom program ska nedan parametrar användas: P.PNR P.PROGR Denna variant används vid: Reservantagning Antagning registrering
Per Lindgren 2013-04-08 6 (15) 4.4 Uppflyttning till nästa termin på program inom terminsreg (R13 Hitta PTILL för kurs inom program/uppflyttning terminsreg) När det gäller kurs inom program ska nedan parametrar användas: P.PNR P.PROGR Denna variant används vid: Uppflyttning till nästa termin när terminsreg används. Både: o Antagning o registrering 4.5 Senare del på program(r12 Hitta PTILL Senare del program) När det gäller senare del ska nedan nedan parametrar användas: P.PNR P.TERMIN P.PROGR P.KULL Denna variant används vid första terminen. Alltså när LOKANTLS.TERMIN = avsedd antagnings/registreringstermin. Detta kan gälla både programantagningen/registreringen och kursantagning/registering. Reservantagning (bara kurs) Antagning registrering
Per Lindgren 2013-04-08 7 (15) 5 Bearbetning 5.1 Kontrollera inparametrar 5.2 Vad ska kontrolleras R1 Bestäm vad som ska kontrolleras Utifrån de parametrar som skickats in avgörs vilket krav som ska utföras. Endast ett av kraven ska utföras! Om P.TERMIN + P.ANMKOD.KTILL2 o Utför krav R10 Hitta KTILL2 Om P.TERMIN + P.ANMKOD.PTILL o Utför krav R11 Hitta PTILL första termin Om P.TERMIN + P.PNR + P.PROGR + P.KULL o Utför krav R12 Hitta PTILL senare del Om P.PNR + P.PROGR o Utför krav R13 Hitta PTILL för kurs inom program/uppflyttning terminsreg Om inget av ovan villkor slagit in o FELAKTIGA_PARAMETRAR=TRUE
Per Lindgren 2013-04-08 8 (15) R10 Hitta KTILL2 Används när antagning finns till kurstillfälle. Observera att endast fristående kurs ska använda denna! Parametrar IN: P.ANMKOD.KTILL2 P.TERMIN parametrar UT: SVAR=AVGIFTSFRI/AVGIFTSBELAGD VARNING(TRUE/FALSE) default= FALSE. Om någon tveksamhet finns sätts TRUE. I dessa lägen är SVAR alltid = AVGIFTSBELAGD Läs i KTILL2 Läs KTILL2 (observera att det i värsta fall kan bli mer än en träff; ska antagligen aldrig inträffa i produktion) o KTILL2.STARTTER=P.TERMIN o KTILL2.KOD=P.ANMKOD.KTILL2 Om EN exakt träff o Om KTILL2.AVGFRI=J SVAR=AVGIFTSFRI o Annars SVAR=AVGIFTSBELAGD Om bom eller flera träff o SVAR= AVGIFTSBELAGD o VARNING=TRUE
Per Lindgren 2013-04-08 9 (15) R11 Hitta PTILL första termin Används när antagning finns till första termin på programmet(lokantlb). För vidhängande kurser kan man också använda denna om informationen från LOKANTLB finns tillgänglig. Parametrar IN: P.ANMKOD.PTILL P.TERMIN parametrar UT: SVAR=AVGIFTSFRI/AVGIFTSBELAGD VARNING(TRUE/FALSE) default= FALSE. Om någon tveksamhet finns sätts TRUE. I dessa lägen är SVAR alltid = AVGIFTSBELAGD Läs i PTILL läs PTILL o PTILL.TERMIN=P.TERMIN o PTILL.ANMKOD=P.ANMKOD.PTILL Om träff o Om PTILL.AVGFRI=J SVAR=AVGIFTSFRI o Annars SVAR=AVGIFTSBELAGD Om bom o SVAR= AVGIFTSBELAGD o VARNING=TRUE
Per Lindgren 2013-04-08 10 (15) R12 Hitta PTILL senare del på program Används när antagning till senare del på program finns(lokantls). För vidhängande kurser kan man också använda denna om informationen från LOKANTLS finns tillgänglig. Parametrar IN: P.PNR P.TERMIN P.KULL P.PROGR parametrar UT: SVAR=AVGIFTSFRITT/AVGIFTSBELAGD VARNING(TRUE/FALSE) default= FALSE. Om någon tveksamhet finns sätts TRUE. I dessa lägen är SVAR alltid = AVGIFTSBELAGD Läs LOKANTLS med nyckeln: LOKANTLS.PNR=P.PNR LOKANTLS.TERMIN=P.TERMIN LOKANTLS.LINJE= P.PROGR Om bom o SVAR=AVGIFTSBELAGD o VARNING=TRUE Om träff o Läs PTILL. Observera att det kan finnas fler än en träff med de parametrar vi skickar. PTILL.TERMIN=LOKANTLS.KULL PTILL.PROGR=LOKANTLS.LINJE PTILL.PROGINR=LOKANTLS.INRIKT PTILL.PROGTAKT=LOKANTLS.LINFART PTILL.ORT=LOKANTLS.ORT PTILL.UNDFORM=LOKANTLS.UNDFORM PTILL.FINFORM=LOKANTLS.FINFORM PTILL.KURSTID=LOKANTLS.KURSTID Om EN exakt träff Vi har hittat rätt PTILL. Om PTILL.AVGFRI=J o SVAR=AVGIFTSFRI
Per Lindgren 2013-04-08 11 (15) Annars o SVAR=AVGIFTSBELAGD Om fler än en träff Om alla träff har PTILL.AVGFRI=J o SVAR=AVGIFTSFRI Om alla träff har PTILL.AVGFRI=N o SVAR=AVGIFTSBELAGD Annars finns det olika värden i PTILL.AVGFRI o SVAR=AVGIFTSBELAGD o VARNING=TRUE Om bom SVAR=AVGIFTSBELAGD VARNING=TRUE Lämna check_utbtillf_avgift
Per Lindgren 2013-04-08 12 (15) R13 Hitta PTILL kurs inom program/uppflyttning terminsreg Används för kurs inom program och vid uppflyttning på termin vid terminsreg. Parametrar IN: P.PNR P.PROGR parametrar UT: SVAR=AVGIFTSFRITT/AVGIFTSBELAGD VARNING=TRUE/FALSE (default=false: TRUE sätts om någon tveksamhet finns. I dessa lägen är SVAR alltid = AVGIFTSBELAGD LOKANTLB i de flesta fall ska LOKANTLB finnas tillgänglig: Läs igenom alla LOKANTLB med LOKANTLB=P.PNR LOKANTLB.REG=J Om bom i LOKANTLB fortsätt med ANTLIN. Om träff (kan alltså vara flera träff i LOKANTLB) Läs PTILL o PTILL.TERMIN=LOKANTLB.TERMIN o PTILL.ANMKOD=LOKANTLB.SOKALT Om träff o Om PTILL.PROGR=P.PROGR Vi har hittat rätt PTILL. Om PTILL.AVGFRI=J SVAR=AVGIFTSFRI Annars SVAR=AVGIFTSBELAGD Lämna check_utbtillf_avgift Om bom o Fortsätt med ANTLIN
Per Lindgren 2013-04-08 13 (15) ANTLIN/ANTINR Läs ANTLIN med nyckeln: ANTLIN.PNR= P.PNR ANTLIN.PROGR=P.PROGR Blir det inte träff är det mycket märkligt men vi måste lämna check_utbtillf_avgift med SVAR=AVGIFTSBELAGD VARNING=TRUE Läs ANTINR Eventuellt kan det finnas en post i ANTINR på samma termin som ANTLIN.ANTTERM. Vi läser med följande värden: ANTINR.PNR = ANTLIN.PNR ANTINR.PROGR = ANTLIN.PROGR ANTINR.TERMIN = ANTLIN.ANTTERM.Skulle det bli fler än en träff är det helt galet så: SVAR=AVGIFTSBELAGD VARNING=TRUE Lämna check_utbtillf_avgift Det normala är bom eller en träff: Om bom använd blankunderscore i läsningen i PTILL nedan. Om träff använd ANTINR.PROGINR i läsningen i PTILL nedan. Läs PTILL Läs PTILL. Observera att det kan finnas fler än en träff med de parametrar vi skickar. PTILL.TERMIN=ANTLIN.ANTTERM PTILL.PROGR=ANTLIN.PROGR PTILL.PROGINR=ANTINR.PROGINR eller blankunderscore om post saknas i ANTINR PTILL.PROGTAKT=ANTLIN.LINFART PTILL.ORT=ANTLIN.ORT
Per Lindgren 2013-04-08 14 (15) PTILL.UNDFORM=ANTLIN.UNDFORM PTILL.FINFORM=ANTLIN.FINFORM PTILL.KURSTID=ANTLIN.KURSTID Om EN exakt träff o Vi har hittat rätt PTILL. o Om PTILL.AVGFRI=J SVAR=AVGIFTSFRI o Annars SVAR=AVGIFTSBELAGD Om fler än en träff o Om alla träff har PTILL.AVGFRI=J SVAR=AVGIFTSFRI o Om alla träff har PTILL.AVGFRI=N SVAR=AVGIFTSBELAGD o Annars finns det olika värden i PTILL.AVGFRI SVAR=AVGIFTSBELAGD VARNING=TRUE Om bom o SVAR=AVGIFTSBELAGD o VARNING=TRUE.
Per Lindgren 2013-04-08 15 (15) 6 Kravförteckning R1 BESTÄM VAD SOM SKA KONTROLLERAS... 7 R10 HITTA KTILL2... 8 R11 HITTA PTILL FÖRSTA TERMIN... 9 R12 HITTA PTILL SENARE DEL PÅ PROGRAM... 10 R13 HITTA PTILL KURS INOM PROGRAM/UPPFLYTTNING TERMINSREG... 12