1 Innledning
2 Oppdatere status på en oppgave
- 2.1 Status alene, oppgave ferdig utført i eksternt system (Task.status)
- 2.2 Oppdatere status samtidig som man setter en grunn for statusendringen (Task.status + Task.statusReason)
3 Legge til en note (Task.note)
4 Endre oppgavens frist(er)
- 4.1 Endre sluttdato og legge til årsak (note)
- 4.2 Endre alle frister
5 Endre oppgavens beskrivelse og legge til note
6 Endre referanse til Helsenorge-element
- 6.1 Legge til referanse
- 6.2 Fjerne referanse
- 6.3 Bytte ut referanse

Innledning

Alle oppgaver er beskrevet i en FHIR Task - Oppgave.

Avsender av en oppgave kan etter at oppgaven er sendt til Helsenorge oppdatere noen av elementene i Oppgaven. For dette benyttes https://www.hl7.org/fhir/fhirpatch.html

Oppdatere status på en oppgave

Status alene, oppgave ferdig utført i eksternt system (Task.status)

Dersom oppgavene er av type generisk oppgave der innbygger utfører oppgaven i sin helhet i et system utenfor Helsenorge, skal eksternt system sette oppgaven til “completed” når den er utført. Normalt ønsker man da også å undertrykke at innbygger varsles om denne tilstandsendringen da innbygger allerede “vet” dette etter å ha utført oppgaven i det eksterne systemet.

FHIR ressursen Parameters kan ikke ha andre metadata enn “varsling”.

<Parameters xmlns="http://hl7.org/fhir">
    <meta>
        <tag>
            <system value="http://helsenorge.no/fhir/varsling"/>
            <code value="1"/>
            <display value="Innbygger skal ikke varsles."/>
        </tag>
    </meta>
    <parameter>
        <name value="operation"/>
        <part>
            <name value="type"/>
            <valueCode value="replace"/>
        </part>
        <part>
            <name value="path"/>
            <valueString value="Task.status"/>
        </part>
        <part>
            <name value="value"/>
            <valueCode value="completed"/>
        </part>
    </parameter>
</Parameters>

Oppdatere status samtidig som man setter en grunn for statusendringen (Task.status + Task.statusReason)

Eks, en tidligere tilsendt oppgave kanselleres.

<Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <name value="operation"/>
        <part>
            <name value="type"/>
            <valueCode value="replace"/>
        </part>
        <part>
            <name value="path"/>
            <valueString value="Task.status"/>
        </part>
        <part>
            <name value="value"/>
            <valueCode value="cancelled"/>
        </part>
    </parameter>
    <parameter>
        <name value="operation"/>
        <part>
            <name value="type"/>
            <valueCode value="replace"/>
        </part>
        <part>
            <name value="path"/>
            <valueString value="Task.statusReason"/>
        </part>
        <part>
            <name value="value"/>
            <part>
                <name value="text"/>
                <valueString value="Oppgaven er kansellert fordi timen er utsatt på ubestemt tid."/>
            </part>
        </part>
    </parameter>
</Parameters>

Legge til en note (Task.note)

Det kan legges til en eller flere noter til en oppgave. Disse skal tidsstemples. Innbygger vil kunne se disse.

<?xml version="1.0" encoding="UTF-8"?>
<Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <name value="operation"/>
        <part>
            <name value="type"/>
            <valueCode value="add"/>
        </part>
        <part>
            <name value="path"/>
            <valueString value="Task"/>
        </part>
        <part>
            <name value="name"/>
            <valueString value="note"/>
        </part>
        <part>
            <name value="value"/>
            <valueAnnotation>
                <time value="2021-12-10T14:03:42.8007888+02:00"/>
                <text value="Oppgavens frist er utsatt da timen er flyttet"/>
            </valueAnnotation>
        </part>
    </parameter>
</Parameters>

Endre oppgavens frist(er)

Tidsrommet man ønsker at innbygger skal utføre en oppgave angis. Oppgaver skal minimum ha en sluttdato, men kan også ha en startdato som den ikke kan utføres før. (Dette siste kommer i H1 2022). I tillegg finnes en extension til Task på Helsenorge der man kan angi en absolutt frist for oppgaven (deadline). Oppgavens frister er definert i elementet Task.restriction.

Endre sluttdato og legge til årsak (note)

Endre alle frister

I dette eksemplet endres både startdato, sluttdato og extension for deadline.

Endre oppgavens beskrivelse og legge til note

I dette eksemplet endres oppgaven beskrivelse samt at det legges til en not som forklarer hvorfor beskrivelsen er endret.

Endre referanse til Helsenorge-element

Det er tre måter å endre referanse til Helsenorge-element i oppgave på:

Legge til en eller flere referanser
Slette alle referanser
Bytte ut (slett + legg til)

Legge til referanse

I dette eksempelet skal det legges til en referanse på en oppgave. Identifier på referansen peker på et Helsenorge-element.

Fjerne referanse

I dette eksempelet skal alle eksisterende elementreferanser på oppgaven slettes.

Bytte ut referanse

I dette eksempelet skal eksisterende referanser byttes ut med referansene i oppdateringen. Utbytting gjøres ved å slette eksisterende referanser og legge til ny(e) referanser