Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 )

...

  • meta.tag - Varsling (frivillig)

    Parameteren bør benyttes for å angi hvordan avsender organisasjonen skal framstå (navn) i SMS- og e-post varsler til innbygger. Dersom ikke angitt, inkluderes ikke navnet til avsender av servicemeldingen i SMS/e-post varsel til innbygger om ny hendlese.

    Kodesystem: http://helsenorge.no/fhir/varsling

    Verdisett (gyldige kodeverdi for ServiceRequest):

    • 9 - Benytt angitt navn som avsender i varsel til innbygger (erstatter tidligere bruk av meta.security - sensitivAvsender)

    Eksempler:

Code Block
<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)

Image Removed<statusReason> <!-- Her SKAL årsak/servicemeldingens tittel legges. -->

 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

 

 

 

Image Added

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: 

Code Block
<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”

Code Block
 <status value="active" />

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

Eksempel for melding om nytt prøvesvar:

Code Block
Code Block
<!-- Servicemeldinger skal alltid ha denne kategorien -->
    <category>
        <coding>
<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

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

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

Eks:

Code Block
<subject>
       <type value="Patient" />
    <category>       <identifier>
 <coding>             <system value="http://terminology.hl7.org/CodeSystem/communication-category "urn:oid:2.16.578.1.12.4.1.4.1" />
            <code<value value="notification13116900216" />

       </coding>
identifier>
   </category>subject>

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

Eks:

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

about (betinget): Dersom servicemeldingen referer til en FHIR-ressurs som er “kjent” på HelsenorgeDersom 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 varsel knyttet til en eksisterende timeavtale

Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel på servicemedling knyttet til timeavtale som allerede er kjent på Helsenorge -->
    <type value="Appointment" />
    <identifier>
       <system value="http://nhn.no/helsenorge/ressursidentifier"/>
       <value value="aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
</about>

Eksempler for en melding som angår nytt prøvesvar.

Pr. i dag har vi 3 forskjellige kilder for prøvesvar:

  • Pasientens Prøvesvar (sentral tjeneste under utprøving)

Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel fra Pasientens Prøvesvar -->
    <type value="Observation" />
    <identifier>
       <system value="http://nhn.no/pps/ressursid"/>
       <value value="aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
</about>
  • Dokumentbaserte prøvesvar (via nasjonal XDS-løsning)

Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel fra dokumentbaserte prøvesvar fra speialisthelsetjenesten -->
    <type value="Observation" />
    <identifier>
       <system value="http://nhn.no/xds/dokumentlokaliseringsinformasjon"/>
       <value value="[Home Community Id]:[Repository Unique Id]:[Document Unique Id]"/>
    </identifier>
</about>
  • FHI sine korona prøvesvar

Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel fra FHI korona prøvesvar -->
    <type value="Observation" />
    <identifier>
       <system value="http://fhi.no/provesvar/provesvarid"/>
       <value value="83099085-ebce-4352-9df3-c8e16d85b47c"/>
    </identifier>
</about>

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

<payload>
Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel fra Pasientens Prøvesvar -->
    <type value="Observation" />
    <identifier>
       <system value="http://nhn.no/pps/ressursid"/>
       <value value="aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
</about>
  • Dokumentbaserte prøvesvar (via nasjonal XDS-løsning)

Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel fra dokumentbaserte prøvesvar fra speialisthelsetjenesten -->
    <type value="Observation" />
    <identifier>
       <system value="http://nhn.no/xds/dokumentlokaliseringsinformasjon"/>
       <value value="[Home Community Id]:[Repository Unique Id]:[Document Unique Id]"/>
    </identifier>
</about>
  • FHI sine korona prøvesvar

Code Block
<about>
    <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel fra FHI korona prøvesvar -->
    <type value="Observation" />
    <identifier>
       <system value="http://fhi.no/provesvar/provesvarid"/>
       <value value="83099085-ebce-4352-9df3-c8e16d85b47c"/>
    </identifier>
</about>

payload: Referanse til en Hendelsestype på Helsenorge. Disse er forhåndsfeinert, og nye legges til ved behov. Teksten som vises for innbygger i Hendelsesmenyen vil være funksjon av Hendelsestype og “category”, se over.

Foreløpig er følgende Hendelsestyper definert:

  • 1001: Nytt prøvesvar

  • 1002: Påminnelse fra verktøy

Code Block
<payload>
   <contentReference>
       <identifier>
           <system value="http://helsenorge.no/fhir/hendelsestype"/>
            <contentString<value value="Du har fått tilgjengeliggjort et nytt prøvesvar. Din behandler kontakter deg, dersom det er behov for å gjennomgå prøvesvaret."/>
</payload>"1001"/>
         </identifier>
        <display value="Nytt prøvesvar"/>
    </contentReference>
</payload> 

requester (mandatory): Den som har generert servicemeldingen. Skal inneholde organisasjonsnummer og navn. “Display-verdien” er slik avsender framstår for innbygger i hendelsesmenyen på Helsenorge.

Code Block
<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>

...

Code Block
<?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 avsenderMan skal 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>
        <tag>
            <extension url="http://helsenorge.no/fhir/extension/varselorganisasjonvarselorgansasjon">
                <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" />"active" />
    <!-- Servicemeldinger skal alltid ha denne kategorien -->
    <category>
        <statusReason><coding>
        <!-- Her SKAL årsak/servicemeldingens tittel legges. --><system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
         <text   <code value="notification"Her/>
skal servicemedlingens tittel legges"/>     </statusReason>coding>
    <!--/category>
Servicemeldinger skal alltid ha kategori:<subject>
notification eller reminder -->    <type <category>
value="Patient" />
       <coding> <identifier>
           <system value="http://terminology.hl7.org/CodeSystem/communication-category "urn:oid:2.16.578.1.12.4.1.4.1" />
            <code<value value="notification13116900216" />
       </identifier>
   </coding>subject>
   <about>
        </category>!-- Dersom relevant: Her legges <subject>inn referanse til FHIR-ressurs som finnes, eller kan hentes, <type value="Patient" />på Helsenorge -->
        <!-- Eksempel <identifier>fra Pasientens Prøvesvar -->
        <system<type value="urn:oid:2.16.578.1.12.4.1.4.1Observation" />
        <identifier>
   <value value="13116900216" />        </identifier>
<system value="http://nhn.no/pps/ressursid"/>
  </subject>    <about>         <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
        <!-- Eksempel fra Pasientens Prøvesvar --><value value="aa54d29e-4009-49cb-9ec4-847a6469459d"/>
        </identifier>
   </about>
   <payload>
       <contentReference>
   <type value="Observation" />      <identifier>
  <identifier>             <system value="http://nhnhelsenorge.no/pps/ressursid"/>
            <value value="aa54d29e-4009-49cb-9ec4-847a6469459dfhir/hendelsestype"/>
            </identifier>   <value </about>value="10001"/>
    <payload>        <!--/identifier>
Max 250 tegn -->        <contentString<display value="Dette er teksten i servicemeldingen slik den skal vises for innbygger"/>Nytt prøvesvar"/>
       </contentReference>
   </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 AkershusUniversitetssykehus"></display>
    </requester>
 </CommunicationRequest>

...