User database objects

User database objects are the objects your code works with the most, from a given Session.

The following diagram illustrates the types of objects you use to access a user database and the relationships between them. The arrows indicate the direction in which you acquire related objects. For example, from the Session object, you can acquire different types of objects such as DatabaseDesc, Entity, EntityDef, QueryDef, and ResultSet directly.

Top level objects are used to access the objects associated with Rational ClearQuest client functions.

In some cases, objects have an indirect relationship. For example, the QueryDef and ResultSet objects work together to run a query, but you create these objects separately using methods of the Session object. The ResultSet object uses information from the QueryDef object to perform the query.

User database object: Description
Session Object: Access the user database; build a new record
Entity Object: An object corresponding to a database record. Work with Record data: set field values, validate, commit, revert.
EntityDef Object: View read-only meta-data: actions, fields, hooks, states, and transitions applicable to a given record type
EntityDefs Object: Collection of EntityDef (record type) objects
QueryDef Object: Defines the query criteria. A QueryDef is the definition of a query.
ResultSet Object: Contains the data the query fetches. A ResultSet is the result when you Executea QueryDef. If the query is a parameterized query, then the ResultSet is used to fill in values for the queries.
QueryFilterNode Object: Implements comparison filters for the query
Workspace Object: The Workspace (WorkSpaceMgr for Perl) object provides an interface for manipulating saved queries, reports, and charts in the Public and Personal Queries folders.