Object PmaAdo (ADO database)

See: PmaAdo - Deatiled object description, PmaAdo - Practical examples

This object provides access to databases using the ADO technology. This object represents connection to one database and can contain multiple AdoRecordset objects (providing access to data in physical database tables). The PmaAdo object can be used for read/write the data from/to the physical database table and also can execute SQL statements in he connected database.
The PmaAdo object directly enables the objects and methods of the ADO technology. Especially the AdoRecordset object as a result of the SQL statement SELECT. This technology ensures that the system is as open as possible and averything that can be done using the ADO technology, can also be used in the PROMOTIC system.

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.
The usage of the PmaAdo object requires purchase of the "PmDB" licence. With the freeware version PmFree, or when developing the application (with development environment for testing purposes), this component is always functional.
This object inherits properties, methods and events of the PmaObject object.
Properties and methods of this object:
DbBeginTrans Starts new transaction over the connected database
DbClose Disconnection of the PmaAdo object of the database and release of all stored AdoRecordset objects
DbCommitTrans Confirms transaction over connected database
DbConnectionParams Additional parameters of database connection
DbConnectionString Database connection parameters
DbExecute Executes the statement entered in the syntax of the SQL language
DbIsOpen Test whether the PmaAdo object has the database connection
DbOpen Connecting the PmaAdo object to the database
DbRollbackTrans Cancells transaction over connected database
LastErr The numeric error code of the result of the last executed method (property) of the PmaAdo object
LastTextErr The text description of the last executed method (property) of the PmaAdo object
RsClose Releases the stored AdoRecordset object with defined identifier
RsGet Returns the stored AdoRecordset object with defined identifier, that has been created previously by calling the RsOpen method
RsIsOpen Test of the existence of the AdoRecordset object with defined identifier
RsOpen Executes the SQL query SELECT and provides the resulting data in the form of the AdoRecordset object (set of records)
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 object in the tree of Pma objects
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 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
ADO Basic settings for database access via the ADO
Methods Definition of designer's method of the object
Related objects:
AdoField(ADO Field) The ADO Field object contains the column information
AdoRecord(ADO Record) The ADO Record object represents a single record
AdoRecordset(ADO Recordset) The ADO Recordset object represents a set of records

Pm9.00.00: Object name changed: PmAdo -> PmaAdo
Pm8.03.22: Generalization of methods DbOpen, DbExecute, RsOpen, DbBeginTrans, DbCommitTrans, DbRollbackTrans.
If you enter the parameter "return:map;", then the methods return moredetailed information regarding the results of method callings.
Pm8.03.09: new methods for transactions support: DbBeginTrans, DbCommitTrans and DbRollbackTrans.
Pm8.01.03: Some methods of the Microsoft objects AdoRecordset did not return the confirmation of completion/failure flag. Therefore the Promotic system adds properties (Pm_LastErr and Pm_LastTextErr) into this object, that can be used for obtaining such confirmation.
Pm8.01.00: Created
PROMOTIC 9.0.17 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