|pMe||(Object) Reference to the PmaReport object where the event rises.|
|pEvent||(Object) Reference to object describing detailed information about the specific event.|
pEvent.Context - (Object) Contains a link to a object with additional information about the calling context (e.g. the user).
pEvent.Context.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).
pEvent.Context.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.
pEvent.Pars - (Object) Contains a reference to an object with additional parameters of the report, provided when the viewer is opened (see sViewPars default value or Opening the viewer of the PmaReport object). Each separate parameter consists of an identifier (name) and a value. These parameters can be used for parametrizing the contents of the report when the viewer is opened. It is possible to use these parameters to parametrize the data being read in the onReportRequest event and also to pass the values of these parameters directly into the report as keywords.
Each parameter can be accessed via the following methods of this object:
pEvent.Pars.GetValueAt - Syntax: String GetValueAt(String sId). The method allows to obtain the value of one parameter according to its identifier (name).
pEvent.Modify - (Long) The output value indicating whether the key values or template file has been updated and the need to re-create the report (see the MakeReport method).
0 - No modification occured, the report wil not be re-created (the cached report of the PmaReport object will be used).
1 - Some modification occured, the output report must be re-created.
pEvent.Modify = 1;