Promotic

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:
ColsThe 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 a value of the table cell
GetColParam()Returns the parameter of the column
InsertCol()Insert of new column
InsertRow()Insert new column
ItemAccess 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
MaxColsMaximum number of columns
MaxRowsMaximum row number
ReadFromWeb()Reading the data from Web server in the XML format
RemoveCol()Removes the column
RemoveRow()Removes the row
RowsThe 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
WebClientIsReadyDetects 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 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:
onEndOfTransferIs triggered after ending the data transfer
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
DataTableDefinition of the data table range
ColumnsDefinition of table columns
PermissionsObject permissions
Web serverThe link-up of the object to Web server
See also:
- PmaData (object)

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.27 SCADA system documentation MICROSYS, spol. s r.o.

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