GetEntityByDbId

Descrizione

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 l'ID visibile invece dell'ID database, utilizzare il metodo GetEntity.

Nota: I DBID sono univoci per una classe di record, univoci all'interno dei record con lo stato ed univoci all'interno dei record stateless. 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 record con DBID (identificativi database) che superano il limite precedentemente stabilito. Per ulteriori informazioni relative ai DBID, consultare Utilizzo di record.

Sintassi

VBScript

session.GetEntityByDbId(entitydef_name,db_id)

Perl

$session->GetEntityByDbId(entitydef_name, db_id);
Identificativo
Descrizione
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entitydef_name
Una stringa 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 corrispondente 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