Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Innledning

Dette er enenkel integrasjon for arkivering av 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: https://www.jobbnorge.no/about/rekrutteringsverktoy/integrasjoner/

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, Apache Kafka

Bare for å produsere meldinger til Jobbnorge

Open API

Nei

IntArk

Ikke brukt

Oversikt

Bakgrunn

Arkivering av pensumlister er et krav som alle institusjoner skal oppfylle. Oppdraget og bestillingen kommer fra Arbeidsgruppen for dokumentasjonsforvaltning.

Interessenter

Dette er en leveranse til både Arkiv og 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

Oppsetter orgId med P360_ShortName

Get single org: configDB.orgs

Amazon S3

Overfører arkiverte filer (localFileName og fileName) til S3 bucket

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

Mongo-databasen

Setter inn et dokument (mongoDoc) i en kolleksjon (p360.jobbnorge).

NB: -id-objektet kan spesifiseres eller ikke (og Mongo-databasen vil autogenerere en).

Insert document: p360.jobbnorge

Mongo-databasen

Finner alle dokumenter i databasen som samsvarer med en spørring (filename eller org); hvis ingen forespørsel er spesifisert, hentes alle dokumenter i kolleksjonen, og hvis det ikke er angitt noe feltobjekt, hentes alle felt.

Find document: p360.jobbnorge

Mongo-databasen

Oppdaterer dokumenter som samsvarer med det gitte søket (fileref og
orgId). Hvis spørringen ikke er spesifisert, hentes alle dokumenter. Siden parameter multi er satt til usann, vil bare det første dokumentet som samsvarer med det, bli oppdatert.

Update documents: p360.jobbnorge

Auth

Autentiserer inngang med system, username og password

MongoDB.users

APIKit

APIKit-ruterelementene gjør det mulig å definere en API

APIkit Router

APIKit

APIKit-konsollens frittstående endepunkt

APIkit Console

Public360

Kloner forespørselen om å få en sak (Clone Request, kapittel 18.1.1.1) med P360_shortName og caseNumber, og oppgi et passende navn

GetCase: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 18.1.2)

Public360

P360 Arkivmodul

Tilgangsstyring og logging

  • Integrasjonen loger til Humio med detaljert logging av prosessen.

  • Integrasjonen er knyttet logg-oversikten som vil logge følgende data (“NOARKSAK”):

    • STILLINGSID

    • SA_TITTEL

    • SA_TITTELINTERN

    • SA_ANSVFIRMANAVN

    • SA_ARKIVREF

    • SA_ANSVEPOST

    • JOURNALPOST_TAB (JOURNALPOST)

      • JP_INNHOLD

      • JP_U1

      • JP_DOKDATO

      • JP_DOKTYPE

      • ADRESSAT_TAB/ADRESSAT (NAVN, ADRESSE, POSTNR, POSTSTED, EPOSTADR, TLF)

      • DOKVERSJON_TAB/DOKVERSJON (VE_NAVN, VE_DOKFORMAT, VE_FILREF, VE_DOKID)

  • Integrasjonen har ikke noe behov for tilgangstyring

Forretningsregler

Behandlingstid/responstid og volum

  • Integrasjonen ikke tatt til bruker nå; ingen data!

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

Generelt vil status og dermed eventuelle feil være synlig og tilgjengelig for institusjonen via logg-oversikten. Det er også utarbeidet mulighet for at enkelt personer ved institusjonen kan melde seg på for mottak av feilmeldinger på epost daglig.

Videre har vi overvåkning av loggene via Humio for å fange opp feil-situasjoner utenfor institusjonens virkeområde, som f.eks. utilgjengelige API endepunkter og bugs i koden.

  • Hva skjer ved overload i kø?

    • Det skjer ikke. Men om vi skulle på grunn av noe feil ikke motta meldingene fra eksamensystemene, vil : Inspera vite om det og sende dem på nytt. Wiseflow: er basert på polling, så vi kan alltid polle igjen

  • Hva skjer med ufullstendige meldinger?

    • De vil feile og det vil vi oppdage i loggene og kan ta aksjon basert på det.

  • Inneholder meldingene personopplysninger?

    • Merk at det utveksles mange “meldinger” mellom ulike systemer i løpet av en integrasjon. Melinger fra eksamensystem inneholder ikke noe persondata, men data vi henter fra FS basert på de meldingene gjør det. Filene vi arkiverer (som kommer fra eksamensystemene) kan også potensielt inneholde personopplysninger.

  • Noe om viktige feil/situasjoner som må passes ekstra på (som kan ha stor konsekvens) :

    • Oppgavene ikke arkiveres (miste meldinger)

    • Oppgaver arkiveres med feil info. (feiltolking eller feil logikk)

    • Oppgaver arkiveres med feil tilganger (slik at oppgaver som ikke skal være offentlige, arkiveres slik at de blir offentlig synlige)

Kommentarer

  • No labels