Arkivering av masteroppgaver

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) 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

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. 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 (endepunkter)
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 `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/ https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html
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	Henter privatpersoner (en list) fra P360 basert på `p360ShortName` og kriterier definert i inngangsparameteren (`PersonalIdNumber` og `ExternalID`).	GetPrivatePersons: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 3.8)
Public360	Oppretter en sak med “Sak/Noark Sak” (`p360ShortName`).	CreateCase: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 6.1)
Public360	Oppdaterer en sak i P360, baseert på `CaseNumber`, `Title`, `p360ShortName` og `ResponsiblePersonEmail`	UpdateCase: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 6.2)
Public360	Sender spesifisert json til arkiv-appen (HTTP-call) Henter en liste over alle tilfeller som oppfyller kriteriene for alle de ikke-blanke egenskapene til den oppgitte parameteren basert på `p360ShortName` og kriterier definert i inngangsparameteren (`CaseNumber` og `ExternalId`).	GetCases: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 6.3)
Public360	Oppretter et arkivdokument	CreateDocument: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 7.1)
Public360	Avskriver et dokument med en svarkode og en valgfri merknad. Parametrene består av `ResponseCode`, `Note`, `Document` og `NoteTitle`	SignOffDocument: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 7.3)
Public360	Henter metadata på dokumenter basert på `p360ShortName` og `Recno`	GetDocuments: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 7.5)
Public360	Strømmer en fil til Public360-serveren (lagret midlertidig), og referert til i CreateDocument() eller UpdateDocument()	Upload: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 9.1)
Public360	Oppdaterer en sak i P360, baseert på `CaseNumber`, `Status` og `p360ShortName`	UpdateCaseStatus: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 15.1)

Tilgangsstyring og logging

Integrasjonen loger til Humio med detaljert logging av prosessen.
Integrasjonen er knyttet logg-oversikten som vil logge følgende data:
- (Legg til fra LastAudit kolleksjonen)
Integrasjonen har ikke noe behov for tilgangstyring

Forretningsregler

Forretningslogikken i integrasjonen. Feks. Bare dokumenter med status X leses etter Y antall dager osv …

Behandlingstid/responstid og volum

Ingen data på ennå

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.