Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7
printablefalse

Innledning

...

Table of Contents
minLevel1
maxLevel7
printablefalse

...

Innledning

Brage er en tjeneste for digitale fulltekstarkiv og effektiv tilgjendeliggjøring av institusjonens forsknings- og studentarbeider. Dette vil betjene begge Arkiv- og DigEks-tjenestene, som inneholder vitenskapelige artikler, bachelor- og masteroppgaver og annet materiale produsert av ansatte og studenter ved de fleste norske utdanningsinstitusjoner. Arkivet høstes av søketjenester som inneholder materialet fra Universitetene som avtaleparter.  

Brage leser masteroppgaver og overfører dem til databasen. Utdata vil bli lagret i databasen og brukt i masteroppgave- / NVA- / oaipmh- / brage-records-appene.

...

Initiering av flyt

  • planlagt igangsetting for “update from FS”

  • planlagt igangsetting for opplasting av filer til S3

  • planlagt igangsetting for å sende/laste opp “in process”-filer til S3

  • 2 meldingskøer for å dele meldinger til de to eksamenssystemene (WISEflow og Inspera)

  • fast frekvens (en gang i timen)

  • fast frekvens (hvert 10. minutt)

  • poll-timeout: 5 minutter (topics: “submission_delivered” og “submission_delivered_brage“)

Flyt møsnter

Halveis synkron

Bruk av meldingskø

Ja, Apache Kafka (Consumer)

  • Brage forbruker webhook-meldinger(contextObjectId, contextObjectType, ASSESSMENT_RUN, associatedObjectId, associatedObjectType, triggeringUserId, triggeringUserName, timestamp, org, instance, env og examSystem)fra begge eksamenssystemene (Inspera/WISEflow)

Open API

Nei

IntArk

Ikke brukt

...

System

Data

Brukt API (endepunkter)

Config-databasen

setter orgCoverSheet til en gitt orgId

configDB.getSingleOrg

Config-databasen

Henter en list fra databasen (MongoDb.SLACK_BLACKLISTS) for appen

configDB.getSlackBlacklist

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>&...../{taskId}

URL for prodtest: https://fswsfs-test.usituio.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 (resourceType 'CandidateSubmission')URL for prod: https://fsws.usit.no/eksamen/ferdigstatus/<ID>?fnr=<nr>&.......

https://apiwww.insperafellesstudentsystem.no/apidoc/#/fileExport/orderExportsbrukersider/teknisk/fsws-dok/rest/digitaleksamen.html

Inspera

Henter resultatkandidatinformasjonen (title, startTime, endTime, assessmentRunId, externalId, candidateId) Hent resultatkandidatinformasjonen for en gitt bruker på en gitt test (instance, org, assessmentRunId og userOrGroupId. Dette samsvarer nesten nøyaktig med utdata fra kandidatinformasjon i GET /test/ API, kun fokusert på en spesifikk bruker (testId og userId)

GET:/v1/candidates/result/listTests{testId}/{userId}

https://api.inspera.no/apidoc/#/candidates/getCandidateResult

Inspera

Henter alle relevante metadata assessmentRunId og result (generalInfo, assessmentInfo, externalTestInfo, options, committees, candidates, contributors, organizationalUnits osv) for testen gitt av instance og testId. Dette vil også inkludere alle relevante kandidatmetadata (userId, candidateId, attendanceStatus, deliveryMode, committeeId, committeeName, committeeGradingStatus, groupId, groupName, submissionDeletedOn, automaticQuestionScore, roomId, roomName, building, candidateExtraTime, incidentTime, finalGrade, gradedDate, startTime, endTime, restrictedUntilDate, deliveryDeadline, externalIds, lastDeviceName og assetsDownloadInfo).

GET: /test/{testId}

https://api.inspera.no/apidoc/#/test/getTestMetadata

LaaS

Registrerer en indeks org, instanceenvevent-name, remote-adr og request-uri i Humio (for å innta og beholde strømmedata)

do Index

Oai-databasen

Henter en record med identifier query

oai-getRecord

Oai-databasen

Henter 'record’er en record med identifier query

oai-getRecordsgetRecord

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 (fs-check-days-back)

oai-getPassedExpectedRecords

Oai-databasen

Legger filer (mainDoc og attachments) til i databasen (BrageFil)

oai-upsertBrageFile

Oai-databasen

Henter filer klare for opplasting (ready) til S3 fra databasen

oai-getBrageFiles

Oai-databasen

Henter en rekke 'repo’er for systemet (wiseflow)

oai-getRepositoriesForSystem

Oai-databasen

Henter en repo etter org og system (eksamensystem og attachments) til i databasen (BrageFil)

oai-getRepositoryupsertBrageFile

Oai-databasen

Oppdaterer en record med DELIVERED_DATE (identifier)Henter filer klare for opplasting (ready) til S3 fra databasen

oai-updateDeliveredDategetBrageFiles

Oai-databasen

Lister ‘record’er (med untilDate, fromDate, eventuelle attributes, org og ready_date eller delayed_dateHenter en rekke 'repo’er for systemet (wiseflow)

oai-oaiListRecordsgetRepositoriesForSystem

Amazon S3

Overfører arkiverte filer (localFileName og fileName) til S3 bucket

upload file:

https://docs.safespring.com/storage/generalinfo/

Slack

Sender feilmeldinger (inkludert også data på module-idog submodul, organisasjons shortName og orgId, examSystem, examSysInstance, vurdId, fetchFsListDates, decodedFsTestId og filesToArchive). Det stemmer overens med Config-databasen (configDB.slack-blacklistsgetSlackBlacklist).

Slack-kanalen (mule-prod)

WISEflow

Returnerer informasjon om en innlevering (submissionId) levert av en student på en bestemt flowIdsom samsvarer med spørringsparameteren (submissionId, flowId, env og orgShortName).

GET: /flow/{flowId}/submission/{submissionId}

https://europe-apidocs.wiseflow.net/

WISEflow

Henter opp grunnleggende informasjon for en gitt flyt som navn, type, start- og sluttdato som kan brukes til å identifisere flyten (basert på contextObjectId (Flow id), org (orgShortName) og env).

GET: /flow/{flowId}

https://europe-apidocs.wiseflow.net/

...

  • 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

...