VP SET ALLOWED METHODS
VP SET ALLOWED METHODS ( methodObj : Object)
Parameter | Type | Description | |
---|---|---|---|
methodObj | Object | -> | Allowed methods in the 4D View Pro areas |
Compatibility
For greater flexiblity, it is recommended to use the
VP SET CUSTOM FUNCTIONS
command which allows you to designate 4D formulas that can be called from 4D View Pro areas. As soon asVP SET CUSTOM FUNCTIONS
is called,VP SET ALLOWED METHODS
calls are ignored. 4D View Pro also supports 4D's genericSET ALLOWED METHODS
command if neitherVP SET CUSTOM FUNCTIONS
norVP SET ALLOWED METHODS
are called, however using the generic command is not recommended.
Description
The VP SET ALLOWED METHODS
command designates the project methods that can be called in 4D View Pro formulas. This command applies to all 4D View Pro areas initialized after its call during the session. It can be called multiple times in the same session to initialize different configurations.
By default for security reasons, if you do not execute the VP SET ALLOWED METHODS
command, no method call is allowed in 4D View Pro areas -- except if 4D's generic SET ALLOWED METHODS
command was used (see compatibility note). Using an unauthorized method in a formula prints a #NAME? error in the 4D View Pro area.
In the methodObj parameter, pass an object in which each property is the name of a function to define in the 4D View Pro areas:
Property | Type | Description | ||
---|---|---|---|---|
<functionName> | Object | Custom function definition. The <functionName> property name defines the name of the custom function to display in 4D View Pro formulas (no spaces allowed) | ||
method | Text | (mandatory) Name of the existing 4D project method to allow | ||
parameters | Collection of objects | Collection of parameters (in the order they are defined in the method). For more information, please refer to the Parameters section. | ||
[ ].name | Text | Name of a parameter to display for the <functionName> .Note: Parameter names must not contain space characters. | ||
[ ].type | Number | Type of the parameter. Supported types:Is Boolean Is collection Is date Is Integer Is object Is real Is text Is time If type is omitted, by default the value is automatically sent with its type, except date or time values which are sent as an object. If type is Is object , the object is sent in a .value property. See Parameters section. | ||
summary | Text | Function description to display in 4D View Pro | ||
minParams | Number | Minimum number of parameters | ||
maxParams | Number | Maximum number of parameters. Passing a number higher than the length of parameters allows declaring "optional" parameters with default type |
Example
You want to allow two methods in your 4D View Pro areas:
C_OBJECT($allowed)
$allowed:=New object //parameter for the command
$allowed.Hello:=New object //create a first simple function named "Hello"
$allowed.Hello.method:="My_Hello_Method" //sets the 4D method
$allowed.Hello.summary:="Hello prints hello world"
$allowed.Byebye:=New object //create a second function with parameters named "Byebye"
$allowed.Byebye.method:="My_ByeBye_Method"
$allowed.Byebye.parameters:=New collection
$allowed.Byebye.parameters.push(New object("name";"Message";"type";Is text))
$allowed.Byebye.parameters.push(New object("name";"Date";"type";Is date))
$allowed.Byebye.parameters.push(New object("name";"Time";"type";Is time))
$allowed.Byebye.summary:="Byebye prints a custom timestamp"
$allowed.Byebye.minParams:=3
$allowed.Byebye.maxParams:=3
VP SET ALLOWED METHODS($allowed)
After this code is executed, the defined functions can be used in 4D View Pro formulas:
In 4D View Pro formulas, function names are automatically displayed in uppercase.