FS-Leganto
- babak.tavassoli
- Armaz Mellati
- Karl Jacob Maus (Deactivated)
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, meldingskø brukes som intern kø for asynkron overføring mot leganto | Tar imot forespørsler fra eksamen-systemer og videresender dem til FS DigEks |
Bruk av meldingskø | MeldingQ (Sikt egen melding-kø system basert på MongoDb, i.e. DocumentDb). N.B. se Integrasjonsplattformen-nettlenken for mer informasjon. | Internt mellom henting fra FS og levering til Leganto. Ettersom meldingssystemet ikke kan aksesseres eksternt, vurderes det heller ikke som nødvendig å utdype dette ytterligere i applikasjonsdokumentasjonen. |
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:
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 30 minutter (avhengig av antall objekter/beskrivelser).
Frekvens: Det meldingssystemet kjører uten forsinkelse på meldingskøen – lytteren til køen tar meldinger én etter én og starter behandlingen umiddelbart.
Volum (målt: Jan 17, 2025): ca. 80 correlationId daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Feil logges til egen fil på institusjonens område på bibsys sin sftp server
Hva skjer ved overload i kø?
Det skjer ikke da-køene kun har én parallell forbruker ('queue-listener');
Hva skjer med ufullstendige meldinger?
De registrerer det og sender dokumentene igjen seinere.
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