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
Nøkkel info
Initiesering av flyt | Inspera : Push (Webhooks) | |
|---|---|---|
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 |
Bakgrunn
Arkivering av masteroppgaver er et krav som alle institusjoner skal oppfylle.
Interessenter
Dette er en leveranse til både Arkiv og Digital-eksamen. Kostandene 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 |
|---|---|---|
Brage-integrasjonen | Denne leser inn opgavene fra Inspera og Wiseflow og lagrer metadata i Oai-databasen som del av Brage-integrasjonen Brage | Se Brage |
Config-databasen | Liste over alle institusjoner med | |
Oai-databasen (Brage integrasjonens database) | Liste over alle oppgaver og deres metadata | |
FS (digex-api) | Henter full exam info for å finne fram til studentens | |
Inspera | Henter test (prøve) for å finne | |
Inspera | Henter opp user, for å mappe | |
Wiseflow | – ikke implementert – noe likt det med Inspera | |
P360-arkiv-app | Sender spesifisert json til arkiv-appen (HTTP-call) | Se |
Hvilken kø-mekanisme brukes evt.?
Til denne integrasjonen, brukes det ikke noe kø mekanisme
Om Int-ark komponenter er brukt og eventuelt hvilke deler
Ikke brukt
Data
Hvilke data utveksles? Alle attributter som utveksles?
Samhandlingsmønster
Hva driver utvekslingen? Request eller Push
Er utvekslingen synkron eller asynkron?
Om involverte API
Brukte API endepunkter
INSPERA : /v1/test/{testId}
/v1/test/{testId}/assessment/pdf
Tilgangsstyring og logging
Hva logges?
Eventuelle tilgangstyring
Forretningsregler
Forretningslogikken i integrasjonen. Feks. Bare dokumenter med status X leses etter Y antall dager osv …
Behandlingstid/responstid og volum
Hva er antallet meldinger pr. døgn i denne forbindelsen (Min, Avg, Max)
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Hva skjer ved overload i kø?
Hva skjer med ufullstendinge meldinger?
Inneholder meldingene personopplysninger?
Noe om viktige feil/situasjoner som må passes ekstra på (som kan ha stor konsekvens). F.eks : Oppgavene som aldri vil publiseres, eller Oppgaver som ikke skal publiseres, publiseres.
Flytdiagram ?