SET ALLOWED METHODS
SET ALLOWED METHODS ( methodsArray )
| Parameter | Type | Description | |
|---|---|---|---|
| methodsArray | Text array | → | Array of method names |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The SET ALLOWED METHODS command designates the project methods that can be called directly from the application.
4D includes a security mechanism that filters callable project methods from the following contexts:
- The formula editor - allowed methods appear at the end of the list of default commands and can be used in formulas (see section Description of formula editor).
- The label editor - the allowed methods are listed in the Apply menu if they are also shared with the component (see section Description of label editor).
- Formulas inserted in styled text areas or 4D Write Pro documents through the ST INSERT EXPRESSION command - disallowed methods are automatically rejected.
- 4D View Pro documents - by default, if the VP SET ALLOWED METHODS command has never been called during the session, 4D View Pro formulas only accept methods defined by SET ALLOWED METHODS. However, using VP SET ALLOWED METHODS is recommended. See Project method references.
By default, if you do not use the SET ALLOWED METHODS command, no method is callable (using an unauthorized method in an expression causes an error).
In the methodsArray parameter, pass the name of an array containing the list of methods to offer in the Formula editor. The array must have been set previously.
You can use the wildcard character (@) in method names to define one or more authorized method groups.
If you would like the user to be able to call 4D commands that are unauthorized by default or plug-in commands, you must use specific methods that handle these commands.
Note: Formula filtering access can be disabled for all users or for the Designer and Administrator via an option on the "Security" page of the Database Settings (see ). If the "Disabled for all" option is checked, the SET ALLOWED METHODS command will have no effect.
Example
This example authorizes all methods starting with “formula” and the “Total_general” method to be executed by the user in protected contexts:
ARRAY TEXT(methodsArray;2)
methodsArray{1}:="formula@"
methodsArray{2}:="Total_general"
SET ALLOWED METHODS(methodsArray)