GetEntity

Description

Restituisce il record specificato.

Quando viene richiesto un tipo di record basato sullo stato, il parametro display_name deve contenere l'ID visibile del record (ad esempio, "DEF00013323"). Per i tipi di record senza stato, questo parametro deve contenere il valore del campo della chiave univoca del record.

Per richiedere un record utilizzando il relativo ID database invece del relativo ID visibile, utilizzare GetEntityByDbId.

Nota: per ottimizzare le prestazioni, se si desidera richiamare alcuni, ma non tutti i valori di campo per un record, è più efficace utilizzare le interrogazioni piuttosto che richiamare EditEntity. È possibile creare un'interrogazione nel campo State per evitare di ottenere l'intero record.

Sintassi

VBScript

session.GetEntity(entity_def_name, display_name) 

Perl

$session->GetEntity(entity_def_name, display_name); 
Identificativo
Description
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entity_def_name
Un valore String che identifica il nome del tipo di record al quale il record appartiene.
display_name
Un valore String che identifica il nome di visualizzazione del record. Il nome di visualizzazione dovrebbe essere l'ID visibile (123@SITE) per le entità di richiesta oppure i campi della chiave univoca per un'entità ausiliaria.
Valore di ritorno
Restituisce un Oggetto Entity che corrisponde al record richiesto.

Esempi

VBScript

set sessionObj = GetSession 
sessionObj.UserLogon "admin", "", "SAMPL", AD_PRIVATE_SESSION, ""
set record1 = sessionObj.GetEntity("defect", "DEF00013323") 

Perl

#Create a Rational ClearQuest session

$sessionObj = $entity->GetSession();

$sessionObj->UserLogon("admin","","SAMPL","");

#Get record DEF00013323

$record1 = $sessionObj->GetEntity( "defect", "DEF00013323" ); 


Feedback