Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Alle FHIR ressurser er av typen Resource og arver disse egenskapene.

Domain Resource (alle FHIR ressurser "arver" disse egenskapene)

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

Nytt kodeverk Kodeverk 7618 på Volven

  • 1 = Helseregister 

  • 2 = Pasientjournal 

  • 3 = Helsehjelp

  • 4 = Forvaltning 

  • 5 = Sekundærbruk 

Eks:

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

Code Block
<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 fortløpende ved behov):på et senere tidspunkt.

Eks:

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

Code Block
<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 (kommer Q1 2022)

For FHIR ressursene, “Parameters”, som benyttes for å endre en ressurs ved hjelp av FHIRPath Patch, er det mulig å undertrykke at innbygger varsles om endringen.

Eks:

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

...