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