Promotic

Panel - tab of the PmaPanel object

Description:
Basic settings of the panel. The panel description is defined here, rights for opening/closing, panel printing, etc.
Configurators:
Panel titleUser name of the panel that is displayed for example in:
- in the window title bar (if opened outside the workspace)
- in the panel list obtained for example by the FindViewers method

This configurator sets the initial value of the property PmaPanel.Title and PmgRoot.ViewerTitle.
Macro expression can be used for input ($.text ..) (it is evaluated while the window is opening).
Open by hotkeyKey or combination of keys used for opening the panel. The key(s) it is necessary to define by pressing it (not editing).
This configurator is considered obsolete and is displayed only if a valit hotkey or combination of keys is defined.
sFramePars default valueParameters for the frame where the viewer will be displayed
Entries are in the KeyVal format, for example "target:_blank;".
See the PmViewCreator.Frame property.
Macro expression can be used for input (it is evaluated while the window is opening).
Values can be edited manually, or can be created by the button on the right, that will open the window for Setting of the sFramePars default values.

It is a static default setting of entries.
The entries can also be defined dynamically at viewer opening (see the sFramePars parameter in the CreateView method). In this case the static default setting of the object is combined with the entries provided dynamically. If the same information is present on both places, then the dynamical information provided at viewer opening is preferred by the system.
sViewPars default valueViewer parameters (they differ for various viewer types)
Entries are in the KeyVal format, for example "name1:value1;name2:value2;".
See the PmViewCreator.View property.
Macro expression can be used for input (it is evaluated while the window is opening).

It is a static default setting of entries.
The entries can also be defined dynamically at viewer opening (see the sViewPars parameter in the CreateView method). In this case the static default setting of the object is combined with the entries provided dynamically. If the same information is present on both places, then the dynamical information provided at viewer opening is preferred by the system.

It allows to set the value of parameters of the PmgRoot object.
This parameter is then accessible in configurators of the panel by means of the Macro expression $.par and in the script by the GetPar method.
Each parameter here consists of an identifier (name) and a value.
Syntax: "pars:{name1:value1;name2:value2; ...}".
See also: Parameters of the Pmg object.

The relation of parameters between Pma object and Pmg object:
It is important that it is possible to deliver the Pma object parameter into the panel as a Pmg object parameter. The basic principle is that the Pma object parameter cannot get inside the panel automatically.
It is necessary to create the corresponding parameter in the PmgRoot object and set it to the value of the Pma object parameter when opening the panel. This can be done by Macro expression $.par, that allows to get the Pma object parameter values in this configurator and use them to create parameters of the PmgRoot object.
Example: There are Pma object parameters "name1" and "name2" with the values "boiler" and "temperature". The values of these parameters are to be delivered to the panel parameters of the same names when the panel is opened. The macro expression: $.join("pars:{name1:",$.par("name1"),";name2:",$.par("name2"),";}") will be evaluated as: "pars:{name1:boiler;name2:temperature;}". By evaluating the macro expression and using the Pma object parameters, the configurator value has been created, setting the panel parameter values for panel opening.
Panel help topicThe identifier of the internal document can be entered here that is displayed if you press the key F1 in the panel (if it is active). The CHM file the path (in case of HLP, the number) to the internal document is entered here. For example, if you want to display the description of the PmaData object in the PromoticEn.chm, then it would be the path: /pmdoc/Objects/Promotic/PmaData/Desc.htm. See the "Runtime helps path" configurator. See also: How to display help texts in running application.
Macro expression can be used for input (it is evaluated while the window is opening).
Scripting language settingsSets the scripting language type (VBScript or JavaScript).
vbscript (obsolete) - All scripts in events of Pmg objects in this panel will be written in the VBScript language.
Such panel cannot be viewed as Web panel, because the Web browsers do not support the VBScript language.
In this case the next "Level of integration of the panel viewer and the local application" configurator is visible and it is possible to enter both "full" and "client".
javascript - All scripts in events of Pmg objects in this panel will be written in the JavaScript language. In such case the Web panels are functional in all standard Web browsers (Chrome, Firefox, Edge, InternetExplorer ...).
In this case, the next "Level of integration of the panel viewer and the local application" configurator is not visible and the "client" mode is set.
Level of integration of the panel viewer and the local applicationSpecifies the level of integration of the panel viewer and local application. One point of view is the access to the application objects from panel viewer scripts, and the other is access to the contents of open panel viewer from local application.
This configurator is visible only if the VBScript language is set. For JavaScript language, the "client" mode is set.
full - FULL access from scripts to the whole application (only for VBScript) - From the scripts in panel viewer it is possible to access the complete local application (i.e. the application Pma objects). It is also possible to access the contents of open panel viewer from the application (i.e. the Pmg objects). In the scripts in events of Pmg objects in local panel viewer, it is possible to access the complete local application the same way as in events of Pma objects. Caution! The option is available only for VBScript language. If the panel is enabled also for the Web, then it is necessary to test in scripts whether the viewer is open localy or in the Web panel for example by means of the PmgRoot.ClientType property.
Caution! The setting is valid only for local application, in the Web panel the panel viewer is always in "client" mode.
client - LIMITED access from scripts to the PmaPanel object and Pm object - From the scripts in the panel viewer it is not possible to access the local application (i.e. the Pma objects). There is only limited access to the PmaPanel and Pm objects, that work as interface between the panel viewer and application. From the application, there is no access to the contents of open panel viewer (i.e. to the Pmg objects). This is the recommended mode, where the viewers of both local and Web panels is limited the same way. Therefore it is not necessary to test whether the viewer is open localy or on the Web. Caution! The option is enabled for both VBScript and JavaScript scripting languages.
Enable multiple opening of local panelIf checked, the panel can be opened multiple times. This is handy especially for parametrized panels - if the same panel is opened with different parameters.
Caution! This option is enabled only for panels where the "Level of integration of the panel viewer and the local application" configurator is set to "client - LIMITED access from scripts to the PmaPanel object and Pm object".
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r.o.