AMQP Digitalbruker

Owned by Levin Løssfelt (Unlicensed), created
Last updated: Feb 03, 2022 by Alette N. L. Olrik (Unlicensed)
6 min read

Denne meldingen skal fases ut, benytt heller API’et DigitaltAktiv https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/23691265

Meldingen gir begrenset funksjonalitet og vil ikke videreutvikles.

 

Prosessen Digitalbruker gir tilgang til funksjonalitet for å sjekke om innbygger er digitalt aktiv eller for helsenorge.no til å publisere endringer i status for digitalt aktiv.

API-navn

DIALOG_INNBYGGER_DIGITALBRUKER

Funksjonelt område

Dialog

API-versjon og dato publisert

v1.2 Nov 23, 2015

Status

Avviklet / I Drift

API-dokumentasjon sist endret

Feb 11, 2021

Teknologi

AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess

Funksjonalitet

Versjon

Dialog_Innbygger_Digitalbruker

Basisversjon for kommunikasjonsprosess.

Skal ikke tas i bruk av nye aktører, er erstattet av API som gir mer detaljert status.

1.2

Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes for de ulike versjonene.

Versjon

Rolle

Funksjon

Meldingsinnhold

1.2

Innbygger

StatusEndring

StatusSvar

Dialogmelding 1.1

Person

Helsepersonell

SjekkStatus

Dialogmelding 1.1

Person

Varsel om endring i innbyggers status digital aktiv

Med «Varsel om endring i innbyggers status digital aktiv» menes det at Helsenorge.no sender en melding for å varsle om at innbygger har blitt digital aktiv bruker på Helsenorge.no (og kan kontaktes av mottager) eller at innbygger har blitt inaktiv bruker.

Varsel om at innbygger har blitt aktiv kan kun sendes til innbyggers fastlege og vil kun sendes for nye innbyggere som samtykker til Helsenorge. Andre aktører som skal ta i bruk løsningen må aktiv spørre om innbygger er aktiv, og ved oppstart av nye legekontor må også spørring gjøres for å identifisere hvem som er aktive.

Varsel om innbygger som har blitt inaktiv kan sendes til aktive helsekontaker og i de tilfeller der innbygger har blitt inaktiv som følge av trukket samtykke til helsenorge. Det er også andre tilfeller som kan medføre at innbygger blir inaktiv og som ikke kan varsles av helsenorge. Aktør som sender meldinger til Helsenorge må håndtere at enhver melding med applikasjonskvittering kan returnere E35 innbygger ikke aktiv.

Sekvensdiagram for funksjonen er vist i figuren under.

Sjekk om innbygger er digitalt aktiv bruker

Med tjenesten «Sjekk om innbyggere er digitalt aktiv brukere» menes det at en aktør sender en liste med pasienter til helsenorge.no og spør om hvem som er digitale aktive brukere på helsenorge.no . Svaret tilbake fra helsenorge.no er en liste med de pasientene som er digitale aktive brukere, eventuelt en kode som angir ingen digitalt aktive brukere.

Det er laget en ny versjon av sjekk av digitalt aktiv bruker, eksponert som et API.

Det nye APIet har en mer nyansert spørring for å angi:

  • Input: Område. Angir hvilket område innbygger skal være aktiv, verdier er "Registerinnsyn", “Pasientjournal", "Helsehjelp", “Forvaltning” og “Sekundærbruk”

  • Output angir både om innbygger er aktiv selv og om innbyger er aktiv via andre.

Tjenesten dokumentert i dette avsnittet tilsvarer bruk av nytt API med input=Helsehjelp og angir om innbygger enten er aktiv selv eller via andre. Dersom det trengs en mer nyansert spørring skal nytt API benyttes og før nyimplementering av denne meldingstypen skal helsenorge kontaktes for funksjonelle og tekniske avklaringer.

Sekvensdiagram for funksjonen er vist under.

 

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Varsel om endring i innbyggers status, asynkron tjeneste

Her er strukturen på meldingen

Tjeneste

Varsel om endring i innbyggers status, asynkron tjeneste

Bruksområde

Brukes av helsenorge.no for å varsle om at innbygger har blitt digital aktiv bruker eller har blitt inaktiv bruker på helsenorge.no. Dersom innbygger er digital aktiv bruker på helsenorge.no kan legekontor/behandler kontakte innbygger via helsenorge.no.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174397

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

