Description
Returns
the record with the specified database ID and the latest database
values.
This method is the same as GetEntityByDbId,
except that it ensures that you are using the latest values in the
database.
Note: In version 7.0 the limit on the number of records
that can be stored increased so the range of DBIDs also increased.
However, Rational® ClearQuest® clients earlier
than version 7.0. cannot display records with database identifiers
(DBIDs) higher than the former limit. For more information on DBIDs,
see
Working with records
Syntax
VBScript
session.LoadEntityByDbId(entitydef_name, db_id)
Perl
$session->LoadEntityByDbId(entitydef_name, db_id);
- Identifier
- Description
- session
- The Session object that represents the current
database-access session.
- entitydef_name
- A String that identifies the name of the record
type (EntityDef) to which the desired record belongs.
- db_id
- A Long that is the number used by the database
to identify the record.
The unique ID of the record
- Return value
- Returns an Entity
Object corresponding to the requested record.
Examples
VBScript
set entityObj = session.LoadEntityByDbId("defect", 33554433)
Perl
$entityObj = $session->LoadEntityByDbId("defect",
33554433);