GetEntity

설명

지정된 레코드를 리턴합니다.

State-based 레코드 유형을 요청할 경우 display_name 매개변수에는 레코드의 볼 수 있는 ID(예:"DEF00013323")가 포함되어야 합니다. Stateless 레코드 유형의 경우, 이 매개변수에는 레코드의 고유 키 필드의 값이 포함되어야 합니다.

표시 이름 대신 데이터베이스 ID를 사용하여 레코드 유형을 요청하려면 GetEntityByDbId를 사용하십시오.

참고: 성능을 최적화하려면, 레코드의 필드 값 전부가 아닌 일부를 검색하려는 경우 EditEntity를 호출하는 대신 조회를 사용하는 것이 더 효율적입니다. 전체 레코드를 가져오는 것을 피하기 위해 State 필드에 대해 조회를 빌드할 수 있습니다.

구문

VBScript

session.GetEntity(entity_def_name, display_name) 

Perl

$session->GetEntity(entity_def_name, display_name); 
ID
설명
session
현재 database-access 세션을 나타내는 Session 오브젝트입니다.
entity_def_name
레코드가 속할 레코드 유형의 이름을 식별하는 문자열입니다.
display_name
레코드의 표시 이름을 식별하는 문자열입니다. 표시 이름은 요청 엔티티에 대한 볼 수 있는 ID 또는 보조 엔티티에 대한 고유 키 필드여야 합니다.
Return value
요청된 레코드에 해당하는 Entity 오브젝트를 리턴합니다.

예제

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" ); 

피드백