Resource (som alle ressurser arver fra)
...
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 GUID dersom satt. Hvis ikke satt, generer Helsenorge en GUID. Bør Kan benyttes av ekstern aktør nå denne benytter FHIR API’er på Helsenorge. Kan Skal benyttes ved meldingsbasert integrasjon. Eks:
...
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: | |||||||||||||
instantiatesUri (conditional):
| |||||||||||||
status (mandatory): Status på oppgaven i henhold til FHIR kodeverk. Vi benytter dette som følger, og følgende tilstander er implementert på Helsenorge:
| |||||||||||||
statusReason (optional): (Ny funksjonalitet H1 2022): 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 benytte, se under. Eks:
| |||||||||||||
intent (mandatory): Hensikt med oppgaven i henhold til FHIR kodeverk.
| |||||||||||||
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. | |||||||||||||
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:
| |||||||||||||
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:
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. focus.display (optional): Kan benyttes for å gjøre FHIR-ressurs referansen mer “lesbar”. Vises ikke til innbygger.
| |||||||||||||
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:
| |||||||||||||
Ny funksjonalitet H1 - 2022: note (optional): Her kan det legges til en eller flere notater. Dette vil som regel skje ved oppdatering av ressursen. Alle noter tas vare på og skl tidstemples. Eks:
| |||||||||||||
restriction (mandatory): Denne skal benyttes for å angi når oppgaven skal utføres, dvs. svarfrist. Eks: Ny funksjonalitet H1-2022: 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 |
...