OPPSUMMERING
De viktigste endringene til versjon 9.4 er
- Strukturen i FS og FS-klienten er klargjort for integrasjon med utdanningsregisteret.
- Endring i feilhåndtering for forretningslogikk.
Detaljerte spesifikasjoner for strukturendringer; se FS-SD/001 Basisskjema. Alle nye felt er beskrevet, og denne beskrivelsen kommer frem i skjermbildene ved hjelp av funksjonstast F2, når skrivemerket står i det felt en ønsker beskrivelse for. Beskrivelse av tabellendringer finnes sist i dette dokumentet.
Spesielle punkter i forbindelse med oppgradering
- Ingen.
FS9.3 er basert på utviklingsverktøyet PowerBuilder – versjon 2022R3. Denne har støtte for Windows 10, Windows 11, Windows Server 2016, 2019 og 2022. Klienten er fortsatt en 32bit klient, men kan kjøres under 64bit Windows.
Versjonen støtter Oracle 23c.
Grå tekst angir at endringene er distribuert mellom versjon 9.3 og 9.4.
De fleste punktene er påført RT- og/eller Jiranummer som henviser til den saken som endringen er oppstått på grunnlag av.
Saker merket med r* legges ut med versjon 9.4.0.*
Oppdateringer utført i forbindelse med oppgraderingen
- Ingen
BILDER
Generelt
- Bilder fra gammel kvalifikasjonsmodul er tatt vekk. FS-1485
- Samisk og engelsk navnevariant har byttet plass i noen bilder - for å få samme rekkefølge: Bokmål - Nynorsk - Samisk - Engelsk. FS-1535
- Tabellen Subject Area er ikke lengre i bruk, denne erstattes med ISCED-F ved utveksling av data (EMREX, EWP, ...). Det er dermed gjort noen endringer i bilder og rapporter som gjelder dette (alle endringene er nevnt i dette dokumentet). r1 FS-1583
- Dialogen Søk på fag som kommer frem når en i felt for fagkode trykker Ctrl-T er endret: Her er Subject Area erstattet med Isced-F. r1 FS-1583
Det er lagt inn en generell sperre mot sletting av personroller (FS9.4.0.1). Årsaken til dette er problemstillinger rundt synkronisering mot andre tjenester, spesielt LMS (inkl Canvas). En må for disse legge inn slutt-dato på rollen i stedet for å slette dem. Det gis en melding om dette ved forsøk på sletting.
Dette gjelder en rekke bilder: Student samlebilde, Fagperson samlebilde, Personrolle, Kull samlebilde, Undervisningsenhet samlebilde, Undervisningsaktivitet samlebilde, Undervisningstimeplan med lærer, Etterutdanningskurs samlebilde, Kursaktivitet samlebilde, Studieprogram samlebilde, Emne samlebilde
r1Reversert i r2 FS-1584
OPPTAK
Generelt
Rutinen for beregning og lagring av vekting høyere utdanning er endret slik at automatisk beregning til 0 studiepoeng vil overskrive eksisterende verdi. Rutinen vil ikke slette disse, med sette 0SP i vektingskolonnen, med kommentar om endringen. Denne beregningen vil også ved nyregistrering av studiepoeng sette N i kolonnen La stå.
Videre er klienten endret til FS9.3.2.0 slik at den ved manuell nyregistrering setter J i kolonnen La stå. Disse vil da ikke overskrives av den automatiske beregningen. RT440746
Søknad samlebilde
Fane HøyUtd (Omfang for høyere utdanning): Ved manuell nyregistrering av rader vil kolonnen La stå automatisk settes til J. Nummerkolonnen settes automatisk som i Søknad samlebilde UHG. RT440746
Søknad samlebilde UHG
Fane HøyUtd (Omfang for høyere utdanning): Ved manuell nyregistrering av rader vil kolonnen La stå automatisk settes til J. RT440746
GODKJENNING
Person Eksternstudium Samlebilde
Fane Resultater: Feltet Subject Area er tatt vekk (ISCED-F er innført i EMREX datautveksling, men enda ikke lagt til som kolonne her. Dette kommer på et senere tidspunkt). r1 FS-1583
PROGRAMSTUDENT
Kull samlebilde
Ny fane: Campus. Denne er innført for rapportering av utdanningsinstans for studieprogram til Utdanningsregisteret. Denne rapporteringen gjøres for kombinasjonen av kull og campus. Etter rapportering vil identitet for utdanningsinstans returneres til FS, og vises under denne fanen for den enkelte campus.
UNDERVISNING
Undervisningsenhet samlebilde
Fane: Campus. Rapportering av utdanningsinstans for emne vil i FS gjøres for hvert campus for den enkelte undervisningsenhet. Etter rapportering vil identitet for utdanningsinstans returneres til FS, og vises under denne fanen for den enkelte campus.
VURDERING
Generelt
Med databaseversjon FS9.3.2 kom det inn tabeller for å ta vare på koblingen mellom helhet og del ved beregning av samlet resultat. Disse er koblet til vurderingsmelding og vurderingsprotokoll. Data i disse genereres av rutinen FS571.001, og de kan ikke oppdateres manuelt. Informasjonen vil i neste omgang brukes for å koble helhet og deler på karakterutskrift og vitnemålsgrunnlag.
Funksjonen Σ som viser beregning av samlet resultat er nå gjort om til å vise innholdet i disse tabellene. Denne finnes i følgende bilder:
- Student samlebilde - fane Vurd.prot (må her først trykke på emnenavnet for helhet for å få vist detaljinformasjon om resultat)
- Vurderingsenhet samlebilde - fane Kandidat
- Student vurdering samlebilde - fane Vurderingsprotokol
FS-1513
Ved nyregistrering av vurderingsmelding til fagkode hentes inn automatisk fra studentoppgave også i tilfeller der studentoppgave ikke har verdi for oppgavetittel. FS-1576 RT466211
Student vurdering samlebilde
Fane Protokoll: Funksjonen Σ som viser beregning av samlet resultat er nå gjort om til å vise strukturerte data.KVALIFIKASJON
Kvalifikasjon samlebilde
Fane Vitnemål: Feltene Visning av veiledere og Visning av bedømmelseskomite lot seg ikke oppdatere. Dette er rettet. r1 RT468273
ETTERUTDANNING
Etterutdanningskurs samlebilde
- Nytt felt: Eksportér til utdanningsregisteret.
- Når emne er eksportert til utdanningsregisteret vises det i bildet koder emnet har fått som Utdanningsspesifikasjon, Utdanningsmulighet og Utdanningsinstans.
STUDIEELEMENTER
Emne samlebilde
- Nytt felt: Eksportér til utdanningsregisteret.
- Når emne er eksportert til utdanningsregisteret vises det i bildet koder emnet har fått som Utdanningsspesifikasjon og Utdanningsmulighet.
Studieprogram samlebilde
- Nytt felt: Eksportér til utdanningsregisteret.
- Når emne er eksportert til utdanningsregisteret vises det i bildet koder emnet har fått som Utdanningsspesifikasjon og Utdanningsmulighet.
- Nytt felt: Enkeltemne-program (J/N). Dette vises kun for fagskoleutdanninger (nivå 40 og 41) og er innført for rapportering av kortere utdanninger. Dersom det legges inn J i feltet vil studenter på dette programmet bli rapportert basert på undervisningsmeldinger i stedet for studieprogramstudent, for det emner som er knyttet til studieprogrammet.
Endringen i rapporteringen kommer til testing før sommeren. FS-1575 - Feltet Subject Area er tatt vekk (feltet for ISCED-F via NUSkode erstatter bruken av Subject Area). r1 FS-1583
Fag
Feltet Subject Area er tatt vekk (feltet for ISCED-F erstatter bruken av Subject Area). r1 FS-1583
KODER
Sted samlebilde (Felles)
- Endret ledetekst fra Forkortelse til Akronym (feltet vises også i listen til høyre, med overskrift Akronym). FS-1523
- Det er lagt til kontroll på at erasmus-institusjonskode følger oppgitt format for denne FS-1560
Akkrediteringsstatus (Studelem)
Nytt bilde for visning av akkrediteringsstatus. Dette har kun felleskoder, innholdet bestemmes av utdanningsregisteret
Organisasjonsakkrediteringstype (Studelem)
Nytt bilde for visning av type akkreditering som kan tildeles en utdanningsinstitusjon. Dette har kun felleskoder, innholdet bestemmes av utdanningsregisteret.
Subject Area (Utveksl)
Bildet er tatt vekk. r1 FS-1583
RAPPORTER/RUTINER
Generelt
Rutiner og rapportering fra gammel kvalifikasjonsmodul er tatt vekk. FS-1485UTVEKSLING
FS280.001 Utvekslingsavtaler
Visning av Subject Area for fag er erstattet med visning av ISCED-F-kode. r1 FS-1583
SEMESTERREGISTRERING
FS350.002 Spørreskjemabesvarelse
Nytt visvalg: Kun spørsmål student har svart på. Pr default er dette valget slått på, rapporten vil dermed fungere annerledes enn tidligere da alle spørsmål ble vist frem. RT453016
VURDERING
FS530.001 Spesialtilpasninger for vurdering
- For rom vises nå bygningsnavn og romnavn i tillegg til bygningskode og romkode. Bygningskode og romkode vises i parentes bak navn. FS-1515
- Rapporten er endret slik at den for alle personer henter rominformasjon fra "eksamensavvikling" (fane Vurderingsenhet samlebilde). Dersom det ikke er angitt rom på eksamensavvikling for student, så hentes dette fra tilpasningen - da vises det med rød tekst prefikset med *e og *p avhengig av om det gjelder eksamens- eller personens spesialtilpasning. FS-1516
FS530.002 Spesialtilpasninger for student meldt til vurderingsenhet
Rettet formatering av ekstra tid, tid over 99 timer ble ikke vist frem. RT459307
FS530.004 : Spesialtilpasninger for vurderingsenhet - datofordelt
- For rom vises nå bygningsnavn og romnavn i tillegg til bygningskode og romkode. Bygningskode og romkode vises i parentes bak navn. FS-1515
- Rapporten vises nå også rom for persontilpasning (har tidligere vist frem rom for eksamenstilpasning). FS-1516
FS571.001 Beregning av samlet karakter for vurdering
Rutinen oppdaterer nå informasjon i ny tabell som eksplisitt tar vare på sammenhengen mellom helthet og deler for vurdering. Denne vil senere tas i bruk i karakterutskrifter/vitnemålsgrunnlag/Vitnemålsportal for fremvisning av dette. I denne dokumentasjonen er det nå aktive resultater som vises frem, men da kvalifikasjoner kan inneholde resultater som ikke lengre er aktive pga forbedringer så vil ikke bruk av aktivstatus fungere for fremvisning av delresultater.
FS573.001 Overføring fra vurderingsmelding til vurderingsprotokoll
Rutinen er utvidet med å overføre informasjon om sammenhengen mellom helhet og del (ref FS571.001).
FS578.001 Ikke-ferdigbehandlede vurderingsenheter
Nytt valg for om test på sted skal gjøres på administrativt ansvarlig enhet eller studieansvarlig enhet. Default valg er administrativt ansvarlig enhet, som har vært utplukket tidligere. RT453970
FS600.001 Karakterutskrift
- Første versjon av (nord)samisk karakterutskrift. FS-1490
- For vitnemålsgrunnlag er headingen for terminkolonnen delt over to linjer. Samtidig er overskriften venstrejuster i forhold til datainnholdet under. Dette gir en liten endring også for plassering for norsk og engelsk overskrift. r1 FS-1519
KVALIFIKASJON
FS690.001 Vitnemålsdokumenter
- Valgene for Generer vitnemålsdata på nytt for hhv kvalifikasjon og student er pr default ikke valgt. FS-1502
- Samisk institusjonslogo kan nå vises i vitnemålsgrunnlaget (side 3). FS-1510
- For vitnemålsgrunnlag er headingen for terminkolonnen delt over to linjer. Samtidig er overskriften venstrejuster i forhold til datainnholdet under. Dette gir en liten endring også for plassering for norsk og engelsk overskrift. FS-1519
- Samisk beskrivelsen av karakterer og karakterfordeling er endret etter korrektur. Beskrivelsen er identisk på karakterutskrift og vitnemålsgrunnlag. FS-1519
- Det er innført ny versjon av tekst for Diploma Supplement kapittel 8. Denne henviser til ny UH-lov, og det er en del endringer i NQF nivåbeskrivelser.
FS690.010 Test av vitnemål side 2
Det er nå mulig å velge språk SAMISK for test av vitnemål side 2. FS-1482
BETALING
FS208.001 Hovedbokføring - rapportering til økonomisystem
Fjernet støtte for Visma Business (formatet ikke lengre i bruk). FS-1531
FS-system
FS002.001 Nedlasting av felleskoder
For institusjon er erasmusinstitusjonskoder rettet slik at de følger formatet som er beskrevet for disse. FS-1560
RAPPORTERING
FS013.003 Fagskole: Emneresultater
- Rapporten har fått nytt navn. FS-1558
- Rapporten tar nå kun resultater som er tellende resultater ved gjentak. Resultater som har resultatstatus ulike B og S (altså gitt ved sensur) gis alle karakter '0' i denne rapporteringen. Ved test av gjentak vil kun tellende resultater tas hensyn til. FS-1558
FS013.006 Bestått eller avbrutt utdanningstilbud
- Rapporten har fått nytt navn. FS-1559
Endringer i feilhåndtering i databasen
Innledning
Skriving i en Oracle-database kan resultere i databasefeil (exceptions). Disse kan være utvikler-definerte (ORA-20xxx) eller predefinerte (alle andre feilnumre). Endringene her gjelder førstnevnte.
I noen tilfeller (f.eks. i FS-klienten) vil feilmeldingene nå ufiltrert ut til bruker. For disse vil ikke endringene ha andre konsekvenser enn at brukerne må forholde seg til noen endringer i layout, men informasjonen vil stort sett være den samme.
I andre tilfeller vil det være applikasjoner, tjenester eller mellomvare som håndterer feilmeldingene (typisk ved å mappe til en annen exception/et varsel el.lign. som gir mening utad). Disse er avhengige av en viss kvalitet og stabilitet i informasjonen som leveres fra databasen. Hittil har ikke dette vært garantert.
Informasjon som leveres i en exception:
- Feilnr (aka SQLCODE) = Negativt femsifret tall, her i intervallet -20000..-20999
- Feiltekst (aka SQLERRM) = ORA-SQLCODE: forklarende tekst
- Feilstack (viser koden der feilen oppsto, hele veien opp til utløsende trigger)
Nå-situasjonen
Innholdet i utvikler-definerte exceptions er helt opp til den enkelte databaseutvikler, og har hittil bestått av "hummer og kanari", både mhp. form og innhold. Typisk har man brukt et vilkårlig valgt feilnr (gjerne via klipp & lim fra andre exceptions) samt en tekst som er mer eller mindre parametrisert (dvs. inneholder argumenter, som typisk er kodeverdier fra basen). Teksten begynner som regel med "FEIL>> ", men ikke alltid.
Dermed kan man hverken bruke feilnr eller feiltekst til å avgjøre maskinelt hva slags feil det er snakk om, og feilstacken sier bare linjenr i kode (noe som naturlig nok er lite stabilt).
Konklusjonen er at vi innfører et strengere regime for feilhåndteringen på databasesiden.
Endringer i formatet
Format på feilmeldinger i nytt regime:
ORA-20xxx: FEIL>> FEILKODE> OBJEKT[ (Referanse)]: Feiltekst
der
- FEILKODE er en tekstlig kode (store bokstaver med evt. tall og underscore) med semantisk innhold, dvs. den skal være mulig å forstå for et menneske
- OBJEKT er enten en tabell (for tabellspesifikke exceptions) eller en fellespakke i databasen (for tverrgående exceptions)
- Referanse er en valgfri primærnøkkel-referanse til aktuell forekomst av tabellen på standardisert format (en liste av kommaseparerte verdier i fast rekkefølge)
Feilkoden kommer til å være stabil, mens feilnr og tekst vil kunne variere over tid (bl.a. vil det gjøres en overhaling av feiltekstene for å standardisere dem).
De aller fleste feilnumre er endret.
- Reelle exceptions ligger i intervallet -20100..-20999
- Internfeil (i feilhåndteringen) ligger mellom -20000..-20099
Sistnevnte meldes automatisk til databaseutviklerne.
Noen eksempler med og uten nøkkel- og argumentverdier:
- ORA-20986: FEIL>> ENDRE_STUDENTNR_ULOVLIG> STUDENT: Det er ikke tillatt å endre StudentNr_Tildelt
- ORA-20987: FEIL>> FS_GENERERT_FODSELSNR_ULOVLIG> STUDENT (123456): Det er ikke anledning til å opprette student med FS-generert fødselsnummer
- ORA-20986: FEIL>> OPPRETTE_PA_UTGATT_STUDIEPROGRAM_ULOVLIG> STUDIEPROGRAMSTUDENT: Studieprogram SP1 er utgått. Det er ikke mulig å legge til nye studenter på dette programmet.
- ORA-20988: FEIL>> DR_KANDIDAT_ARBEIDSFORHOLD_DATO_ULOVLIG> STUDIEPROGRAMSTUDENT (123456,SP1,2025,VÅR): Brudd på en av datorestriksjonene. Sjekk datoene for Arbeidsforhold og Studieprogramstudent og rett feilen. Dato 01.01.2025.
- ORA-20000: FEIL>> INTERN_FEIL> IKKE_IMPLEMENTERT: Feilkode TULLEKODE for PERSON er ikke implementert
NB! Applikasjoner, tjenester eller mellomvare som tolker nåværende feilnr/-tekst må skrives om til å bruke kombinasjonen av FEILKODE og OBJEKT for å identifisere/tolke feilsituasjonen.
Det er lastet opp et regneark som mapper fra gammel til ny feilinformasjon. Den inneholder objekt, gammel(t) feilnr/feiltekst og ny(tt) feilnr/feilkode/feiltekst. Den nye feilteksten er kun delen av feilmeldingen etter OBJEKT + evt. Referanse (resten kan utledes av formatet). NB! Noen feilkoder forekommer flere ganger - grunnen til det er at flere feilmeldinger er slått sammen til én (som mapper fra flere gamle feilmeldinger).
Eksempel på feiltekst i regnearket:
- En exception kan f.eks. leveres som "ORA-20986: FEIL>> ENDRE_STUDENTNR_ULOVLIG> STUDENT: Det er ikke tillatt å endre StudentNr_Tildelt",
- men i tabellen står det "Det er ikke tillatt å endre StudentNr_Tildelt" (-20986 er feilnr, ENDRE_STUDENTNR_ULOVLIG er feilkode og STUDENT er objekt)
Tabeller som foreløbig har fått ny feilhåndtering
- DELTAKER
- EMNE
- EMNEKOMBINASJON
- EMNE_I_EMNEKOMBINASJON
- EMNE_I_STUDIEPROGRAM
- ETTERUTDKURS
- FAG
- FAGPERSONUNDSEMESTER
- FAKTURARESKONTRO
- FAKTURARESKONTRODETALJ
- GODKJSAK
- GODKJSAK_MERKNAD
- GODKJSAK_OMFANG
- INNVILGET_PERMISJON
- KOMMISJON
- KULLKLASSE
- KVALIFIKASJON
- KVALOPPN
- KVALOPPN_EKSTRES
- KVALOPPN_EMNE
- KVALPROT_EKSTRES
- KVALPROT_EMNE
- MIDLERTIDIG_LISENS
- PERSON
- PERSONTELEFON
- REGISTERKORT
- STUDENT
- STUDENTKORT
- STUDIEPROGRAM
- STUDIEPROGRAMSTUDENT
- STUDPROGSTUD_EKSTRES
- STUDPROGSTUD_EMNE
- STUDPROGSTUD_MERKNAD
- TILDELT_LISENS
- UNDERVISNINGSMELDING
- UTVPERSON
- VURDKOMBENHET
- VURDKOMBMELDING
Det vil også kunne dukke opp feilmeldinger på nytt format fra felleskode som brukes ifm. oppdatering av flere tabeller (inkludert tabeller som ikke står i regnearket).
Databasehendelser
Disse er grunnlaget for såkalte API-hendelser i GraphQL-APIet.
- Det er lagt til ny informasjon i noen eksisterende hendelser, som bl.a. gjør det mulig å filtrere Personrolle-hendelser på en bedre måte
- Leveranse av utfasede felt med navn som begynner på "X_" er fjernet
- Leveranse av endrede klokkeslett er rettet opp (de leverte tidligere kun verdi i dato-delen, med standardverdi 1900-01-01)
Datastruktur
Constraints
Noe triggerfunksjonalitet er omgjort til constraints
- Fakturareskontrodetalj: Alle eller ingen komponenter i emne-referanse er satt
- Studentkort: At dato utstedelse er tidligere enn dato utgått
- Studieprogramstudent
- At dato sendt avtale er tidligere enn levert avtale
- At dato sendt avtale er tidligere enn purret avtale
- At dato levert prosjektbeskrivelse er tidligere enn godkjent prosjektbeskrivelse
Tabellendringer
| Tabell | Endringsbeskrivelse |
|---|---|
| Akkrediteringsstatus | Ny tabell for status for en akkreditering |
| Emne | Nye kolonner: Status_Eksport_Utdreg, UtdregId_Spesifikasjon, UtdregId_Mulighet |
| Etterutdkurs | Nye kolonner: Status_Eksport_Utdreg, UtdregId_Spesifikasjon, UtdregId_Mulighet, UtdregId_Instans |
| Kull | Ny kolonne: UtdregId_Instans |
| Organisasjon_Akkreditering | Ny tabell for akkreditering av organisasjonen |
| Organisasjon_Akkreditering_Fag | Ny tabell for fagområde/nivå/kvalifikasjon-akkreditering |
| Organisasjonsakkrediteringstype | Ny tabell for type organisasjonsakkreditering (universitet, høyskole, ...) |
| Studieprogram | Nye kolonner: Status_Eksport_Utdreg, UtdregId_Spesifikasjon, UtdregId_Mulighet |
| Undervisningsenhet | Ny kolonne: UtdregId_Instans |
| Utdanning_Akkreditering | Ny tabell for akkreditering av enkeltutdanning |
| Vurdmelddel | Fremmednøkkel mot vurderingsmelding (helhet) er tatt vekk pga problemstillinger ved overføring til protokoll. For Vurdprotdel er denne beholdt. |
Felles studentsystem