Felles for alle FHIR ressurser (Resource)

Til venstre vises den formelle strukturen for Resource som alle FHIR-ressurser arver. 

På Helsenorge benytter vi 5 av mekanismene som ligger i denne strukturen:

• id: Dette er ressursens ID. Dersom denne er angitt på en ressurs, kan ressursen aksesseres direkte på Helsenorge gjennom å inkludere id’en i URL'en på de REST-API’er som tilbys. Skal være en UUID dersom satt. Hvis ikke satt, generer Helsenorge en UUID. (Se eventuell ytterligere beskrivelse/detaljering for de enkelte FHIR ressurser).

• meta.security:

  • Kan benyttes for å angi hvilket "tjenesteområde" FHIR ressursen tilhører (se under)

  • Kan benyttes for å angi at avsenders identitet/navn er sensitivt og ikke skal benyttes/vises ved varsling av innbygger i usikre kanaler (se under)

  • Kan benyttes dersom det skal være spesiell tilgangsstyring for den aktuelle ressursen som avviker fra standard regler på Helsenorge (se under)

• meta.tag: Kan benyttes for å angi informasjon for å styre hvordan ressursen håndtyeres på Helsenorge. Hvilke opsjoner som er tilgjengelige for hvilke FHIR-ressurser vil framgå av detaljdokumentasjonen for den enkelte ressurs.

• Contained: Benyttes for å inkludere andre type FHIR ressurser som kun er referert i den aktuelle FHIR ressurs. Hvor dette benyttes, er beskrevet i profilen til den enkelte FHIR ressurs.

• Extension: Benyttes der det er behov for å gjøre utvidelser i en Ressurs i forhold til det som er definert i basis versjonen. (Hvis benyttet, er dette dokumentert under profilen for den aktuelle FHIR ressurs.)

meta.security - Tjenesteområde:

Det er innført et felles system for å kategorisere informasjonsobjekter/ressurser på Helsenorge. Formålet med dette er man på Helsenorge skal kunne avgjøre:

• Om innbygger er tilstrekkelig digital aktiv til at Helsenorge kan motta det aktuelle informasjonsobjekt på vegne av innbygger.

• Hvilke representasjonsformer som default tillates for å gi tilgang til informasjonsobjektet på Helsenorge.

For noen FHIR ressurser er det underforstått hvilken kategori/område ressursen tilhører. For andre mere generiske FHIR-ressurser (eksempel FHIR Task) er det behov for å angi dette. Det vil framgå av profilen for den enkelte FHIR-ressurs om dette er obligatorisk eller ikke.

Følgende 5 Tjenesteområder som en FHIR-ressurs kan tilhøre er definert:

• Helseregister – brukes for informasjon og tjenester knyttet til innbyggers innsyn og rettigheter i ulike registre 
  eks: besvare innsynsforespørsler

• Pasientjournal – brukes for informasjon og tjenester knyttet til innbyggers personvernrettigheter i pasientjournal
  eks: besvare innsynsforespørsler

• Helsehjelp – brukes for informasjon og tjenester knyttet til innbyggers direkte behandling, helsehjelp og forebygging og hvordan videre behandlingsløp, oppfølging og informasjon skal håndteres eks: sende oppgaver, timeavtaler eller annet til innbygger ifm. pasientforløp

• Forvaltning – brukes for informasjon og tjenester knyttet til helseforvaltning og helseøkonomiforvaltning 
  eks: sende ut vedtak

• Sekundærbruk – brukes for informasjon og tjenester knyttet til forskning, helseundersøkelser og annen sekundærbruk 
  eks: invitere til deltakelse og sende ut informasjon fra forskningsprosjekter og helseundersøkelser

Kodeverk 7618 på Volven

• 1 = Helseregister 

• 2 = Pasientjournal 

• 3 = Helsehjelp

• 4 = Forvaltning 

• 5 = Sekundærbruk 

Eks:

<meta>
    <security>
       <!-- For ressursen Task 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 -->
       <system value="urn:oid:2.16.578.1.12.4.1.1.7618"/>
       <code value="3"/>
       <display value="Helsehjelp"/>
    </security>
<meta>

meta.security - Sensitiv avsender

Avsender kan angi om avsenders navn/identitet er sensitiv eller ikke. Dette kan benyttes for å hindre at avsenders navn inkluderes når innbygger varsles om mottak på Helsenorge. Dette fordi varsel skjer gjennom usikre kanaler (e-post og/eller SMS). Vi så langt valgt å ikke publisere kodeverdiene på Volven.

Kodesystem: http://helsenorge.no/fhir/sensitiv-avsender

Verdisett:

• 0 = "Ikke sensitiv avsender"

• 1 = "Sensitiv avsender"

