EntityVisible

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.

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

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.

Questo metodo può anche essere utilizzato per impostare i record del contesto di sicurezza, per un riferimento tra difetti correlati, al fine di impedire agli utenti la creazione di un riferimento ad un difetto che un utente non può visualizzare. Il metodo fornisce informazioni indicanti se un record è visibile o meno.

Per i record stateless, l'argomento del nome di visualizzazione (display_name) è la stringa ID (ad esempio, RAMBU00001234).

Per i record stateless, display_name è composto dalla concatenazione di tutti i valori campo chiave univoca separati dallo spazio. Ad esempio, se un tipo di record project dispone di due campi, nome e reparto e sono entrambi designati come campi della chiave univoca, display_name sarebbe "<nome> <reparto>"

Per un progetto con nome "ACME" e reparto "Finance":

exists_flag = session.EntityVisible "Project", "ACME Finance"  

Per un progetto con nome "ACME" che dispone di un campo della chiave univoca, nome:

exists_flag = session.EntityVisible "Project", "ACME"
Nota: questo metodo è stato reso disponibile nella versione 7.1.0.

Sintassi

VBScript

session.EntityVisible entity_def_name, display_name 

Perl

$session->EntityVisible(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 contiene il nome (EntityDef) del tipo di record.
display_name
Una stringa che contiene il nome di visualizzazione (stringa ID) del record
Valore di ritorno
Restituisce un valore Long contenente un valore di enumerazione EntityStatus.

Esempi

VBScript

set sessionObj = GetSession

ResultFromEntityVisible = sessionObj.EntityVisible("defect", "test00000001") 

Perl

$sessionObj = $entityObj->GetSession();

$ResultFromEntityVisible = $sessionObj->EntityVisible("defect", "test00000001"); 

Feedback