Object PmaTrendGroup (Trend group)
Description:
See:
PmaTrendGroup - Deatiled object description
The object provides storing the time history of variables defined on the "
Data" tab in 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:
Licences for PROMOTIC runtime environment).
This object inherits properties, methods and events of the
PmaObject object.
Properties and methods of this object:
| 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 trends 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 | Saving the current values with the specified time |
|---|
| SaveToFile | Saving data of this object into the file |
|---|
| SetValueByTime | Writing the value (more values) of a variable (more variables) by the specified time. |
|---|
Properties and methods inherited from the PmaObject object:
| AddEvent | Registers a function into selected event |
|---|
| GetInfo | Returns the Info object with the specified name |
|---|
| GetOwnedByIndex | Returns the subobject defined by its index |
|---|
| GetOwnedByName | Returns reference to the subobject defined by its name |
|---|
| GetOwnedByType | Array of references to the subobjects |
|---|
| GetOwnedNum | Returns number of subobjects in the object |
|---|
| GetPar | Reading the value of the Pma object parameter (or its parents) |
|---|
| GetPathName | Object name with the path to this object |
|---|
| GetPermission | Returns permission of corresponding operation from object |
|---|
| Methods | Access to designer's methods of this object |
|---|
| Name | Object name (without the path) |
|---|
| Parent | Returns reference to the parent Pma object |
|---|
| Pm | Returns reference to the Pma object or to its implementation subobject |
|---|
| RemoveEvent | Un-registers the function in the specified event |
|---|
| Root | Returns reference to the root application object PmaRoot |
|---|
Events of this object:
| 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 error in the object |
|---|
Events inherited from the PmaObject object:
| onStart | Is triggered for each object in the runtime only once at the beginning |
|---|
| onStop | Is triggered for each Pma object in the runtime mode only once at the stop of the application |
|---|
Configuration tabs:
| Object | General information about the object |
|---|
| Events | Definition of object events algorithms |
|---|
| Data | Definition of trends group data |
|---|
| Trend | Basic settings of trends group |
|---|
| Storage | Data persistence configuration of trends group |
|---|
| Permissions | Object permissions |
|---|
| Web server | The link-up of the object to 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 enter different column name in the database.
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.
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.