Page Comparison

identifier (mandatory): Unik identifikator som identifiserer denne oppgaven. Benyttes som forretnings-referanse mellom Aktør og Helsenorge. Alle andre ressurser som som “oppstår” som følge av denne oppgaven vil være relatert til oppgaven gjennom referanse til denne identifikatoren. Identifikatoren skal være globalt unik og være av type GUID. Eks:

Image Modified

instantiatesUri (conditional):

1. Skal benyttes for å peke til eksterne skjemautfyllere dersom oppgaven er av type Questionnaire. Dvs. dersom en oppgave av type skjema skal utføres i en annen skjemautfyller enn den som finnes på Helsenorge. Dette skal være en full URL med nødvendige parametere slik at ekstern utfyller kan utføre oppgaven.

2. (Ny oppgavetype Q4 2021): Skal også benyttes der man ønsker å peke til et eksternt nettsted der innbygger skal utføre en oppgave, dvs. der Task.focus er av typen “task”. Dette skal være en full URL med nødvendige parametere

status (mandatory): Status på oppgaven i henhold til FHIR kodeverk.

Vi benytter dette som følger, og følgende tilstander er

implementert på Helsenorge:

• requested: Dette er verdien som eksterne skal sette når de sender en oppgave til

• innbygger. På Helsenorge vises dette som "Ikke utført"

• on-hold:

• Noen arbeidsflyter på Helsenorge har en tilstand der innbygger kan starte en oppgave, men velge å lagre resultatet av delvis utført oppgave. Innbygger kan senere velge å fullføre oppgaven med utgangspunkt i mellomlagrede data. På Helsenorge vises dette som "Påbegynt"

• completed: Dette er tilstand når oppgaven er ferdigstilt.

• På Helsenorge vises dette som "Utført"

• cancelled: (Ny status Q4 2021): En ekstern aktør kan kansellere en oppgave som tidligere er sendt til innbygger.

Image Modified

statusReason (optional): (Ny funksjonalitet Q4 2021): Her kan en ekstern aktør “forklare” hvorfor en tidligere sendt oppgave eventuelt har blitt kansellert.

Eks:

<statusReason>
        <text value="Oppgaven er kansellert fordi timen er utsatt på ubestemt tid"/>
</statusReason>

intent (mandatory): Hensikt med oppgaven i henhold til FHIR kodeverk.

• Normalt benyttes “proposal”

• Ny funksjonalitet Q4 2021: “plan”: Innbygger har ikke anledning til å slette slike oppgaver (men kan velge å ikke utføre de).

Image Modified

priority (optional): Hvor mye det haster. Dersom ikke angitt, blir denne satt til "routine" som default på Helsenorge. Det benyttes standardiserte regler knyttet til varsling og påminnelser på Helsenorge basert på verdien her.

Image Modified

code (mandatory): Her skal oppgave tittelen legges. Dette bør være en kort beskrivende overskrift av hva oppgaven innebærer. Tittel vises i oversikten over oppgaver i Meldingssenteret på Helsenorge.

Eks:

<code>
        <!-- Her SKAL oppgavens tittel legges. -->
        <text value="Her skal oppgavens tittel legges"/>
</code>

description (mandatory): En tekstlig beskrivelse av oppgaven som vises til innbygger. Bør gi en kort forklaring av oppgavens formål og innhold, og gjerne også noe om hvem som eventuelt får resultatet av utført oppgave. (Dette siste er spesielt relevant for skjemaoppgaver).

focus: Dette er en beskrivelse av ressursen som skal modifiseres når oppgaven utføres. Her skal det beskrives hva slags ressurs som skal håndteres/modifiseres. Normalt skal det også beskrives hvilken ressurs, av aktuell type, som skal modifiseres ved å angi en identifikator for denne slik den er definert på Helsenorge.

Ressursens identifikator skal alltid benyttes med unntak av når instantiatesUri er benyttet:

• I tilfellet der oppgaven er av type skjemaoppgave (Questionnaire) og det benyttes ekstern skjemautfyller. (I slikt tilfelle er ressurs ID’en en del av instantiatesUri).

• Ny funksjonalitet Q4 2021: Ressursen kan være av en generisk oppgave (Task) som skal utføres utenfor Helsenorge. (I slikt tilfelle er ressurs ID’en en del av instantiatesUri).

focus.type (mandatory): Type ressurs.

Så langt støttes

:

