Prototype

TASK_CANCEL(task_reference)

The action executed by this FORMULA depends on the type of TASK:

If task_reference refers to an EDUCATIONAL TASK, then it will be deleted (this behavior was introduced in API Version 2.7.25).
Otherwise the status of the TASK will change to "CANCELLED". The TASK must be in the current ADMISSION. If task_reference refers to a TASK that is not open, this function will do nothing.

Input Parameters

Parameter

Type

Default

Description

task_reference

Number, String, Array

Reference to a TASK OBJECT. Accepted values:

The TASK reference or TASK_CODE is searched only in the current ADMISSION (the one where the formula is executed).

Return value

This function does not return a value

Execution

On closing the form. The ITEM containing this FORMULA must be defined as type 'ACTION' (which are always executed when a FORM is closed)

Examples

Formula	Description
TASK_CANCEL(12322)	Deletes the TASK with reference 12322
TASK_CANCEL("MANEUVER:BAS")	Deletes all open TASKs of the current ADMISSION whose TASK_CODE is "MANEUVER:BAS"
TASK_CANCEL(ADMISSION.TASK{MANEUVER:BAS}.REF, 0)	Deletes all the TASKs in the current ADMISSION whose TASK_CODE is "MANEUVER:BAS" (see OBJECT CODES)
TASK_CANCEL(["MANEUVER:BAS", "DRUG_INTAKE"])	Deletes all open TASKs of the current ADMISSION whose TASK_CODE is "MANEUVER:BAS" or "DRUG_INTAKE"