Changes the 'locked' state of a TASK. A locked TASK cannot be modified by the person to whom it is assigned. This means that any call form_set_answer() to modify a question of any FORM in the TASK will fail

Input Parameters

Parameter

Type

Default

Description

task_reference

Number, String

Reference to a TASK OBJECT. Accepted values:

Numeric value: it is considered to be a direct TASK reference.
Alphanumeric string: it is considered a TASK_CODE.
Array of TASK references
A formula expression that returns valid TASK references (array or single value)

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

Special values:

"THIS": locks/unlocks the TASK from where the formula is executed
"NEXT": locks/unlocks the next TASK following the one where the formula is executed

do_lock

Boolean

true

0/false: unlock the TASK
Other value: lock the TASK

This parameter is optional. The default value is 1

Return value

This FORMULA does not return a value

Execution

Immediate unless the FORMULA is defined in an ITEM of type 'ACTION' (which are always executed when a FORM is closed)

Examples

Formula	Description
TASK_LOCK(12322)	Locks the TASK with reference 12322
TASK_LOCK(12322, 0)	Unlocks the TASK with reference 12322
TASK_LOCK([12322,12323], 0)	Unlocks the TASK with references 12322 and 12323
TASK_LOCK("NEXT")	Locks the next TASK in the ADMISSION
TASK_LOCK("MANEUVER:BAS")	Locks all the TASKs of the current ADMISSION whose TASK_CODE is "MANEUVER:BAS"
TASK_LOCK($2, 0)	Unlocks the TASK whose reference is the one stated in question $1
TASK_LOCK(ADMISSION.TASK{MANEUVER:BAS}.REF, 0)	Unlocks all the TASKs in the current ADMISSION whose TASK_CODE is "MANEUVER:BAS" (see OBJECT CODES)

Browser not supported