An example of the usage: Imagine the folder PmaFolder that represents a device (e.g. Boiler). Sometimes it is necessary to detach this Boiler. It can be done so that in another folder there is detailed algorithm how to detach the Boiler but much better is to create the method directly in the "Boiler" object where the algorithm for the outage is placed. Then from the other folder this method is just called.
|pMe||(Object) Reference to the Pma object, where the method is defined.|
|pResult||[for write only] (Variant) Output parameter that is used for method output value.|
|pContext||(Object) (for PmaRoot and PmaPanel objects) reference to the object containig additional information about method calling conditions.|
pContext.User - (Object) property with referrence to the PmUser object, containing detailed information about the user (local or network), that called the method. It can be used for example:
- for protecting the method for specific logged user or user group.
- for storing and reading the private user state data using the methods SetPrivateData and GetPrivateData.
Caution! In order to keep the subobject User value trustworthy it is necessary to exclude the pseudo-groups $ANY and $ANY_NET from the appropriate permission WebRead (i.e. to ensure that the user is logged in when opening the Web page).
pContext.Language - (String) it returns the information about the national language, to be used for text outputs of the method (suitable especially for calling the method from Web panels). Language is determined with a text identifier, e.g. "en", "de", "ru" etc. - see Fully supported languages in the PROMOTIC system. See the "Main language of runtime" configurator.
pContext.TypeEnable - (Long) A permission type of client method calling. The designer can (according to the user setting, password or the computer address) disable the operation. Setting this parameter is recommended only for special cases. Common security setting is better to be done by standard means of the permissions: WebMethods.
Caution! The property is functional only for Web panels.
1 (default) - enabling operation.
-1 - required log-on of the user (if the user hasn't been set) or disabling the user (if the user has been set but the name and password are wrong).
-2 - disabling operation for the client unconditionally.
|Parameters defined by designer||(Variant) It is used as passed parameters when calling the method. These parameters are defined in the "Parameters" configurator.|
var val = pMe.Pm("DAT").Item(par1).Value;
return val + 10;
var n = oFolder.Methods.dataadd("data1");
if (pContext.User.Type == 2 && Pm.TestUserInGroup(1, "$ADMIN", pContext.User.Id))
var val = Pm.Methods.GetStartTime(par1);