CommunicationRequest - Service melding

Metainformasjon

(Se her for forklaring av elementer og gyldige kodeverdier som kan benyttes på Helsenorge for alle typer FHIR-ressurser: Meta informasjon som kan benyttes for alle FHIR ressurser )

id: Dette er ressursens ID når ressursen er lagret på Helsenorge. Denne genereres av Helsenorge og er alltid en GUID.
meta.security - Tjenesteområde (betinget):
- Skal alltid være med for CommunicationRequest dersom dette er en hendelse som skal vises på Helsenorge (se elementet ServiceRequest.medium)
- Skal ikke være med dersom dette er en direktemelding til innbygger (se elementet ServiceRequest.medium)

Eks:

<meta>
    <!-- For en del FHIR-ressurser skal avsender angi hvilket "område" ressursen faller inn under. Dette benyttes
             på Helsenorge for å tilordnede riktig tilgansstyringsprofil til det aktuelle objektet.   -->
    <!-- Volven kodeverk 7618 -->
    <security>
        <system value="urn:oid:2.16.578.1.12.4.1.1.7618"/>
        <code value="3"/>
        <display value="Helsehjelp"/>
    </security>
</meta>

meta.security - Tilgangsbegrensning (betinget)
Denne parameteren skal være med dersom melding/ressurs inneholder informasjon om en innbygger som er fra og med 12 år og opp til og med 15 år. Elementet er altså "conditional" (og ikke obligatorisk i skjemaet). Det skal angis om det ikke er noen tilgangsbegrensning (dvs. at både foreldre og ungdommen selv har tilgang til informasjonen), eller om bare foreldre har tilgang eller bare ungdommen selv. Årsaken til at vi krever denne er satt når pasienten er 12-16 år, er at den indikerer at det er gjort et bevist valg/vurdering om hvem som skal ha tilgang til informasjonen. (Selv om konklusjonen er at både foreldre og ungdom kan få tilgang).
Kodesystem: "http://helsenorge.no/fhir/tilgangsbegrensning
Gyldige verdier:
1 - Ingen begrensning
2 - Kan kun ses av foreldre (ungdom vil ikke kunne se dette informasjonselemnentet selv).
3 - Kan kun ses av ungdommen selv (foreldre vil ikke kunne se dette informasjon selementet),
```
<meta>
   <security>
      <Tilgangsbegrensning>
        <system value="http://helsenorge.no/fhir/tilgangsbegrensning"/>
        <code value="2" />
        <display>Kun foreldre</display>
      </Tilgangsbegrensning>
   </security>
</meta)
```
meta.tag - Varsling (frivillig)
For enkelte FHIR ressurser er det mulig å undertrykke at innbygger varsles når en ekstern aktør lagrer eller endrer en ressurs på Helsenorge. Videre kan parameteren benyttes for å angi hvordan avsender organisasjonen skal framstå (navn) i SMS- og e-post varsler til innbygger.
Kodesystem: http://helsenorge.no/fhir/varsling
Verdisett (gyldige kodeverdier for ServiceRequest):
- 9 - Benytt angitt navn som avsender i varsel til innbygger (erstatter tidligere bruk av meta.security - sensitivAvsender)
Eksempler:

<meta>
   <tag>
       <extension url="http://helsenorge.no/fhir/extension/varselorganisasjon">
         <valueString value="Ullevål sykehus, OUS"/>
       </extension>
       <system value="http://helsenorge.no/fhir/varsling"/>
       <code value="9"/>
       <display value="Benytt angitt navn som avsender i varsel til innbygger"/>
   </tag>
</meta>

Ressursens profil (CommunicationRequest)

identifier (mandatory): En identifikator som identifiserer denne servicemeldingen forretningsmessig uavhengig av ressursens id på en FHIR-server. Skal være en GUID. Kan benyttes for å knytte denne servicemeldingen sammen med eventuelle etterfølgende servicemeldinger. Eks:

