STU 3 Candidate

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

5.33.12 Resource Task - Operations

This resource has 11 operations associated with it:

$reserveReserve Task
$startStart Task
$finishFinish Task
$failFail Task
$releaseRelease Task
$suspendSuspend Task
$resumeResume Task
$cancelCancel Task
$stopStop Task
$set-inputSet Task Input
$set-outputSet Task Output

For more information about operations, including how they are invoked, see Operations.

5.33.12.1 Reserve Task

Reserve this task for the specified entity. Makes the specified entity the task owner, and transitions the task to the Ready state. This operation may be used by an entity to claim a task for itself, or to delegate or forward the task to another entity.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$reserve

In Parameters:
NameCardinalityTypeBindingProfileDocumentation
owner1..1Reference(Device | Organization | Patient | Practitioner | RelatedPerson )

The entity who is to be assigned ownership of this task.

 

5.33.12.2 Start Task

Start this task by the specified entity (or if none specified, by the present task owner). If an owner is specified, that owner is assigned as the task owner. The task is transitioned to the In Progress state.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$start

In Parameters:
NameCardinalityTypeBindingProfileDocumentation
owner0..1Reference(Device | Organization | Patient | Practitioner | RelatedPerson )

The entity who is to be assigned ownership of this task. If no entity is provided, the ownership of the task remains unchanged.

 

5.33.12.3 Finish Task

Finish this task. The task is transitioned to the completed state.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$finish

 

5.33.12.4 Fail Task

Fail this task. The task is transitioned to the failed state.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$fail

In Parameters:
NameCardinalityTypeBindingProfileDocumentation
reason0..1CodeableConcept

The reason for failure. If present, this is assigned to the failureReason property of the task.

 

5.33.12.5 Release Task

Release a previously reserved task. The task owner is cleared and the task is transitioned to the Ready state.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$release

 

5.33.12.6 Suspend Task

Place a hold on any activity for this task until it is subsequently resumed. The task remains in its current state but is marked as being suspended, indicating that no additional activity should b performed. If the task has subtasks, these are also suspended.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$suspend

 

5.33.12.7 Resume Task

Indicate that activity on this task can now be resumed. Removes the mark that the task is suspended, and propgates the resume to any child tasks.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$resume

 

5.33.12.8 Cancel Task

Cancel the task. Set the status of the task to cancelled.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$cancel

 

5.33.12.9 Stop Task

Stop processing the task. The task is returned to the ready state.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$stop

 

5.33.12.10 Set Task Input

Set one of the inputs for a task.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$set-input

In Parameters:
NameCardinalityTypeBindingProfileDocumentation
input1..*
input.name1..1 (string

The name of the input to add or update.

input.value[x]0..1*

If no value is provided, any current input with that name is removed from the resource.

 

5.33.12.11 Set Task Output

Set one of the outputs of a task.

Formal Definition (as a OperationDefinition).

URL: [base]/Task/[id]/$set-output

Out Parameters:
NameCardinalityTypeBindingProfileDocumentation
output1..*
output.name1..1 (string

The name of the output to add or update.

output.value[x]0..1*

If no value is provided, any current output with that name is removed from the resource.