Prototype

LINK(OBJECT_TYPE, REF)

Used in "LINK" ITEMS. This formula generates the information necessary for a client (e.g. LC2) to generate a hyperlink to an OBJECT (e.g. a TASK, FORM...)

After the execution,the information about the link in the answer value of the question where it is invoked.

Input Parameters

OBJECT_TYPE

reference to a FORM OBJECT

Accepted values:

"TASK"
"FORM"
"URL". Available from API Version 2.7.17

REF

string or FORM FORMULAS

The target of the link.

If OBJECT_TYPE is "URL", then a string with a valid URL
If OBJECT_TYPE is "TASK" or "FORM", an ID of a valid OBJECT. It can be expressed in several ways:
- As a numeric reference to the OBJECT (the ID of the object)
- As as textual value that represents the code of the object. For example, if the object type is "TASK", it is possible to reference it by its TASK_CODE. Note that this code will be searched in the ADMISSION where the FORMULA is being executed. If more than one OBJECT is found, the first one will be used to build the link
- As a reference to another question in the same FORM (e.g. $12)
- As a FORMULA that returns a valid reference to the OBJECT

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
LINK("TASK", $12)	Link to the TASK referenced by the value of the ITEM 12 in the same FORM where the FORMULA is executed
LINK("TASK", ADMISSION.TASK{SPIRO}.REF)	Link to the TASK referenced by the OBJECT CODES ADMISSION.TASK{SPIRO}.REF
LINK("URL", "https://www.linkcareapp.com")	Hides all the FORMs in the current ADMISSION whose FORM_CODE is "MANEUVER:BAS" (see OBJECT CODES)

Link information generated

Depending on the OBJECT_TYPE indicated, the function generates a JSON string containing related information:

OBJECT_TYPE	Information generated
TASK	{ "link_type" : "TASK", "case" : "878", "admission" : "323", "task" : "99" }
FORM	{ "link_type" : "FORM", "case" : "878", "admission" : "323", "task" : "99", "form" : "58" }

Browser not supported