Object PmaTrendGroup (Trend group)

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 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 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 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 PmaObject:
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 object in the tree of Pma objects
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 PmaObject:
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 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
Related objects:
PmVar(Variable) Object represents one data item of the object
ExtTrend An extension for connection to the PmaTrendGroup object
See also:
- PmgTrendViewer (object)
- PmVar (object)
- ExtTrend (object)

Pm9.00.12: Fixed bug: Bugfix of record reading via GetValueByTime and GetData methods. The filename comparation was case sensitive by mistake.
Pm9.00.00: Object name changed: PmTrend -> PmaTrendGroup
- The GetValueByTime method was not able to return single value for Database dBase backups saving type.
- If Database Access backups (obsolete) saving type was used a new backup was created each time the runtime was launched.
Pm8.03.01: New "Additional parameters" configurator.
Pm8.02.16: Fixed bug: for "Database Oracle cyclic" saving type - deleting old records did not work.
Pm8.02.07: In the configurators Unit and Name for displaying it is now possible to use Macro expression $.text.
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 the Web also if the local application is switched to another language.
Pm8.01.05: If the "Automatic saving after launch is enabled" configurator switched on, then the application under load could try to write multiple records with identical time.
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.
- 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.
PROMOTIC 9.0.17 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