Description
Devuelve el registro solicitado (Entity) utilizando el ID exclusivo del registro.
Utilice este método para obtener un registro del que conozca el ID de base de datos. Puede obtener el ID de base de datos de un registro llamando al método GetDbId del objeto Entity correspondiente.
Para solicitar el registro utilizando su ID visible en lugar del ID de base de datos, utilice el método GetEntity.
Nota: Los DBID son exclusivos de una clase de registros, exclusivos dentro de los registros con estado y exclusivos dentro de los registros sin estado. En la versión 7.0 se ha aumentado el límite del número de registros que se pueden almacenar, por lo que también se ha aumentado el rango de DBID.
Sin embargo, los clientes de Rational ClearQuest anteriores a la versión 7.0 no pueden visualizar registros con identificadores de base de datos (DBID) que excedan el límite anterior. Para obtener más información sobre DBID, consulte el apartado
Trabajo con registros.
Sintaxis
VBScript
session.GetEntityByDbId(entitydef_name,db_id)
Perl
$session->GetEntityByDbId(entitydef_name, db_id);
- Identificador
- Description
- session
- El objeto Session que representa la sesión de acceso a la base de datos actual.
- entitydef_name
- Un valor String que identifica el nombre del tipo de registro al que pertenece el registro que se desea.
- db_id
- Un valor Long que es el número que utiliza la base de datos para identificar el registro.
ID exclusivo del registro (Entity).
- Valor de retorno
- Devuelve un Objeto Entity correspondiente al registro solicitado.
Ejemplos
VBScript
' Save this record's ID for later use.
set sessionObj = GetSession
set record1 = sessionObj.GetEntity("defect", "DEF00013323")
id = record1.GetDbId
' ...
' Get the record again
set record1 = sessionObj.GetEntityByDbId("defect", id)
Perl
#Assume you have $entityObj, an Entity Object
#Save the session and record id for later use:
$sessionObj = $entityObj->GetSession();
$dbid = $entityObj->GetDbId();
# ...
#Later, to get the record again:
$entityObj = $sessionObj->GetEntityByDbId("defect",$dbid);