GetEntity

Descrizione

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 stateless, 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, utilizzare le query invece di richiamare EditEntity. È possibile creare una query 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
Descrizione
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entity_def_name
Una stringa che identifica il nome del tipo di record al quale il record appartiene.
display_name
Una stringa che identifica il nome di visualizzazione del record. Il nome di visualizzazione deve essere l'ID visibile per l'entità di richiesta oppure i campi della chiave univoca per le entità ausiliarie.
Valore di ritorno
Restituisce un Oggetto Entity corrispondente al record richiesto.

Esempi

VBScript

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

Perl

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

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

Feedback