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 )

  • 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 (obligatorisk):

    • Skal alltid være med for CommunicationRequest

    .
    • (se HER for ytterligere forklaring og gyldige kodeverdier)

Eks:

Code Block
<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 tag - Tilgangsbegrensning Varsling (betingetfrivillig)

    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),

    code

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

...

meta.tag - VarselOrganisasjon (frivillig)

Verdien i denne mata.tag’en inneholder navnet på avsenders organisasjon slik det vil framgå i varsel fra Helsenorge til innbygger om mottatte ressurser. Formålet med “VarslingOrganisasjon) er at navnet kan angis på et tilstrekkelig høyt nivå som ikke anses som sensitivt. Hvis ikek angis utelates avsenders navn fra varslet fra Helsenorge til innbygger.

Meta.tag er av type “coding”, derfor er det laget en Helsenorge extension for å angi den tekstlige verdien på avsenders organisasjon.

Eks:

Code Block
<meta>
   <tag>
      <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon"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)

 

 

 

MOD_fhir-single_CommunicationRequest.bmpImage Added

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

Code Block
<identifier>
        <!-- GUID satt av den som har generert Hendelsesvarselet. Benyttes for å referer til dette Hendelsesvarselet unikt -->
        

...

<system value="

...

urn:ietf:rfc:3986"/>
       

...

 

...

Ressursens profil (CommunicationRequest)

 

 

Image Removed

 

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 servicemedlingen sammen med eventuelle etterfølgende servicemedlinger. Eks: 

Code Block<identifier> <!-- GUID satt av den som har generert servicemeldingen. Benyttes for å referer til denne servicemedlingen unikt -->
<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 Hendelsesvarselet:

  • “notification”: Benyttes normalt ved nye meldinger

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

Code Block
<!-- Hendelsesvarsel skal angi kategori -->
    <category>
        <coding>
            <system value="
urn:ietf:rfc:3986
http://terminology.hl7.org/CodeSystem/communication-category "/>
            
<value
<code value="
urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d
notification"/>
        </coding>
    </
identifier>
category>
status

subject (mandatory):

Status på CommunicationRequest i henhold til FHIR kodeverk.Skal alltid være “active”

Dette identifiser innbygger som skal ha Hendelsesvarselet og det skal benyttes fødselsnummer eller d-nummer.

Eksempel på bruk under:

Code Block
<status
<subject>
       <type value="
active
Patient" />

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

Code Block<statusReason>

        
<!--
<identifier>
Her
 
SKAL
 
årsak/servicemeldingens
 
tittel
 
legges.
 
-->
      
<text
<system value="
Her skal servicemedlingens tittel legges"/> </statusReason>

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

For servicemeldinger skal denne alltid være “notification”

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

about (

mandatory

betinget):

  • “routine” - En servicemelding som har normal hastegrad

  • “urgent” - En servicemelding som haster

Eks.

Code Block
<priority value="routine" />

subject (mandatory): Her identifiseres den innbygger som skal ha servicemedlingen. Det skal benyttes Fødselsnummer.

Eks:

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

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 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å Hendelsesvarsel knyttet til timeavtale som allerede er kjent på Helsenorge -->
    <type value="Appointment" />
    <identifier>
       
<value
<system value="
13116900216"
http://nhn.no/helsenorge/ressursidentifier"/>
       <value value="aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </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 ekstrene aktøren.

Eksempel fra pasientene Prøvesvar:

Code Block<about> <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge --> <!-- Eksempel fra Pasientens Prøvesvar -->
about>

Eksempler for en 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å 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: Endrede pørvesvar - Innbygger varsles på Helsenorge i henhold til innbyggers varslingsprofil

  • 1010: 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 Hendelsesvarselet. Skal inneholde organisasjonsnummer og navn. Denne informasjonen vises ikke til innygger i Hendelsemenyen.

Eks:

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

Sender (mandatory): Den tjeneste som varselet er relatert til. Denne vises som avsender av Hendelsesvarselet for innbygger i Hendelsesmenyen.

