Dialogmelding

Informasjonsmodellen for dialogmeldingen er vist under, med elementer i bruk ekspandert. Dialogmelding brukes til to anvendelser:

• Forespørsel/henvendelse. Bruk av elementet Foresporsel

• Svar på forespørsel/henvendelse. Bruk av Notat

For dialogmelding v1.0 er det beskrevet at ved svar er det obligatorisk å inkludere mottatt forespørsler/henvendelser i svaret. For digital dialog med innbygger vurderes det som ikke hensiktsmessig å inkludere Forespørsel ved svar på forespørsel. Hovedårsaken til denne vurderingen er at begge parter i dialogen kan sende flere forespørsler og flere svar, og det er da ikke åpenbart hvilken forespørsel det svares på. For å håndtere meldingstråder og visning i EPJ og helsenorge.no benyttes RefToParent og RefToConversation fra hodemeldingen.

Alle svar skal også benytte Notat, uavhengig om hvem som svarer eller hvem som har sendt opprinnelig forespørsel. Innbygger kan for eksempel sende en forespørsel, og så «svare» på denne med ytterligere informasjon ved bruk av Notat. 

Skjemaet i bruk definerer ikke makslengder eller innhold i felter. For Digital dialog med innbygger er det innført begrensninger i brukergrensesnitt for feltlengder. Begrensninger er vist i tabellen er vist under.

Ved en forespørsel skal det alltid angis med en kodet verdi hvilken type forespørsel meldingen inneholder, f.eks. «Reserver time». Type forespørsel vil da alltid bestemme hvilken videre oppfølging/handling som skal skje i mottakersystemet. Den kodete verdien sendes i attributtene «TypeForesp» for forespørsel og i «TemaKodet» i Notat. Detaljert bruk av kodeverdier er beskrevet for den enkelte prosess.

Ved å inkludere type forespørsel på innholdsnivå blir selve overføringen av XML-meldingene teknologinøytral. Innholdet i XML-meldingene vil være likt uavhengig om en velger å kommunisere via web services, meldingskøer eller andre teknologier.

Til hver forespørsel er det et sett av mulige svarkoder som skal brukes når det svares på henvendelse. Svarkoden vil angi om henvendelsen kunne oppfylles eller eventuelle feilkoder som angir årsak til at ønsket henvendelse ikke kunne utføres.

Feilkoder vist i tabellen under kan benyttes i Dialogmeldingen ved svar. Dette brukes i tilfeller der det er sendt en positiv applikasjonskvittering, men forespørsel ikke kan besvares eller ved synkrone kall som ikke benytter applikasjonskvitteringer.

To elementer av datatypen anyType i Dialogmeldingen støtter bruk av formatert tekst i XML-en ved å bruke xhtml. Xhtml versjon 1.1 skal benyttes ved formatering av innholdet. Beskrivelse av bruk og lovlig innhold er beskrevet i referansedokumentet for bruk av xhtml: https://www.ehelse.no/standardisering/standarder/bruk-av-xhtml-formatering

Et eksempel på bruk av anyType der teksten legges i en <div> tag er vist under.

<Sporsmal>
	<div xmlns="http://www.w3.org/1999/xhtml">Her ligger det norske bokstaver: ÆØÅæøå<br /><br />Linjeskift<br /><br />Og en link: https://helsenorge.no/<br /><br /></div>
</Sporsmal> 

RollerRelatertNotat benyttes for å oppgi informasjon om personer, helsepersonell og/eller organisasjoner relatert til dialogen. Dette er en presisering og detaljering av funksjonalitet som angitt i HITS 1174:2017: https://www.ehelse.no/standardisering/standarder/bruk-av-kontaktopplysninger-i-basismeldinger-dialogmelding-og-pleie-og-omsorgsmeldinger

Elementet benyttes for følgende funksjonalitet:

• Meldinger sendt fra Innbygger:

  • RollerRelatertNotat angir helsepersonellet det ønskes at dialogen rutes til. Forutsetter at innbygger har hentet behandlere på forhånd.

  • RollerRelatertNotat angir timeboken det ønskes å bestille time i. Forutsetter at innbygger har hentet timebøker på forhånd.

  • RollerRelatertNotat angir hvilket register (RegisterID) det ønskes å kommunisere med når innbygger kontakter en tjenesteadresse som representerer mer enn ett Helseregister (se kapittel 5 for detaljer).

• Sendt fra Helsepersonell: RollerRelatertNotat angir helsepersonellet som besvarte eller initierte dialogen

• Sendt fra Helseregister: RollerRelatertNotat angir hvilket register (RegisterID) som opplysningene er hentet fra.

• Sendt fra en enhet: RollerRelatertNotat angir hvilken enhet som er avsender og skal vises til innbygger

• Angivelse av timebok for timeavtaler

Dialogmeldingskjemaet gir stor fleksibiliet i bruk at RollerRelatertNotat. For bruk i integrasjon med Helsenorge benyttes kun ett element av RollerRelatertNotat, og dette kan inneholde en av følgende

• HealthcareProfessional

• TilknyttetEnhet

• TilknyttetEnhet og HealthcareProfessional

Det er ikke identifisert brukstilfeller som krever mange intstanser av RollerRelatertNotat.

