Automatisk arkivering fra FS til P360

Dokumentasjon for FS Webservice tjenestene som håndterer automatisk arkivering av FS-data til arkivsystemet Public 360 (P360).

Automatisk arkivering av klagesaker

En jobb (Scheduler Job JOB_<instnr>_P360_KLAGER) går én gang i timen og plukker ut klager fra klagetabellen. PDF genereres og oversendes Mule som videresender dette til Public360. Som standard vil overføring av klagesaker bli prøvd et begrenset antall ganger. Hvis det f.eks. skjer feil ved overføring av klagesak, så vil den bli prøvd overført igjen ca. 1, 2 og 3 dager etter at klagesaken sist var endret.

Oppretting av klagesak i P360

Først søkes det etter saker som skal opprettes. Her velges alle forekomster fra FS.Vurdkombklage hvor

1. Dato_Sist_Endret er
   1. kommet senere enn sist vellykete kjøring (statuskode 2xx), eller også
   2. innenfor siste 2 timer
2. Klagetypekoden er SENSUR
3. Enten
   1. Status_Ferdigbehandlet er forskjellig fra J, eller
   2. Journalnr mangler
4. Dato_Opprettet må være etter 1/10-2018 for å ikke få med ufullstendige men utdaterte saker.

Dette oversendes fra FS-basen og til FSWS (FS WebService), og her kommer webservicen inn:

Diverse metadata for overføringen populeres:

• Doktittel settes til Klage på karakterfastsetting <EMNEKODE>_<VERSJONSKODE> <Emnenavnet>
• Eksternid settes til KL_<personløpenummer til studenten>_<institusjonsnummeret>_<emnekode>_<versjonskode>_<vurdkombkode>_<årstall>_<vurdtidkode>_<løpenummeret til saken i FS>
• Studentreferansen settes til personløpenummeret
• Saksbehandler hentes fra FS.Personrolle (må ha Rollekode = 'VURDKLAADM' og stedkoden må 'dekke' stedkoden til emnet, epostadressen i FS må stemme overens med epostadresse i P360)
• Sakstype settes til Klage på sensur
• Klagetypekode hentes opp (er pr. nå SENSUR)
• Saktstatus settes til ÅPEN
• Sakstittel settes til Klage på karakterfastsetting <EMNEKODE>_<VERSJONSKODE> (Her skal også Arkivdel, arkivkode, tilgangskode og tilgangsgruppe hentes opp fra klagetype-tabellen og sendes over. Dette er ikke implementert pt.)
• DOKUMENT lages
  • filnavn settes lik dokumenttittelen (med "_" istedenfor mellomrom)
  • dokumenttittel er Klage på karakterfastsetting
  • retning er inn
  • mottattDato er dagens dato
  • innhold er PDF som skal arkiveres. Denne genereres så:
    • Her lagres kandidatinfo (fødselsdato, personnr, navn, adresse, epostadresse)
    • Emneinfo (sted, sakstype, klagetype, emnekode, emnenavn, versjonskode, vurdkombkode, dato for vurdering og tidsinfo tid og reell tid, terminkode, årstall)
    • Dato klagen er mottatt

Det ovenfor overføres til Public 360 hvor det opprettes sak på bakgrunn av metadata. FSWS avslutter ved å skriver inn journalnummeret det mottar fra P360 (CaseId fra responsen) i tabell FS.Vurdkombklage.Journalnummer dersom det ikke finnes fra før og dersom alt har gått ok.

Det logges i tabellen FS.Wslogg

• Wstjenestekode: P360
• Operasjon: KLAGOPPR
• Innhold: antall som har feilet og antall som har blitt opprettet i P360, samt http status og personløpenr på de som har feilet

Avslutning av klagesak i P360

Etter at nye saker har blitt opprettet søkes etter saker som skal avsluttes. Kriteriene er de samme som for opprettelse, med unntak av at Vurdkombklage.Status_Ferdigbehandlet må være J og Journalnr må være satt.