Eks:

Code Block
<sender>
        <type value="HealthcareService"/>
        <display value="Pasientens Prøvesvar"/>
</sender>

 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 Hendelsesvarselet. Benyttes for å referer til dette Hendelsesvarselet unikt -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
    <status value="active" />
    <!-- Hendelsesvarsel skal alltid angi kategori -->
    <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="

...

1001"/>
  

...

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

...

          </identifier>
           

...

<display value=

...

requester (mandatory): Den som har generert servicemedlingen. Skal inneholde organisasjonsnummer og navn. 

...

"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>
   

...

 <sender>
        <type value="HealthcareService"/>
        <display value="

...

Pasientens Prøvesvar"/>
    </sender>
 </

...

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>
            <!-- For en del FHIR-ressurser Man 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="31"/>
            <display value="HelsehjelpRettigheter og selvhjelp"/>
        </security>
        <security>
   
        <!-- Dersom pasienten er mellom 12 - 16 år SKAL dette elementet settes. Selv om det ikke er begrensninger om foreldre/barnet selv
            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 -->
     skal  servivemeldingen --><tag>
            <system<extension valueurl="http://helsenorge.no/fhir/extension/tilgangsbegrensningvarselorgansasjon"/>
    
       <code value="3"/>        <valueString     <display value="Kan kun ses av ungdommen selv"/>
  SMART-mosjon"/>
     </security>       </extension>
 <tag>           <system  <extension urlvalue="http://helsenorge.no/fhir/extensionvarsling"/varselorgansasjon">
            <code value="9"/>
     <valueString value="Ullevål sykehus, OUS"/>    <display value="Benytt angitt navn som avsender i varsel til <innbygger"/extension>>
        </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:aa54d29e3b52ec71-40093681-49cb4d01-9ec4849f-847a6469459d21278bf2a21d"/>
    </identifier>
    <status value="active" />
    <!-- Hendelsesvarsel skal alltid angi kategori -->
    <category>
  <statusReason>      <coding>
             <!-- Her SKAL årsak/servicemeldingens tittel legges. --><system value="http://terminology.hl7.org/CodeSystem/communication-category "/>
             <text<code value="reminder"Her/>
skal servicemedlingens tittel legges"/>     </statusReason>coding>
    <!-- Servicemeldinger skal alltid ha denne kategorien -->/category>
    <subject>
       <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" />
        </coding>identifier>
    </category>subject>
   <about>
 <!-- Prioritet for varselet, mapper til "Viktig" og "Obligatorisk" i varseloppsettet hos innbygger. Lovlige verdier "routine" og "urgent"   <!-- Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
     <priority value="routine" />
    <subject> <!-- Eksempel for Verktøyet SMART-mosjon -->
       <type value="PatientDevice" />

       <identifier>
           <system value="urn:oid:2.16.578.1.12.4.1.4.1="http://nhn.no/helsenorge/verktoyid" />
           <value value="13116900216" 9d493acb-a404-48de-83d4-5f2d0806f74b"/>
       </identifier>
   </subject>about>
   <payload>
    <about>   <contentReference>
     <!-- Dersom relevant: Her legges inn referanse<identifier>
til FHIR-ressurs som finnes, eller kan hentes,  Helsenorge -->      <system value="http://helsenorge.no/fhir/hendelsestype"/>
 <!-- Eksempel fra Pasientens Prøvesvar -->         <reference<value value="Observation/12345678901010"/>
            </about>identifier>
   <payload>        <contentString<display value="DettePåmionnelse er teksten i servicemeldingen slik den skal vises for innbygger"/>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="948554062983544622" />
        </identifier>
        <display value="Studentsamskipnaden i Oslo og Akershus"></display>
"Helsedirektoratet"></display>
    </requester>
    <sender>
        <type value="HealthcareService"/>
        <display value="SMART-mosjon"/>
    </requester>sender>
 </CommunicationRequest>

Add label