Promotic

Application - tab of the PmaRoot object

Description:
Basic settings of the application.
Configurators:
Main language of runtimeSpecifies the default national language that is used in the running application (in runtime) of the PROMOTIC system application (if the component requesting localized text does not explicitly specify the different language).
Language is determined with a text identifier, e.g. "en", "de", "ru" etc. - see Fully supported languages in the PROMOTIC system.
If the "develop" (development) identifier is selected, then the language of the development environment is used. Note: The language for the development environment is entered in the menu " > PROMOTIC settings" in the "Development environment language" configurator.
This configurator sets the initial value of the Pm.RtLang property.
All used languagesThe list of all national languages supported in the running application simultaneously.
Language defined in the "Main language of runtime" configurator should also be listed in the list. If missing, then it is added to the list automatically.
The meaning of the list is to inform the PROMOTIC system about languages which should be loaded into the memory after the application is launched. It is used for optimalization of loaded languages into the memory possible because not used languages are not loaded into the memory. The list itself consist of abbreviations of languages separated with comma (,).
If the application is designed only for one language, then this configurator should be left empty.
This language list is also used for the PmaWebLang object, offering the Web page language versions to Web server.
Runtime licence typeThe configurator specifies the way of the licence assignement to the application in runtime (see also List of the licence types of the PROMOTIC system).
LicKey1 - according to the licence key (enable PmRtTestFree) (default) - The application will be assigned the licence that is found in the corresponding licence key (see hwkey,netkey,swkey). If the licence is not found then the application will run under the PmRtTestFree licence (see PmFree).
LicKey2 - according to the licence key (disable PmRtTestFree) - The application will be assigned the licence that is found in the corresponding licence key (see hwkey,netkey,swkey). If the licence is not found then the application will not run under the PmRtTestFree licence and therefore will not be allowed to launch.
PmRtFree - free runtime, limited application size - The application will run under the PmRtFree licence (see PmFree).
PmRtDemo - demo runtime, unlimited application size - The application will run under the PmRtDemo licence. This mode allows to launch an application of any size for demo purposes. This runtime contains the warning windows and a time limitation up to 1 hour. It is not designed for running real applications.
Runtime helps pathPath to the help file (*.hlp) that is called in the running application after pressing the "Help" button of the panel. The file can be listed by the button. See: How to display help texts in running application.
Panels timer periodThe period in seconds with which active panels of the application are refreshed. Only those panels that haven't set the " > Setting of the sFramePars default values > Refresh period (refresh)" configurator will be refreshed.
The default value is 0.5 sec.
This configurator sets the initial value of the Pm.Blinker property.
The period defined here affects only the local panels of the application. The period of Web panels is defined in the "PmaPanel > Web server > Refresh period of the Web panel [s]" configurator.
Stop application runtime with confirmationIf checked, then on stopping the application runtime the confirmation window is displayed
Development environment
Editing the application with password verificationSetting the authorization for editing the application in the development environment. See The authorization for editing the application.
If the authorization is used and if the authorization fails, then the development environment isn't opened.
It is used for preventing opening and vieweing of the application content by unauthorized persons. In order to protect the runtime mode of the PROMOTIC application - see the Pm.LicenceInfo method.
Paths to system folders
#appres: - to resources (resources: jpg,gif,avi,wav,...)Path to the resources folder (images, sounds, ..) of the application. It means to files of the type:
- image (svg, png, jpg, bmp, gif, wmf ...) - used for example by PmgRasterImage object.
- film (avi, mpeg, divx ...) - used for example by PmgVideo object.
- sound (wav) - used for example by Pm.PlaySound method.
The path is used if the files are not found on defined paths or in the application folder.
 
For obtaining this path, the #appres: can be used.
This configurator is preset to "#app:Resource", i.e. the Resource subfolder in the application folder.
#data: - to data filesPath to the data files folder of the application. It is suitable to store any data files on this path.
On some places this path is preset:
- for alarms for files with the *.al/*.dbf extension to the subfolder Alarm (#data:Alarm/). See the "Folders for files" configurator.
- for events for files with the *.ev/*.dbf extension to the subfolder Event (#data:Event/). See the "Folder for files" configurator.
- for trends for database files to the subfolder Trend (#data:Trend/). See the "Backup (table) name prefix" configurator.
 
For obtaining this path, the #data: can be used.
This configurator is preset to "#app:Data", i.e. the Data subfolder in the application folder.
#cfg: - to configuration filesPath to the application configuration files folder. It is suitable to store files with configuration information on this path (the information that doesn't change too much - contrary to #data:).
On some places this path is preset (by a macro):
- for alarms for files with the .ag extension (see the "Folders for files" configurator).
- for events for files with the .eg extension (see the "Folders for files" configurator).
- for trends for files with the .tg extension in the preset event of the buttons "Read"/"Save" of the Preconfiguration "Trend viewer with header and control" Pmg object.
 
For obtaining this path, the #cfg: can be used.
This configurator is preset to "#app:Cfg", i.e. the Cfg subfolder in the application folder.
#temp: - to temporary filesPath to temporary and auxiliary files of the development environment and runtime.
- Runtime environment: for example the contents of the INFO system are stored here (see the "File to print the content" configurator).
- Development environment: for example, search results are stored here or a listing of errors during an application consistency test.
 
For obtaining this path, the #temp: can be used.
This configurator is preset to "#app:Temp", i.e. the Temp subfolder in the application folder.
To system data filesPath to system data files, i.e. files generated directly by the running PROMOTIC system. In particular the LOG files (see [Log]).
This configurator is preset to "#app:", i.e. the application folder.
Localized texts managerOpens the window that is used for managing localized texts of the application: Localized texts manager
Manager of configuration filesOpens the window for managing application configuration files: Manager of configuration files
Application backup managerOpens the window for application backups management: Application backup manager
Manager of application scriptsOpens the window for management of application scripts: Manager of application scripts

History:
Pm9.00.06: New "Runtime licence type" configurator for setup of the licence assignment to applications in runtime.
Pm8.02.02: The password protected application (see the "Editing the application with password verification" configurator) was not available for editing (bug since Pm8.2.1 version).
Pm8.02.01: The "Run on start" configurator has been removed. It means that with the development key, the application always starts in development mode. For PmFree applications, it is possible to define in the "Runtime licence type" configurator, whether the application starts in the development environment or in runtime.
Pm8.02.00: System datafiles (e.g. the Application.log file) are by default saved in the application folder.
Now it can be changed in the "PmaRoot > Application > To system data files" configurator.
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

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