...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Contained: Requestor vil alltid være en "Contained Resource" som refereres til i FHIR task. Her skal organisasjonen som ber om at oppgaven utføres angis samt kontaktdetaljene der innbygger kan henvende seg ved spørsmål. Eks:
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Extension: Dersom det (i sjeldne tilfeller) skulle være behov for å ha et annet tidspunkt for “dead-line” for utførelse av en task enn det som er angitt som frist for utførelse, kan dette angis i en Helsenorge spesifikk extension (se under).
Image Removedidentifier (mandatory): En identifikator som identifiserer denne oppgaven forretningsmessig uavhengig av ressursens id på en FHIR-server. Skal være en GUID. Kan benyttes for å knytte forskjellige andre type FHIR-ressurser, som oppstår som følge av at oppgaven utføres, sammen med oppgaven de tilhører (f.ek. et Skjemasvar). Kan også benyttes for å søke fram en oppgave når man ikke kjenner oppgavens “id”. Eks: Image Removed | instantiatesUri (conditional): 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. Skal 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: ready: Dette er verdien som eksterne skal sette når de sender en oppgave til innbygger. På Helsenorge vises dette som "Ikke utført". Oppgaven kan da utføres innfor “gyldighetstid”. in-progress: 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: En ekstern aktør kan kansellere en oppgave som tidligere er sendt til innbygger. entered-in-error: En ekstern aktør kansellere en oppgave på grunn av at den ble feilregistrert. Image Removed |
statusReason (optional, maks 250 tegn): Her kan en ekstern aktør “forklare” hvorfor en tidligere sendt oppgave har endret status f.eks. blitt kansellert. Teksten vil kun vises så lenge status ikke (igjen) endres. Dersom man ønsker å bevare historikk på slike forklaringer må Task.note benyttes, se under. Eks: Code Block |
---|
<statusReason>
<text value="Oppgaven er kansellert fordi timen er utsatt på ubestemt tid"/>
</statusReason> |
|
intent (mandatory): Hensikt med oppgaven i henhold til FHIR kodeverk. Image Removed |
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 Removed |
code (mandatory, max 250 tegn): 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 Block |
<code>før konsultasjon"/>
</code> |
|
description (mandatory, max 1024 tegn): 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 type ressurs som skal håndteres/modifiseres. Ofte skal det også beskrives hvilken ressurs, av aktuell type, som skal modifiseres ved å angi en identifikator for denne slik den er definert på Helsenorge (se under). focus.type (mandatory): Type ressurs. Så langt støttes: "Consent" - Benyttes ved Samtykkeforepørsler "Questionnaire" - Benyttes dersom oppgaven er å fylle ut et skjema, da skal skjemasvaret lagres i innbyggers helsearkiv på Helsenorge "Task" (uten ytterligere spesifikasjon) - Benyttes for generelle oppgaver innbygger skal utføre i systemer utenfor Helsenorge. "Schedule" (kommer H2-2024) - Benyttes der innbygger selv kan velge time for spesialistbehandling etter at det er innvilget rett til helsehjelp. "Device" - Benyttes dersom innbygger får i oppgave å ta i bruk et digitalt verktøy.
focus.identifier (conditional): Identifikator for en ressurs av aktuell type. Benyttes alltid dersom ikke instantiatesUri benyttes (dvs. kan kun utelates dersom oppgaven utføres i et system utenfor Helsenorge) focus.display (conditional): Visningsnavn for ressursen. Påkrevd for oppgave om å ta i bruk et digitalt verktøy. Kan utelates for andre typer ressurser. Eksempler: Code Block |
---|
<focus>
<type value="Consent" />
<identifier>
<system value="http://helsenorge.no/fhir/personverninnstillingdefinisjon-id"/>
<value value="fb9214ff-2fcb-4242-a111-7880547c3523"/>
</identifier>
</focus> |
|
<!--HerSKALoppgavenstittel legges. --><system value="http://helsenorge.no/fhir/skjema-id"/>
|
|
<text"Her skal oppgavens tittel legges"/>
</code>description (mandatory, max 1024 tegn): 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 type ressurs som skal håndteres/modifiseres. Ofte skal det også beskrives hvilken ressurs, av aktuell type, som skal modifiseres ved å angi en identifikator for denne slik den er definert på Helsenorge (se under).
focus.type (mandatory): Type ressurs. Så langt støttes:
focus.identifier (conditional): Identifikator for en ressurs av aktuell type. Benyttes alltid dersom ikke instantiatesUri benyttes (dvs. kan kun utelates dersom oppgaven utføres i et system utenfor Helsenorge)
Eksempler:
Code Block |
<focus>
"8"/>
</identifier>
</focus> |
Code Block |
---|
<focus>
<type value="Questionnaire"/>
<identifier>
<!-- Peker til skjemadefinisjon i samme bundle. GUID er samme som Questionnaire.id (i bundelen) -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:f3da38c2-594c-4d0a-b969-4ab9dfc0cc3f"/>
</identifier>
</focus> |
Eksempel på skjemaoppgave, der ekstern utfyller benyttes, Merk: Da angis kun ressurstype og ikke skjemaets “identifier” i “focus”. Oppgavens ID i dte ekstrene systemet er en del av Task.instantiatesUri:
Code Block |
---|
<focus>
<type value="Questionnaire"/>
<!-- Merk at skjemaets identifier ikke er med i "focus" dersom ekstern skjemautfyller benyttes.
|
|
<typevalue="Consent"/><identifier>del av instantiatesUri. -->
|
|
<system value="http://helsenorge.no/fhir/personverninnstillingdefinisjon-id"/>
<value value="fb9214ff-2fcb-4242-a111-7880547c3523"/>
</identifier> 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. Questionnaire <identifier>
<system value="http://helsenorge.no/fhir/blankett-nummer"/>
<!-- Peker til en unik identifikator for en Schedule som kan benyttes fra Helsenorge mot Timeløsningen hos spesialist.
|
|
<valuevalue="3DHV-IIFJ-1"/> Det hentes et antall Slots der |
|
</identifier>
</focus>Der man refererer til en bestemt instans av et blankettnummer.
Code Block |
<focus>
<type value="Questionnaire"/>innbygger kan velge en for å opprette en Appointment. Oppgaven utføres på Helsenorge,
|
|
<identifier> i samvirke med spesialist sin Timeløsning. -->
<system value=" |
|
http://helsenorge.no/fhir/skjema-id 8urn:uuid:f3da38c2-594c-4d0a-b969-4ab9dfc0cc3f"/> |
|
der Helsenorge skjemautfyller benyttes, men der selve spørreskjemaet (Questionnaire) sendes med fra avsender sammen men oppgaven: Code Block |
<focus> Code Block |
---|
| <focus>
<!-- Eksempel på referenase til et Verktøy som ligger i Verktøykatalogen på Helsenorge -->
<type value=" |
|
Questionnaire<!--Peker til skjemadefinisjon i samme bundle. GUID er samme som Questionnaire.id (i bundelen) -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:f3da38c2-594c-4d0a-b969-4ab9dfc0cc3f"/>
</identifier>
</focus>Eksempel på skjemaoppgave, der ekstern utfyller benyttes, Merk: Da er ikke “identifier” med, men oppgavens ID er en del av Task.instantiatesUri:
Code Block |
---|
<focus>
<type value="Questionnaire"/>
<!-- Merk at skjemaets identifier ikke er med i "focus" dersom ekstern skjemautfyller benyttes.
Denne er da en del av instantiatesUri. -->
</focus> |
authoredOn (optional): Tidspunkt når oppgaven ble laget. Dette settes normalt automatisk av Helsenorge ved mottak av oppgaven. Dersom det er viktig for avsender å indikere overfor innbygger at oppgaven er opprettet på et tidligere tidspunkt, kan denne settes. . |
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: <system value="http://nhn.no/helsenorge/verktoyid" />
<value value="6aaa34b9-103a-4d6c-a850-6cbfebb16348"/>
</identifier>
<display value="Assistert Selvhjelp Mestringsverktøy"/>
</focus> |
|
authoredOn (optional): Tidspunkt når oppgaven ble laget. Dette settes normalt automatisk av Helsenorge ved mottak av oppgaven. Dersom det er viktig for avsender å indikere overfor innbygger at oppgaven er opprettet på et tidligere tidspunkt, kan denne settes. . |
requester (mandatory): Den som ber om at oppgave utføres. Code Block |
---|
<!-- Skal alltid være med og SKAL referere til en "contained" ressurs -->
<requester>
<!-- Her referers til en organisasjon -->
<reference value="#requester-1" />
<type value="Organization" />
</requester> |
Code Block |
---|
<!-- Skal alltid være med og SKAL referere til en "contained" ressurs -->
<requester>
<!-- Her referers til en individuell behandler -->
<reference value="#requester-1" />
<type value=" |
|
OrganizationPractitioner" />
</requester> |
|
owner (mandatory): Den |
som "eier" utførelsen av oppgaven. I vårt tilfelle er dette alltid pasienten dvs. innbygger. som ‘eier’ utførelsen av oppgaven. I vårt tilfelle er dette alltid pasienten. (Oppgaver kan på Helsenorge utføres av andre enn pasienten, f.eks. foreldre på vegne av barn, men oppgaven skal alltid sendes til pasienten.) Skal angis med innbyggers fødselsnummer. Eks: Code Block |
---|
<!-- Skal alltid |
|
vørehvemsomskalutføreoppgaven; her innbygger til -->
<owner>
<type value="Patient" />
<identifier>
<system value="urn:oid:2.16.578.1.12.4.1.4.1" />
<value value="13116900216" />
</identifier>
</owner> |
|
note (optional, maks 2048 tegn): Kan kun være med ved senere oppdatering av oppgaven. Her kan det legges til en eller flere notater til en eksisterende oppgave. Dette vil skje ved oppdatering av ressursen. Alle noter tas vare på og skal tidsstemples. Eks: Code Block |
---|
<note>
<time value="2021-12-10T14:03:42.8007888+02:00"/>
<text value="Oppgaven ble opprinneig opprettet som forberedelse til spesialisttime. Oppgaven er nå trukket tilbake fordi timen er utsatt på ubestemt tid."/>
</note> |
|
restriction (mandatory): Denne skal benyttes for å angi når oppgaven skal/må utføres MERK! Helsenorge benytter kun angitte datoer i forretningslogikken. (Dvs. eventuell angivelse av time, minutt etc., tas ikke hensyn til): Code Block |
---|
<!-- Dette er svarfrist for utførelse av oppgaven. -->
<restriction>
<period>
<end value="2019-12-04T00:00:00.0000000+02:00" />
</period>
</restriction> |
|
(Ikke utviklet enda)Dersom man ønsker Det er under vurdering om man skal kunne angi at innbygger ikke skal kunne påbegynne oppgaven før et bestemt tidspunkt, I slikt tilfelle kan "period" utvides med et "start" element. Eks: Code Block |
---|
<!-- Dette er tidligste startdato og svarfrist for utførelse av oppgaven. -->
<restriction>
<period>
<start value="2019-11-21T00:00:00.0000000+02:00" />
<end value="2019-12-04T00:00:00.0000000+02:00" />
</period>
</restriction> |
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: Code Block |
---|
<!-- Dette er svarfrist for utførelse av oppgaven. -->
<restriction>
<!-- Mulighet for å angi annen deadline enn svarfrist (dvs. etter svarfrist) -->
<extension url="http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline">
<valueDate value="2019-12-31"/>
</extension>
<!-- Her er den ordinære svarfristen -->
<period>
<end value="2019-12-04T00:00:00.0000000+02:00" />
</period>
</restriction> |
|
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 |