Versions Compared

Key

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

...

Innledning

Dette er et proxy-api som i hovedsak gjenspeiler DigEks API’et fra FS. https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html#digeks_liste

...

Hoved funksjonen er er at den bygger en Authentiisering og authorisasjonslag på toppen av den eksisterende API’et fra FS.
Brukeren av dette API’et er eksamensystemer.

Inc drawio
zoom1
simple0
pageId2300936195
custContentId2640019666
lbox1
diagramDisplayNameGenerell dokumentasjon 202302023.drawio
hiResPreview0
baseUrlhttps://unit.atlassian.net/wiki
diagramNameGenerell dokumentasjon 202302023.drawio
imgPageId2305720351
pCenter0
aspect4ixEm6HPNFkVSt904zkt L5LBMexe2NAQtkSbVwMH-1
width1630
includedDiagram1
aspectHash21c7fefe1af4410e464c8de3c98f5e4e46438b8b
linksauto
tbstyletop
height1176

Nøkkel info

Initiering av flyt

Scheduler (fire ganger hver dag for hvert “objects” og “description”)

 

Flyt mønster

Synkron

Tar imot HTTP forespørsler fra eksamen-systemer og videresender dem til FS DigEks

Bruk av meldingskø

Nei

 

Open API

Nei

Men brukes av eksterne systemer

IntArk

JA

Bruker Gravitee. Mule-endepunktet ligger bak Gravitee.

...

Da FS DigEks i sin tid ble opprettet, hadde den ikke noe passende mekanisme for tilgangskontroll. Den var heller ikke egnet for å stå som en ekstern endepunkt mot et ukjent antall eksamen-systemer. Et API ble derfor opprettet via Mule som samtidig sørget for et mer uniformt API.

...

Interessenter

Brukeren av API’et er eksamensystemer som trenger data fra FS.

...

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

System

Data

Brukt API (endepunkter)

Innholdsinformasjon-ext

Sender contents, isbn (ISBN13), description_long, audio_file, image_small, image_large, image_original og source til API mot Alma legget av Team Smile

putInfo

 Bokbasen Extension

Denne metoden brukes for å hente objekter fra Bokbasen database. Den mottar enten en "siden"-verdi (since brukes bare hvis next ikke er angitt) eller en "neste"-verdi (next). Resultatet fra databasen transformeres fra xml til json (den setter pagesize hvis spesifisert, ellers brukes bokbasens standard).

Objektrapporten (bilder og lydfiler) inneholder identifikatorer og referanser til adressen hvor objektene kan lastes ned. Disse referansene vil være gyldige i en begrenset periode.

 getPagedObjectsSince

https://bokbasen.jira.com/wiki/spaces/api/pages/67993638/Objects

 Bokbasen Extension

Denne metoden brukes for å hente beskrivelser fra Bokbasen database. Den mottar enten en “siden”-verdi (since brukes bare hvis next ikke er angitt) eller en "neste" verdi (next). Resultatet fra databasen transformeres fra xml til json.

getPagedDescriptionsSince

Tilgangsstyring og logging

...

Behandlingstid/responstid og volum

  • Behandlingstid/responstid: gj. snitt ca. 2s (avhengig av antall objekter/beskrivelser)

  • Frekvens: Scheduler (fire ganger hver dag for hvert “object” og “description”) for datastrømmestrategi

  • Volum (målt: ): ca. 1000 “descriptions” og 300 “objects” daglig

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

...