<identifier>
        <!-- GUID satt av den som har generert servicemeldingen. Benyttes for å referer til denne servicemeldingen unikt -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>

status (mandatory): Status på CommunicationRequest i henhold til FHIR kodeverk.

Skal alltid være “active”

 <status value="active" />

statusReason (mandatory): Årsaken til at det skal sendes en servicemelding. Benyttes som tittel i Hendelsesmenyen.

Eksempel for melding om nytt prøvesvar:

<statusReason>
        <!-- Her SKAL årsak/servicemeldingens tittel legges. -->
        <text value="Nytt prøvesvar"/>
</statusReason>

category (mandatory): Type CommunicationRequest i henhold til FHIR kodeverk.

Gyldige kodeverdier for servicemelding:

“notification”: Benyttes normalt ved nye meldinger
“reminder”: Benyttes når innbygger minnes på noe man tidligere er gjort kjent med

<!-- Servicemeldinger skal alltid ha denne kategorien -->
    <category>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
            <code value="notification"/>
        </coding>
    </category>

priority (mandatory): Vurderes fjernet, men må kanskje ersattes av noe som reflekterer varselnivåene på Helsenorge?

“routine” - En servicemelding som har normal hastegrad
“urgent” - En servicemelding som haster

Eks.

<priority value="routine" />

medium (mandatory):

Benyttes for å angi om dette er en servicemelding som skal vises i hendelsesmenyen på Helsenorge (og innbygger varsles da om ny hendelse i henhold til varseloppsett) eller om dette er en direktemelding der innholdet ønskes formidlet direkte til innbygger på SMS eller e-post. Merk at dersom dette er en direktemelding som skal ut på SMS eller e-post, så må både opsjonene med å angi et ikke sensitivt avsendernavn benyttes samt at selve innholdet i meldingen ikke kan være sensitivt. Ved direktemeldinger varsles ikke innbygger i tillegg.

Kodesystem: http://helsenorge.no/fhir/servicemedling/medium
Verdisett (gyldige kodeverdier):
- 1 - Hendelse til innbygger som er aktiv på Helsenorge
- 2 - Hendelse til aktiv innbygger, SMS- alternativt e-post til ikke aktive innbyggere (pri 1 SMS - Pri 2 e-post)
- 3 - Direktemelding til innbygger - prioritert SMS
- 4 - Direktemelding til innbygger - Prioritet e-post

Eks:

<medium>
  <coding>
      <system value="http://helsenorge.no/fhir/servicemedling/medium"/>
      <code value="1"/>
      <display value="Hendelse til innbyggere som er aktiv på Helsenorge"/> 
  </coding>
</medium>

subject (mandatory): Her identifiseres den innbygger som skal ha servicemeldingen. Det skal benyttes fødselsnummer eller d-nummer.

Eks:

<subject>
       <type value="Patient" />
        <identifier>
           <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
           <value value="13116900216" />
       </identifier>
</subject>

about (frivillig): Dersom servicemeldingen referer til en FHIR-ressurs som er “kjent” på Helsenorge, kan det legges inn en referanse til denne her. Med “kjent” menes at ressursen enten er lagret på Helsenorge eller at Helsenorge kan hente denne på vegne av innbygger fra den eksterne aktøren. Hver ressurs-type er tilknyttet et løsningsområde på Helsenorge som har ansvaret for å vise den aktuelle referansen til innbygger når det “klikkes” i hendelsesmenyen.

Eksempel for en melding som angår nytt prøvesvar:

<about>
        <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
        <!-- Eksempel fra Pasientens Prøvesvar -->
        <reference value="DiagnosticReport/1234567890"/>  
</about>

payload (mandatory, maks 250 tegn): Dette er den tekststreng som skal vises for innbygger under hendelsesmenyen.

Merk! Dersom dette er en direktemelding, eller det ønskes “videreformidling” av hendelser for ikke aktive innbyggere, kan denne teksten ikke inneholde sensitiv informasjon. (se ServiceRequest.medium over)

