| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
...
Initiering av flyt | Scheduler (to ganger daglig) eller manuell trigging |
|
|---|---|---|
Flyt mønster | (a)Synkron henting av data fra FS, kafka brukes som intern kø for asynkron overføring mot leganto | Tar imot HTTP forespørsler fra eksamen-systemer og videresender dem til FS DigEks |
Bruk av meldingskø | Kafka | Internt mellom henting fra FS og levering til Leganto |
Open API | Nei | Men brukes av eksterne systemer |
IntArk | NEI |
...
Import av emnene muliggjør kobling av lister til et emne og kobling mellom læringsplattform og Leganto.
Interessenter
Hvem er ansvarlig for datakommunikasjonen? Hvem bestilte dette og betaler for at utvekslingenpågår?BIBSYSBIBSYS (Leganto tjenesteansvarlig)
Brukerhistorie (gjerne sekvensdiagram) ?
Bruker med behov for å lage pensumlister benytter seg av BIBSYS sin FS-konverter for å generere fil, som lastes opp på BIBSYS server. Denne plukkes opp av integrasjonen som genererer input til pensumlisteverktøyet Leganto og laster det opp til institusjonens område på BIBSYS sftp-server. Bruker kan så hente ut fil og lastes opp i Leganto.
Systemer/tjenester
Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?
Hvilken kø-mekanisme brukes evt.?
Om Int-ark komponenter er brukt og eventuelt hvilke deler
System | Data | Brukt API (endepunkter) | oai-ext|
|---|---|---|---|
configDb-ext |
| Org short name to FS inst id | |
sftp | hente input parametre fra bibsys konverter | sftp.bibsys.no/home/pensum/konverter_input | |
sftp | lagre legantofil og logfil | sftp.bibsys.no/home/pensum/konverter_output | |
s3 | mellomlagring av alle data | write file | |
FS-api-ext | undervisningsinformasjon | get undervisning | |
fs-api-ext | antall studenter på et emne de siste 3 årene | get number of students from studentundervisning | |
fs-api-ext | data om undervisningsaktiviteter | get undervisningsaktiviteter | |
fs-gemini-ext | termintyper | get termin typer | |
fs_api-ext | emnedata | get by href | |
fs-api-ext | org data | get by href | |
fs-api-ext | personrolledata faglærere | get roller | |
fs-api-ext | personrolledata faglærere | get personroller | |
fs-api-ext | persondata | get person | |
s3-ext | hente mellomlagret data | get file |
Data
Hvilke data utveksles? Alle attributter som utveksles?
Samhandlingsmønster
Hva driver utvekslingen? Request og SchedulerEr utvekslingen synkron eller asynkron?
...
Brukte API endepunkter
Tilgangsstyring og logging
Hva logges?
Eventuelle tilgangstyring
Forretningsregler
Forretningslogikken i integrasjonen. Feks. Bare dokumenter med status X leses etter Y antall dager osv …
Behandlingstid/responstid og volum
Hva er antallet meldinger pr. døgn i denne forbindelsen (Min, Avg, Max)Behandlingstid/responstid: den kan varieres fra mindre enn et minutt til mer enn 14 minutter. (avhengig av antall objekter/beskrivelser)
Frekvens: HTTPS-‘listener’ repeterbar fillagerstrøm og Scheduler (to ganger om dagen) for datastrømmestrategi fra FS, og 2-minutter poll timeout for Apache-Kafka forbruk til Leganto
Volum (målt: ): ca. 5,5k daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Hva skjer ved Feil logges til egen fil på institusjonens område på bibsys sin sftp server
Ved overload i kø ?
Hva skjer med ufullstendinge meldinger?
Inneholder meldingene personopplysninger?
Noe om viktige feil/situasjoner som må passes ekstra på (som kan ha stor konsekvens). F.eks : Oppgavene som aldri vil publiseres, eller Oppgaver som ikke skal publiseres, publiseres.
...
kan integrasjonen stoppe opp og ikke publisere pensumlister.
Ufullstendige kafka-meldinger gjør at prosessen stopper opp, og oversending til p360 feiler.
Meldingene inneholder personopplysninger i form av navn på faglærere og undervisngingsansvarlige.
Det mest alvorlige som kan skje er om pensumlistene som genereres er feil og fører til at studenter kjøper feil pensumlitteratur. Andre ting vil være om feil fagperson blir knyttet opp til undervisning/aktiviteter.