Gangen og tjenesten er den samme som for opprettelse, med enkelte unntak:

• Titler er Resultat etter klage på karakterfastsetting
• Status settes til LUKKET evt. TRUKKET (og ikke ÅPEN )
• retning er out
• Innholdet i PDF vil inkludere kandidatinfo, emneinfo, opprinnelig resultat og resultat på klagen, dato for vedtaket, hvorvidt det er bedt om begrunnelse og evt dato for dette.

FSWS avslutter igjen ved å sende metadata og dokument over til P360 og skrive inn CaseID i journalnr. i tilfelle dette ikke ble gjort første gang. Dette lukker også saken i P360.

Tilsvarende som for opprettelse så logges det i tabellen FS.Wslogg

• Wstjenestekode: P360
• Operasjon: KLAGAVSL
• Innhold: antall som har feilet og antall som har blitt avsluttet i P360, samt http status og personløpenr på de som har feilet

Automatisk arkivering av resultatprotokoll

(Denne er ikke implementert, herunder følger planlagt gang)

En jobb (Scheduler Job JOB_<instnr>_P360_RESULTAT) går én gang per halvår og starter webservice som henter ut alle resultater fra tabellen FS.Studentvurdkombprotokoll. CSV tekstfil (semikolonseparert) genereres og oversendes Mule som videresender dette til Public360.

Kjøringen går to ganger i året

• 1. januar år X
  2. tar med seg alt fra FS.Studentvurdkombprotokoll med Dato_sist_endret i perioden januar 01 år (X-1) og juni 30 år (X-1)
  3. Oversender med status ÅPEN til sak RES_(X-1) (åpner sak i p360)
• 1. juli år X
  2. tar med seg alt fra FS..Studentvurdkombprotokoll med Dato_sist_endret i perioden juli 01 år (X-1) og desember 31 år (X-1)
  3. Oversender med status LUKKET til sak RES_(X-1) (lukker sak som ble åpnet i januar)

Følgende felter hentes ut og lagres som CSV (FS feltnavn i parentes der de er forskjellig fra CSV feltnavn)

• Fødselsnummer (Fodselsdato og Personnr)
• Navn (Fornavn Etternavn)
• Emnenavn (Emnenavn_bokmal)
• Eksamensdato (Dato_innlevering fra enten Studentvurdkombprotokoll eller Vurdkombenhet dersom protokoll mangler)
• Institusjonsnummer
• Emnekode
• Versjonskode
• Vurdkombkode
• Årstall
• Vurdtidkode
• Karakter (Karakternavn eller Karaktertall dersom karakternavn mangler)
• Vurdresstatkode
• Vekting (Vektingstall + Vekttypekode eller (Ingen) dersom vekting manger)
• Sensorer (Personliste_sensur eller (Tom liste) dersom personliste mangler)

Overføring av studentdata til Public360

Utplukk og data

Jobb P360_STUD_FULL kjører full overføring av studenter til Public 360 en gang pr uke.

• Henter ut følgende fra persontabellen
  • Personløpenr (eksternid)
  • Fødselsnummer
  • Navn
  • Adresseland_hjemsted (land)
  • Fylkesnr_hjemsted (fylke)
  • Adresselinjer hjemsted (linje 1 og 2 blir postadresse, linje 3 blir postkode)
  • postnr hjemsted
    • Disse adressene blir satt som hjemmeadresse.
  • Epostadresser
• Fra persontelefon-tabell hentes
  • telefonlandnr + telefonnr
  • telefonnrtypekode bestemmer om det er hjemmenummer eller mobil
• Fra studenttabellen hentes
  • studentnr
  • semesteradresser (linjer 1 og 2 er postadresse, 3 er postkode)

Alt samstemmes med registerkort-tabellen ift hvilke som skal hentes ut. Studenter må ha fått tildelt studierett i løpet av de siste 2 år, og gyldig regiserkort i løpet av de siste 2 år.