| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
...
Innledning
Grovt om hva denne integrasjonen er fra hvor / Til hvor?
Bakgrunn
Litt om grunnen til integrasjonen. Hva for en behov dekkes av integrasjonen.
Interessenter
Hvem er ansvarlig for datakommunikasjonen? Hvem bestilte dette og betaler for at utvekslingenpågår?
Brukerhistorie (gjerne sekvensdiagram) ?
Hvis vi har noenDenne integrasjonen kalles også jobbnorge-integrasjonen. Den sørger for mottak av rekruterings-filer og arkivering av dem gjennom p360-arkiv-appen. Alle institusjoner bruker Jobbnorge, bortsett fra Oslomet som bruker Varbi.
Jobbnorge/Varbi sender rekruterings-filer som skal arkiveres som PDF’er (Varbi sender også noen gager wordfiler) og en XML med nødvendige metadata. Filene mottas og lagres i S3. Men så fort XML’en kommer (som skal alltid komme etter), blir de plukket opp og sendes til arkivering.
PS! Denne integrasjonen har også en grafisk grensesnitt med egen API som tillater brukerne se status på overføringer, rette dem opp og sende dem på nytt.
Til arkivering, benyttes p360-arkiv-appen
Veiledning og virkemåte: Om Jobbnorge rekrutteringsverktoy
Lenke til Jobbnorge-integrasjon siden: Integrasjoner på Mule | Jobbnorge
| Inc drawio | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Nøkkel info
Initiesering av flyt | Rekruteringsystemet sender filene til oss | |
|---|---|---|
Flyt møsnter | synkron | |
Bruk av meldingskø | nei | |
Open API | Nei | |
IntArk | Ikke brukt |
Oversikt
Bakgrunn
Arkivering av filer fra rekruteringsystemet er lovpålagt.
Interessenter
Dette er en leveranse til Rekrutering. Kostandene føres på rekrutering.
Arkiv har produsert og bestemt den såkalte mappinsdokumentet som definerer hvordan oppgavene skal arkiveres i arkiv-systemet.
Brukerhistorie
Bruker av rekruteringsystemet bruker rekruteringsystemet som vanlig uten å tenke på arkivering. Arkivering skjer automatisk i bakgrunnen av seg selv. Ny sak opprettes ved behov og dokumentene arkiveres.
Bruker sørger for å registrere en saksnummer på rekruterings-saken, ellers bruker systemet som normalt. Arkivring skjer i bakgrunn av seg selv og dokumentene arkiveres i oppgitt saksnummer.
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
Data
Hvilke data utveksles? Alle attributter som utveksles?
Samhandlingsmønster
Hva driver utvekslingen? Request eller Push
Er 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)
Tabellen under tar for seg BARE
System | Data | Brukt API (endepunkter) |
|---|---|---|
Config-databasen | Oppsetter orgId med | Get single org: configDB.orgs |
Amazon S3 | Overfører arkiverte filer ( | Upload file: https://docs.safespring.com/storage/generalinfo/ |
Mongo-databasen | Setter inn et dokument ( 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 ( | Find document: p360.jobbnorge |
Mongo-databasen | Oppdaterer dokumenter som samsvarer med det gitte søket ( | Update documents: p360.jobbnorge |
Auth | Autentiserer inngang med | 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 | GetCase: https://help.360online.com/ReleaseInformation/SIF APIs - Documentation.pdf (kapittel 18.1.2) |
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 (“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
Behandlingstid/responstid: ca. 1s
Frekvens: HTTPS-‘listener’ repeterbar fillagerstrøm for datastrømmestrategi
Volum (målt: ): gj.sn. ca. 1,8k hits daglig
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Ved feil, vil det sendes e-poster til oppgitte brukere (de meldes til oss via e-post) ved hver institusjon. I tillegg vil vi kunne se det i loggene våre i humio. Brukerne kan oftest selv fikse og resende.
Hva skjer ved overload i kø?
I verste fall vil Jobbnorge (rekruteringsystemet) få tilbakemelding om feil. De vil da sende på nytt ved seinere anledning.
Hva skjer med ufullstendinge ufullstendige meldinger?
Vi har ingen forhåndsjekk av melding struktur. Avhenig av når feilen merkes vil enten Kilde-systemet få beskjed eller brukerne.
Inneholder meldingene personopplysninger?
Ja
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.
...
:
Lager for mange dokumentter/saker og dermed roter til Arkivsystemet
Dokumenter arkiveres i feil institusjon
Dokumenter forsvinner uten noe melding eller spor