Drawio | |
---|---|
zoom | 1 |
simple | 0 |
inComment | 0 |
pageId | 2303328290 |
custContentId | 2417950827 |
lbox | 1 |
diagramDisplayName | Digitaleksamen.drawio |
contentVer | 1 |
revision | 1 |
baseUrl | https://unit.atlassian.net/wiki |
diagramName | Digitaleksamen.drawio |
pCenter | 0 |
width | 1153.3333333333333 | links | tbstyle |
height | 817 |
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
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
Veiledning til integrasjonen og løsningsbeskrivelse :
Nøkkel info
...
Initiering av flyt
...
Inspera : Push (inspera-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
...
I klage-beg-dispatcher-app trigger den meldinger fra FS som skal komponeres og videresendes mot eksamensystemer. Den mottar data nedenfor:
contextObjectId
,contextObjectType
,associatedObjectId
,associatedObjectType
,triggeringUserId
,triggeringUserName
,timestamp
,org
,instance
,env
ogexamSystem
, og sender over begrunnelser (vurdId
,klage
,examSys
,orgId
ogenv
) til Inspera/WISEflow.ّInspera-webhook produserer webhook-meldinger (
timestamp
,org
,instance
,env
ogexamSystem
) mot begge eksamenssystemene (Inspera/WISEflow);Inspera-klage og wiseflow-klage forbruker
vurdId
,examSys
,orgId
,env
og klage meldinger (personlopenr, kandidatnr
,brukernavn
,fornavn
,etternavn
,klagestatus
,sensurfrist
,kommisjonsidOppr
ogkommisjonsidNy
) sendes fra FS, og klage-vedtak meldinger fra Inspera (contextObjectId
,contextObjectType
,associatedObjectId
,associatedObjectType
,triggeringUserId
,triggeringUserName
,timestamp
,org
,instance
,env
,eventName
,examSystem
) eller svar fra wiseflow (flowId
,explanationRequestId
,participantId
,assessorId
,callTime
,sequenceNumber
,timestamp
,org
,env
ogexamSystem
).Inspera-begrunnelse og wiseflow-begrunnelse forbruker
vurdId
,examSys
,orgId
,env
og begrunnelse-forespørsler (personlopenr, kandidatnr
,brukernavn
,kommisjonsId
,datoKlageMottat
ogdatoVedtakFormidlet
) sendes fra FS, og begrunnelse-svar meldinger fra Inspera (contextObjectId
,contextObjectType
,associatedObjectId
,associatedObjectType
,triggeringUserId
,triggeringUserName
,timestamp
,org
,instance
,env
,eventName
,examSystem
).
...
Open API
...
Nei
...
IntArk
...
Ikke brukt
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?
...
System
...
Data
...
Brukt API (endepunkter)
...
Brage-integrasjonen
...
Config-databasen
...
Liste over alle institusjoner med ArkivMBOppgaver
satt til true
...
configDB.orgs
...
Oai-databasen
...
henter aktive institusjoner med aktiv klage- og begrunnelse-status som tilsvarer examSystem
, org
og instance
...
oai.KlageBegrunnelseEnvs
...
FS-Digex
Henter ut en liste (en JSON-liste) over begrunnelsesforespørsler som har blitt opprettet eller endret siden oppgitt tidspunkt basert på examSystem
, institutionNr
(Nummeret for institusjonen som du skal hente fra) og changedSince
(tidspunkt for sist sjekk. Format: DDMMYYYYhhmm).
...
Drawio | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
...
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
Veiledning til integrasjonen og løsningsbeskrivelse :
Nøkkel info
Initiering av flyt | Inspera : Push (inspera-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 |
|
Open API | Nei | |
IntArk | Ikke brukt |
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?
System | Data | Brukt API (endepunkter) | ||||
---|---|---|---|---|---|---|
Config-databasen | Finner | configDB.orgs | ||||
Config-databasen | Hvis prosessen var mislykket ( NB: Modulen hjelper utviklere og testere av systemet; sluttbrukeren vil ikke legge merke til det. | configDB.slack-blacklists | ||||
FS-Digex | Henter ut en liste (en json-liste) over begrunnelsesforespørsler som har blitt opprettet eller endret siden oppgitt tidspunkt basert på | GET: /eksamen/begrunnelse/{examSystem} URL for test: https://fs-test.uio.no/eksamen/begrunnelse/<examSystem>?institusjonsnr=...&siden=...& https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | ||||
FS-Digex | Henter ut en json-liste basert på | GET: /eksamen/klager/{examSystem}/ URL for test: https://fs-test.uio.no/eksamen/klager/<examSystem>?institusjonsnr=...&siden=...& https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | ||||
FS-Digex | Henter begrunnelser for en gitt eksamen basert på | GET: /eksamen/begrunnelser/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/begrunnelser/{examSystem}/{examId} https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | ||||
FS-Digex | Henter klager for en gitt eksamen basert på | GET: /eksamen/klager/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/begrunnelse/<examSystem>?institusjonsnr=...&siden=...&klager/{examSystem}/{examId} https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | FS-Digex | Henter status på kandidatens oppgave ifm overføring til Brage som tilsvarer | ||
GET: /eksamen/ferdigstatus/Inspera | Henter | GET: /test/{testId} https://wwwapi.fellesstudentsysteminspera.no/brukersiderapidoc/teknisk#/fsws-dok/rest/digitaleksamen.html | FS-Digex | Henter begrunnelser for en gitt eksamen basert på | GET: /eksamen/begrunnelser/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/begrunnelser/{examSystem}/{examId} | |
Inspera | Lar en søke etter tester basert på enkle kriterier ( | GET: /test/search https://wwwapi.fellesstudentsysteminspera.no/brukersiderapidoc/teknisk#/fsws-dok/rest/digitaleksamen.html | ||||
FS-Digex | Henter klager for en gitt eksamen basert på | GET: /eksamen/klager/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/klager/{examSystem}/{examId} https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | ||||
Inspera | Henter | Inspera | Henter opp user, for å mappe | Inspera | Henter kandidatens innsendings-id som tilsvarer | GET: /candidates/submission/ https://api.inspera.no/apidoc/#/candidates/getSubmissions_1test/search |
Inspera | Henter alle relevante metadata for testen gitt av | GET: /test/{testId} | ||||
Inspera | Henter opp user, for å mappe | GET: /users/ | ||||
Inspera | Henter kandidatens innsendings-id som tilsvarer | GET: /candidates/submission/ | ||||
LaaS | Registrerer en indeks | do Index | ||||
Mongo-databasen | Finner alle dokumenter i databasen ( | Find documents i oai.KlageBegrunnelseEnvs kolleksjonen | ||||
Oai-databasen | legger auditInfoMap log til databasen | oai-addAuditLog | ||||
Oai-databasen | Henter aktive institusjoner med aktiv klage- og begrunnelse-status som tilsvarer | oai.KlageBegrunnelseEnvs | ||||
Oai-databasen | Hvis prosessen var mislykket ( | ‘Delete Kafka Message By Hash’ i oai.Records | ||||
Oai-databasen | Henter | ‘Get Instance By Org And Env’ i oai.KlageBegrunnelseEnvs | ||||
Oai-databasen | Legger klagen eller begrunnelsen (hvis den ikke er i databasen) til i databasen ( | oai.Records | ||||
Slack | Sender feilmeldinger (inkludert også data på | Slack-kanalen (mule-prod) | ||||
WISEflow | Henter opp grunnleggende informasjon for en gitt flyt som navn, type, start- og sluttdato som kan brukes til å identifisere flyten (basert på | GET: /flow/{flowId} |
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
Behandlingstid/responstid og volum
Integrasjonen ikke tatt til bruker nå; ingen data!
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
...