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)

  • Kommer Q1 - 2023: 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 håndteringen av ressursen 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 skal 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. Dette er derfor ikke obligatorisk å benytte Metadata.security. Det vil framgå av profilen for den enkelte FHIR-ressurs om dette er obligatorisk eller ikke.

Følgende 5 kategorier som en FHIR-ressurs kan tilhøre er definert og ønskes benyttet i sektoren:

• Helseregister – når det handler om opplysninger registrert om innbygger i ulike registre

• Pasientjournal – når det handler om opplysninger i pasientjournal

• Helsehjelp – når det handler om tjenester knyttet til direkte behandling og helsehjelp til innbygger for å vite hvordan videre behandlingsløp, oppfølging og informasjon skal håndteres

• Forvaltning – når det handler om tjenester knyttet til generell helseforvaltning / helsesektor

• Sekundærbruk – når det handler om tjenester knyttet til forskning og annen sekundærbruk

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>

(Kommer Q1 - 2023): 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 ikke kombineres med andre koder enn kode 6 (Kan utføres av innbygger med begrenset adresse (adressekode 6/7))

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

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

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

• 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 kun utføres dersom representasjon er 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 - Innholdtype:

For noen FHIR-ressurser og i visse contexter kan/skal avsender angi hva slags "innholdtype" ressursen tilhører. Dette må ikke forveksles med Tjenesteområder beskrevet over. Formålet med "innholdtype" er blant annet å kunne differensiere varslingtekster og varslingsnivå på Helsenorge. Det vil framgå av profilen for den enkelte FHIR ressurs om det er nødvendig, eller mulig, å sette denne parameteren eller ikke.
Volven kodeverk 7613 benyttes. Dette er i øyeblikket svært begrenset og vil utvides på et senere tidspunkt.

Eks:

<meta>
   <tag>
        <system value="urn:oid:2.16.578.1.12.4.1.1.7613"/>
        <code value="IB"/>
        <display value="Innkallingsbrev"/>
    </tag>
</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).

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

Verdisett (gyldige kodeverdier):

• 1 - Videreformidling hvis ikke aktiv

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 endrer en ressurs på Helsenorge. I slikt tilfelle benyttes FHIR ressursen “Parameters”, som benyttes for å endre allerede lagrede ressurser ved hjelp av FHIRPath Patch. 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>