FS-Leganto

1 Innledning
2 Nøkkelinfo
3 Bakgrunn
4 Interessenter
5 Brukerhistorie
6 Systemer/tjenester
7 Tilgangsstyring og logging
8 Forretningsregler
9 Behandlingstid/responstid og volum
10 Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
11 Kommentarer

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)

System	Data	Brukt API (endepunkter)
configDb-ext	`fs-inst-id`	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, og hashedInputProperties), filnavn finnes i S3, sesjon info (host, port og username),
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.