<Type V="DIALOG_INNBYGGER_DIGITALBRUKER" DN="Dialog med innbygger – digital bruker"/>

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

<Ack DN="Ja" V="J"/>

Dialogmelding

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Foresporsel/TypeForesp

  • Dialogmelding/Foresporsel/KodetOpplysning

 

Lovlige kodeverdier som kan brukes i TypeForesp:

  • SDAB           Status digital aktiv bruker

 

Lovlige kodeverdier som kan brukes i KodetOpplysning (kodeverk 1101, http://volven.helsedirektoratet.no/produkt.asp?id=220749&catID=3&subID=8 ):

  • 1     Ja

  • 2     Nei

 

KodetOpplysning er obligatorisk for å angi status om innbygger er digital aktiv innbygger. Kodeverdi 1=Ja betyr at innbygger har blitt digital aktiv bruker, kodeverdi 2=Nei betyr at innbygger har blitt inaktiv bruker.

 

XML eksempel:

<Foresporsel> <TypeForesp V="SDAB" DN="Status digital aktiv bruker" S="2.16.578.1.12.4.1.1. 7601"/> <KodetOpplysning V="1" DN="Ja" S="2.16.578.1.12.4.1.1.1101"/> </Foresporsel>

RollerRelatertNotat

Ikke aktuelt å bruke for denne tjenesten.

iCalender

Ikke aktuelt å bruke for denne tjenesten.

Helsepersonell

Ikke aktuelt å bruke for denne tjenesten.

Pasientrelasjon

Ikke aktuelt å bruke for denne tjenesten.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten.

 

Forespørsel om sjekk digitalt aktive brukere

Her er strukturen på en query

Tjeneste

Forespørsel om sjekk digitalt aktive brukere, asynkron tjeneste

Bruksområde

Brukes når EPJ-systemet ønsker å å spørre helsenorge.no om angitte pasienter er digitale aktive brukere.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174397

Et unntak er at pasient skal ikke oppgis. Dvs. at patient-elementet i Hodemeldingen skal utelates.

 

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

Dialogmelding

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Foresporsel/TypeForesp

 

Lovlige kodeverdier som kan brukes i TypeForesp:

  • SIDAB          Sjekk om innbyggere er digitalt aktive brukere

 

XML eksempel:

RollerRelatertNotat

Ikke aktuelt å bruke for denne tjenesten.

iCalender

Ikke aktuelt å bruke for denne tjenesten.

Helsepersonell

Ikke aktuelt å bruke for denne tjenesten.

Pasientrelasjon

Ikke aktuelt å bruke for denne tjenesten.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten.

Personer

Obligatorisk informasjon som skal inneholde de personene som en ønsker å spørre om er digitalt aktive brukere på helsenorge.no .

Xml-eksempel:

Svar på forespørsel om sjekk digitalt aktive brukere

Her er strukturen på en respons

Tjeneste

Svar på forespørsel om sjekk digitalt aktive brukere, asynkron tjeneste

Bruksområde

Svaret fra helsenorge.no med de pasientene i forespørselen som er digitale aktive brukere på helsenorge.no.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i

Et unntak er at pasient ikke skal oppgis. Dvs. at patient-elementet i Hodemeldingen skal utelates.

 

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

Dialogmelding

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Notat/Temakodet

  • Dialogmelding/Notat/TekstNotatInnhold

  • Dialogmelding/Notat/Foresporsel

Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding.

 

Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet:

  • 28     Digitale aktive brukere

  • 29     Ingen digitale brukere

 

Kodeverdi 28 betyr at en eller flere av oppgitte pasienter i forespørsel er digitale aktive brukere.
Kodeverdi 29 betyr at ingen av de oppgite pasienter i forespørsel er digitale aktive brukere.
De personene som er digitalt aktive brukere oversendes i informasjonsobjektet «Personer»

XML eksempel:

RollerRelatertNotat

Ikke aktuelt å bruke for denne tjenesten.

iCalender

Ikke aktuelt å bruke for denne tjenesten.

Helsepersonell

Ikke aktuelt å bruke for denne tjenesten.

Pasientrelasjon

Ikke aktuelt å bruke for denne tjenesten.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten.

Personer

Obligatorisk informasjon når det returneres en eller flere personer som er digitalt aktive brukere, dvs. at kodeverdi 28 returneres.

Xml-eksempel:

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Eksempelmeldinger



Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: