레코드의 가시성 유형을 리턴합니다. 이 메소드는 엔티티가 존재하는지 여부와 존재하는 엔티티와 존재하지만 숨겨져 있는 엔티티를 구분할 수 있는지 여부를 나타내는 값을 리턴합니다.
EntityVisible 메소드를 사용하면 통합을 통해 표시되지 않는 사례에 참조된 레코드를 로드하지 않도록 할 수 있습니다 그렇지 않으면 로드를 시도할 때 오류가 발생됩니다. (EntityExists 메소드는 레코드가 숨겨져 있을 때에도 존재하며 로드할 수 없음을 나타냅니다.)
숨겨져 있는 레코드를 사용할 때 이 메소드가 참조 목록 지원을 제공합니다. 레코드가 숨겨진 상태에서, 사용자가 레코드를 볼 수 있지만 해당 필드 중 하나에 참조되는 레코드는 볼 수 없습니다.
이 메소드는 사용자가 볼 수 없는 결함에 대한 참조를 작성하지 않도록 차단하기 위해 관련 결함 간의 참조에 대해 보안 컨텍스트 레코드를 설정하는 데에도 사용할 수 있습니다. 이 메소드는 레코드가 표시되는지 여부에 대한 정보를 제공합니다.
Stateful 레코드의 경우, 표시 이름 인수(display_name)는 id 문자열(예: RAMBU00001234)입니다.
Stateless 레코드의 경우, display_name은 사이에 공백 문자가 있는 모든 고유 키 필드 값의 연결로 구성됩니다. 예를 들어, 프로젝트 레코드 유형에 name 및 department의 두 필드가 있고 모두 고유 키 필드로 지정된 경우, display_name은 <name> <department>"입니다.
name "ACME" 및 department "Finance"의 프로젝트:
exists_flag = session.EntityVisible "Project", "ACME Finance"
하나의 고유 키 필드 name이 있는 "ACME" 프로젝트:
exists_flag = session.EntityVisible "Project", "ACME"
VBScript
session.EntityVisible entity_def_name, display_name
Perl
$session->EntityVisible(entity_def_name, display_name);
VBScript
set sessionObj = GetSession
ResultFromEntityVisible = sessionObj.EntityVisible("defect", "test00000001")
Perl
$sessionObj = $entityObj->GetSession();
$ResultFromEntityVisible = $sessionObj->EntityVisible("defect", "test00000001");