Tjenesteoversikt kan benyttes for å sende en helsekontakt til innbygger. Meldingstypen ble opprinnelig kalt tjenesteoversikt fordi den gir en oversikt over hvilke helsetjenester innbygger mottar og som gir digitale innbyggertjenester.
Forutsetninger for å bruke denne prosessen er:
Kommunikasjonsparten Avsender må kunne markere enkelte tjenester som digitale innbyggertjenester
Kommunikasjonsparten Avsender må være i stand til å ha en elektronisk meldingsutveksling med Helsenorge.no
Page Properties | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Prosesser og flyt
Her er info om prosesser og flyt
Expand | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
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.
Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under. |
Info |
---|
Se ytterligere detaljer i innholdsstandarder for innhold i meldinger |
Hodemelding
Hodemelding vil inneholde informasjon om avsender, mottaker og pasient. Hodemelding vil også inneholde teknisk informasjon som unik id og tidspunkt for generering. Nedenfor beskrives de viktigste delene av standarden som slik den skal brukes for orientering om tjenestetilbud
Expand | ||
---|---|---|
| ||
Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier). XML eksempel:
|
Expand | ||||
---|---|---|---|---|
| ||||
Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Tjenesteoversikt. Innholdet skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon:
|
Expand | ||||
---|---|---|---|---|
| ||||
Informasjon om avsender og mottaker skal være i henhold til beskrivelsen i standarden for tjenestebasert adressering tilgjengelig her: https://www.ehelse.no/standarder/om-standardisering-i-e-helse/tjenestebasert-adressering Avsender: MsgHead/MsgInfo/Sender I avsender av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator. XML eksempel med Oslo kommune som avsender:
Mottaker: MsgHead/MsgInfo/Receiver I mottager av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator, et XML eksempel er vist under.
|
Expand | ||
---|---|---|
| ||
Elementet <MsgHead/MsgInfo/Ack> skal benyttes til å angi at det skal svares med applikasjonskvittering. Tjenesteoversikt skal alltid ha en applikasjonskvittering. XML eksempel:
|
Expand | ||
---|---|---|
| ||
For identifikasjon av en pasient benyttes kodeverket «ID-type for personer» 8116, se http://www.volven.no . Skjemaet støtter flere identifikatorer, men for digital dialog benyttes bare en identifikator og det er bare støtte for fødselsnummer eller D-nummer Følgende informasjon er obligatorisk å oppgi for pasient.
XML eksempel for pasient med fødselsnummer:
|
Expand | ||
---|---|---|
| ||
Hodemeldingen har struktur for å ha null til mange forekomster av MsgHead/Document. Under «Document» vil faginnholdet i en melding være plassert, og faginnholdet er definert i egne xml skjema. Innholdet under Document vil være xml skjemaet TjenesteOversikt. |
Tjenesteoversikt
For bruk mot helsenorge.no for overføring av tjenester som innbygger mottar overføring av helsekontakter er det utarbeidet et eget skjema spesifikt for dette formålet- tjenesteoversikt.
Expand | ||
---|---|---|
| ||
Expand | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||
Tabellen under oppsummerer attributtene i Tjeneste.
Et eksempel på XML med Oslo kommune, og to aktive tjenester er vist under. Den første tjenesten har en primærkontakt og telefonnummer og URL til tjenesten.
|
Expand | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
RelaterteRoller benyttes for å kunne overføre helsepersonell knyttet til tjenesten og som skal være tilgjengelig for innbygger på Helsenorge. Tabellen under oppsummerer attributtene i RelaterteRoller. Skjemaet tillater også sending av enheter og personer, dette er ikke støttet funksjonelt. RelaterteRoller inneholder samme informasjon som RollerRelatertNotat i dialogmeldingen og burde vært navngitt konsistent med dialogmeldingingdialogmelding. En endring krever oppdatert skjema og versjon av kommunikasjonsprosess, og anses ikke hensiktsmessig.
Et eksempel på XML med en primærkontakt er vist under:
|
Expand | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||
Avsender vil alltid sende en komplett liste med gjeldende tjenester, og mottager vil alltid synkronisere denne komplett ved å:
Nøkkelfelt for å identifisere en tjeneste unikt er:
Avsender har logikk for håndtering av sending av tjenesteoversikt slik at korrekt informasjon for en tjeneste kan vises i Helsenorge.no. Et tenkt tilfelle er vist i tabellen under, der en tjeneste går fra Aktiv-> Inaktiv -> Aktiv:
I dette tilfellet skal EPJ sende følgende informasjon for at informasjon i helsenorge.no Helsenorge skal bli riktig:
Dersom tjeneste med startdato 8.6 sendes før 8.6 vil tjenesten ikke vises riktig som aktiv eller historisk. Helsenorge .no lagrer ikke historikk for meldingen, så de fleste feilsituasjoner kan løses ved å sende ny korrekt melding. Tabellen under gir foreslått håndtering av kjente tilfeller.
|
Applikasjonskvittering
Applikasjonskvittering skal benyttes for å bekrefte at melding er mottatt og kan behandles av systemet. Applikasjonskvittering v1.1 skal benyttes, slik beskrevet i https://ehelse.no/his80415-2012.
Expand | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Applikasjonskvittering skal benyttes slik det er beskrevet i standarden for Applikasjonskvittering v1.1. Det er beskrevet at følgende hovedprinsipp gjelder for når det skal sendes positiv eller negativ kvittering.
En negativ applikasjonskvittering betyr i hovedsak at det var noe feil med mottatt melding slik at denne ikke kunne behandles av mottaker. Når det sendes en negativ kvittering forventes det at mottaker følger opp denne i henhold til feilkoder og sender en ny (og feilfri) melding. Kodeverk 8221 «Feilmeldinger for applikasjonskvittering» skal brukes ved negativ applikasjonskvittering for å angi type feilmelding. Ved mottak av en melding gjøres det i hovedsak to ulike valideringer
Tabellen under viser negative applikasjonskvitteringer som kan forventes mottatt.
|
Expand | ||
---|---|---|
| ||
I noen tilfeller er melding korrekt og sendt til riktig innbygger, men meldingen kan likevel ikke behandles. Dette skjer dersom en aktør sender melding til en person som ikke har en innbyggerprofil på helsenorge.no og samtykke til digital helsetjeneste. Helsenorge.no har i dette tilfellet ikke lov til å lagre eller behandle meldingen. I dette tilfellet sendes negativ kvittering med feilkoden «E35 - Pasienten finnes ikke i mottakersystemet». Mottager av kvittering skal markere innbygger som ikke aktiv og melding skal ikke resendes. |
Generell info om meldingsutveksling med Helsenorge
For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge og PVK
Ytterligere informasjon
Under er forskjellige typer supplerende informasjon
Rammeverk for meldingsutveksling
AMQP (Advanced Message Queuing Protocol) versjon 1.0 skal benyttes for meldingsutvekslingen for digital dialog med helsenorge.no .
Beskrivelse av AMQP kan finnes hos OASIS: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-overview-v1.0-os.html.
Oppsett av AMQP-meldingen skal gjøres i henhold til spesifikasjon i AMQP profil https://ehelse.no/hits1216-2018.