Versions Compared

Old Version 3

changes.mady.by.user Alette N. L. Olrik

Saved on

compared with

New Version 4

changes.mady.by.user Alette N. L. Olrik

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Digital Aktiv er en funksjon på Helsenorge som gir svar på om en aktuell innbygger har Digitalt aktiv status i Helsenorge, slik at meldinger kan utveksles.

Det er 2 alternativeralternative metoder:

  1. Metoden DigitaltAktivOmraade brukes av eksterne aktører for å undersøke få svar på om en innbygger er digitalt aktiv på Helsenorge eller ikke. Basert på svaret, kan det eksterne systemet vurdere om det kan og bør kommunisere med innbyggeren via Helsenorge og/eller om det må benytte alternative kanalerinnbyggers digitale status i Helsenorge. Det bør kun sjekkes på pasienter som har status inaktiv. Dette er den foretrukne metoden , og bør benyttes i det behov for dialog med innbygger oppstår.og vil være tilstrekkelig for legekontorer og andre med mindre pasientmengder.

  2. Metoden DigitaltAktivStatusEndringer. Denne gir en totaloversikt over de innbyggere på Helsenorge som potensielt har fått endret DigitalAktiv status siden et gitt tidspunkt. Ved å sammenlikne dette svaret med lokal “pasient status-liste”, vil det kun være behov for å kalle metoden DigitaltAktivOmraade for de pasienter i systemet som er på “endringslisten” og samtidig finnes lokalt.

Dokumentasjon:

Status
colourPurple
titleUnder arbeid

Løsningen:
Status
colourGreen
titleI DRIFT

Gliffy
imageAttachmentIdatt867762177
macroIda9b86c6c-90b1-478f-804d-8e9503a2aca8
baseUrlhttps://helsenorge.atlassian.net/wiki
nameDigitalAktiv
diagramAttachmentIdatt867631118
containerId23691265
timestamp1608017706283

Forretningsbehov

Expand
titleBrukerhistorier & forretningsmessige akseptansekriterier

Id

Brukerhistorie

Forretningsmessige akseptansekriterier

1

Som integrasjonspart ønsker jeg å sjekke om en innbygger er digitalt aktiv i HN slik at jeg vet om jeg kan sende meldinger/informasjon til mottaker eller ikke.

2

Svaret er nyansert avhengig av hvilket tjenesteområde det spørres om for den spesifikke innbyggeren. Ved å kunne spørre om innbygger er digital aktiv innenfor forskjellige tjenesteområder, tas det høyde for at innbygger på Helsenorge kan nyansere hvilke digitale helsetjenester de ønsker å benytte/få og hvilke de evt. ønsker å reservere seg mot.


3

Som legekontor … i …. ønsker jeg å …….
slik at……I de fleste tilfeller skilles det ikke på hvordan en innbygger er aktiv i HN.
Det er kun ved enkelte tjenester hvor systemet må håndtere om aktiv status via andre skal hindre utførelse.

Systemet må håndtere mottak av svar på om innbygger er

  • digital aktiv selv (true/false)

  • digital aktiv via andre (true/false)

og oppdatere evt. egen status med resultatet.

En innbygger kan være:

  • kun aktiv selv

  • kun aktiv via andre

  • både digitalt aktiv selv og samtidig aktiv via andre

  • ingen av delene

2

Som system ønsker jeg å sjekke på digital status i HN avhengig av hvilket område min tjeneste gjelder.

Systemene må håndtere forespørsler og mottak av svar for følgende områder
1 (Helseregister)

2 (Pasientjournal)

3 (Helsehjelp

4 (Forvaltning)

5 (Sekundærbruk)

6 (Ungdom) - nytt område for ungdom mellom 12-16 år))
Volven kodeverk, 7618

3

Som legekontor ønsker jeg å ha kontroll på hvilke pasienter jeg kan ha digital dialog med slik at jeg

Forutsetninger & tips

  1. Brannmursåpning - se beskrivelse<Liste forutsetninger 2>

  2. API’et krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken.

  3. NB! Digitalt aktiv svaret fra HN inneholder ikke status på om innbygger har reservert seg mot digital kommunikasjon i DigDirs kontakt- og reservasjonsregister. Det betyr at personer kan være aktive på Helsenorge, også i de tilfeller hvor de har reservert seg mot digital kommunikasjon sentralt. Dette hindrer ikke digital dialog via HN, men hindrer f.eks. videreformidling av brev.

