Table of Contents | ||||||
---|---|---|---|---|---|---|
|
...
Innledning
Dette er en enkel integrasjon for arkivering av eksamensoppgaver og veiledningerav pensumlister fra Legato til arkiv-systemet. Brukerne (av leganto) eksporterer ønskede pensumlister til gitt folder på en SFTP server. Integrasjonen plukker opp filene, samt en konnfig-fil i form av json-fil og sender dem til arkivering.
Til arkivering, benyttes p360-arkiv-appen
Veiledning og virkemåte : Arkivering av pensumlister fra Leganto
Inc drawio | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Nøkkel info
Initiesering av flyt |
---|
Poll-request | Kjører hver time |
Flyt møsnter |
---|
synkron |
, batch-jobb | Sjekker om det er lagt ut pensum-lister til arkivering, om det er det, arkiveres de en og en |
Bruk av meldingskø |
---|
Ja, Kafka
Mottar/forbruker webhook-meldinger som skal omdirigeres til Leganto, og publiserer sessionName
, orgShortName
og hashedInputProperties
fra FS
Nei | ||
Open API | Nei | |
---|---|---|
IntArk | Ikke brukt |
Oversikt
Bakgrunn
Arkivering av eksamensoppgaver og veiledninger pensumlister er et krav som alle institusjoner skal oppfylle. Oppdraget og bestillingen kommer fra Arbeidsgruppen for dokumentasjonsforvaltning.
...
Dette er en leveranse til både Arkiv og Digital-eksamen Bibliotek-tjenesten (ved Asbjørn Risan). Kostandene deles derfor mellom disse 2.
Arkiv har produsert og bestemt den såkalte mappinsdokument som definerer hvordan oppgavene skal arkiveres i arkiv-systemet.
Brukerhistorie
??Leganto medarbeider eksporterer pensumlister som ønskes arkivert. Pensumlistene arkiveres autoatisk til riktig sak i Arkiv-systemet.
Systemer/tjenester
Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?
Tabellen under tar for seg BARE
System | Data | Brukt API (endepunkter) |
---|---|---|
Config-databasen |
Henter fs-inst-id
basert på orgShortName
MongoDb
FS API
Henter emne basert på institusjon (fsId) og emne id
Inspera
Henter informasjon om en bruker basert på en ekstern bruker-ID (external-id
) og instance
(Get test by external id)
GET: /users/external/
https://api.inspera.no/apidoc/#/users/getExternalUserInfoInspera
Henter alle relevante metadata for testen gitt av test-id
og instance
(Get test by id). Dette vil også inkludere alle relevante kandidatmetadata.
GET: /test/
https://api.inspera.no/apidoc/#/test/getTestMetadataInspera
Dette vil se ut som en pdf generert gjennom Inspera-frontend (basert på test-id
og instance
), med følgende innstillinger: "No cover, documents autoscored questions, cover, correct answers, max score and large interactions included, page breaks between questions turned on" (Get assessment pdf url).
Liste over alle institusjoner med | configDB.orgs | |
Slack | Sender feilmelding beskrivelser (inkludert også data på | |
FS API | Henter emner (undervisning høst/vår, undervisning år/termin) med | GET /emner |
SFTP
module
do Index
Amazon S3 |
Overfører arkiverte filer ( |
filnavn
hentes fra Inspera/WISEflow) til mapper ('exams-arkiv' bucket).GET: /flow/{flowId}/{content}
https://europe-apidocs.wiseflow.net/
| upload file: |
WISEflow
Henter tildelingsinformasjon for en gitt flowId
. Dette endepunktet returnerer informasjon om alle oppdrag i en gitt flyt.
GET: /flow/{flowId}/{assignments}
https://europe-apidocs.wiseflow.net/WISEflow
Henter tilleggsinnhold for en gitt flowId
. Dette kan være filer eller lenker som er tilgjengelig enten som generelt materiale, innhold for deltakelse, innhold for vurdering eller som dedikerte retningslinjer for assessor
.
Public360 | P360 Arkivmodul | |
Documaster | Documaster arkiv-module |
Tilgangsstyring og logging
Integrasjonen loger til Humio med detaljert logging av prosessen.
Integrasjonen er knyttet logg-oversikten som vil logge følgende data:submodule
examSystem
examSysInstance
p360Instance
orgId
vurdId
env
fetchFsListDates
success (true/false)
errorMessage (hvis aktuelt)
decodedFsTestId
filesToArchiveIntegrasjonen har ikke noe behov for tilgangstyring
...