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 Hendelsesvarselet i SMS/e-post varsel til innbygger om ny hendelse.

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

    Verdisett (gyldige kodeverdi for ServiceRequest):

    • 9 - Benytt angitt navn som avsender i varsel til innbygger

    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)

 

 

 

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

Code Block
<identifier>
        <!-- GUID satt av den som har generert servicemeldingenHendelsesvarselet. Benyttes for å referer til dennedette servicemeldingenHendelsesvarselet 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” og er påkrevd.

Code Block
 <status value="active" />

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

Gyldige kodeverdier for servicemeldingHendelsesvarselet:

  • “notification”: Benyttes normalt ved nye meldinger

  • “reminder”: Benyttes når innbygger minnes på noe man tidligere er gjort kjent med

Code Block
<!-- ServicemeldingerHendelsesvarsel skal angi angikategorikategori -->
    <category>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
            <code value="notification"/>
        </coding>
    </category>

subject (mandatory): Dette identifiser innbygger som skal ha servicemeldingen Hendelsesvarselet og det skal benyttes fødselsnummer eller d-nummer.

Eksempel på bruk under:

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 DersomHendelsesvarsel referer til en ressurs som er tilgjengelig på Helsenorge, kan det legges inn en referanse til denne her. Med tilgjengelig menes at ressursen enten er lagret på Helsenorge eller at Helsenorge kan hente denne på vegne av innbygger fra den eksterne aktøren. Helsenorge kan da vise detaljene til innbygger. For ressurser som hentes eksternt, må avsender av hendelse verifisere at innbygger som mottar hendelse også har tilgang til ressursen. Eksempelvis skal det ikke sendes varsel om prøvesvar som ikke er tilgjengelig for innbygger.

Eksempel for varsel hendelsevarsel 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å servicemedlingHendelsesvarsel 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 hendelsevarsel 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>
    <!-- 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>
    <!-- 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>
    <!-- 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>

Eksempel på melding hendelsevarsel som inneholder påminnelse fra et Verktøy

Code Block
<about>
    <!-- Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel på referenase til et Verktøy som ligger i Verktøykatalogen på Helsenorge -->
    <type value="Device" />
    <identifier>
       <system value="http://nhn.no/helsenorge/verktoyid" />
       <value value="6aaa34b9-103a-4d6c-a850-6cbfebb16348"/>
    </identifier>
</about>

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

Foreløpig er følgende Hendelsestyper definert:

  • 1001: Nytt prøvesvar - Innbygger varsles på Helsenorge i henhold til innbyggers varslingsprofil

  • 1002: Påminnelse fra verktøy - Innbygger varsles ikke fra Helseorge om hendelsen (men ser den ved første innlogging)

Code Block
<payload>
   <contentReference>
       <identifier>
           <system value="http://helsenorge.no/fhir/hendelsestype"/>
            <value value="1001"/>
         </identifier>
        <display value="Nytt prøvesvar"/>
    </contentReference>
</payload> 

requester (mandatory): Den som har generert servicemeldingenHendelsesvarselet. 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>

 Eksempel på CommunicationRequest

Varsel om nytt Prøvesvar i Pasientens Prøvesvar

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>
            <!-- Man 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>
        <!-- Må benyttes dersom avsenders navn skal være med i varsler fra Helsenorge til innbygger på e-post/SMS -->
        <tag>
            <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon">
                <valueString value="Pasientens Prøvesvar"/>
            </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 servicemeldingenHendelsesvarselet. Benyttes for å referer til dennedette servicemedlingenHendelsesvarselet unikt -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
    <status value="active" />
    <!-- ServicemeldingerHendelsesvarsel skal alltid haangi denne kategorienkategori -->
    <category>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
            <code value="notification"/>
        </coding>
    </category>
    <subject>
       <type value="Patient" />
        <identifier>
           <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
           <value value="13116900216" />
       </identifier>
   </subject>
   <about>
        <!-- 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>
   <payload>
       <contentReference>
           <identifier>
               <system value="http://helsenorge.no/fhir/hendelsestype"/>
               <value value="10001"/>
            </identifier>
           <display value="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="994598759" />
        </identifier>
        <display value="Norsk Helsenett SF"></display>
    </requester>
 </CommunicationRequest>

Påminnelse fra Verktøy

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>
            <!-- Man 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>
        <!-- Må benyttes dersom avsenders navn skal være med i varsler fra Helsenorge til innbygger på e-post/SMS -->
        <!-- Inntil videre tillates ikke at Helsenorge selv varsler innbygger via e-post/SMS for Verktøypåminnelser -->
        <tag>
            <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon">
                <valueString value="SMART-mosjon"/>
            </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 servicemeldingenHendelsesvarselet. Benyttes for å referer til dennedette servicemedlingenHendelsesvarselet unikt -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:3b52ec71-3681-4d01-849f-21278bf2a21d"/>
    </identifier>
    <status value="active" />
    <!-- Servicemeldinger skal alltid haangi denne kategorienkategori -->
    <category>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
            <code value="reminder"/>
        </coding>
    </category>
    <subject>
       <type value="Patient" />
        <identifier>
           <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
           <value value="13116900216" />
       </identifier>
   </subject>
   <about>
      <!-- Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
      <!-- Eksempel for Verktøyet SMART-mosjon -->
      <type value="Device" />
      <identifier>
           <system value="http://nhn.no/helsenorge/verktoyid" />
               <value value="4b28d363-14ab-4972-a0ae-72f94a45854e"/>
       </identifier>
   </about>
   <payload>
       <contentReference>
           <identifier>
               <system value="http://helsenorge.no/fhir/hendelsestype"/>
               <value value="10002"/>
            </identifier>
           <display value="Påminnelse fra verktøy"/>
       </contentReference>
   </payload> 
   <requester>
        <type value="Organization"/>
        <identifier>
           <!-- Avsenders organisasjonsnummer -->
           <system value="urn:oid:2.16.578.1.12.4.1.2.101" />
            <value value="983544622" />
        </identifier>
        <display value="Helsedirektoratet"></display>
    </requester>
 </CommunicationRequest>

...