Note

Ønsker å fjerne alt dette - bør være i HN intern sys.dok
Hva betyr det å være Digital aktiv?

Spørsmålet om en person er Digital Aktiv er ikke et binært ja/nei-spørsmål. Svarene funksjonen gir vil avhenge av:

  • Hvilke opplysninger som er registrert om personen i folkeregisteret

  • Om personens kontaktinformasjon i Difis kontakt- og reservasjonsregister er oppdatert eller bekreftet siste 18 mnd

  • Om personen har tatt i bruk Helsenorge, og i så fall hvilke samtykker og personverninnstillinger personen har gjort

  • Om det er et barn som har en voksen (forelder) som kan representere det

  • Om personen har gitt andre fullmakt til å operere på vegne av seg (og til hva)

  • Hvilke type tjeneste/område det er snakk

omMerk: DigitalAktiv-sjekken for Helsenorge er helt uavhengig av

  • om

en innbygger har reservert seg mot digital kommunikasjon i DigDirs kontakt- og reservasjonsregister.

Det betyr at personer kan være aktive på Helsenorge, også i de tilfeller hvor de har reservert seg mot digital kommunikasjon sentralt.

Aktiv selv

Betyr at innbygger har en aktiv profil på Helsenorge og kan motta digital informasjon innenfor det området det er snakk om i det aktuelle tilfellet.

Aktiv via andre

Betyr at det finnes minst en annen person som har tilgang til å representere den aktuelle innbyggeren innenfor det aktuelle området på Helsenorge. Dvs. at det finnes andre som kan få tilgang til informasjon på vegne av innbyggeren og evt. utføre aktuelle handlinger på vegne av denne. Dette kan også fungere som et supplement i tillegg til informasjon som også må gis i andre kanaler for å nå innbygger direkte. Personen(-e) som kan representere andre på denne måten har fått denne tilgangen gjennom fullmakt eller fordi de har foreldreansvar for barnet det er snakk om.
Helsenorge tilbyr pårørendeinvolvering og ønsker å gjøre det lettest mulig å være pårørende. Det betyr at vi ønsker å tilrettelegge slik at det er mulig å tilgjengeliggjøre mest mulig informasjon for pårørende samtidig som vi ivaretar at innbyggeren/pasienten selv får informasjon på den måten de har krav på.

Tolkning av svaret på DigitaltAktivOmråde

Det er den eksterne aktøren og det eksterne systemet som er ansvarlig for å avgjøre hva som er riktig å gjøre i hvert enkelt tilfelle basert på svarene. Den eksterne aktøren må derfor selv definere hva som er riktige forretningsregler for sin bruk når det gjelder de ulike svarkombinasjonene i svaret fra DigitalAktivOmraade

En innbygger kan være:

  • både digitalt aktiv selv og samtidig aktiv via andre

  • kun aktiv selv

  • kun aktiv via andre

  • ingen av delene

Teknisk Implementasjon

Feilhåndtering

Følgende responskoder kan forventes fra Helsenorge:

Alle tjenester i API'ene har følgende logikk for HTTP-respons:

  • Statuskode når kallet er utført ok: 200 

  • Statuskode ved feilende validering av request: 400

  • Statuskodde ved feil eller manglende autorisasjon: 401

  • Statuskode ved manglende tilganger: 403

Ved HTTP-statuskoder som tilsier at det har oppstått en feil returneres også en respons med feilkode og feilmelding.

Eks:
{
  "Code": "SEC-110000",

  "Message": "Token is expired or invalid"
}

Teknologi

Dokumentasjon

Kommentar

Status
titleREST

Metode DigitaltAktivOmråde

Gir informasjon om en innbygger sin digitalt aktiv status

Status
titleREST

Metode DigitaltAktivStatusEndringer

Gir informasjon om hvilke innbyggere som potensielt har fått endret sin digitalt aktiv status siden angitt tidspunkt

Status
titleREST
?

01 - System til System

Autorisasjon og aksesstoken

Alle API’er krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken som skal være med i tjenestekallene til det enkelte API. DigitalAktiv tjenesten krever ikke at kallet utføres i context av en innlogget bruker dvs. UseCase 1 (system-til-system) beskrevet i dokumentasjonen til venstre“01 - System - System”.

Integrasjonskrav

Tabellen med krav og akseptansekriterier for integrasjonsparten finnes på egen side.

Integrasjonskrav Digital aktiv