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.
Returns a different error message if record is hidden from
the user vs record doesn't exist
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
Mit Datensätzen arbeiten
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
- An Entity Object corresponding
to the requested record.
Returns an Entity object or one
of the following error messages:
1 = AD_ENTITY_NOT_FOUND
- Does not exist
3 = AD_ENTITY_HIDDEN - Exists but
hidden from current user
Examples
VBScript
set entityObj = session.LoadEntityByDbId("defect", 33554433)
Perl
$entityObj = $session->LoadEntityByDbId("defect",
33554433);