Object PmaTrendGroup (Trend group)

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:
AddFilterAdds the value filter
BackupCreateCreates a new backup
BackupInfoReturns information about saved trend data on the disk
ClearHistoryRemove all archived data
CloseClose the trend archive
CountThe number of variables in the object
CreateFilterCreates the value of the filter range for next methods
GetDataReturns the stored data
GetGroupTitleReturns the user defined name of trends group
GetPersistInfoReturns information regarding data saving to disk
GetTimeReturns requested time
GetValueByTimeReturns a value (or more values) of a variable (more variables) by the specified time
GetVarExtensionsArray of all data extensions registered into this object
GroupIdGroup identifier
ItemAccess to variables of the PmVar type of this object
ItemExAccess to variables of the PmVar type of this object
OpenOpen the trend archive
RunSave the current values with the current time
RunTimeSaving the current values with the specified time
SaveToFileSaving data of this object into the file
SetValueByTimeWriting the value (more values) of a variable (more variables) by the specified time.
Properties and methods inherited from the PmaObject object:
AddEventRegisters a function into selected event
GetInfoReturns the Info object with the specified name
GetOwnedByIndexReturns the subobject defined by its index
GetOwnedByNameReturns reference to the subobject defined by its name
GetOwnedByTypeArray of references to the subobjects
GetOwnedNumReturns number of subobjects in the object
GetParReading the value of the Pma object parameter (or its parents)
GetPathNameObject name with the path to this object
GetPermissionReturns permission of corresponding operation from object
MethodsAccess to designer's methods of this object
NameObject name (without the path)
ParentReturns reference to the parent Pma object
PmReturns reference to the Pma object or to its implementation subobject
RemoveEventUn-registers the function in the specified event
RootReturns reference to the root application object PmaRoot
Events of this object:
onAddRecordIs triggered on the request for saving the values
onBackupCreateIs triggered on the request for creating new backup
onErrorIs triggered on the error in the object
Events inherited from the PmaObject object:
onStartIs triggered for each object in the runtime only once at the beginning
onStopIs triggered for each Pma object in the runtime mode only once at the stop of the application
Configuration tabs:
ObjectGeneral information about the object
EventsDefinition of object events algorithms
DataDefinition of trends group data
TrendBasic settings of trends group
StorageData persistence configuration of trends group
PermissionsObject permissions
Web serverThe link-up of the object to Web server
Related objects:
PmVar(Variable) Object represents one data item of the object
ExtTrendData extension for connection to the PmaTrendGroup object
See also:
- PmgTrendViewer (object)
- PmVar (object)
- ExtTrend (object)

Pm9.00.12: Fixed bug: Bugfix of records 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 after starting the application.
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 Displayed name of the trend 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 enter different column name in the database.
Pm8.02.00: The string value of the "Displayed name of the trend" 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.23 SCADA system documentation MICROSYS, spol. s r.o.

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