Object PmaDataTable (Data Table)

Description:

See: PmaDataTable - Deatiled object description

The object serves for the definition of the data table (2-dimensional array). Data in this table are ordered into columns and rows. It is the analogy of the database table. A data type and a column name can be defined for the column.

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:

Cols	The number of columns
EndOfTransfer	Fires the onEndOfTransfer event
FindValue	Search for the row with the specified value
GetArray	Creates an array of values from selected data items of the object
GetCellValue	returns the value of the table cell
GetColParam	Returns the column parameter
InsertCol	Insert of new column
InsertRow	Insert new column
Item	Access to table values (obsolete)
LoadFromFile	Loading data for this object from the file
LoadFromString	Assignment of selected data item values of the object from the string value
MaxCols	Maximum number of columns
MaxRows	Maximum row number
ReadFromWeb	Reading data from Web server in the XML format
RemoveCol	Removes the column
RemoveRow	Removes the row
Rows	The number of rows
SaveToFile	Saving data of this object into the file
SaveToString	Creates a string value from selected data item values of the object
SetArray	Assignment of the array of values to the data items of the object
SetCellValue	Sets the value of the table cell
Sort	Sort of rows by values in the specified column
WebClientIsReady	Detects whether the object is ready to write/read to Web server
WriteToWeb	Sending data to Web server in the XML format

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:

onEndOfTransfer	Is triggered after ending the data transfer

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
DataTable	Definition of the data table range
Columns	Definition of table columns
Permissions	Object permissions
Web server	The link-up of the object to Web server

History:

Pm9.00.00: Object name changed: PmDataTable -> PmaDataTable

Pm8.03.15: The first column can now be defined as Identifier type. This row identifier can be used for example in the GetCellValue method for addressing the table cell.

Pm8.03.14: On the "Columns" tab there is a new "Read only" configurator for each new column. The variable in such column can be written only once and these variables are not included into the total variable count of the application. This fact then affects the type of basic runtime licence to be used. See "Read only" columns.

PROMOTIC 9.0.21 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remark Contact responsible person

Navigation:

- PROMOTIC SCADA/HMI system

- Documentation contents

- Objects of the PROMOTIC system

- PmaAdo

- PmaComm