Resource (som alle ressurser arver fra)
...
meta.security - Hvem som kan utføre/endre på aktuell ressurs.
Denne opsjonen gir ikke mulighet til å bestemme hvem som skal kunne “se” oppgaven. Dette styres av standardiserte regler på Helsenorge.
For å håndheve unntaksbestemmelsen for ungdom, benyttes meta.security - Tilgangsbegrensning
NB! Denne opsjonen for kan benyttes dersom det er nødvendig/ønskelig å overstyre det som er standard regler på Helsenorge for hvem som kan utfølre en oppgave:
Hvem som skal kunne utføre forskjellige type oppgaver på vegne av innbygger/pasient
.
Om oppgaven kun kan utføres av innbygger selv, eller om innbygger med spesielle attributter (undom eller sperret adresse) også skal kunne utføre oppgaven.
Før denne opsjone benyttes bør aktørens ha dialog med sin kontaktperson på Helsenorge. Dette for å sikre å sikre korrekt bruk! Opsjonen skal kun unntaksvis benyttes.
For skjemaoppgaver gjelder spesielle regler i forhold til innbyggere med adressesperre:
Skjemaoppgaver kan pr Q2-2023, ikke utføres av innbyggere med adressesperre. Dette er resultat av en risikoanalyse innen området. Setting av attributt på oppgaven som tillater at oppgaven utføres av innbygger med adressesperre vil ikke overstyre dette.
Det er under vurdering om også skjemaoppgaver kan tillates utført av innbyggere med adressesperre. Dette blir i så fall ingen generell tillatelse. Det vi i tillegg kreves at det enkelte skjema der dette skal tillates, eksplisitt er merket med attributter i skjemadefinisjonene som tilsier at skjemaet er trygt for slik bruk. (Nærmere informasjon om dette kommer når de nødvendige vurderinger er gjort).
Se også generell informasjon om begrensninger i bruk av de forskjellige opsjonskodene i fellesdokumentasjonen for alle FHIR-ressurser.
Eks: Kan kun utføres av innbygger selv, også dersom innbygger har adressespere (strengt fortrolig adresse eller fortrolig adresse, gamle adressekode 6/7)
Code Block language xml <meta> <security> <system value="http://helsenorge.no/fhir/KanUtforesAv"/> <code value="1"/> <display value="Kan kun utføres av innbygger selv"/> </security> <security> <system value="http://helsenorge.no/fhir/KanUtforesAv"/> <code value="6"/> <display value="Kan utføres selv om innbygger med adressesperree (adressekode 6/7)"/> </security> </meta>
Eks: Kan kun utføres dersom representasjon er foreldrerepresentasjon eller ved fullmakt for ikke samtykkekompetent
Code Block language xml <meta> <security> <system value="http://helsenorge.no/fhir/KanUtforesAv"/> <code value="2"/> <display value="Kan utføres av foreldre til barn under 12 år"/> </security> <security> <system value="http://helsenorge.no/fhir/KanUtforesAv"/> <code value="3"/> <display value="Kan utføres av foreldre til barn mellom 12-16 år"/> </security> <security> <system value="http://helsenorge.no/fhir/KanUtforesAv"/> <code value="4"/> <display value="Kan utføres av representant med tildelt fullmakt (ikke samtykkekompetent pasient)"/> </security> </meta>
meta.tag - Videreformidling: Kan være med dersom man ønsker at en oppgave skal formidles i fysisk post til innbygger dersom innbygger ikke er digitalt aktiv på Helsenorge. Der angitt i dokumentasjonen for den enkelte oppgavetype om videreformidling støttes eller ikke. Eks:
Code Block | ||
---|---|---|
| ||
<meta> <!-- Avsender ønsker doument som erstatter/inneholder oppgaven videreformidlet til fysisk post dersom innbygger ikke er digital aktiv på Helsenoreg. --> <tag> <system value="http://helsenorge.no/fhir/videreformidling"/> <code value="1"/> <display value="Videreformidling hvis ikke aktiv"/> </tag> </meta> |
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:
...
identifier (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: | |||||||||||||||||
instantiatesUri (conditional):
| |||||||||||||||||
basedOn (optional): Helseaktør kan referere til andre typer ressurser som er “kjent” på Helsenorge for å gi innbygger bedre forståelse for hvilken sammenheng oppgaven kommer i. For eksempel kan oppgaven referere til en henvisning når innbygger bes om å velge time som del av et behandlingsløp, eller til en timeavtale når innbygger bes om å sende inn utfyllende helsestatus. Task.basedOn vil bestå av en eller flere referanser. Disse kan oppdateres.
Hvordan man kan endre referansen (og andre definerte felt på en eksisterenede Task) er beskrevet her: Oppdatering av attributter på Task (FhirPatch) | |||||||||||||||||
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, 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:
| |||||||||||||||||
intent (mandatory): Hensikt med oppgaven i henhold til FHIR kodeverk.
| |||||||||||||||||
priority (optional): Benyttes ikke av Helsenorge. | |||||||||||||||||
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:
| |||||||||||||||||
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:
| |||||||||||||||||
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:
| |||||||||||||||||
owner (mandatory): Den 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.) Skal angis med innbyggers fødselsnummer. Eks:
| |||||||||||||||||
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:
| |||||||||||||||||
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):
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:
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 |
...