Object PmaTrendGroup (Trend group)
Description:
See:
PmaTrendGroup - Deatiled object description
The object stores the time history of variables defined on the "
Data" tab into the memory and on the computer hard disk. The storing is performed in the optional periods by the
Run,
RunTime methods. For viewing the archived data the
PmgTrendViewer object can be used, respectively either in the panel of the client PROMOTIC application or in the Web browser (
Chrome,
Firefox,
Edge,
InternetExplorer ...).
No other
Pma objects can be created in this object.
This object can be created in objects: PmaRoot, PmaFolder, PmaPrototype. Multiple objects of this type can be created in such objects.
This object adds variables into the calculation of the application size, which influences the basic runtime licence type/size (see: Price list of the PROMOTIC system ).
This object adopts properties and methods of the
PmaObject object.
Properties and methods:
| AddFilter | Adds the value filter |
|---|
| BackupCreate | Creates a new backup |
|---|
| BackupInfo | Returns information about saved trend data on the disk |
|---|
| ClearHistory | Remove all archived data |
|---|
| Close | Close the trend archive |
|---|
| Count | The number of variables in the object |
|---|
| CreateFilter | Creates the value of the filter range for next methods |
|---|
| GetData | Returns the stored data |
|---|
| GetGroupTitle | Returns the user defined name of trend group |
|---|
| GetPersistInfo | Returns information regarding data saving to disk |
|---|
| GetTime | Returns requested time |
|---|
| GetValueByTime | Returns a value (or more values) of a variable (more variables) by the specified time |
|---|
| GetVarExtensions | Array of all data extensions registered into this object |
|---|
| GroupId | Group identifier |
|---|
| Item | Access to variables of the PmVar type of this object |
|---|
| ItemEx | Access to variables of the PmVar type of this object |
|---|
| Open | Open the trend archive |
|---|
| Run | Save the current values with the current time |
|---|
| RunTime | Save the current values with the specified time |
|---|
| SaveToFile | Storing data of this object into the file |
|---|
| SetValueByTime | Writing the value (more values) of a variable (more variables) by the specified time. |
|---|
Events:
| onAddRecord | Is triggered on the request for saving the values |
|---|
| onBackupCreate | Is triggered on the request for creating new backup |
|---|
| onError | Is triggered on the object error |
|---|
Configuration tabs:
| Object | General information about the object |
|---|
| Content | Content of the object in the XML form |
|---|
| Events | Definition of object events algorithms |
|---|
| Data | Definition of trend group data |
|---|
| Trend | Basic settings of group of trends |
|---|
| Storage | Disk data persistence configuration |
|---|
| Permissions | Object permissions |
|---|
| Web server | The link-up of the object to the Web server |
|---|
History:
Pm9.00.00: Object name changed:
PmTrend ->
PmaTrendGroup Pm8.02.06: in the trend variable in the "
Additional parameters" configurator, there is a new item
Additional parameters, that allows to define different column name in the database.
Pm8.02.00: The string value of the "
name for displaying" configurator is now localized on Web also if the local application is switched to another language.
Pm8.01.04: reading of large number of DBF files on application start has been accelerated.
Pm8.00.05:
Fixed bug:
- when saving into
Database dBase backups the time can be saved with the precision up to one thousandth second. When reading the data, the time was rounded off to seconds.
- in the PROMOTIC 8.0.4 version, there there has been introduced a New configurator
Autosave period [s]. During the conversion of older projects there was a disallowed value of 0 inserted into this configurator - now the correct value of 60 is being inserted during each conversion.
Pm8.00.04:
- The value saving period can now be set directly in the object - see the "
Autosave period [s]" configurator. It is not necessary to call the
Run method anymore.
- there is a new
data extension ExtTrend. Now it is not necessary to configure the trend data in the
PmaTrendGroup object. The trends can now be configured directly in the variable in the
PmaData object.