• "Consent"

• "Questionnaire"

• Ny funksjonalitet Q4-2021: Task

focus.identifier (conditional): Identifikator for en ressurs av aktuell type. Benyttes alltid

dersom ikke instantiatesUri benyttes.

focus.display (

optional):

Kan benyttes for å gjøre FHIR-ressurs referansen mer “lesbar”. Vises ikke til innbygger.

• Eksempel på samtykkeforespørsel:

<focus>
        <type value="Consent" />
        <identifier>
            <system value="http://helsenorge.no/fhir/personverninnstillingdefinisjon-id"/>
            <value value="fb9214ff-2fcb-4242-a111-7880547c3523"/>
        </identifier>
        <display value="Samtykke til betingelsene for å være sæddonor"/>
</focus>

• Eksempel på skjemaoppgave, der Helsenorge sin skjemautfyller benyttes:

  • Der man refererer til et blankett nummer i skjemakatalogen. Et blankett nummer kan inneholde flere instanser, f.eks. for forskjellige språk. Innbygger velger da først språk i skjemautfyller.

  • Code Block
    <focus> <type value="Questionnaire"/> <identifier> <system value="http://helsenorge.no/fhir/blankett-nummer"/> <value value="3DHV-IIFJ-1"/> </identifier> <display value="Helseskjema for fastlege konsultasjon"/> </focus>

  • Der man refererer til en bestemt instans av et blankettnummer.

• Code Block
  <focus> <type value="Questionnaire"/> <identifier> <system value="http://helsenorge.no/fhir/skjema-id"/> <value value="8"/> </identifier> <display value="Helseskjema for fastlege konsultasjon"/> </focus>

• Eksempel på skjemaoppgave, der ekstern utfyller benyttes:

 <focus>
        <type value="Questionnaire"/>
        <!-- Merk at skjemaets identifier ikke er med i "focus" dersom ekstern skjemautfyller benyttes. Denne er da en del av instantiatesUri. -->
        <display value="Pasientens vurdering av utført spesialistbehandling."/>
</focus>

• Eksempel på ekstern oppgavehåndtering, der arbeidsflyt for oppgaven skjer utenfor Helsenorge. I disse tilfellene så må eksternt system oppdatere status på oppgaven når den er utført.

  Code Block
  language xml
  <focus> <type value="Task"/> <!-- Merk at oppgavens identifier ikke er med i "focus" dersom ekstern oppgavehåndtering benyttes. --> <display value="Kartlegging av pasientens vurderinger i forbindelse med (...)"/> </focus>

authoredOn (optional): Tidspunkt når oppgaven ble laget. Dersom ikke angitt settes denne av Helsenorge til det tidspunkt oppgaven ble mottatt.

lastModified (optional): Tidspunkt når oppgaven sist ble endret. Vil typisk være når status endres, dvs. når den er fullført. Settes av Helsenorge.

requester (mandatory): Den som  ber om at oppgave utføres. Vi referer her til en organisasjon med kontakt detaljer. Organisasjonen inkluderes som en såkalt "contained ressurs". Eks: 

owner (mandatory): Den som "eier" utførelsen av oppgaven. I vårt tilfelle er dette alltid pasienten dvs. innbygger. Skal angis med innbyggers fødselsnummer. Eks:

restriction (mandatory): Denne skal benyttes for å angi når oppgaven skal utføres, dvs. svarfrist. Eks:

Image Modified

Dersom man ønsker at innbygger ikke skal kunne påbegynne oppgaven før et bestemt tidspunkt, kan "period" utvides med et "start" element. Eks: 

Image Modified

Det er også laget en egen Helsenorge extension til restriction som er kalt "deadline" (ref: https://github.com/helsenorge/helsenorge-fhir/blob/master/StructureDefinition/hn-task-deadline.structuredefinition-extension.xml  ). Denne er mulig å bruke dersom man har en svarfrist, men det skal være mulig å utføre oppgaven etter dette tidspunkt. Dersom denne benyttes, må det i "description" ligge en forklaring på dette forholdet som er forståelig for innbygger. Eks:

Image Modified

input: Denne benyttes ikke for håndtering av workflow objektet Task. Her kan avsender legge til parametere som eventuelt behøves under selve oppgaveutføreselen. Det vil avhenge av type oppgave om slike input parametere er med eller ikke. Dette er dokumentert her: Task.input for forskjellige oppgavetyper