Avsender kan angi hvilket helsepersonell som besvarer, og dermed skille dette fra hvem som teknisk er avsender slik angitt i hodemeldingen. XML-eksempelet under viser at turnuslege Rita Lin har svart innbygger:

<RollerRelatertNotat> 
	<RoleToPatient V="16" DN="Turnuslege" S="2.16.578.1.12.4.1.1.9034" />
	<HealthcareProfessional>
		<FamilyName>Lin</FamilyName> 
		<GivenName>Rita</GivenName>
		<Ident>
			<Id>9144900</Id>
			<TypeId V="HPR" DN="HPR-nummer" S="2.16.578.1.12.4.1.1.8116" />
		</ Ident>
	</HealthcareProfessional>
</RollerRelatertNotat> 

Dersom innbygger ønsker at meldingen skal rutes til en spesifikk person benyttes meldingen som vist i XML-eksempelet under. Kodeverdien 23- Ønsket behandler benyttes alltid dersom innbygger sender meldingen og angir hvem som skal motta meldingen.

<RollerRelatertNotat> 
<RoleToPatient V="23" DN="Ønsket behandler" S="2.16.578.1.12.4.1.1.9034" />
<HealthcareProfessional>
<FamilyName>Lin</FamilyName> 
<GivenName>Rita</GivenName>
<Ident>
                <Id>9144900</Id>
                <TypeId V="HPR" DN="HPR-nummer" S="2.16.578.1.12.4.1.1.8116" />
</ Ident>
</HealthcareProfessional>
</RollerRelatertNotat> 

Eksemplet under viser hvordan et spesifikt register angis/adresseres dersom kommunikasjonsparten meldingen sendes til representerer flere enn et register (se Oversikt dialogtjenester - Helse og omsorg for meldinger mellom innbygger og registre). ID’en som benyttes er RegisterID fra Oppføringsregisteret.

<RollerRelatertNotat> 
    <TilknyttetEnhet>
<Kontaktenhet>
   <OrganisationName>Norsk MS-register og biobank</OrganisationName>
<Ident>
                <Id>MSREG</Id>
                <TypeId V="LOK" DN="Lokal identifikator uten nærmere angivelse" S="2.16.578.1.12.4.1.1.9051" />
</ Ident>
</Kontaktenhet>
    </TilknyttetEnhet>
</RollerRelatertNotat> 

Avsender kan angi hvilken enhet som besvarer, og dermed skille dette fra hvem som teknisk er avsender slik angitt i hodemeldingen. Eksemplet under viser hvordan en helsestasjon kan angis som avsender av en melding. Som Id kan en lokal identifikator fra avsender benyttes, feltet er påkrevd i svaret.

<RollerRelatertNotat> 
    <TilknyttetEnhet>
<Kontaktenhet>
   <OrganisationName>Nydalen helsestasjon 0-5 år</OrganisationName>
<Ident>
                <Id>D37D8296-A656-422D-AE1A-670A1D7184CC</Id>
                <TypeId V="LOK" DN="Lokal identifikator uten nærmere angivelse" S="2.16.578.1.12.4.1.1.9051" />
</ Ident>
</Kontaktenhet>
    </TilknyttetEnhet>
</RollerRelatertNotat> 

Eksemplet under viser hvordan det angis en timebok for en timeavtale. Timeboken er hentet i prosessen Ressursoversikt og returneres ved bestilling av time eller ved en avtale sendt til Helsenorge. Innholdet i informasjon er navn og Id på timeboken.

<RollerRelatertNotat> 
    <TilknyttetEnhet>
<Kontaktenhet>
   <OrganisationName>Influensavaksine </OrganisationName>
<Ident>
                <Id>3546c8f7-3cd3-4693-929e-66501642504c </Id>
                <TypeId V="LOK" DN="Lokal identifikator uten nærmere angivelse" S="2.16.578.1.12.4.1.1.9051" />
</ Ident>
</Kontaktenhet>
    </TilknyttetEnhet>
</RollerRelatertNotat> 

For noen aktører er inngansbilletten til dialogprosesser en helsekontakt som sendes til innbygger. Denne helsekontakten angir hvem innbygger kan ha dialog med og hvor meldingene teknisk skal adresseres (kommunikasjonspart, nivå 2 her id). Helsekontakten har en intern id i avsenders system, og denne Iden kan sendes i dialogmeldingen i feltet Sakstype. Informasjonen har flere mulige formål:

• Sendt fra helsenorge.no kan den benyttes for intern ruting hos mottager (utover den tjenestebaserte adresseringen). Dette gir mulighet til å vite hvilken helsekontakt dialogen gjelder

• Sendt til helsenorge.no kan den benyttes for å vise hvilken helsekontakt meldingen kommer fra

XML eksempel for hvordan Sakstype sendes i en forespørsel fra helsenorge.no for en avbestilling er vist under.

<Sakstype>12>/Sakstype>
<Foresporsel>
<TypeForesp V="ART" DN="Avbestill reservert time" S="2.16.578.1.12.4.1.1. 7601"/>
       <Sporsmal>Gjelder avtalen den 8.6 kl 14:00 til 15:00 for praktisk bistand</Sporsmal>
</Foresporsel>

En forutsetning for dette er at helsekontakt på forhånd er sendt til helsenorge.no.