Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 29 Next »

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)

<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.restriction"/>
        </part>
        <part>
            <name value="value"/>
            <part>
                <name value="period"/>
                <valuePeriod>
                    <end value="2021-12-24T16:00:00+02:00"/>
                </valuePeriod>
            </part>
        </part>
    </parameter>
    <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 alle frister

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

<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.restriction"/>
        </part>
        <part>
            <name value="value"/>
            <part>
                <name value="extension"/>
                <part>
                    <name value="url"/>
                    <valueUri value="http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline"/>
                </part>
                <part>
                    <name value="value"/>
                    <valueDate value="2021-12-10"/>
                </part>
            </part>
            <part>
                <name value="period"/>
                <valuePeriod>
                    <start value="2021-12-12T16:00:00+02:00"/>
                    <end value="2021-12-24T16:00:00+02:00"/>
                </valuePeriod>
            </part>
        </part>
    </parameter>
</Parameters>

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.

<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.description"/>
        </part>
        <part>
            <name value="value"/>
            <valueString value="Ny/endret beskrivelse for oppgaven (...)"/>
        </part>
    </parameter>
    <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 beskrivelse er endret fordi (...)"/>
            </valueAnnotation>
        </part>
    </parameter>
</Parameters>

Endre referanse til Helsenorge-element

Legge til referanse

I dette eksempelet skal det legges til en referanse til en oppgave som allerede har en referanse til et Helsenorge-element.

<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="basedOn" />
        </part>
        <part>
            <name value="value" />
            <valueReference>
                <type value="Appointment" />
                <identifier>
                    <system value="urn:ietf:rfc:3986" />
                    <value value="urn:uuid:b134a864-e412-4aa7-11a1-22a0b1da4ac0" />
                </identifier>
                <display value="Timeavtale" />
            </valueReference>
        </part>
    </parameter>
</Parameters

Fjerne referanse

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

Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <name value="operation" />
        <part>
            <name value="type" />
            <valueCode value="delete" />
        </part>
        <part>
            <name value="path" />
            <valueString value="Task" />
        </part>
        <part>
            <name value="name" />
            <valueString value="basedOn" />
        </part>
    </parameter>
</Parameters>

Bytte ut referanse

I dette eksempelet skal eksisterende referanse(r) byttes ut med referansen(e) i oppdateringen. (Her timeavtalemed ny ID)

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" />
        </part>
        <part>
            <name value="name" />
            <valueString value="basedOn" />
        </part>
        <part>
            <name value="value" />
            <valueReference>
                <type value="Appointment" />
                <identifier>
                    <system value="urn:ietf:rfc:3986" />
                    <value value="urn:uuid:ba660d99-f962-4f49-8a22-ffa79ebd8a60" />
                </identifier>
                <display value="Timeavtale" />
            </valueReference>
        </part>
    </parameter>
</Parameters>
  • No labels