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 status (et JSON-objekt) på bachelor/master oppgave ifm overføring til Brage (basert på examSystem
og taskId
)
GET:/eksamen/ferdigstatus/{examSystem}/{taskId}
URL for test: https://fs-test.uio.no/eksamen/ferdigstatus/<ID>?fnr=<nr>&.....
URL for prod: https://fsws.usit.no/eksamen/ferdigstatus/<ID>?fnr=<nr>&.......
...
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).
GET: /eksamen/begrunnelse/{examSystem}
URL for test: https://fs-test.uio.no/eksamen/begrunnelse/<examSystem>?institusjonsnr=...&siden=...&
URL for prod: https://fsws.usit.no/eksamen/begrunnelse/<examSystem>?institusjonsnr=...&siden=...&
...
FS-Digex
...
Henter begrunnelser for en gitt eksamen basert på examSystem
og examId
.
GET: /eksamen/begrunnelser/{examSystem}/{examId}
URL for test: https://fs-test.uio.no/eksamen/begrunnelser/{examSystem}/{examId}
URL for prod: https://fsws.usit.no/eksamen/begrunnelser/{examSystem}/{examId}
https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html
...
FS-Digex
...
Registrerer explanations
(urlBegrunnelse
, datoBegrunnelseBedtOm
, dokumentBegrunnelse
, kandidatnr
, datoBegrunnelseGitt
, contentTypeBegrunnelse
) gitt til en kandidat for en eksamen basert på examSystem
POST: /eksamen/begrunnelser/{examSystem}
...
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 | setter | configDB.getSingleOrg | |
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#digeks_begr_posthtml | |
Inspera | planlegger og laster ned innlevering av en enkelt kandidat eller gruppe på en test…😎 | GET: /candidates/submission/{testId}/{userId} (depreciated) POST: /fileExport/order ( | |
Inspera | Henter resultatkandidatinformasjonen ( | GET: /candidates/listTests/{userId} https://api.inspera.no/apidoc/#/candidates/getCandidateResult | |
Inspera | WISEflow | Returnerer grunnleggende informasjon ( | Henter alle relevante metadata GET: /test/{testId} https://api.inspera.no/apidoc/#/test/getTestMetadata |
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-databasen | Legger filer ( | oai-upsertBrageFile | |
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} | |
GET: /flow/{flowId}/participants, | GET: /test/{testId} | ||
LaaS | Registrerer en indeks | do Index | |
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-databasen | Legger filer ( | oai-upsertBrageFile | |
Oai-databasen | Henter filer klare for opplasting ( | oai-getBrageFiles | |
Oai-databasen | Henter en rekke depoter for systemet ( | oai-getRepositoriesForSystem | |
Amazon S3 | Overfører arkiverte filer ( | upload file: | |
Slack | Sender feilmeldinger (inkludert også data på | Slack-kanalen (mule-prod) | |
WISEflow | Returnerer informasjon om en innlevering ( | GET: /flow/{flowId}/submission/{submissionId} | |
WISEflow | Hvis den er aktivert på flyten (av gitt | POSTHenter opp grunnleggende informasjon for en gitt flyt som navn, type, start- og sluttdato som kan brukes til å identifisere flyten (basert på | GET: /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
Behandlingstid/responstid: ca. 2s
Frekvens: HTTPS-‘listener’ repeterbar fillagerstrøm for datastrømmestrategi (Inspera-webhook, brage-app og oai-pmh) og 5-minutter poll timeout for Apache-Kafka forbruk for eksamensystemer (Brage-app)
Volum (målt: ): gj.sn. ca. 23k hits daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
...