Arkivering av masteroppgaver

Owned by Armaz Mellati
Last updated: Feb 21, 2024
3 min read

Innledning

Dette er en integrasjon for arkivering av Master oppgaver fra Wiseflow og Inspera. Integrasjonen bygger videre på arbeidet allerede gjort i forbindelse med Brage-integrasjonen. Da Brage-integrasjonen allerede henter inn master-oppgaver med tilhørende meta-data fra eksamen-systemene, benyttes den delen videre i denne integrasjonen.

Til arkivering, benyttes p360-arkiv-appen

Veiledning til integrasjonen og løsningsbeskrivelse :

 

Nøkkel info

Initiesering av flyt

Inspera : Push (Webhooks)
Wiseflow : Poll-request

 

Flyt møsnter

Halveis synkron

Den delen som leser inn fra Inspera/Wiseflow er en egen prosess og er fra-koblet fra resten. Men den delen som arkiverer går synkront til arkiv-tjenesten

Bruk av meldingskø

Ja, Kafka

Bare for mottakk av webhook-meldinger fra Inspera

Open API

Nei

 

IntArk

Ikke brukt*

*-Gravitee brukes men ikke som en IntArk komponent, men som en proxy-ruter mot de ulike arkiverings-endepunkter

Oversikt

 

Bakgrunn

Arkivering av masteroppgaver er et krav som alle institusjoner skal oppfylle.

Interessenter

Dette er en leveranse til både Arkiv og Digital-eksamen. Kostnadene deles derfor mellom disse 2.

Arkiv har produsert og bestemt den såkalte mappinsdokument som definerer hvordan oppgavene skal arkiveres i arkiv-systemet.

Brukerhistorie

  • Student A leverer masteroppgave i Inspera/Wiseflow. Oppgaven skal automatisk arkiveres i institusjonens arkivsystem etter at div. klage/begrunnelse frister er gått ut.

Systemer/tjenester

  • Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?

    Tabellen under tar for seg BARE

System

Data

Brukt API (endepunkter)

System

Data

Brukt API (endepunkter)

Brage-integrasjonen

Denne leser inn opgavene fra Inspera og Wiseflow og lagrer metadata i Oai-databasen som del av Brage-integrasjonen

Se

Config-databasen

Liste over alle institusjoner med ArkivMBOppgaver satt til true

configDB.orgs

Oai-databasen (Brage integrasjonens database)

Liste over alle oppgaver og deres metadata; liste over org i løped av tida basert på READY_DATE og DELAYED_DATE

oai.Records

FS (digex-api)

Henter full exam info for å finne fram til studentens lopenummer basert på kandidatnr

https://fsws.usit.no/eksamen/<system>/<ID>

FS (digex-api)

Henter status på kandidatens oppgave ifm overføring til Brage som tilsvarer examSystem og test-Id

GET: /eksamen/ferdigstatus/

Inspera

Henter test (prøve) for å finne user-id til eier av prøven

GET: /test/

https://api.inspera.no/apidoc/#/test/getTestMetadata

Inspera

Henter opp user, for å mappe user-id til feide-id

GET: /users/

https://api.inspera.no/apidoc/#/users/getUserInfo

Inspera

Henter kandidatens innsendings-id som tilsvarer test-id og user-id

GET: /candidates/submission/

https://api.inspera.no/apidoc/#/candidates/getSubmissions_1

WISEflow

– ikke implementert – noe likt det med Inspera

!

Public360

https://unit.atlassian.net/wiki/spaces/IPM/pages/2365751297

Documaster

https://unit.atlassian.net/wiki/spaces/IPM/pages/2759688223

Tilgangsstyring og logging

  • Integrasjonen loger til Humio med detaljert logging av prosessen.

  • Integrasjonen er knyttet logg-oversikten som vil logge følgende data:

    • orgId

    • oppgaveIdentifier

    • testId

    • userOrGroupId

    • examSystem

    • studentRefs

    • success (true/false)

    • errorMessage (hvis aktuelt)

  • Integrasjonen har ikke noe behov for tilgangstyring

Forretningsregler

Se

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

Generelt vil status og dermed eventuelle feil være synlig og tilgjengelig for institusjonen via logg-oversikten. Det er også utarbeidet mulighet for at enkelt personer ved institusjonen kan melde seg på for mottak av feilmeldinger på epost daglig.

Videre har vi overvåkning av loggene via Humio for å fange opp feil-situasjoner utenfor institusjonens virkeområde, som f.eks. utilgjengelige API endepunkter og bugs i koden.

 

  • Hva skjer ved overload i kø?

    • Det skjer ikke. Men om vi skulle på grunn av noe feil ikke motta meldingene fra eksamensystemene, vil : Inspera vite om det og sende dem på nytt. Wiseflow: er basert på polling, så vi kan alltid polle igjen

  • Hva skjer med ufullstendige meldinger?

    • De vil feile og det vil vi oppdage i loggene og kan ta aksjon basert på det.

  • Inneholder meldingene personopplysninger?

    • Merk at det utveksles mange “meldinger” mellom ulike systemer i løpet av en integrasjon. Melinger fra eksamensystem inneholder ikke noe persondata, men data vi henter fra FS basert på de meldingene gjør det. Filene vi arkiverer (som kommer fra eksamensystemene) kan også potensielt inneholde personopplysninger.

  • Noe om viktige feil/situasjoner som må passes ekstra på (som kan ha stor konsekvens) :

    • Oppgavene ikke arkiveres (miste meldinger)

    • Oppgaver arkiveres med feil info. (feiltolking eller feil logikk)

    • Oppgaver arkiveres med feil tilganger (slik at oppgaver som ikke skal være offentlige, arkiveres slik at de blir offentlig synlige) 

Kommentarer