Inc drawio | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
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, benyttesDenne integrasjonen sørger for å ektrahere oppgavetittel for Master og Bachelor oppgavene og registrere dem. Tidligere har studenten selv måtte sørge for å registrere oppgavetittel direkte via studweb noe som kunne føre til dårlig og uriktig data kvalitet.
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.
...
Dette er en leveranse til både Arkiv og Digital-eksamen. Kostandene deles derfor mellom disse 2.
...
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 |
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 | Henter alle relevante metadata | GET: /test/{testId} |
LaaS | Registrerer en indeks | do Index |
Oai-databasen | Henter en record med | oai-getRecord |
Oai-databasen | Henter 'record’er 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 'repo’er for systemet ( | oai-getRepositoriesForSystem |
Oai-databasen | Henter en repo etter | oai-getRepository |
Oai-databasen | Oppdaterer en record med | oai-updateDeliveredDate |
Oai-databasen | Lister ‘record’er (med | oai-oaiListRecords |
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 | 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} |
...
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
...