Versions Compared

Key

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

...

  • Integrasjonen henter ut vurderingsinformasjon fra FSWS og oppretter prøver i WISEflow på bakgrunn av dette.

Inc drawio
simple0
zoom1

...

pageId

...

2302771203
custContentId

...

3417112623

...

diagramDisplayName

...

DigEks.drawio
lbox1
hiResPreview0
baseUrlhttps://

...

sikt.atlassian.net/wiki
diagramName

...

DigEks.drawio
imgPageId

...

2742714411
pCenter0
aspect

...

OOK5al9Ag-Kyg9dfiho5 1

...

includedDiagram

...

1

...

width

...

1653
aspectHash

...

6df9d94baa863af28665b1af1aaeb051fcd39e57
linksauto
tbstyletop
height

...

1101

Nøkkel info

Initiering av flyt

Poller FSWS hver 6. time for endringer i vurderinger siste 3 dager.

Flyt mønster

Halveis synkron

Den delen som leser inn fra FS er en egen prosess og er frakoblet den delen som sender til WISEflow. Hver del er synkron for seg.

Bruk av meldingskø

Ja, Kafka

Følgende felter sendes over fra FS-delen og til WISEflow-delen:

examInfo prøvedata fra FS

shortName, fsID institusjonsinfo fra IOM sin configDB

examInstance spesifiserer hvilken WISEflow som berøres

doPOST flagg for å bestemme om det skal skrives til WISEflow. For bruk til utvikling.

Open API

Nei

IntArk

Kan brukes etter ønske, for å aksessere WISEflow gjennom Gravitee. Meldingskø ikke implementert.

Institusjonen bestemmer selv og gir oss beskjed om integrasjonen skal kontakte WISEflow-instansen direkte eller om integrasjonen skal gå gjennom Gravitee

Bakgrunn

  • Hver eneste prøve som skal holdes i WISEflow må opprettes manuelt i dag. Dette er en tidkrevende prosess for saksbehandler, og denne integrasjonen vil lette dette arbeidet.

...

  • Vurdering gjøres klar i FS, med kandidater oppmeldt

  • Eksamensansvarlige har fått laget en bruker i WISEflow

  • Integrasjonen plukker opp ny prøve fra FS og oppretter i WISEflow

  • Eksamensansvarlig logger seg på WISEFLOW, finner prøven opprettet og kan fortsette med populering av oppgavesett, og annet.

  • FS-synken sørger for at prøven holdes synkronisert med kandidater, sensorer og kommisjoner.

Systemer/tjenester

System

Data

Brukt API (endepunkter)

Config-databasen

Finner data (shortName, fsId, examInstance, stedkodefilter, startYear, maler) for alle institusjoner som har aktivert AutoPostExam i databasen for gjeldende miljø.

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 json-liste basert på institutionsnr, datofra, datotil, sistEndret og examSystem over alle vurderinger som har blitt endret siden oppgitt tidspunkt.

GET: /eksamen/liste?institusjonsnr={examSystem}&datofra={datofra}&datotil={datotil}&eksamenssystem=WISEFLOW&sistEndret={sistEndret}

URL for test: https://fs-test.uio.no/eksamen/liste?

URL for prod: https://fsws.usit.no/eksamen?liste?…

FS-Digex

Henter full info for en gitt eksamen basert på examSystem og examId.

GET: /eksamen/{examSystem}/{examId}

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

FS-API

Henter ut merknadsfelt fra vurderingsenheter for å kunne matche med WISEflow:flowkode for mal, eller også flowtype. Input-parametre er institusjonsnr, emnekode, versjonskode, vurdkombkode, årstid, terminkode

GET: /vurderingsenheter

FS-API

Henter ut merknadsfelt fra vurderingskombinasjoner for å kunne matche med WISEflow:flowkode for mal, eller også flowtype. Input-parametre er institusjonsnr, emnekode, versjonskode, vurdkombkode

GET: /vurderingskombinasjoner

LaaS

Registrerer auditInfoMap (se under) i Humio (for å innta og beholde strømmedata)

do Index

Oai-databasen

legger auditInfoMap log (se under) til databasen

oai-addAuditLog

Slack

Sender feilmeldinger (inkludert også auditInfoMap, se under). Det stemmer overens med Config-databasen (configDB.slack-blacklists).

Slack-kanalen (mule-prod)

WISEflow

Spør examInstance om bruker med idsys:FEIDE orgId:brukernavn@domene.no finnes i WISEflow (eksamensansvarlig FS:EKSANSV). Returnerer WISEflow:userId om bruker finnes som bruker i WISEflow.

GET: /user/eduPrincipalName/{orgId}

WISEflow

Spør examInstance etter integrationId for kobling til FS.

GET: /license/sis/clients

WISEflow

Søk i examInstance etter prøve med externalID (base64 hash som definerer FS-vurdering: <institusjonsnr>||<emnekode>||<versjonskode>||<vurdkombkode>||<årstall>||<vurdtidkode>). Returnerer tomt json-array dersom det ikke finnes noen flow med den id.

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

WISEflow

Oppretter ny prøve i examInstance

Payload består av FS metadata samt wiseflow-brukerinfo til EKSANSV og flowtype fra merknadsfelt.

POST: ​/license/create/flow

Code Block
{
  "title": {FS:Emnetittel},
  "subTitle": {FS:Emnekode},
  "type": {FLOWtype},
  "managers": [
    {WISEflow:userId}
  ]
}

WISEflow

Oppretter ny prøve i examInstance fra kopi av mal med id flowId.

Payload består av FS metadata samt wiseflow-brukerinfo og diverse boolske config.settings som bestemmer hva som skal over (varierer med flowtypen til flowId.

POST: ​/flows/{flowId}/copy

Code Block
{
  "title": {FS:Emnetittel},
  "subTitle": {FS:Emnekode},
  "managerUserIds": [
    {WISEflow:userId}
  ],
  "configuration": {
  <CONFIGURATION SETTINGS>
  }
}

WISEflow

Knytter WISEflow prøve flowId til FS prøve med prøvedata decodedExternalID (Klartekst-streng som definerer FS prøve <institusjonsnr>||<emnekode>||<versjonskode>||<vurdkombkode>||<årstall>||<vurdtidkode>) og klargjør for nattlig eller manuell synkronisering. Returnerer tomt med statuskode 204 dersom alt er ok, feilmelding ellers.

POST: /flow/{flowId}/source/add

Code Block
{
  "sourceCode": {decodedExternalID},
  "integrationId": {integrationId},
  "useSisMetaData": true,
  "useSisDates": true
}

Tilgangsstyring og logging

...