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 )

...

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

...

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

...

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

Code Block
<meta>
   <tag>
       <extension url="http://helsenorge.no/fhir/extension/varselorganisasjon">
         <valueString value="Ullevål sykehus, OUS"/>meta>

Ressursens profil (CommunicationRequest)

 

 

 

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"

...

Ressursens profil (CommunicationRequest)

<status

Her identifiseres den innbygger som skal ha servicemeldingen. Det skal benyttes fødselsnummer eller d-nummer.

Eks:

 

 

 

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

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

Eksempel for melding om nytt prøvesvar:

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

Code Block
<!-- Servicemeldinger skal alltid ha denne kategorien -->
    <category>
        <coding>
            <system value="urn:ietf:rfc:3986http://terminology.hl7.org/CodeSystem/communication-category "/>
            <value<code value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459dnotification"/>
        </identifier>
status
coding>
    </category>

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

Skal alltid være “active”

Code Block
Code Block
<subject>
       <type value="activePatient" />

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

Eksempel for melding om nytt prøvesvar:

Code Block
<statusReason>
        <identifier>
    <!-- Her SKAL årsak/servicemeldingens tittel legges. -->         <text<system 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 -->
    <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" />
       </identifier>
</subject>

about (betinget): 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 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>
   </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.

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

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

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 (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 varsel knyttet til en eksisterende timneavtale

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.

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)

Code Block
<payload><system value="http://nhn.no/helsenorge/ressursidentifier"/>
       <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>

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

Code Block
<requester>
        <type value="Organization"/>
        <identifier>
           <!-- Avsenders organisasjonsnummer -->
  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 <system value="urn:oid:2.16.578.1.12.4.1.2.101" />aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
</about>
  • Dokumentbaserte prøvesvar (via nasjonal XDS-løsning)

Code Block
<about>
    <!-- Dersom relevant: <value value="948554062" />
        </identifier>
 Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge -->
    <!-- Eksempel <display value="Pasientensfra dokumentbaserte prøvesvar"></display>
</requester>

 Eksempel på CommunicationRequest

...

 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.

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

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

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<CommunicationRequest 
    xmlns="http://hl7.org/fhir"
     <system valuexmlns:xsi="http://helsenorgewww.w3.noorg/fhir2001/tilgangsbegrensningXMLSchema-instance"/> 
           <code value="3"/>
  xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd">
    <meta>
        <security>
<display value="Kan kun ses av ungdommen selv"/>      <!-- For en </security>
        <tag>
  del FHIR-ressurser skal avsender angi hvilket "område" ressursen faller inn under. Dette benyttes
         <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon">        Helsenorge for å tilordnede riktig tilgansstyringsprofil til det aktuelle <valueString value="Ullevål sykehus, OUS"/objektet.   -->
            </extension>!-- Volven kodeverk 7618 benyttes -->
            <system value="http://helsenorge.no/fhir/varslingurn:oid:2.16.578.1.12.4.1.1.7618"/>
            <code value="93"/>
            <display value="Helsehjelp"Benytt/>
 angitt navn som avsender i varsel til innbygger"</>security>
        </tag><tag>
    </meta>     <identifier>   <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon">
     <!-- GUID satt av den som har generert servicemeldingen. Benyttes for å referer til denne servicemedlingen unikt --><valueString value="Ullevål sykehus, OUS"/>
           <system value="urn:ietf:rfc:3986"/> </extension>
            <value<system value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459dhttp://helsenorge.no/fhir/varsling"/>
       </identifier>     <status<code value="active9" />
          <statusReason>  <display value="Benytt angitt navn som avsender i <!-- Her SKAL årsak/servicemeldingens tittel legges. -->varsel til innbygger"/>
        </tag>
   <text value="Her skal servicemedlingens tittel legges"/>
 </meta>
    <identifier>
   </statusReason>     <!-- ServicemeldingerGUID kansatt væreav varslingden (notfication)som ellerhar påminnelse (reminder) -->
    <category>
  generert servicemeldingen. Benyttes for å referer til denne servicemedlingen unikt -->
     <coding>   <system value="urn:ietf:rfc:3986"/>
        <system<value value="http://terminology.hl7.org/CodeSystem/communication-category "/>
 urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
    </identifier>
    <status <code value="notificationactive" />
    <statusReason>
   </coding>     </category>
    <!-- Prioritet for varselet, mapper til "Viktig" og "Obligatorisk" i varseloppsettet hos innbygger. Lovlige verdier "routine" og "urgent"   --> 
    <priority value="routine" /!-- Her SKAL årsak/servicemeldingens tittel legges. -->
        <text value="Her skal servicemedlingens tittel legges"/>
    </statusReason>
    <!-- Servicemeldinger skal alltid ha denne kategorien -->
    <medium><category>
        <coding>
            <system value="http://helsenorgeterminology.hl7.noorg/fhir/servicemedling/medium"/>
            <code value="1"CodeSystem/communication-category "/>
            <display<code value="Hendelse til innbyggere som er aktiv på Helsenorgenotification"/> 
        </coding>
    </medium>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>
        <!-- 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>
   <payload>
       <!-- Max 250 tegn -->
       <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>

...