FHIR Artifacts > Structure Definition: Task Profile

Structure Definition: Task Profile

Canonical URL:http://ehealthontario.ca/fhir/StructureDefinition/ca-on-eReferral-profile-Task

Simplifier project page: Task

Derived from: Task (CA:eReC)

Base FHIR: Task (R4)

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work

Hybrid View

identifier0..*Identifier
instantiatesCanonicalΣ0..1canonical(ActivityDefinition)
instantiatesUriΣ0..1uri
groupIdentifierΣ0..1Identifier
partOfΣ0..*Reference(Task)
statusS Σ ?!1..1codeBinding
statusReasonΣ0..1CodeableConcept
intentS Σ1..1codeBindingPattern
priority0..1codeBinding
descriptionΣ0..1string
focusΣ0..1Reference(Resource)
forΣ0..1Reference(Resource)
encounterΣ0..1Reference(Encounter)
executionPeriodΣ0..1Period
authoredOnS I0..1dateTime
lastModifiedS Σ I0..1dateTime
requesterΣ0..1Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
performerType0..*CodeableConceptBinding
locationΣ0..1Reference(Location)
reasonCode0..1CodeableConcept
reasonReference0..1Reference(Resource)
insurance0..*Reference(Coverage | ClaimResponse)
note0..*Annotation
relevantHistory0..*Reference(Provenance)

Usage

The Task resource is used as follows in this IG:

  • a "Process Request" Task ("Task.code": "process-request") SHALL be used by an RMS Target to track and communicate the status of a referral request to the RMS Source

  • a "Process Request Consult" Task ("Task.code": "process-request-consult") SHALL be used by an RMS Target to track and communicate the status of a consult request to the RMS Source

Each Task SHALL reference the ServiceRequest it is basedOn.

Using Task for ServiceRequest Documentation
Documenting reasons provider recommendations were overridden
An example of this is when a Central Intake Hub routes a referral to someone other than was suggested by the Provincial Care Coordination Gateway (PCCG). The Central Intake Hub would be expected to document the rationale for overriding the recommended providers supplied by the PCCG:

  • MeessageEvent.code="notify-update-process-request"
  • Focus=Task Bundle
  • Task.code="data-process-documentation"
  • Task.output.type="RoutingOverrideReason"
  • Task.output.value.display=[value from RoutingOverrideReason]
  • Task.output.type="RoutingDestination"
  • Task.output.value.display=[text describing who the referral was routed to]
  • Task.output.type="RoutingOverrideComment"
  • Task.output.value.display=[comment indicating why routing recommendations were overriden]

Documenting the amount of time a provider spent on consultation
Additional Task outputs would be added to the consultation task:
  • MeessageEvent.code="notify-update-process-request"
  • Focus=Task Bundle
  • Task.output.type="ConsultationTime"
  • Task.output.value.display=[time spent on the consultation in minutes]
  • Task.output.type="ConsultationTimeComments"
  • Task.output.value.display=[additional comments relating to time spent on the consultation]

Notes

.id

  • used to uniquely identify the resource
  • if a persistent identity for the resource is not available to use when constructing a message Bundle for transmission via Direct Messaging, a UUID SHOULD be used in this element (with a corresponding value in Bundle.entry.fullUrl)

.meta.profile

  • used to declare conformance to this profile
  • populate with a fixed value: `http://ehealthontario.ca/fhir/StructureDefinition/ca-on-eReferral-profile-Task|1.1.0'

.extension:PatientNeedsToBeSeen

  • For eConsult: when a Performer (Specialist) responds to a consult request suggesting an eReferral, SHALL be set to true

.basedOn

  • used to associate the Task with the ServiceRequest being performed
  • SHALL be populated with a reference to the ServiceRequest being performed
  • if the Task is being transmitted via messaging, the referenced ServiceRequest resource SHALL be included in the message as a Bundle.entry

.status

  • for a "Process Request" Task, used to track the status of the ServiceRequest being performed as work progresses through to completion see - state machine
  • for a "Request for Information" Task, used to track the status of the request for information

.businessStatus

  • for a "Process Request" Task businessStatus.text or businessStatus.code (extensible) MAY be used to communicate deployment specific status information

.intent

  • populate with "proposal"

.code

  • identifies the type of task
  • SHALL always be populated
    • with "process-request" for a "Process Request" Task
    • with "process-request-consult" for a "Process Request" eConsult Task

.description (for further discussion)

  • where .code is "request-for-information-for-requester" MAY include a free-text description of what is needed

.authoredOn

  • indicates the dateTime that the eReferral was received by the RMS
  • usually the same as ServiceRequest.authoredOn, except in cases when ServiceRequest.authoredOn is used to record that a request was signed by the requester before the transmission took place

.lastModified

  • indicates the dateTime when an update of note/significance was made to the referral (i.e., related resources such as ServiceRequest, patient, Task, Appointment, etc...)

.owner

  • a reference to the person or organization responsible for handling the referral
  • if the Task is being transmitted via messaging, the referenced PractitionerRole resource SHALL be included in the message as a Bundle.entry

.note

  • SHOULD be populated when a task is completed

.output

  • MAY to used to provide the outcome of a Referral
  • SHALL contain a reference to Communication when an eConsult is provided by a specialist

.output.valueReference

  • a reference to Communication (or potentially other resources)

  • if the Task is being transmitted via messaging, the referenced FHIR resource SHALL be included in the message as a Bundle.entry

  • For eConsult: When a consult is provided by a specialist .output.valueReference SHALL reference Communication

NOTE: Communication.payload.content can be string and/or attachment