Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Inc drawio
zoom1
simple0
pageId2304802895
custContentId2451046407
lbox1
diagramDisplayNameDataflyt-oversikt-20220801.drawio
hiResPreview0
contentVer1
baseUrlhttps://unit.atlassian.net/wiki
diagramNameDataflyt-oversikt-20220801.drawio
pCenter0
aspect3QyGyzPtm0rDNT5SDeRo uV_2_xjBd2DBvYv8w5rY-1
width1660
linksauto
tbstyletop
isUpload1
height1180
Table of Contents
minLevel1
maxLevel7
printablefalse

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 og examSystem) 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 og examSystem 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
zoom1
simple0
pageId2304802895
custContentId2451046407
lbox1
diagramDisplayNameDataflyt-oversikt-20220801.drawio
hiResPreview0
contentVer1
baseUrlhttps://unit.atlassian.net/wiki
diagramNameDataflyt-oversikt-20220801.drawio
pCenter0
aspect3QyGyzPtm0rDNT5SDeRo uV_2_xjBd2DBvYv8w5rY-1
width1660
linksauto
tbstyletop
isUpload1
height1180
Table of Contents
minLevel1
maxLevel7
printablefalse

...

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 og examSystem) 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 og examSystem 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>&.......

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å 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=...&

https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html

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/begrunnelse/<examSystem>?institusjonsnr=...&siden=...&{examSystem}/{examId}
URL for prod: https://fsws.usit.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 explanations (urlBegrunnelse, datoBegrunnelseBedtOm, dokumentBegrunnelse, kandidatnr, datoBegrunnelseGitt, contentTypeBegrunnelse) gitt til en kandidat for en eksamen basert på examSystem og examId.

GETPOST: /eksamen/begrunnelser/{examSystem}/{examId}

URL for test: https://fs-test.uio.no/eksamen/begrunnelser/{examSystem}/{examId}<examSystem>
URL for prod: https://fsws.usit.no/eksamen/begrunnelser/{examSystem}/{examId}https://fsws.usit.no/eksamen/begrunnelser/<examSystem>

https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html#digeks_begr_post

Inspera

Henter resultatkandidatinformasjonen (title, startTime, endTime, assessmentRunId, externalId, candidateId) for en gitt bruker på en gitt test (instance, org, assessmentRunId og userOrGroupId)

GET: /candidates/listTests/{userId}

https://wwwapi.fellesstudentsysteminspera.no/brukersiderapidoc/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}

URL for test: https://fs-test.uio.no/eksamen/begrunnelser/<examSystem>
URL for prod: https://fsws.usit.no/eksamen/begrunnelser/<examSystem>

https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html#digeks_begr_postcandidates/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

Mongo-databasen

Finner alle dokumenter i databasen (orgId, examSys, insperaClientCode, fsEnv, instance, active, begrunnelse, klage, autoEpost og XklageFilter) som samsvarer med aktiv status og aktiv-verdi for Klage- eller Begrunnelse-felt. Find documents i oai.KlageBegrunnelseEnvs kolleksjonen.

Find documents i oai.KlageBegrunnelseEnvs kolleksjonen

Oai-databasen

Henter record med identifier query

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

oai-getPassedExpectedRecords

Oai-databasenlegger auditInfoMap log til databasen

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

oai-addAuditLogupsertBrageFile

Oai-databasen

Henter aktive institusjoner med aktiv klage- og begrunnelse-status som tilsvarer examSystem, org og instance

oai.KlageBegrunnelseEnvs

Oai-databasen

Sender category (wiseflow-begrunnelse) og Json-string (vurdId, klage, examSys, orgId og env) til databasen, og hvis

‘returnTrueAndAddToDatabaseIfNotInDatabase’ i oai.kafkaMessages

Oai-databasen

Henter dokumenter som ikke ble behandlet (success er False med mindre enn 5 failedAttempts) for å sende dem videre i flyten for å prøve på nytt.

oai.LastAudit

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 karakterbegrunnelsen (av gitt orgShortName, env, flowId og explanationRequestId). Denne informasjonen inneholder navnet på flyten (flowId), datoer (requestDate, assignDate, acceptDate og dueDate), informasjon om participant, informasjon om assignedAssessor og eventuell karakterbegrunnelse gitt med mer.

GET: /flow/{flowId}/explanation/request/{explanationRequestId}

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

WISEflow

Oppdater synligheten til en karakterbegrunnelse (av gitt orgShortName, env, flowId og explanationRequestId) for participant i WISEflow med flowId, explanationRequestId og showJustification.

PATCH: /flow/{flowId}/explanation/request/{explanationRequestId}

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

WISEflow

Returnerer en liste (combinedMainFlowId, purpose, combinedSubFlowIds, variant, state, creationDate, type og flowId) over flyter som samsvarer med spørringsparameteren (sisCode, env og orgShortName).

GET: /license/sis/flows/{sisCode}

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/

WISEflow

Returnerer grunnleggende informasjon (submissionId, assessorIds, groupId, id, assessorGroupIds og user) om alle deltakere som er tildelt en gitt flowId.

GET: ​/flow​/{flowId}​/participants

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

WISEflow

Hvis den er aktivert på flyten (av gitt orgShortName, env, flowId , dueDate og participantId), kan en participant be om en begrunnelse på den gitte vurderingen.

POST: /flow/{flowId}/explanation/request

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

Klage-beg-dispatcher

volum

...

Inspera-webhook

...

  • Behandlingstid/responstid: ca.

    6s

    2s

  • 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-minutt

    oai-pmh) og 5-minutter poll timeout for Apache-Kafka forbruk for

    begrunnelse-svar

    eksamensystemer (

    WISEflow

    Brage-

    begrunnelse

    app)

  • Volum (målt:

    29 Jul

    ): gj.sn. ca.

    28k

    23k hits daglig

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

...