EntityVisibleByDbId

Descrizione

Restituisce il tipo di visibilità di un record. Questo metodo restituisce un indicazione se l'entità esiste e se è in grado di distinguere tra un'entità che esiste e un'entità che esiste ma è nascosta.

Il metodo fornisce il supporto per i riferimenti e gli elenchi di riferimento se si utilizzano record nascosti. Con tale procedura, un utente può visualizzare un record, ma non un record a cui fa riferimento uno dei campi relativi.

Con il metodo EntityVisible, un'integrazione può decidere di non caricare un record di riferimento nei casi in cui non è visibile e tale tentativo risulterebbe piuttosto in un errore. (Il metodo EntityExists indica che un record esiste anche quando è nascosto e non può essere caricato.)

Nota: questo metodo è stato reso disponibile nella versione 7.1.0.
Nota: Nella versione 7.0 e successive, il limite sul numero di record che è possibile memorizzare è stato aumentato in modo da poter aumentare anche l'intervallo dei 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 sui DBID, consultare l'argomento Utilizzo di record

Sintassi

VBScript

session.EntityVisibleByDbId entity_def_name, db_id 

Perl

$session->EntityVisibleByDbId(entity_def_name, db_id); 
Identificativo
Descrizione
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entity_def_name
Una stringa che contiene il nome (EntityDef) del tipo di record.
db_id
Un valore Long che contiene il numero ID univoco del record.
Valore di ritorno
Restituisce un valore Long contenente un valore di enumerazione EntityStatus.

Esempi

VBScript

set sessionObj = GetSession

set entityObj = session.GetEntity("defect", "test00000001")

dbid = entity.GetDbId

ResultFromEntityVisibleDbid = sessionObj.EntityVisibleByDbId("defect", dbid) 

Perl

$sessionObj = $entityObj->GetSession();

$entityObj = $sessionObj->GetEntity("defect", "test00000001");

$dbid = $entityObj->GetDbId();

$ResultFromEntityVisibleDbid = $sessionObj->EntityVisibleByDbId("defect", dbid); 

Feedback