<payload>
       <contentString value="Du har fått tilgjengeliggjort et nytt prøvesvar. Din behandler kontakter deg, dersom det er behov for å gjennomgå prøvesvaret."/>
</payload>

requester (mandatory): Den som har generert servicemeldingen. Skal inneholde organisasjonsnummer og navn. Dette er slik avsender framstår i hendelsesmenyen på Helsenorge.

<requester>
        <type value="Organization"/>
        <identifier>
           <!-- Avsenders organisasjonsnummer -->
           <system value="urn:oid:2.16.578.1.12.4.1.2.101" />
            <value value="948554062" />
        </identifier>
        <display value="Pasientens prøvesvar"></display>
</requester>

Eksempel på CommunicationRequest

<?xml version="1.0" encoding="UTF-8"?>
<CommunicationRequest 
    xmlns="http://hl7.org/fhir"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd">
    <meta>
        <security>
            <!-- For en del FHIR-ressurser skal avsender angi hvilket "område" ressursen faller inn under. Dette benyttes
                 på Helsenorge for å tilordnede riktig tilgansstyringsprofil til det aktuelle objektet.   -->
            <!-- Volven kodeverk 7618 benyttes -->
            <system value="urn:oid:2.16.578.1.12.4.1.1.7618"/>
            <code value="3"/>
            <display value="Helsehjelp"/>
        </security>
        <security>
            <!-- Dersom pasienten er mellom 12 - 16 år SKAL dette elementet settes. Selv om det ikke er begrensninger om foreldre/barnet selv
                 skal få servivemeldingen -->
            <system value="http://helsenorge.no/fhir/tilgangsbegrensning"/>
            <code value="3"/>
            <display value="Kan kun ses av ungdommen selv"/>
        </security>
        <tag>
            <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon">
                <valueString value="Ullevål sykehus, OUS"/>
            </extension>
            <system value="http://helsenorge.no/fhir/varsling"/>
            <code value="9"/>
            <display value="Benytt angitt navn som avsender i varsel til innbygger"/>
        </tag>
    </meta>
    <identifier>
        <!-- GUID satt av den som har generert servicemeldingen. Benyttes for å referer til denne servicemedlingen unikt -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
    <status value="active" />
    <statusReason>
        <!-- Her SKAL årsak/servicemeldingens tittel legges. -->
        <text value="Her skal servicemedlingens tittel legges"/>
    </statusReason>
    <!-- Servicemeldinger kan være varsling (notfication) eller påminnelse (reminder) -->
    <category>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
            <code value="notification"/>
        </coding>
    </category>
    <!-- Prioritet for varselet, mapper til "Viktig" og "Obligatorisk" i varseloppsettet hos innbygger. Lovlige verdier "routine" og "urgent"   --> 
    <priority value="routine" />
    <medium>
        <coding>
            <system value="http://helsenorge.no/fhir/servicemedling/medium"/>
            <code value="1"/>
            <display value="Hendelse til innbyggere som er aktiv på Helsenorge"/> 
        </coding>
    </medium>
    <subject>
       <type value="Patient" />
        <identifier>
           <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
           <value value="13116900216" />
       </identifier>
   </subject>
    <about>
        <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
        <!-- Eksempel fra Pasientens Prøvesvar -->
        <reference value="Observation/1234567890"/>  
    </about>
   <payload>
       <contentString value="Dette er teksten i servicemeldingen slik den skal vises for innbygger"/>
   </payload> 
    <requester>
        <type value="Organization"/>
        <identifier>
           <!-- Avsenders organisasjonsnummer -->
           <system value="urn:oid:2.16.578.1.12.4.1.2.101" />
            <value value="948554062" />
        </identifier>
        <display value="Studentsamskipnaden i Oslo og Akershus"></display>
     </requester>
 </CommunicationRequest>

Add label