Krav og testbeskrivelser
Formålet med denne siden er å gi en oversikt over krav til integrasjoner mot eFormidling, med tilhørende testbeskrivelser.
Informasjon om nødvendig testoppsett finnes på Kom i gang med testing.
- Felles krav
- Støtter visning av siste status for sendt melding (MÅ)
- Støtter varsling av avsender for meldinger som får status feilet eller levetid utløpt (MÅ)
- Støtter visning av sendte meldinger og status for disse (MÅ)
- Bruker grensesnittet eFormidling 2 som beskrevet i dokumentasjonen (MÅ)
- Dersom på-vegne-av brukes, så er dette oppsettet testet (MÅ)
- Dersom kanal brukes, så er dette oppsettet testet (MÅ)
- Produserer og konsumerer meldinger som forventet (MÅ)
- Krav til eventuell drift av integrasjonspunkt
- Saksbehandling
- Støtter sending til mottakere med eFormidling (DPO) (MÅ)
- Støtter sending til mottakere med KS SvarUt/SvarInn (DPF) (MÅ)
- Støtter sending til mottakere med Altinn Digital Post (DPV) (MÅ)
- Støtter mottak fra avsendere med eFormidling (DPO) (MÅ)
- Støtter mottak fra avsendere med KS SvarUt/SvarInn (DPF) (MÅ)
- Støtter å motta svar direkte på sak og journalpost (BØR)
- Støtter å sende svar direkte til sak og journalpost (BØR)
- Taushetsbelagt saksbehandling
- Vedtak til innbyggere
- Støtter sending til mottakere med DPI (MÅ)
- Støtter sending til mottakere med Altinn Digital Post (DPV) (BØR)
- Støtter sending til mottakere med postadresse (print) (BØR)
- Støtter sending til mottaker med postadresse (print) og ukjent fødselsnummer (BØR)
- Støtter DPI-utvidelsen “lenke utenfor brev” (KAN)
- Støtter DPI-utvidelsen “bevis” (KAN)
- Støtter DPI-utvidelsen “arrangement” (KAN)
- Støtter konfigurasjon av avsenderidentifikator for DPI (BØR)
- Publisering av møte til eInnsyn
- Publisering av journalpost til eInnsyn
- Mottak av innsynskrav fra eInnsyn
Felles krav
Disse kravene gjelder uavhengig av hvilke prosess(er) som støttes.
Støtter visning av siste status for sendt melding (MÅ)
- Verifiser at bruker som sendte meldingen kan se siste status for denne
Støtter varsling av avsender for meldinger som får status feilet eller levetid utløpt (MÅ)
- Fyll inn utilstrekkelige eller feil metadata for melding
- Send melding til en mottaker som bruker eFormidling
- Verifiser at meldingen blir markert som feilet
- Verifiser at bruker som sendte meldingen får beskjed om at melding feilet uten å kreve at bruker selv aktivt sjekker status for meldingen
Verifiser at følgende kategorier feil håndteres:
- synkron feil, for eksempel dersom adresseoppslag feiler, send f.eks. til adresse som ikke finnes
- asynkron feil, for eksempel dersom autentisering feiler mot aktuell meldingstjeneste, legg f.eks. inn feil brukernavn for meldingstjenesten i konfigurasjonen før en sender melding
- levetid utløpt, for eksempel dersom mottaker lar være/ikke klarer å behandle melding, send f.eks. til qa-integrasjonspunkt og vent til levetid utløper
Verifiser at systemet følger med på asynkrone statuser (inkludert feil-statuser) knyttet til en melding helt til den har fått en av følgende statuser: levert
, feil
eller levetid utløpt
. Merk at statusen lest
vil kunne komme flere dager og uker etter at meldingen er sendt og at en derfor må polle over et udefinert tidsrom dersom denne ønskes.
Støtter visning av sendte meldinger og status for disse (MÅ)
- Fyll inn utilstrekkelige eller feil metadata for melding
- Send melding til en mottaker som bruker eFormidling
- Verifiser at bruker selv kan vise en liste over forsendelser som har feilet
- Verifiser at den feilede meldingen er i denne listen
Bruker grensesnittet eFormidling 2 som beskrevet i dokumentasjonen (MÅ)
- Verifiser at integrasjonspunktets API (eFormidling 2) brukes
- Verifiser at integrasjonspunktets gamle API (BEST/EDU) ikke brukes
- Verifiser at en sender meldinger med en av strategiene som er beskrevet på Integrasjonspunktets API (eFormidling 2)
- Verifiser at en følger med på status for sendte meldinger med en av strategiene som er beskrevet på Integrasjonspunktets API (eFormidling 2)
- Verifiser at en mottar meldinger med en av strategiene som er beskrevet på Integrasjonspunktets API (eFormidling 2)
- Verifiser at en har lagt til rette for feilsøking ved å oppgi navn og versjon for eget system ved oppretting av melding
- Verifiser at en ikke bruker ettstegs strategi for sending av små meldinger dersom en skal sende meldinger over 5 MB
- Verifiser at polling brukes ved mottak av innkommende statuser (webhook-abonnement er bare et supplement)
- Verifiser at polling brukes ved mottak av innkommende meldinger (webhook-abonnement er bare et supplement)
- Verifiser at en ikke behandler vellykket bekreftelse på at melding er lagt på kø for sending som at meldingen er sendt eller levert vellykket
- Verifiser at en ikke behandler vellykket bekreftelse på at melding er sendt som at meldingen er levert vellykket
- Verifiser at en kan motta så store meldinger som beskrevet i terskelverdiene som er beskrevet under eFormidlings egenskaper
- Verifiser at en kan sende så store meldinger som beskrevet i terskelverdiene som er beskrevet under eFormidlings egenskaper
- Verifiser at det ikke er mulig å sende meldinger som overskrider terskelverdiene som er beskrevet under eFormidlings egenskaper
Dersom på-vegne-av brukes, så er dette oppsettet testet (MÅ)
Se gjerne på vegne av.
- Verifiser at aktuelle tester er gjennomført med på-vegne-av-oppsett
Dersom kanal brukes, så er dette oppsettet testet (MÅ)
Se gjerne kanal.
- Verifiser at aktuelle tester er gjennomført med kanal-oppsett
Produserer og konsumerer meldinger som forventet (MÅ)
- Verifiser at kommunikasjon fungerer også med andre system enn ens egen
- Verifiser at spesialtegn fungerer som forventet i titler, filnavn, osv
- Verifiser at begrensninger som lengder på tekstfelt fungerer som forventet
- Se begrensninger for dokumenttypene
- Se begrensninger for Integrasjonspunktets API (eFormidling 2)
- Verifiser at sending og mottak fungerer når bare påkrevd informasjon er oppgitt
- Verifiser at sending og mottak fungerer når all mulig informasjon er oppgitt
- Verifiser at kommunikasjon fungerer med ønskede filstørrelser
- Verifiser at kommunikasjon fungerer med ønskede filformat
- Verifiser at gyldige meldinger produseres både når all informasjon er oppgitt og når bare påkrevd informasjon er oppgitt
- Verifiser at innkommende meldinger som mangler påkrevd informasjon likevel ikke avvises
- Verifiser at en ikke sender filer med navn som inneholder tegn som ikke fungerer bra i filnavn, for eksempel kolon
Krav til eventuell drift av integrasjonspunkt
Disse kravene gjelder eventuell drift av integrasjonspunkt.
Har tilfredsstillende tilgangskontroll og sikring av grensesnitt, meldinger og hemmeligheter (MÅ)
- Verifiser at installasjon og konfigurasjon er gjort i henhold til beskrivelser
- Verifiser at transport er tilstrekkelig sikret, f.eks. med hjelp av transportsikring
- Verifiser at tilgang til grensesnittet er tilstrekkelig sikret, f.eks. med hjelp av HTTP basic auth
- Verifiser at hemmeligheter beskyttes tilfredsstillende, f.eks. med hjelp av Hashicorp Vault
- Verifiser at integrasjonspunktets grensesnitt bare er tilgjengelig for autoriserte brukere og system
Har rutiner for å holde integrasjonspunktet oppdatert (MÅ)
- Verifiser at det finnes en rutine for jevnlig oppdatering av integrasjonspunktet
Har automatiserte rutiner for å holde integrasjonspunktet oppdatert (KAN)
- Verifiser at automatisk oppdatering er konfigurert
- Verifiser at oppdateringstidspunkt er gjennomtenkt
Saksbehandling
Disse kravene gjelder dersom saksbehandling støttes.
Støtter sending til mottakere med eFormidling (DPO) (MÅ)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til en mottaker som bruker eFormidling
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til mottaker
- Verifiser at innholdet hos mottaker er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
- Marker melding som lest hos mottaker (varierer fra system til system hvordan - f.eks. først ved tilordning av saksnummer)
- Verifiser at meldingen blir markert som lest
Støtter sending til mottakere med KS SvarUt/SvarInn (DPF) (MÅ)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til en mottaker som bruker KS SvarUt/SvarInn
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til mottaker
- Verifiser at innholdet hos mottaker er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
- Marker melding som lest hos mottaker (varierer fra system til system hvordan - f.eks. først ved tilordning av saksnummer)
- Verifiser at meldingen blir markert som lest
Støtter sending til mottakere med Altinn Digital Post (DPV) (MÅ)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til en mottaker som bruker Altinn Digital Post
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til mottaker
- Verifiser at innholdet hos mottaker er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
- Marker melding som lest hos mottaker (varierer fra system til system hvordan - f.eks. først ved tilordning av saksnummer)
- Verifiser at meldingen blir markert som lest
Støtter mottak fra avsendere med eFormidling (DPO) (MÅ)
- Fyll inn ønsket metadata for melding i et system som bruker eFormidling (husk 1.7)
- Send melding til mottaker som bruker eget system (systemet som testes)
- Verifiser at meldingen blir markert som sendt hos avsender
- Verifiser at meldingen kommer frem til mottaker
- Verifiser at innholdet hos mottaker er som forventet (husk 1.7)
- Verifisert at meldingen blir markert som mottatt og etter hvert levert hos avsender
- Marker melding som lest hos mottaker
- Verifiser at meldingen blir markert som lest hos avsender
Støtter mottak fra avsendere med KS SvarUt/SvarInn (DPF) (MÅ)
- Fyll inn ønsket metadata for melding i et system som bruker KS SvarUt (husk 1.7)
- Send melding til mottaker som bruker eget system (systemet som testes)
- Verifiser at meldingen blir markert som sendt i KS SvarUt
- Verifiser at meldingen kommer frem til mottaker
- Verifiser at innholdet hos mottaker er som forventet (husk 1.7)
- Verifisert at meldingen blir markert som mottatt og etter hvert levert i KS SvarUt
- Marker melding som lest hos mottaker
- Verifiser at meldingen blir markert som lest i KS SvarUt
Støtter å motta svar direkte på sak og journalpost (BØR)
- Fyll inn ønsket metadata for melding
- Send melding til en mottaker som bruker eFormidling
- Verifiser at meldingen kommer frem til mottaker
- Svar på meldingen fra mottakers system
- Verifiser at svaret kommer frem, koblet til sak og journalpost som forventet
Støtter å sende svar direkte til sak og journalpost (BØR)
- Fyll inn ønsket metadata for melding i et system som bruker eFormidling
- Send melding til mottaker som bruker eget system (systemet som testes)
- Verifiser at meldingen kommer frem til mottaker
- Svar på meldingen fra mottaker
- Verifiser at svaret kommer frem, koblet til sak og journalpost som forventet
Taushetsbelagt saksbehandling
Disse kravene gjelder dersom taushetsbelagt saksbehandling støttes.
Taushetsbelagt saksbehandling følger tilsvarende flyt som saksbehandling, med noen tilleggskrav.
- Krav og testbeskrivelser for Saksbehandling
- Tillegg
skrav for taushetsbelagt saksbehandling
- Verifiser at det er mulig å markere melding som taushetsbelagt
- Verifiser at det er mulig å oppgi DPV varslingstekst for taushetsbelagt melding
Vedtak til innbyggere
Disse kravene gjelder dersom vedtak til innbyggere støttes.
Støtter sending til mottakere med DPI (MÅ)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Verifiser at det er mulig å oppgi varslingstekst
- Send melding til mottaker som bruker DPI
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til DPI
- Verifiser at innholdet i DPI er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
Støtter sending til mottakere med Altinn Digital Post (DPV) (BØR)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Verifiser at det er mulig å oppgi varslingstekst
- Send melding til mottaker som bruker DPV
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til DPV
- Verifiser at innholdet i DPV er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
Støtter sending til mottakere med postadresse (print) (BØR)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til mottaker som verken bruker DPI eller DPV
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til print
- Verifiser at innholdet i print er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
Støtter sending til mottaker med postadresse (print) og ukjent fødselsnummer (BØR)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til annen mottaker som verken bruker DPI eller DPV
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til print
- Verifiser at innholdet i print er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
Støtter DPI-utvidelsen “lenke utenfor brev” (KAN)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til annen mottaker som bruker DPI
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til DPI
-
Verifiser at innholdet i meldingen er som forventet (husk 1.7)
- Verifiser at lenke utenfor brev fungerer som forventet
Støtter DPI-utvidelsen “bevis” (KAN)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til annen mottaker som bruker DPI
- Verfiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til DPI
- Verifiser at innholdet i meldingen er som forventet (husk 1.7)
- Verifiser at bevis fungerer som forventet
Støtter DPI-utvidelsen “arrangement” (KAN)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til annen mottaker som bruker DPI
- Verfiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til DPI
- Verifiser at innholdet i meldingen er som forventet (husk 1.7)
- Verifiser at arrangement fungerer som forventet
Støtter konfigurasjon av avsenderidentifikator for DPI (BØR)
- Verifiser at det er mulig å konfigurere avsenderidentifikator for DPI
Publisering av møte til eInnsyn
Disse kravene gjelder dersom publisering av møte til eInnsyn støttes.
Støtter publisering av møte til eInnsyn (MÅ)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til eInnsyn
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til eInnsyn
- Verifiser at innholdet i eInnsyn er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
Publisering av journalpost til eInnsyn
Disse kravene gjelder dersom publisering av journalpost til eInnsyn støttes.
Støtter publisering av journalpost til eInnsyn (MÅ)
- Fyll inn ønsket metadata for melding (husk 1.7)
- Send melding til eInnsyn
- Verifiser at meldingen blir markert som sendt
- Verifiser at meldingen kommer frem til eInnsyn
- Verifiser at innholdet i eInnsyn er som forventet (husk 1.7)
- Verifiser at meldingen blir markert som mottatt og etter hvert levert
Mottak av innsynskrav fra eInnsyn
Disse kravene gjelder dersom mottak av innsynskrav fra eInnsyn støttes.
Støtter mottak av innsynskrav fra eInnsyn (MÅ)
- Send innsynskrav fra eInnsyn
- Verifiser at innsynskravet kommer frem
- Verifiser at innholdet i innsynskravet er som forventet (husk 1.7)