FS-Leganto
Innledning
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.
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
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. 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 |
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
Styringsparametre settes av input-fil laget med konverter. Hva de forskjellige styringsparameterne gjør er beskrevet her.
Behandlingstid/responstid og volum
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: Sep 30, 2022): ca. 5,5k daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Feil logges til egen fil på institusjonens område på bibsys sin sftp server
Ved overload i kø 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.
Kommentarer