This page is part of the FHIR Specification (v1.6.0: STU 3 Ballot 4). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
. Page versions: R5 R4B R4 R3

Detailed Descriptions for the elements in the Task resource.
| Task | |
| Definition | A task to be performed. |
| Control | 1..1 |
| Invariants | Defined on this element inv-1: Last modified date must be greater than or equal to created date. (expression : lastModified >= created, xpath: f:lastModified >= f:created) |
| Task.identifier | |
| Definition | The business identifier for this task. |
| Note | This is a business identifer, not a resource identifier (see discussion) |
| Control | 0..1 |
| Type | Identifier |
| Task.basedOn | |
| Definition | Identifies a plan, proposal or order that this task has been created in fulfillment of. |
| Control | 0..* |
| Type | Reference(Any) |
| Summary | true |
| Task.requisition | |
| Definition | An identifier that links together multiple tasks and other requests that were created in the same context. |
| Control | 0..1 |
| Type | Identifier |
| Requirements | Billing and/or reporting can be linked to whether multiple requests were created as a single unit. |
| Summary | true |
| Task.parent | |
| Definition | Task that this particular task is part of. |
| Control | 0..* |
| Type | Reference(Task) |
| Requirements | Allows tasks to be broken down into sub-steps (and this division can occur independent of the original task). |
| Summary | true |
| Comments | This should usually be 0..1. |
| Task.status | |
| Definition | The current status of the task. |
| Control | 1..1 |
| Binding | TaskStatus: The current status of the task. (Required) |
| Type | code |
| Requirements | These states enable coordination of task status with off-the-shelf workflow solutions that support automation of tasks. |
| Summary | true |
| Task.statusReason | |
| Definition | An explanation as to why this task is held, failed, was refused, etc. |
| Control | 0..1 |
| Type | CodeableConcept |
| Summary | true |
| Comments | This applies to the current status. Look at the history of the task to see reasons for past statuses. |
| Task.businessStatus | |
| Definition | Contains business-specific nuances of the business state. |
| Control | 0..1 |
| Binding | TaskBusinessStatus: The domain-specific business-contextual sub-state of the task. For example: "Blood drawn", "IV inserted", "Awaiting physician signature", etc. |
| Type | CodeableConcept |
| Requirements | There's often a need to track substates of a task - this is often variable by specific workflow implementation. |
| Summary | true |
| Task.stage | |
| Definition | Indicates the "level" of actionability associated with the Task. I.e. Is this a proposed task, a planned task, an actionable task, etc. |
| Control | 1..1 |
| Binding | Task Stage Codes: Distinguishes whether the task is a proposal, plan or full order (Extensible) |
| Type | CodeableConcept |
| Summary | true |
| Comments | This element is immutable. Proposed tasks, planned tasks, etc. must be distinct instances. |
| Task.code | |
| Definition | A name or code (or both) briefly describing what the task involves. |
| Control | 0..1 |
| Type | CodeableConcept |
| Summary | true |
| Task.priority | |
| Definition | The priority of the task among other tasks of the same type. |
| Control | 0..1 |
| Binding | TaskPriority: The task's priority (Required) |
| Type | code |
| Meaning if Missing | If missing, this task should be performed with normal priority |
| Requirements | Used to identify the service level expected while performing a task. |
| Task.description | |
| Definition | A free-text description of what is to be performed. |
| Control | 0..1 |
| Type | string |
| Summary | true |
| Task.focus | |
| Definition | The request being actioned or the resource being manipulated by this task. |
| Control | 0..1 |
| Type | Reference(Any) |
| Requirements | Used to identify the thing to be done. |
| Summary | true |
| Comments | If multiple resources need to be manipulated, use sub-tasks. (This ensures that status can be tracked independently for each referenced resource.). |
| Task.for | |
| Definition | The entity who benefits from the performance of the service specified in the task (e.g., the patient). |
| Control | 0..1 |
| Type | Reference(Any) |
| Requirements | Used to track tasks outstanding for a beneficiary. Do not use to track the task owner or creator (see owner and creator respectively). This can also affect access control. |
| Alternate Names | Patient |
| Summary | true |
| Task.context | |
| Definition | The healthcare event (e.g. a patient and healthcare provider interaction) during which this task was created. |
| Control | 0..1 |
| Type | Reference(Encounter | EpisodeOfCare) |
| Requirements | For some tasks it may be important to know the link between the task or episode of care the task originated within. |
| Summary | true |
| Task.created | |
| Definition | The date and time this task was created. |
| Control | 1..1 |
| Type | dateTime |
| Requirements | Most often used along with lastUpdated to track duration of task to supporting monitoring and management. |
| Alternate Names | Created Date |
| Invariants | Affect this element inv-1: Last modified date must be greater than or equal to created date. (expression : lastModified >= created, xpath: f:lastModified >= f:created) |
| Task.lastModified | |
| Definition | The date and time of last modification to this task. |
| Control | 1..1 |
| Type | dateTime |
| Requirements | Used along with history to track task activity and time in a particular task state. This enables monitoring and management. |
| Alternate Names | Update Date |
| Summary | true |
| Invariants | Affect this element inv-1: Last modified date must be greater than or equal to created date. (expression : lastModified >= created, xpath: f:lastModified >= f:created) |
| Task.requester | |
| Definition | The creator of the task. |
| Control | 1..1 |
| Type | Reference(Device | Organization | Patient | Practitioner | RelatedPerson) |
| Requirements | Identifies who created this task. May be used by access control mechanisms (e.g., to ensure that only the creator can cancel a task). |
| Alternate Names | Initiator; Author |
| Summary | true |
| Task.owner | |
| Definition | The owner of this task. The participant who can execute this task. |
| Control | 0..1 |
| Type | Reference(Device | Organization | Patient | Practitioner | RelatedPerson) |
| Requirements | Identifies who is expected to perform this task. |
| Alternate Names | Performer; Executer |
| Summary | true |
| Comments | Tasks may be created with an owner not yet identified. |
| Task.performerType | |
| Definition | The type of participant that can execute the task. |
| Control | 0..* |
| Binding | TaskPerformerType: The type(s) of task performers allowed (Preferred) |
| Type | CodeableConcept |
| Requirements | Use to distinguish tasks on different activity queues. |
| Task.reason | |
| Definition | A description or code indicating why this task needs to be performed. |
| Control | 0..1 |
| Binding | TaskReason: Indicates why the task is needed. E.g. Suspended because patient admitted to hospital. |
| Type | CodeableConcept |
| Comments | This should only be included if there is no focus or if it differs from the reason indicated on the focus. |
| Task.note | |
| Definition | Free-text information captured about the task as it progresses. |
| Control | 0..* |
| Type | Annotation |
| Task.fulfillment | |
| Definition | Identifies any limitations on what part of a referenced task subject request should be actioned. |
| Control | 0..1 |
| Requirements | Sometimes when fulfillment is sought, you don't want full fulfillment. |
| Task.fulfillment.repetitions | |
| Definition | Indicates the number of times the requested action should occur. |
| Control | 0..1 |
| Type | positiveInt |
| Requirements | E.g. order that requests monthly lab tests, fulfillment is sought for 1. |
| Task.fulfillment.period | |
| Definition | Over what time-period is fulfillment sought. |
| Control | 0..1 |
| Type | Period |
| Requirements | E.g. order that authorizes 1 year's services. Fulfillment is sought for next 3 months. |
| Task.fulfillment.recipients | |
| Definition | For requests that are targeted to more than on potential recipient/target, for whom is fulfillment sought? |
| Control | 0..* |
| Type | Reference(Patient | Practitioner | RelatedPerson | Group | Organization) |
| To Do | Is this in the 80%? |
| Task.definition | |
| Definition | A reference to a formal or informal definition of the task. For example, a protocol, a step within a defined workflow definition, etc. |
| Control | 0..1 |
| Type | uri |
| Requirements | Enables a formal definition of how he task is to be performed (e.g. using BPMN, BPEL, XPDL or other formal notation) to be associated with a task, enabling automation. |
| Summary | true |
| Task.input | |
| Definition | Additional information that may be needed in the execution of the task. |
| Control | 0..* |
| Requirements | Resources and data used to perform the task. This data is used in the business logic of task execution, and is stored separately because it varies between workflows. |
| Alternate Names | Supporting Information |
| Task.input.type | |
| Definition | A code or description indicating how the input is intended to be used as part of the task execution. |
| Control | 1..1 |
| Binding | TaskInputParameterType: Codes to identify types of input parameters. These will typically be specific to a particular workflow. E.g. "Comparison source", "Applicable consent", "Concommitent Medications", etc. |
| Type | CodeableConcept |
| Requirements | Inputs are named to enable task automation to bind data and pass it from one task to the next. |
| Alternate Names | Name |
| Comments | If referencing a BPMN workflow or Protocol, the "system" is the URL for the workflow definition and the code is the "name" of the required input. |
| Task.input.value[x] | |
| Definition | The value of the input parameter as a basic type. |
| Control | 1..1 |
| Type | * |
| [x] Note | See Choice of Data Types for further information about how to use [x] |
| Task.output | |
| Definition | Outputs produced by the Task. |
| Control | 0..* |
| Requirements | Resources and data produced during the execution the task. This data is generated by the business logic of task execution, and is stored separately because it varies between workflows. |
| Task.output.type | |
| Definition | The name of the Output parameter. |
| Control | 1..1 |
| Binding | TaskOutputParameterType: Codes to identify types of input parameters. These will typically be specific to a particular workflow. E.g. "Identified issues", "Preliminary results", "Filler order", "Final results", etc. |
| Type | CodeableConcept |
| Requirements | Outputs are named to enable task automation to bind data and pass it from one task to the next. |
| Alternate Names | Name |
| Task.output.value[x] | |
| Definition | The value of the Output parameter as a basic type. |
| Control | 1..1 |
| Type | * |
| [x] Note | See Choice of Data Types for further information about how to use [x] |
| Requirements | Task outputs can take any form. |