Eks:

<meta>
   <security>
       <system value="http://helsenorge.no/fhir/sensitiv-avsender"/>
       <code value="1"/>
       <display value="Sensitiv avsender"/>
    </security>
<meta>

meta.security - Hvem som kan utføre/endre på aktuell ressurs.

NB! Denne opsjonen gir ikke mulighet til å bestemme hvem som skal kunne “se” den aktuelle ressurs. Dette styres av standardiserte regler på Helsenorge.

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

Verdisett (gyldige kodeverdier):

• 1 - Kan kun utføres av innbygger selv

  • Kan kun kombineres med tilgangskode 6 (Kan utføres av innbygger med begrenset adresse (adressekode 6/7)). ) Tilgangskode 1 inkludere ikke tilgangskode 6, så denne må settes eksplisitt hvis ønsket.

• 2 - Kan utføres av foreldre til barn under 12 år

• 3 - Kan utføres av foreldre til barn mellom 12-16 år

  • Inkluderer ikke tilgangskode 7 (dvs. tilgangskode 7 må settes eksplisitt dersom barnet 12-16 også skal kunne utføre/endre).

• 4 - Kan utføres av representant med tildelt fullmakt (ikke samtykkekompetent pasient)

• 5 - Kan utføres av representant med ordinær fullmakt (i tillegg til innbygger selv)

  • Inkluderer innbygger selv

• 6 - Kan utføres selv om innbygger med begrenset adresse (adressekode 6/7)

• Kommer senere: 7 - Kan utføres av innbygger selv i aldersgruppen mellom 12-16 år

Eks: Kan kun utføres av innbygger selv, også dersom innbygger har begrenset adresse (adressekode 6/7)

<meta>
   <security>
      <system value="http://helsenorge.no/fhir/KanUtforesAv"/>
      <code value="1"/>
      <display value="Kan kun utføres av innbygger selv"/> 
   </security>
   <security>
      <system value="http://helsenorge.no/fhir/KanUtforesAv"/>
      <code value="6"/>
      <display value="Kan utføres selv om innbygger med begrenset adresse (adressekode 6/7)"/>    
   </security>
</meta>

Eks: Kan utføres av innbygger selv samt ved foreldrerepresentasjon eller ved fullmakt for ikke samtykkekompetent

<meta>
   <security>
      <system value="http://helsenorge.no/fhir/KanUtforesAv"/>
      <code value="2"/>
      <display value="Kan utføres av foreldre til barn under 12 år"/> 
   </security>
   <security>
      <system value="http://helsenorge.no/fhir/KanUtforesAv"/>
      <code value="3"/>
      <display value="Kan utføres av foreldre til barn mellom 12-16 år"/>    
   </security>
   <security>
      <system value="http://helsenorge.no/fhir/KanUtforesAv"/>
      <code value="4"/>
      <display value="Kan utføres av representant med tildelt fullmakt (ikke samtykkekompetent pasient)"/>    
   </security>
</meta>

meta.tag - Videreformidling:

For enkelte FHIR ressurser tilbys videreformidling av ressursen i lesbart format til innbygger dersom innbygger ikke er aktiv på Helsenorge. Det vil da formidles en PDF versjon av resursen i fysisk post til innbygger. Dersom en aktør ønsker dette, må det i tillegg inkluderes et eget videreformidling skjema i meldingen. (Se egen dokumentasjon for dette). MERK! Det vil framgå i detaljbeskrivelsen av den enkelte ressurs om videreformiding støttes, og også hvilke av verdiene under som støttes.

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

Verdisett (gyldige kodeverdier):

• 1 - Videreformidling hvis ikke aktiv

• 2 - Videreformidling ved varslingsfeil

• 3 - Videreformidling hvis ikke lest

Eks:

<meta>
   <tag>
       <!-- Avsender ønsker task videreformidlet til fysisk post dersom innbygger ikke er digital aktiv på Helsenorge. -->
       <system value="http://helsenorge.no/fhir/videreformidling"/>
       <code value="1"/>
       <display value="Videreformidling hvis ikke aktiv"/>
   </tag>
<meta>

meta.tag - Varsling

For enkelte FHIR ressurser er det mulig å undertrykke at innbygger varsles når en ekstern aktør lagrer eller endrer en ressurs på Helsenorge. Parameteren har fått den generelle navnet “varsling” for eventuelle framtidige opsjoner knyttet til varsling.

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

Verdisett (gyldige kodeverdier):

• 1 - Innbygger skal ikke varsles

Eks:

<meta>
   <tag>
        <system value="http://helsenorge.no/fhir/varsling"/>
        <code value="1"/>
        <display value="Innbygger skal ikke varsles"/>
    </tag>
</meta>