Task - FHIR Resource (stu3)
This Task Resource uses the
FHIR API standard for access and structure.
Validate an Task FHIR Resource (stu3)
Task Attributes
AttributeField is listTypeDescription
Description: Constraints on fulfillment tasks
Attribute Type : Data Type
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Task Type
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Start and end time of execution
Attribute Type : Period
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"executionPeriod":
Description: What task is acting on
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Reason for current status
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: "owner" : { Reference(Device|Organization|Patient|Practitioner|
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: "definitionReference" : { Reference(ActivityDefinition) },
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"definitionReference":
Description: normal | urgent | asap | stat
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Beneficiary of the Task
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Request fulfilled by this task
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Comments made about the task
Attribute Type : Annotation
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Information used to perform task
Attribute Type : Data Type
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: draft | requested | received | accepted | +
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Human-readable explanation of task
Attribute Type : string
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Requisition or grouper id
Attribute Type : Identifier
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"groupIdentifier":
Description: "definitionUri" : "<uri>",
Attribute Type : uri
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Why task is needed
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: proposal | plan | order +
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Key events in history of the Task
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"relevantHistory":
Description: Who is asking for task to be done
Attribute Type : Data Type
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: E.g. "Specimen collected", "IV prepped"
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"businessStatus":
Description: C? Task Creation Date
Attribute Type : dateTime
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: requester | dispatcher | scheduler | performer | monitor | manager | acquirer | reviewer
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: C? Task Last Modified Date
Attribute Type : dateTime
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Healthcare event during which this task originated
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Information produced as part of task
Attribute Type : Data Type
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Task Instance Identifier
Attribute Type : Identifier
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Composite task
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Task Structure
{
"resourceType" : "Task",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Task Instance Identifier
// definition[x]: Formal definition of task. One of these 2:
"definitionUri" : "<uri>",
"definitionReference" : { Reference(ActivityDefinition) },
"basedOn" : [{ Reference(Any) }], // Request fulfilled by this task
"groupIdentifier" : { Identifier }, // Requisition or grouper id
"partOf" : [{ Reference(Task) }], // Composite task
"status" : "<code>", // R! draft | requested | received | accepted | +
"statusReason" : { CodeableConcept }, // Reason for current status
"businessStatus" : { CodeableConcept }, // E.g. "Specimen collected", "IV prepped"
"intent" : "<code>", // R! proposal | plan | order +
"priority" : "<code>", // normal | urgent | asap | stat
"code" : { CodeableConcept }, // Task Type
"description" : "<string>", // Human-readable explanation of task
"focus" : { Reference(Any) }, // What task is acting on
"for" : { Reference(Any) }, // Beneficiary of the Task
"context" : { Reference(Encounter|EpisodeOfCare) }, // Healthcare event during which this task originated
"executionPeriod" : { Period }, // Start and end time of execution
"authoredOn" : "<dateTime>", // C? Task Creation Date
"lastModified" : "<dateTime>", // C? Task Last Modified Date
"requester" : { // Who is asking for task to be done
"agent" : { Reference(Device|Organization|Patient|Practitioner|
RelatedPerson) }, // R! Individual asking for task
"onBehalfOf" : { Reference(Organization) } // Organization individual is acting for
},
"performerType" : [{ CodeableConcept }], // requester | dispatcher | scheduler | performer | monitor | manager | acquirer | reviewer
"owner" : { Reference(Device|Organization|Patient|Practitioner|
RelatedPerson) }, // Responsible individual
"reason" : { CodeableConcept }, // Why task is needed
"note" : [{ Annotation }], // Comments made about the task
"relevantHistory" : [{ Reference(Provenance) }], // Key events in history of the Task
"restriction" : { // Constraints on fulfillment tasks
"repetitions" : "<positiveInt>", // How many times to repeat
"period" : { Period }, // When fulfillment sought
"recipient" : [{ Reference(Patient|Practitioner|RelatedPerson|Group|
Organization) }] // For whom is fulfillment sought?
},
"input" : [{ // Information used to perform task
"type" : { CodeableConcept }, // R! Label for the input
// value[x]: Content to use in performing the task. One of these 23:
"valueInteger" : <integer>
"valueDecimal" : <decimal>
"valueDateTime" : "<dateTime>"
"valueDate" : "<date>"
"valueInstant" : "<instant>"
"valueString" : "<string>"
"valueUri" : "<uri>"
"valueBoolean" : <boolean>
"valueCode" : "<code>"
"valueBase64Binary" : "<base64Binary>"
"valueCoding" : { Coding }
"valueCodeableConcept" : { CodeableConcept }
"valueAttachment" : { Attachment }
"valueIdentifier" : { Identifier }
"valueQuantity" : { Quantity }
"valueRange" : { Range }
"valuePeriod" : { Period }
"valueRatio" : { Ratio }
"valueHumanName" : { HumanName }
"valueAddress" : { Address }
"valueContactPoint" : { ContactPoint }
"valueSchedule" : { Schedule }
"valueReference" : { Reference }
}],
"output" : [{ // Information produced as part of task
"type" : { CodeableConcept }, // R! Label for output
// value[x]: Result of output. One of these 23:
"valueInteger" : <integer>
"valueDecimal" : <decimal>
"valueDateTime" : "<dateTime>"
"valueDate" : "<date>"
"valueInstant" : "<instant>"
"valueString" : "<string>"
"valueUri" : "<uri>"
"valueBoolean" : <boolean>
"valueCode" : "<code>"
"valueBase64Binary" : "<base64Binary>"
"valueCoding" : { Coding }
"valueCodeableConcept" : { CodeableConcept }
"valueAttachment" : { Attachment }
"valueIdentifier" : { Identifier }
"valueQuantity" : { Quantity }
"valueRange" : { Range }
"valuePeriod" : { Period }
"valueRatio" : { Ratio }
"valueHumanName" : { HumanName }
"valueAddress" : { Address }
"valueContactPoint" : { ContactPoint }
"valueSchedule" : { Schedule }
"valueReference" : { Reference }
}]
}
Task Search Parameters
The following search parameters can be used to query Task resources. Just submit them like so:
https://api.1up.health/fhir/stu3/Task?query-param=queryvalue
Search Parameter | Field Type | Resource Fields Searched |
---|
authored-on | date | authoredOn |
based-on | reference | basedOn |
business-status | text | businessStatus |
code | text | code |
context | reference | context |
focus | reference | focus |
group-identifier | text | groupIdentifier |
identifier | text | identifier |
intent | text | intent |
modified | date | lastModified |
organization | reference | requester.onBehalfOf |
owner | reference | owner |
part-of | reference | partOf |
patient | reference | for |
performer | text | performerType |
period | date | executionPeriod |
priority | text | priority |
requester | reference | requester.agent |
status | text | status |
subject | reference | for |