Inc 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
...
Poll-request
...
Flyt møsnter
...
Halveis synkron
...
Bruk av meldingskø
...
Ja, Kafka
...
Inspera-webhook produserer webhook-meldinger (
timestamp
,org
,instance
,env
ogexamSystem
) mot begge eksamenssystemene (Inspera/WISEflow);Brage også forbruker
event
,contextObjectId
,contextObjectType
,associatedObjectId
,associatedObjectType
,triggeringUserId
,triggeringUserName
,inputTopic
,id
,action
,licenseId
,flowId
,userId
,submissionId
,participantId
,isHandedIn
,callTime
,eventVersion
,sequenceNumber
,timestamp
,org
,instance
,env
,eventName
ogexamSystem
fra eksamensystemer
...
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 orgShortName
i databasen til en gitt orgId
...
configDB.orgs
...
Config-databasen
...
Hvis prosessen var mislykket (success
er False), henter den en 'blacklist' for tjenesten for å bestemme om det skal registreres som en Slack-feilmelding i kanalen.
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å examSystem
, institutionNr
(Nummeret for institusjonen som du skal hente fra) og changedSince
(tidspunkt for sist sjekk).
...
Inc 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 | Poll-request | |
---|---|---|
Flyt møsnter | Halveis synkron | |
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 status (et JSON-objekt) på bachelor/master oppgave ifm overføring til Brage (basert på | GET:/eksamen/ferdigstatus/{examSystem}/{taskId} URL for test: https://fs-test.uio.no/eksamen/ferdigstatus/<ID>?fnr=<nr>&..... https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | |||
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 begrunnelser for en gitt eksamen basert på | GET: /eksamen/begrunnelser/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/begrunnelser/begrunnelse/<examSystem>?institusjonsnr=...&siden=...&{examSystem}/{examId} https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html | |||
FS-DigexHenter begrunnelser for en gitt | Registrerer | GETPOST: /eksamen/begrunnelser/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/begrunnelser/{examSystem}/{examId}<examSystem> | |||
Inspera | Henter resultatkandidatinformasjonen ( | GET: /candidates/listTests/{userId} https://wwwapi.fellesstudentsysteminspera.no/brukersiderapidoc/teknisk#/fsws-dok/rest/digitaleksamen.html | FS-Digex | Registrerer | POST: /eksamen/begrunnelser/{examSystem} URL for test: https://fs-test.uio.no/eksamen/begrunnelser/<examSystem> https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html#digeks_begr_postcandidates/getCandidateResult |
Inspera | Henter alle relevante metadata | GET: /test/{testId} | |||
LaaS | Registrerer en indeks | do Index | |||
Mongo-databasen | Finner alle dokumenter i databasen ( | Find documents i oai.KlageBegrunnelseEnvs kolleksjonen | |||
Oai-databasen | Henter record med | oai-getRecords | |||
Oai-databasen | Legger til et nytt dokument i databasen | oai-addRecord | |||
Oai-databasen | Oppdaterer et dokument i databasen | oai-updateRecord | |||
Oai-databasen | Legger auditInfoMap log til databasen | oai-addAuditLog | |||
Oai-databasen | Hente dokumenter fra et visst antall dager tilbake ( | oai-getPassedExpectedRecords | |||
Oai-databasenlegger auditInfoMap log til databasen | Legger filer ( | oai-addAuditLogupsertBrageFile | |||
Oai-databasen | Henter aktive institusjoner med aktiv klage- og begrunnelse-status som tilsvarer | oai.KlageBegrunnelseEnvs | |||
Oai-databasen | Sender | ‘returnTrueAndAddToDatabaseIfNotInDatabase’ i oai.kafkaMessages | |||
Oai-databasen | Henter dokumenter som ikke ble behandlet ( | oai.LastAudit | |||
Slack | Sender feilmeldinger (inkludert også data på | Slack-kanalen (mule-prod) | |||
WISEflow | Returnerer informasjon om karakterbegrunnelsen (av gitt | GET: /flow/{flowId}/explanation/request/{explanationRequestId} | |||
WISEflow | Oppdater synligheten til en karakterbegrunnelse (av gitt | PATCH: /flow/{flowId}/explanation/request/{explanationRequestId} | |||
WISEflow | Returnerer en liste ( | GET: /license/sis/flows/{sisCode} | |||
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} | |||
WISEflow | Returnerer grunnleggende informasjon ( | GET: /flow/{flowId}/participants | |||
WISEflow | Hvis den er aktivert på flyten (av gitt | POST: /flow/{flowId}/explanation/request |
...
Integrasjonen loger til Humio med detaljert logging av prosessen.
Integrasjonen er knyttet logg-oversikten som vil logge følgende data:
action, callTime, candidateIds, event, eventName, eventVersion, env, errorMessage, examSys (examSystem), flowId, id (identifier), identifier, inputTopic, isHandedIn, key, licenseId, moduleId, modified_date, orgId (org), participantId, sequenceNumber, submissionId, submodule, success (boolsk), testId, timestamp, triggeringCandidateId, vurdId (decodedVurdId) og userId
Integrasjonen har ikke noe behov for tilgangstyring
...
Behandlingstid/responstid og volum
Klage-beg-dispatcher
volum
...
Inspera-webhook
...
Behandlingstid/responstid: ca.
6s2s
Frekvens:
2-minutter poll timeout for manuelt triggering og 120-minutters tidsplaner for faste frekvenser (Klage-beg-dispatcher),HTTPS-‘listener’ repeterbar fillagerstrøm for datastrømmestrategi (Inspera-webhook
), brage-app og
2-minutter poll timeout for Apache-Kafka forbruk for begrunnelse og 1-minuttoai-pmh) og 5-minutter poll timeout for Apache-Kafka forbruk for
begrunnelse-svareksamensystemer (
WISEflowBrage-
begrunnelseapp)
Volum (målt:
29 Jul): gj.sn. ca.
28k23k hits daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
...