Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7
printablefalse

...

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
simple0
zoom1
pageId2300936195
custContentId3417636882
diagramDisplayNameArkiv.drawio
lbox1
hiResPreview0
baseUrlhttps://sikt.atlassian.net/wiki
diagramNameArkiv.drawio
imgPageId2303262731
pCenter0
aspect4ee8JR1-_TgsK1CAWJvy 1
includedDiagram1
width1654
aspectHash8f462a64b3982bdc3e1ceb3853e73841eb19a622
linksauto
tbstyletop
height1121

Nøkkel info

Wiseflow :

Initiesering av flyt

Inspera : Push (Webhooks)

Poll-request

Kjører hver time

Flyt møsnter

Halveis

synkron

Den delen som leser inn fra Inspera/Wiseflow er en egen prosess og er fra-koblet fra resten. Men den delen som arkiverer går synkront til arkiv-tjenesten

, 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

https://api.fellesstudentsystem.no/swagger.html#/koder/getEmner

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/getExternalUserInfo

Inspera

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/getTestMetadata

Inspera

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).

GET: /test/{testId}/assessment/pdf

Liste over alle institusjoner med PensumListeArkiv satt til “true”

configDB.orgs

Slack

Sender feilmelding beskrivelser (inkludert også data på module-id, og orgShortName) til Slack-kanalen (mule-prod)

sikt-no.slack.com

FS API

Henter emner (undervisning høst/vår, undervisning år/termin) med fsId, og emneKode og emneVersjon (valgfri)

GET /emner

https://api.

inspera

fellesstudentsystem.no/

apidoc

swagger.html#/

#/test/schedulePDFExport

SFTP

module

do Index

koder/getEmner

Amazon S3

Laster opp

Overfører arkiverte filer (

med filnavn hentes fra Inspera/WISEflow) til mapper ('exams-arkiv' bucket).

GET: /flow/{flowId}/{content}

https://europe-apidocs.wiseflow.net/

localFileName og fileName) til S3 bucket

upload file:

https://docs.safespring.com/storage/generalinfo/

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

  • filesToArchive

  • Integrasjonen har ikke noe behov for tilgangstyring

...