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 i usikre kanaler (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

• 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.tag - Innholdtype:

For en del 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 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).

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 oppretter eller endrer en ressurs på Helsenorge. Dette gjelder blant annet for, “Parameters”, som benyttes for å endre allerede lagrede ressurser ved hjelp av FHIRPath Patch. Hvilke FHIR ressurser som har sik mulighet er dokumentert i dokumentasjonen av profilen for den enkelte ressurs.

Eks:

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