Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Dette dokumentet er fortsatt under arbeid.

Table of Contents
minLevel1
maxLevel7

...

Oppdatere status på en oppgave

Status alene

...

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

...

UseCases:

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.

...

Dersom et eksternt system ønsker å kansellere en tidligere sendt oppgave, kan status settes til “cancelled”. (Kan/bør settes sammen med grunn for denne status, se under).

Eks. (completed):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”.

Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<Parameters <Parameters xmlns="http://hl7.org/fhir">
    <parameter><meta>
        <name value="operation"/><tag>
        <part>             <name <system value="typehttp://helsenorge.no/fhir/varsling"/>
            <valueCode<code value="replace1"/>

       </part>     <display value="Innbygger skal ikke <part>varsles."/>
        </tag>
   <name value="path"/></meta>
    <parameter>
       <valueString <name value="Taskoperation"/>
      
 </part>         <part>
            <name value="nametype"/>
            <valueString<valueCode value="statusreplace"/>
        </part>
        <part>
            <name value="valuepath"/>
            <valueCode<valueString value="completedTask.status"/>
        </part>
    </parameter>
</Parameters>

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

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Parameters xmlns="http://hl7.org/fhir"    <part>
            <name value="value"/>
    <parameter>         <name<valueCode value="operationcompleted"/>
        <part>
</part>
    </parameter>
</Parameters>

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

Eks, en tidligere tilsendt oppgave kanselleres.

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

...

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

Code Block
languagexml
<?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.note"/>
        </part>
        <part>
            <name value="name"/>
            <valueString value="timenote"/>
         </part>
        <part>
<part>            <name value="value"/>
           <valueDateTime <valueAnnotation>
                <time value="2021-12-10T14:03:42.8007888+02:00"/>
         </part>       <text value="Oppgavens frist <part>er utsatt da timen         <name value="name"er flyttet"/>
           <valueString value="text"/></valueAnnotation>
        </part>
        <part>
           <name value="value"/>
           <valueString value="Oppgavens frist er utsatt da timen er flyttet"/>
        </part>
   </parameter>
</Parameters></parameter>
</Parameters>

Endre oppgavens frist(er)

...

Endre sluttdato og legge til årsak (note)

<?
Code Block
languagexml
<Parameters versionxmlns="1.0" encoding="UTF-8"?>
<Parametershttp://hl7.org/fhir">
    <parameter>
        <name value="operation"/>
       xmlns="http://hl7.org/fhir"
 <part>
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"      xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd">
    <parameter>
        <name value="operation"/>         <part>
            <name value="type"/>
            <valueCode value="replace"/>
        </part>
        <part>
            <name value="path"/>
            <valueString value="Task.restriction.period"/>
        </part>
        <part>
            <name value="namevalue"/>
            <valueString value="end"/><part>
                <name </part>value="period"/>
          <part>      <valuePeriod>
      <name value="value"/>             <valueDateTime<end value="2021-12-24T16:00:00+02:00"/>
        </part>        </parameter>valuePeriod>
    <parameter>        </part>
 <name value="operation"/>      </part>
  <part>  </parameter>
    <parameter>
     <name value   <name value="operation"/>
        <part>
            <name value="type"/>
            <valueCode value="add"/>
        </part>
        <part>
            <name value="path"/>
            <valueString value="Task.note"/>
        </part>
        <part>
            <name value="name"/>
            <valueString value="timenote"/>
        </part>
        <part>
            <name value="value"/>
            <valueAnnotation>
   <valueDateTime             <time value="2021-12-10T14:03:42.8007888+02:00"/>
        </part>        <text <part>value="Oppgavens frist er utsatt da timen        <name value="name"er flyttet"/>
            <valueString value="text"/></valueAnnotation>
        </part>
        <part>
            <name value="value"/>
   </parameter>
</Parameters>

Endre alle frister

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

Code Block
languagexml
<Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <valueString<name value="Oppgavens frist er utsatt da timen er flyttet"/>operation"/>
        <part>
        </part>    <name </parameter>
</Parameters>

Endre alle frister

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

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Parametersvalue="type"/>
            <valueCode value="replace"/>
        xmlns="http://hl7.org/fhir"</part>
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation  <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.

Code Block
languagexml
<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

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.

Code Block
languagexml
<Parameters xmlns="http://hl7.org/fhir fhir-single.xsd">
    <parameter>
        <name value="operation" />
        <part>
            <name value="type" />
            <valueCode value="replaceadd" />
        </part>
        <part>
            <name value="path" />
            <valueString value="Task.restriction.period" />
        </part>
        <part>
            <name value="name" />
            <valueString value="startbasedOn" />
        </part>
        <part>
            <name value="value"/>
            <valueDateTime value="2021-12-12T16:00:00+02:00"value" />
        </part>    <valueReference>
    <part>             <name<type value="nameAppointment" />
            <valueString value="end"/>
    <identifier>
       </part>         <part>    <system value="urn:ietf:rfc:3986" />
      <name value="value"/>             <valueDateTime<value value="2021-12-24T16:00:00+02:00"/>urn:uuid:b134a864-e412-4aa7-11a1-22a0b1da4ac0" />
           </part>     </parameter>identifier>
       <parameter>         <name<display value="operationTimeavtale" />
        <part>    </valueReference>
        </part>
     <name value="type"/></parameter>
</Parameters>

Fjerne referanse

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

Code Block
languagexml
Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <valueCode<name value="replaceoperation" />
        </part>
        <part>
            <name value="pathtype" />
            <valueString<valueCode value="Task.restrictiondelete" />
        </part>
        <part>
            <name value="namepath" />
            <valueString value="hn-task-deadlineTask" />
        </part>
        <part>
            <name value="value"/>  <part>
            <valueDate<name value="2021-12-10name" />
        </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.

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Parameters<valueString value="basedOn" />
        xmlns="http://hl7.org/fhir"</part>
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation</parameter>
</Parameters>

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

Code Block
languagexml
<Parameters xmlns="http://hl7.org/fhir fhir-single.xsd">
    <parameter>
    <name value="operation"/>
    <part>         <name value="typeoperation" />
        <valueCode value="replace"/>     </part> <part>
   <part>         <name value="pathtype" />
         <valueString   <valueCode value="Taskdelete" />
        </part>
        <part>
            <name value="namepath" />
            <valueString value="descriptionTask" />
        </part>
        <part>
            <name value="valuename" />
            <valueString value="Ny/endret beskrivelse for oppgaven...."basedOn" />
        </part>
    </parameter>
    <parameter>
        <name value="operation" />
        <part>
            <name value="type" />
            <valueCode value="add" />
        </part>
        <part>
            <name value="path" />
            <valueString value="Task.note" />
        </part>
        <part>
            <name value="name"/> value="name" />
            <valueString value="basedOn" />
        </part>
        <part>
            <valueString<name value="timevalue" />
         </part>   <valueReference>
      <part>          <type  <name value="valueAppointment" />
             <valueDateTime value="2021-12-10T14:03:42.8007888+02:00"/>   <identifier>
          </part>         <part> <system value="urn:ietf:rfc:3986" />
        <name value="name"/>            <valueString<value value="text"urn:uuid:b134a864-e412-4aa7-11a1-22a0b1da4ac0" />
        </part>        </identifier>
    <part>            <name<display value="valueTimeavtale" />
           <valueString value="Oppgavens beskrivelse er endret fordi......"/> </valueReference>
        </part>
    </parameter>
</Parameters>