MeldingInnbygger

Melding til innbygger er et skjema som benyttes i forbindelse med dialogprosessen DIALOG_INNBYGGER_MELDINGSFORMIDLING. Se AMQP Meldingsformidling til innbygger

Skjemaet beskriver hvordan meldingen som sendes til innbygger skal framstå for innbygger i dennes “inboks” på Helsenorge. Dette skjemaet skal alltid være med i DIALOG_INNBYGGER_MELDINGSFORMIDLING. I tillegg kan skjemaet for Videreformidling være med dersom man ønsker levering også til offentlig digital postkasse eller fysisk brev, for innbyggere som ikke er digitalt aktiv på Helsenorge.

Oversikt over parametere i Skjemaet

Skjemaet anvendes alltid i kommunikasjonsprosessen DIALOG_INNBYGGER_MELDINGSFORMIDLING:

  • Innholdstype (obligatorisk): Kodeverdi. Angir “brevets” kategori/innhold. Benyttes på Helsneorge både for å sjekke om innbygger er tilstrekkelig digital aktiv for å motta brevet, og for å inngå i varsel-tekst til innbygger når brevet mottas. Volven kodeverk 7613 benyttes for å kode innholdstype. Hvis ikke angitt settes foreløpig default: “Helsehjelp”, dette skal avvikles og meldinger uten innholdstype vil bli avvist.

    • Merk! Av kodene i Volven 7613, er det foreløpig kun IB =“Innkallingsbrev” som påvirker tekst i varsel til innbygger. Da vil det inngå i varselteksten at det er mottatt et innkallingsbrev.

  • Emne (obligatorisk): Tekst.Tittel på meldingen i innbyggers innboks

  • Meldingsavsender (frivillig): Tekst. Klar tekst angivelse av hvilket helseforetak som har sendt brevet (framkommer som avsender i innbyggers inboks). Dersom ikke satt, hentes verdien fra nivå 2 adresse i avsender i Hodemeldingen.

  • Meldingstekst (obligatorisk): Tekst. Tekst som beskriver hoved essensen av brevets innhold (vises for innbygger som meldingens tekst i innboks)

  • SvarTillatt (obligatorisk). Boolean. Hvis “true”, betyr dette at avsender tilbyr digital dialog med innbygger basert på denne Meldingstypen.

  • UtsattVisningstidspunk (frivillig): DateTime. Dersom avsender ikke ønsker at innbygger skal se mottat melding før et bestemt tidspunkt fram i tid, kan denne benyttes.

  • DelInnholdMedHelsepersonell (frivillig): Kodeverk. Avsender kan anmode innbygger om å dele brevet med Helsepersonell. Pr. nå støttes kun deling med Fastlege på Helsenorge. Volven koldeverk 9246 benyttes for å angi hvilke type Helsepersonell man anmoder å dele med.

  • SensitivAvsender (frivillig): Boolean. Hvis true, inkluderes ikke avsenders navn i varsler til innbygger om at brevet er mottatt. Hvis ikke angitt, default: “true”

  • Lenkereferanse (frivillig): Struktur med referanse til forhåndsdfefrinert dyplenke på Helsenorge + parameter. Slike lenker vises eksplisitt under medlingsteksten i innbyggers innboks.

    • PartKode (obligatorisk): Tekst. Dyplenker som er forhåndsregistrert på Helsenorge kan være globale (kan benyttes av alle aktører) eller være forbeholdt en aktør/avsender. Alle aktører/avsendere som ønsker å inkludere dyplenkert tilordnes en bilateralt avtalt (og unik) PartKode

    • LenkeKortnavn (obligatorisk): Tekst. En bilateralt avtale referanse til en bestemt dyplenke registrert på Helsenorge. Vanligvis et beskrivense kortnavn.

    • OpsjonelParameter (frivillig). Tekst. En parameter som legges til dyplenken når innbygger velger å benytte denne i inboksen. (Kan f.eks. være skjemaID dersom man ønsker at innbygger skal fylle ut et bestemt skjema, eller en “time-id” dersom man ønsker at innbygger skal bekrefte en bestemt time). Merk:

      • Spørsmålstegn “?” legges automtisk til etter URL som er definert i dyplenke

      • Man kan i denne pareameteren “kode” flere parametere om ønskelig. Eks: “parameter1=verdi1&parameter2=verdi2”

Skjemaet 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.

Felt

Feltlengde

Kommentar

Emne

50

Emne begrenses til 50 tegn i brukergrensesnitt

Meldingsavsender

255

Makslengde på felt er 255 tegn, innhold utover dette vil ikke vises på Helsenorge.

  

Meldingstekst

4.000

Makslengde på felt er 4.000 tegn, innhold utover dette vil ikke vises på Helsenorge.

 

XML-eksempel MeldingInnbygger-v1.0:

<MeldingInnbygger xmlns="http://ehelse.no/xmlstds/MeldingInnbygger/2018-09-25"> <Innholdstype V="IB" S="2.16.578.1.12.4.1.1.7613" DN="Innkallingsbrev"/> <Emne>Innkallingsbrev fra STHF</Emne> <Meldingsavsender>Sykehuset Telemark - Radiologiavdelingen</Meldingsavsender> <Meldingstekst>Innkalling til innbygger hos foretak ABC</Meldingstekst> <SvarTillatt>false</SvarTillatt> <UtsattVisningstidspunkt>2022-10-28T09:30:00Z</UtsattVisningstidspunkt> <DelInnholdMedHelsepersonell V="6" S="2.16.578.1.12.4.1.1.9246" DN="Fastlege"/> <SensitivAvsender>false</SensitivAvsender> <LenkeReferanse> <PartKode>Global</PartKode> <LenkeKortnavn>UtfyllingAvHelsenorgeSkjema</LenkeKortnavn> <OpsjonellParameter>blankett-nummer=3DHV-IIFJ-1</OpsjonellParameter> </LenkeReferanse> </MeldingInnbygger>

Visuell representasjon av skjemaet

MeldingInnbygger-v1.jpg

 

Skjemadefinisjon (xsd)