Table of Contents | ||||||
---|---|---|---|---|---|---|
|
...
Innledning
Denne integrasjonen sørger for å opprette klage-flows for hver flow, der det kommer en klage på. Egentlig skal den opprette en klage-flow når den første klage-forespørselen kommer. Men i praksis, oppretter den klage-flowen (utfører kall til WF) for hver eneste klage som kommer. API’et til Wiseflow oppretter uansett bare 1 klage-flow og over ser overser alle andre.
Inc drawio | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Nøkkel info
Initiering av flyt | Polling Pulling utført av klage-beg-dispatcher | Merk at klage-beg-dispatcher-app poller puller FS og sender klage-forespørslene som meldinger til wiseflog-klage |
---|---|---|
Flyt møsnter | Asynkron | Den delen som leser fra FS er |
Bruk av meldingskø | Ja, Kafka |
|
Open API | Nei | |
IntArk | Ikke brukt |
Bakgrunn
Det er Wiseflow som oppdaterer en klage-flow med kandidater og kommisjoner osv. Men en klage-flow må opprettes når den første klage-forespørselen kommer inn. Det er den jobben denne integrasjonen tar seg av.
Interessenter
Dette er en leveranse til Digital-eksamen.
Brukerhistorie
Student ber om klage i studenweb (eller hvor det måtte være). En klage-flow opprettes i Wiseflow hvis den ikke er allerede opprettet.
Systemer/tjenester
Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?
...
System | Data | Brukt API (endepunkter) |
---|---|---|
Config-databasen | Finner | configDB.orgs |
Config-databasen | Hvis prosessen var mislykket ( 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å | GET: /eksamen/klager/{examSystem}/ URL for test: https://fs-test.uio.no/eksamen/klager/<examSystem>?institusjonsnr=...&siden=...& https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html |
FS-Digex | Henter klager for en gitt eksamen basert på | GET: /eksamen/klager/{examSystem}/{examId} URL for test: https://fs-test.uio.no/eksamen/klager/{examSystem}/{examId} https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html |
LaaS | Registrerer en indeks | do Index |
Mongo-databasen | Finner alle dokumenter i databasen ( | Find documents i oai.KlageBegrunnelseEnvs kolleksjonen |
Oai-databasen | legger auditInfoMap log til databasen | oai-addAuditLog |
Oai-databasen | Henter aktive institusjoner med aktiv klage- og begrunnelse-status som tilsvarer | oai.KlageBegrunnelseEnvs |
Oai-databasen | Hvis prosessen var mislykket ( | ‘Delete Kafka Message By Hash’ i oai.Records |
Slack | Sender feilmeldinger (inkludert også data på | Slack-kanalen (mule-prod) |
WISEflow | Returnerer en liste ( | GET: /license/sis/flows/{sisCode} |
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} |
WISEflow | Returnerer grunnleggende informasjon ( | GET: /flow/{flowId}/participants |
WISEflow | Oppretter en revurderingsflyt til en allerede opprettet flyten (av gitt NB: Dette endepunktet krever revurderingsmodulen på lisensen. | POST: /flow/{flowId}/reassessment |
Tilgangsstyring og logging
Integrasjonen loger til Humio med detaljert logging av prosessen.
Integrasjonen er knyttet logg-oversikten som vil logge følgende data:
env
errorMessage (String)
errorCode (Number)
examSys
flowId
hash
inputTopic
kandidatNr
orgId
personlopeNr
reassessmentFlowId
submodule
success (boolsk)
vurdId (decodedVurdId)
Integrasjonen har ikke noe behov for tilgangstyring
Forretningsregler
Hoved flyt i integrasjonen:
For hver klage-forespørsel fra FS
Finn alle aktive flow i Wiseflow.
Hvis studenten (som har klaget) finnes i flowen
og er aktiv, opprett klage-flow for aktuell flow
Andre egenskaper og prosesser i integrasjonen
klage-beg-dispatcher kjører annen hver time og henter klager for 2 dager tilbake i tid. Den sender da klage-forespørselen over BARE hvis den ikke er sendt allerede de siste 2 dagene.
Merk ! Det vil si om en klage endres noe på innen 2 dager, vil den ikke sendes videre. Ikke sikker dette har noe praksis betydningDet betyr om institusjonen ønsker å sende en klage på nytt (noe de gjør ved å endre noe fiktiv på klagen i FS, slik at den plukkes opp igjen), vil den ikke sendes på nytt allikevel, hvis endringen skjer innen 2 dager fra opprinnelig melding sendt.
Feilede overføringer vil forsøkes re-sendt opp til 5 ganger.
Behandlingstid/responstid og volum
behandlingstid/responstid: gj.sn. ca. 3s
Frekvens: 2-minutter poll timeout for manuelt triggering og 120-minutters tidsplaner for faste frekvenser (Klage-beg-dispatcher), og 2-minutter poll timeout for Apache-Kafka forbruk (WISEflow-klage-app)
Volum (målt: ): gj.sn. ca. 5k hits daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Opprettelse av feil klage-flow for feil flow.
Bare en feil koding kunne føre til noe slikt. Tester sørger for at dette ikke skjer.
Ikke overføring og dermed opprettelse av klage-flow
Resending av feilede feilede overføringer pluss antall ganger hver klage forsøkes lest og overført, gjør sannsynligheten for denne feilen minimalt