Promotic

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 methods Run, RunTime. 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
CountThe 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
GroupIdGroup 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 the specified 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
MethodsAccess to designer's methods of this object
NameObject name (without the path)
ParentReturns reference to the parent Pma object
Pm()Returns reference to the Pma object or to its implementation subobject
RemoveEvent()Unregisters 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 runtime only once at the beginning
onStopIs triggered for each Pma object in runtime 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)

History:
Pm9.00.12: Fixed bug: Bugfix of records reading by methods GetValueByTime and GetData. The filename comparation was case sensitive by mistake.
Pm9.00.00: Object name changed: PmTrend -> PmaTrendGroup
Pm8.03.09:
- 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 the application is 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 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 at application launch 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.
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

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