WA SET CONTEXT

WA SET CONTEXT ( {* ;} object ; contextObj )

Parameter	Type		Description
*	Operator	→	If specified, object is an object name (string). If omitted, object is a variable.
object	Form object	→	Object name (if * is specified) or Variable (if * is omitted).
contextObj	Object	→	Object containing the functions that can be called with $4d.

Description

The WA SET CONTEXT command defines a context object contextObj for $4d in the Web area designated by the * and object parameters. When this command is used, $4d can only access contents declared within the provided contextObj. When no context object is set, $4d has access to all 4D methods and can not access user classes.

note

The command is only usable with an embedded web area where the Use embedded web rendering engine and Access 4D methods parameters are set to true.

Pass in contextObj user class instances or formulas to be allowed in $4d as objects. Class functions that begin with _ are considered hidden and cannot be used with $4d.

• If contextObj is null, $4d has access to all 4D methods.
• If contextObj is empty, $4d has no access.

Example 1

Allow $4d to specific methods

 var $context:={}
 $context.myMethod:=Formula(myMethod)
 $context.myMethod2:=Formula(myMethod2)

 WA SET CONTEXT(*; "myWebArea"; $context)

In JavaScript:

$4d.myMethod(); // Allowed
$4d.myMethod2(); // Allowed
$4d.someOtherMethod(); // Not accessible

Example 2

Using a Class Object

 var $myWAObject:=cs.WAFunctions.new()

 WA SET CONTEXT(*; "MyWA"; $myWAObject)

In JavaScript:

$4d.myWAFunction(); // Allowed
$4d._myPrivateFunction(); // Will do nothing because function is private

See also

WA Get context

Properties

Command number	1848
Thread safe	✗