Samspill med Helsenorge for nasjonale helseverktøy
For nasjonale verktøy er flere muligheter for samspill med Helsenorge etablert og det jobbes med ytterligere fremtidige muligheter.
Tilgjengelig funksjonalitet
For nasjonale verktøy er følgende hovedområder tilgjengelig
Selvplukk for innbygger
Uthopp med direkte lenke: Denne benyttes for verktøy som ikke har noen innlogging eller brukerprofil. Verktøyet startes fra Helsenorge i ny fane basert på forhåndslagret URL. Ingen øvrig integrasjon.
Uthopp med sømløs innlogging: Verktøyet må benytte Helsenorge sin OpenID Connect provider og verktøyet startes i en ny fane
Lagre innbyggers kopi på Helsenorge: Dette krever at det først er gjort et sømløst uthopp, verktøyet kan da lagre innbyggers informasjon på Helsenorge
Verktøyformidling. Behandlere kan tipse innbyggere om å bruke nasjonale helseverktøy, enten ved bruk av APIer støttet i et behandlerverktøy eller ved bruk av egen brukerflate Verktøyformidler.
Uthopp med sømløs innlogging
Verktøyet kan ta i bruk Helsenorge-innlogging
Lagre innbyggers kopi
Følgende funksjonalitet er tilgjengelig, etter hvert vil flere API-er kunne utvikles avhengig av behov i sektoren
DokumentAPI: Dette kan benyttes dersom Verktøyet skal lagre dokumenter i innbyggers helsearkiv på Helsenorge. Dette kan være som informasjon til innbygger, eventuelt innbyggers kopi.
Verktøyformidling
Det er mulig å tipse innbygger om bruk av nasjonale helseverktøy, dette kan gjøres enten via API (foretrukket) fra egne løsninger eller ved å bruke en egen midlertidig brukerflate (Verktøyformidleren) som NHN har utviklet for de aktører som ikke har egen systemstøtte for dette ennå. Bruk av APIer for å sende verktøy til innbygger er beskrevet under Samspill med Helsenorge for behandlerverktøy og spesifikt Verktøy API
Verktøyformidleren
Verktøyformidleren er en nettløsning med eget brukergrensesnitt og er tilgjengelig gjennom tjenesteportalen for helseaktører. Gjennom Verktøyformidleren kan helsepersonell i den offentlige helsetjenesten sende nasjonale helseverktøy til pasienter på en trygg og effektiv måte. Pasienten vil få varsel, informasjon og tilgang til verktøyet gjennom Helsenorge.
Verktøyene som kan sendes ut må ligge i Verktøykatalogen. Løsningen benytter HelseID for pålogging for helsepersonell.
Verktøyformidleren er utviklet av Norsk helsenett og inngår som en del av tjenestene som er knyttet til Helsenorge. Den vil være begrenset til formidling av nasjonale helseverktøy og bruk av APIer direkte fra helsepersonells brukerflate er foretrukket for en god flyt for Helsepersonell.
Brukerveiledning for Verktøyformidleren
Brukerveiledning for Verktøyformidleren er tilgjengelig i vedlagt dokument.
Hendelsesvarsel
Hendelsesvarsel
Nasjonale verktøy kan sende varsel til innbygger via Helsenorge om aktivitet eller informasjon i verktøyet. Det kan brukes for å informere innbyggere om viktige hendelser i verktøy som er integrert med Helsenorge. Varslene vises i innbyggerens varseloversikt på Helsenorge. Innbyggere som har aktivert pushvarsler i Helsenorge-appen kan i tillegg motta pushvarsel.
Begrensninger knyttet til varsling
Helsenorge sin ordinære varslingsfunksjonalitet for SMS og e-post er basert på kontaktinformasjon som er registrert i Kontakt- og reservasjonsregisteret (KRR). Nasjonale verktøy har ikke tilgang til denne kontaktinformasjonen gjennom Helsenorge og kan derfor ikke benytte Helsenorges SMS- eller e-postvarsling.
Dette skyldes at kontaktinformasjon i KRR er underlagt særskilte regler for tilgang og bruk. Opplysningene kan kun benyttes av virksomheter som har rettslig grunnlag for dette og til formål som er omfattet av regelverket for registeret. Selv om et nasjonalt verktøy er tilgjengelig gjennom Helsenorge, innebærer ikke dette at leverandøren av verktøyet får tilgang til innbyggerens mobilnummer eller e-postadresse.
Denne avgrensningen er etablert for å:
ivareta innbyggernes personvern og sikre at kontaktinformasjon ikke deles med flere aktører enn nødvendig
sikre at opplysninger fra KRR kun brukes til de formålene de er innhentet og forvaltet for
tydeliggjøre ansvarsforholdet mellom Helsenorge og leverandøren av det nasjonale verktøyet
redusere risikoen for at kontaktinformasjon brukes eller lagres utenfor de etablerte forvaltnings- og sikkerhetsmekanismene knyttet til KRR
Som følge av dette kan Helsenorge kun levere hendelsesvarsler til innbygger gjennom Helsenorges egne kanaler:
Hendelsen kan vises til innbygger på Helsenorge.
Helsenorge kan sende pushvarsel til innbyggere som har aktivert pushvarsler i Helsenorge-appen.
Verktøyet får ikke informasjon om hvorvidt innbygger har aktivert pushvarsler.
Verktøyet mottar informasjon dersom et pushvarsel ikke ble sendt.
Verktøyet får ikke tilgang til kontaktinformasjon fra KRR.
Dersom varsling via SMS eller e-post er nødvendig, må verktøyet selv innhente og forvalte kontaktinformasjonen, samt ha egen funksjonalitet for utsendelse av slike varsler.
Forutsetninger for å bruke hendelsesvarsler fra nasjonale verktøy
Verktøyet må selv ha funksjonalitet for at innbygger kan styre varsling fra verktøyet, for eksempel slå varsling av og på eller velge ønsket kanal. Inkludert valg om hendelsesvarsel kan sendes som pushvarsel via Helsenorge.
Verktøyet må ha egen håndtering for tilfeller hvor Helsenorge ikke kan levere pushvarsel, for eksempel fordi innbygger ikke har aktivert pushvarsler eller har reservert seg mot denne typen varsler.
Dersom SMS- eller e-postvarsling er nødvendig, må verktøyet selv innhente og forvalte kontaktinformasjonen som benyttes.
Hendelsesvarsel er nærmere beskrevet her: https://helsenorge.atlassian.net/wiki/x/AYAgew
Fremtidige muligheter
Fremtidige muligheter vil etableres basert på integrasjonsmønster og innholdsstandarder som øvrige Helsenorgeintegrasjoner. Disse er overordnet beskrevet på Teknisk integrasjon med Helsenorgetjenester
Lagre innbyggers kopi
Måledata: Dette kan benyttes dersom verktøyet skal lagre innbyggers strukturerte måledata på Helsenorge. Dette kan benyttes for verktøy som ikke har egen lagring eller som ønsker å tilby innbygger en kopi av lagret informasjon.