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 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.
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
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. 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 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.12 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