| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
...
Integrasjonen henter undervisningsenheter/-aktiviteter og kobling til fagpersoner fra FS, og lager en importfil til Alma/Leganto. Undervisningsenhetene/-aktivitetene som er lastet opp kalles emner (courses) i Alma/Leganto.
| Inc drawio | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Nøkkelinfo
Initiering av flyt | Scheduler (to ganger daglig) eller manuell trigging |
|
|---|---|---|
Flyt mønster |
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 |
Bakgrunn
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?BIBSYS
...
BIBSYS (Leganto tjenesteansvarlig)
Brukerhistorie
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.
Systemer/tjenester
...
Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?
...
Hvilken kø-mekanisme brukes evt.?
...
Bruker kan så hente ut fil og lastes opp i Leganto.
Systemer/tjenester
System | Data | Brukt API (endepunkter) |
|---|
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?
Om involverte API
Brukte API endepunkter
Tilgangsstyring og logging
...
Tilgangsstyring og logging
loggene er i to retninger: fra FS (grunnlag for å lage pensumlister) og mot Leganto.
De som kjører mot Leganto:
kakfa meldinger (
sessionName,orgShortName, oghashedInputProperties), filnavn finnes i S3, sesjon info (host,portogusername),
Eventuelle tilgangstyring
Forretningsregler
Forretningslogikken i integrasjonen. Feks. Bare dokumenter med status X leses etter Y antall dager osv …Styringsparametre settes av input-fil laget med konverter. Hva de forskjellige styringsparameterne gjør er beskrevet her.
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.