Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Panel - page of object PmaPanel

Description:
Basic settings of the panel. The panel description is defined here, rights for opening/closing, panel printing, etc.
Configuration items:
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.

sOptions default valueThe parameters transferred to the viewer. These define where and how to open the viewer.

Entries are in KeyVal format, for example "target:_blank;modal:1;".

Macro expression can be used for input (it is evaluated while the window is opening).

Values can be edited manually, or created by the button on the right, that will open the window for Setting of the Options default values.

 
It is a static default setup of entries.

The entries can also be defined dynamically at viewer opening (see parameter sOptions in the OpenView method). In this case the static default setup 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.

sParams default valueParameters transferred to the object that is to be viewed by the corresponding viewer.

Entries are in KeyVal format, for example "name1:value1;name2:value2;".

Macro expression can be used for input (it is evaluated while the window is opening).

 
It is a static default setup of entries.

The entries can also be defined dynamically at viewer opening (see parameter sParams in the OpenView method). In this case the static default setup 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 the panel configurators by means of the Macro expression $.par and from the script by the GetPar method. Each parameter consists of an identifier (name) and a value. Syntax: "par:name1=value1;par:name2=value2; ...". See also: Parameters of the Pmg object.
 
The relation 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 autoamtically.

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 parameter 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("par:name1=",$.par("name1"),";par:name2=",$.par("name2"),";") will be evaluated as: "par:name1=boiler;par: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 this 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: /Objects/Promotic/PmaData/Desc.htm. See "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 VBScript language. In such case the Web panels are functional only in Internet Explorer browser.

In this case the next "Level of integration of 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 VBScript 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 panel viewer and the local application" configurator is not visible and the "client" mode is set.

Level of integration of panel viewer and the local applicationSpecifies the level of integration of 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 Pmg object events in panel viewer, it is possible to access the complete local application the same way as in Pma object events. Caution! The option is available only for VBScript scripting language. If the panel is enabled also for 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 panel If 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 that have the "Level of integration of panel viewer and the local application" configurator set to "client - LIMITED access from scripts to the PmaPanel object and Pm object".

PROMOTIC 9.0.7 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice