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 | (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 |
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
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.
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 fra bibsys konverter | sftp.bibsys.no/home/pensum/konverter_input |
s3 | mellomlagring av alle data | write file |
FS-api-ext | get undervisning | |
fs-api-ext | get number of students from studentundervisning | |
get undervisningsaktiviteter | ||
fs-gemini-ext | get termin typer | |
fs_api | emnedata | get by href |
org data | get by href | |
personrolledata faglærere | get roller | |
get personroller | ||
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
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)
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Hva skjer 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.