GetEntityByDbId

Description

Restituisce il record richiesto (Entity) utilizzando l'ID univoco del record.

Utilizzare questo metodo per ottenere un record di cui si conosce ID database. È possibile ottenere l'ID database di un record richiamando il metodo GetDbId dell'oggetto Entity corrispondente.

Per richiedere il record utilizzando il relativo ID visibile invece del relativo ID database, utilizzare il metodo GetEntity.

Nota: Nella versione 7.0, il limite relativo al numero di record memorizzabili è stato incrementato come anche l'intervallo di DBID. Tuttavia, nelle versioni precedenti la 7.0 dei client Rational ClearQuest non è possibile visualizzare un numero di record con DBID (identificativi database) che supera il limite precedentemente stabilito. Per ulteriori informazioni relative ai DBID, consultare Gestione dei record

Sintassi

VBScript

session.GetEntityByDbId(entitydef_name, db_id)

Perl

$session->GetEntityByDbId(entitydef_name, db_id);
Identificativo
Description
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entitydef_name
Un valore String che identifica il nome del tipo di record al quale il record desiderato appartiene.
db_id
Un valore Long che rappresenta il numero utilizzato dal database per identificare il record.

L'ID univoco del record (Entity).

Valore di ritorno
Restituisce un Oggetto Entity che corrisponde al record richiesto.

Esempi

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);


Feedback