FHIR Task - Oppgave

identifier (mandatory): Unik identifikator som identifiserer denne oppgaven for den aktuelle innbygger. Benyttes som referanse mellom Aktør og Helsenorge, samt som intern referanse til denne oppgaven mellom vertikaler på Helsenorge. Denne skal være globalt unik og være av type GUID. Eks:

instantiatesUri (conditional): 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 er en URL som alltid kombineres med en av følgende parametere for å angi enten oppgave-id eller hvilket skjema som skal benyttes:

• "{id}" - Makro som setter inn skjema id som skal benyttes: Task.focus.identifier.value (se lenger ned om "focus" elementet).

• "{bn}" - Makro som setter inn skjema navnet som skal benyttes: Task.focus.identifier.value (se lenger ned om "focus" elementet).

• “{tid} - Makro som setter inn oppgavens ID: Task.identifier

Merk! Url skal normalt også inneholde parameter for det som legges til:

Eksempler:

• https://skjemautfyller.skjema.no/?id={id}

• https://skjemautfyller.digi.com/?bn={bn}

• https://skjemautfyller.xys.no/?tid={tid}

Det er noen skjemautfyller som i dag ikke har med i http-requesten hvilken parameter som er lagt til. Dette bør unngås, men støttes for bakoverkompatibilitet.

Eks:

https://proms2.hemit.org/Proms/Form/Edit/{id}

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

Vi benytter dette som følger, og følgende tilstander er implementeres i Oppgavevertikalen vår:

• requested: Dette er verdien som eksterne skal sette når de sender en oppgave til oss. I Oppgave vertikalen tolkes dette som "Ikke utført"

• on-hold: Dette er en tilstand som noen av de vertikaler der oppgaven utføres kan ha. I Oppgave vertikalen tolkes dette som "Påbegynt"

• completed: Dette er tilstand når oppgaven er ferdigstilt. I oppgave vertikalen tolkes dette som "Utført"

intent (mandatory): Hensikt med oppgaven i henhold til FHIR kodeverk. Normalt benyttes “proposal”

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.

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 den resurs som skal modifiseres når oppgaven utføres. Her beskrives hva slags ressurs som skal håndteres/modifiseres samt en identifikator for den aktuelle ressurs slik denne er definert på Helsenorge. Dette elementet skal alltid benyttes. Men "Identifier-elementet" kan utelates dersom man benytter ekstern skjemautfyller og det i instantiatesUri refererer til oppgavens {id} (se over om instantiatesUri).

focus.type (mandatory): Type ressurs. (Så langt støttes kun "Consent" og "Questionnaire")

focus.identifier (conditional): Identifikator for en ressurs av aktuell type. Benyttes alltid bortsett fra når kun oppgave-ID refereres i instantiateUri.

focus.display (mandatory): Dette benyttes som tittel på oppgaven

• Eks samtykkeforespørsel:

• Eks skjemaoppgave (der Helsenorge sin skjemautfyller benyttes eller ekstern skjemautfyller der det refereres til hvilket skjema som skal benyttes ved oppstart):

• Eks skjemaoppgave (der ekstern utfyller benyttes og det refereres kun til oppgave-id ved oppstart):

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:

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

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:

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