EntityVisible

Descripción

Devuelve el tipo de visibilidad de un registro. Este método devuelve una indicación sobre si la entidad existe y si puede distinguir entre una entidad que existe y una entidad que existe pero está oculta.

Con el método EntityVisible, una integración puede decidir no cargar un registro referencia en los casos en los que no está visible, lo que provocaría un error si se intentara hacerlo. (El método EntityExists indica que existe un registro incluso cuando está oculto y no se puede cargar).

El método proporciona soporte para referencias y listas de referencias si utiliza ocultamiento de registro. Con ocultamiento de registro, un usuario puede poder ver un registro, pero no ver un registro al que hace referencia una de sus campos.

Este método también se puede utilizar para configurar registros de contexto de seguridad, para una referencia entre defectos relacionados para impedir que los usuarios creen una referencia a un defecto que un usuario no puede ver. El método proporciona información sobre si un registro está visible o no.

Para registros con estado, el argumento del nombre de visualización (display_name) es la serie de ID (por ejemplo, RAMBU00001234).

Para registros sin estado, el display_name se compone una concatenación de todos los valores de campo de clave exclusiva separados por un carácter de espacio. Por ejemplo, si el tipo de registro del proyecto tiene dos campos, nombre y departamento, y ambos se han designado como campos de clave exclusiva, el display_name sería <name> <department>"

Para un proyecto con el nombre "ACME" y el departamento "Finance":

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

Para un proyecto con el nombre "ACME" que tenga un campo de clave exclusiva, nombre:

exists_flag = session.EntityVisible "Project", "ACME"
Nota: Este método estuvo disponible en la versión 7.1.0.

Sintaxis

VBScript

session.EntityVisible entity_def_name, display_name 

Perl

$session->EntityVisible(entity_def_name, display_name); 
Identificador
Descripción
session
El objeto Session que representa la sesión de acceso a la base de datos actual.
entity_def_name
Un valor String que contiene el nombre del tipo de registro (EntityDef).
display_name
Un valor String que contiene el nombre de visualización (serie de ID) del registro
Valor de retorno
Devuelve un valor Long que contiene un valor de enumeración EntityStatus.

Ejemplos

VBScript

set sessionObj = GetSession

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

Perl

$sessionObj = $entityObj->GetSession();

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

Comentarios