Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • Innledning

  • Nøkkel info

  • Bakgrunn

  • Interessenter

  • Brukerhistorie

  • Systemer/tjenester

  • Tilgangsstyring og logging

  • Forretningsregler

  • Behandlingstid/responstid og volum

  • Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

  • Kommentarer

...

Veiledning til integrasjonen og løsningsbeskrivelse :

Inc drawio
zoom1
simple0
pageId2300936195
custContentId2640019666
lbox1
diagramDisplayNameGenerell dokumentasjon 202302023.drawio
hiResPreview0
baseUrlhttps://unit.atlassian.net/wiki
diagramNameGenerell dokumentasjon 202302023.drawio
imgPageId2302705702
pCenter0
aspectWZL_C7zIUOqVIDdk2fCY MtUSYfcKr3AQ57z7wqSJ-1
width1667
includedDiagram1
aspectHashae8b3dd20e5b46e945b69f512b9ff961bb0a86fe
linksauto
tbstyletop
height1127

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 og examSystem) mot FS-tittel;

  • FS-tittel forbruker meldinger (event, contextObjectId, contextObjectType, associatedObjectId, associatedObjectType, triggeringUserId, triggeringUserName, inputTopic, id, action, licenseId, flowId, userId, submissionId, participantId, isHandedIn, callTime, eventVersion, sequenceNumber, timestamp, org, instance, env, eventName og examSystem ) fra eksamenssystemene gjennom inspera-webhook

Open API

Nei

 

IntArk

Ikke brukt

 

Bakgrunn

Arkivering av masteroppgaver er et krav som alle institusjoner skal oppfylle.

...

  • Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?

System

Data

Brukt API (endepunkter)

Config-databasen

Finner FsId til en gitt orgShortName(org)

configDB.fsIdToOrgShortName

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 (gjennom FS-tittel API’et)

Registrerer oppgavetittel (engelsk, kandidatnr, original) institusjonsnr og vurdId på vurderingsmeldinger til egen examSystem

URL for test: https://fs-test.uio.no/eksamen/oppgavetittel/{examSystem}/registrer
URL for prod: https://fsws.usit.no/eksamen/oppgavetittel/{examSystem}/registrer

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')

https://api.inspera.no/apidoc/#/fileExport/orderExports

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

Legger auditInfoMap log til databasen

oai-addAuditLog

Oai-databasen

Henter en repo etter org og system (eksamensystem)

oai-getRepository

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-blacklists).

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:

    • assessmentRunId, candidateId, candidateIds, env, errorMessage, examSystem, failedAttempts, flowId, handedInDate, id, inputTopic, instance, isGroup (boolsk), orgId (org), submissionId, success (boolsk), status, testId, timestamp, vurdId (decodedVurdId) og user/groupId

  • 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) og 2-minutter poll timeout for Apache-Kafka forbruk fra eksamensystemer (fs-tittel-app)

  • Volum (målt: ): gj.sn. ca. 3k hits daglig

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

...