Task

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
resource-originC0..1Extension(Reference(KT2_Device))
instantiatesC0..*Extension(Reference(KT2_ActivityDefinition))
modifierExtension?! C0..*Extension
identifier1..*Identifier
instantiatesCanonicalΣ0..1canonical(KT2_ActivityDefinition)
instantiatesUriΣ0..0uri
basedOnΣ C0..0Reference(Resource)
groupIdentifierΣ0..0Identifier
partOfΣ C0..*Reference(KT2_Task)
statusΣ ?!1..1codeBinding
statusReasonΣ0..0CodeableConcept
businessStatusΣ0..0CodeableConcept
intentΣ1..1codeBinding
priority0..1codeBindingFixed Value
codeΣ0..1CodeableConceptBinding
descriptionΣ0..1string
focusΣ C0..0Reference(Resource)
forΣ C1..1Reference(KT2_Patient)
encounterΣ C0..0Reference(Encounter)
executionPeriodΣ C0..1Period
authoredOnC0..1dateTime
lastModifiedΣ C0..1dateTime
requesterΣ C0..1Reference(KT2_Practitioner)
performerType0..0CodeableConceptBinding
ownerΣ C1..1Reference(KT2_CareTeam | KT2_Patient | KT2_Practitioner | KT2_RelatedPerson)
locationΣ C0..0Reference(Location)
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Resource)
insuranceC0..0Reference(ClaimResponse | Coverage)
note0..0Annotation
relevantHistoryC0..0Reference(Provenance)

Reference to ActivityDefinition

⚠️ Warning As of 2023-11-02 the way the ActivityDefinition is referenced is changed!

A Task should refer to the ActivityDefinition it instantiates. This provides the possibility to search for Tasks that instantiate a specific instance of an ActivityDefinition, which in turn can be found based on its publisherId.

Using the element instantiatesCanonical does not however allow chaining of the search parameters. Therefore this profile contains an extension instantiates which should hold the reference to the instantiated ActivityDefinition.

The element instantiatesCanonical should not be used for this reference. Receivers of a Task instance can ignore any value in the instantiatesCanonical and should look for the referred ActivityDefinition in the instantiates extension.

KT2_Task.owner

KT2_Task.owner determines which actor is the executor of the respective task.

The RelatedPerson can be assigned as the owner of a task either directly or through a CareTeam.

KT2_Task.partOf

This element is used to indicate the reference of a subtask to the main task. The main task is assigned to the patient through KT2_Task.owner= Reference (KT2_Patient). The subtask is created as follows:

  • KT2_Task.partOf` references the main task
  • The KT2_RelatedPerson who assists becomes the Task.owner
  • KT2_Task.forreferences thePatient` of the main task

KT2_Task.code

With the KT2_Task.code element the permission of a KT2_Task can be set to view. The exact meaning of the view permission can differ per application because authorisations in Koppeltaal 2.0 are defined and executed by the applications.

Validation: Task with read-only permissions

A digital intervention with read-only permissions must be related to another task where the owner has write permissions. When a Task with read-only permissions is created (indicated by Task.code = view), the following validations MUST be performed:

Applications MUST validate that:

  • Task.partOf is present
  • Task.partOf contains a reference to a Task where Task.code is absent
  • Task.for is equal to the Task.for of the Task referenced in Task.partOf

If these validations are not met, the Task with read-only permissions MUST NOT be assigned.

Example

This example shows a subtask for the RelatedPerson assigned in the Task of the patient.

{
    "resourceType" : "Task",
    "meta" : {
        "profile" : [
            "http://koppeltaal.nl/fhir/StructureDefinition/KT2Task"
        ]
    },
    "extension" : [
        {
            "url" : "http://vzvz.nl/fhir/StructureDefinition/instantiates",
            "valueReference" : {
                "reference" : "ActivityDefinition/8635519a-3ca5-4dc8-bd07-4ec1e7fefcd5",
                "type" : "ActivityDefinition"
            }
        }
    ],
    "identifier" : [
        {
            "use" : "official",
            "system" : "http:/vzvz.nl/Testtooling",
            "value" : "Vragenlijst${IdentifierValue}"
        }
    ],
    "description" : "Vul de vragenlijst zo goed mogelijk in. Dit kost ongeveer 10 minuten.",
    "partOf" : [{
        "reference" : "Task/1f2f427a-d7fd-4b91-809c-f4607365ce73",
        "type" : "Task"
    }],
    "for" : {
        "reference" : "Patient/810c315e-4720-4253-8369-1011f87691b6",
        "type" : "Patient"
    },
    "intent" : "order",
    "priority" : "routine",
    "code" : {
        "coding" : [
            {
                "system" : "http://vzvz.nl/fhir/CodeSystem/koppeltaal-task-code",
                "code" : "view",
                "display" : "This task can be viewed"
            }
        ]
    },
    "executionPeriod" : {
        "start" : "2024-07-20T08:25:05+02:00"
    },
    "requester" : {
        "reference" : "Practitioner/8849c230-5f03-4aab-83a0-8295dfc6000b",
        "type" : "Practitioner"
    },
    "owner" : {
        "reference" : "RelatedPerson/355651f0-2b28-4bf7-800d-0bbe4d96d793",
        "type" : "RelatedPerson"
    },
    "status" : "ready",
    "authoredOn" : "2024-07-30T08:25:05+02:00",
    "lastModified" : "2024-07-30T09:45:05+02:00"
}