GetFieldRequiredness

설명

지정된 필드의 동작을 식별합니다.

필드는 필수, 선택적 또는 읽기 전용일 수 있습니다. 엔티티가 편집 가능한 Entity 오브젝트가 아니면 이 메소드는 항상 READONLY라는 값을 리턴합니다. 조치가 초기화되어 Entity 오브젝트가 편집 가능하면, 리턴값은 READONLY, MANDATORY 또는 OPTIONAL일 수 있습니다.

이 메소드에서는 USE_HOOK 값이 리턴되지 않습니다. 필드의 동작이 권한 후크에 의해 결정될 경우, Rational® ClearQuest®는 이미 해당 후크를 실행하여 결과 값을 캐시했을 것입니다. 그런 다음 이 메소드는 캐시된 값을 리턴합니다.

참고: 후크는 관리자(수퍼 유저) 권한을 사용하여 작동하므로 현재 동작 설정에 관계 없이 항상 필드의 컨텐츠를 설정할 수 있습니다. Rational ClearQuest 사용자에 대해 필드의 값이 READONLY인 경우 리턴값은 READONLY입니다. 레코드 유형 필드의 정의된 동작(READONLY)을 리턴하게 하려면 EntityDef 오브젝트의 GetFieldRequiredness을 참조하십시오.

GetFieldNames 메소드를 사용하여 field_name 매개변수에 대한 올바른 이름 목록을 확보할 수 있습니다.

구문

VBScript

entity.GetFieldRequiredness(field_name) 

Perl

$entity->GetFieldRequiredness(field_name); 
ID
설명
entity
사용자 데이터 레코드를 나타내는 Entity 오브젝트. 후크 내에서 구문에 이 부분을 생략할 경우, Entity 오브젝트가 현재 데이터 레코드에 해당한다고 가정합니다(VBScript에만 해당).
field_name
엔티티의 올바른 필드 이름을 식별하는 문자열.
Return value
이름 지정된 필드의 동작을 식별하는 Long 값. 값은 Behavior 상수 중 하나에 해당합니다.

예제

VBScript

' Change all mandatory fields to optional 
' Retrieve the collection of fields
fieldNameList = GetFieldNames 
For Each fieldName in fieldNameList 
' Find out if the selected field is mandatory 
	fieldReq = GetFieldRequiredness(fieldName) 
	if fieldReq = AD_MANDATORY 
	' Since it is, make it optional 
	Then SetFieldRequirednessForCurrentAction fieldName, AD_OPTIONAL 
	End If 
Next

Perl

# Change all MANDATORY fields to OPTIONAL 
# Retrieve the collection of fields 
$fieldnamelist = $entity->GetFieldNames();
foreach $fieldname (@$fieldnamelist)
{ 
	# Find out if the selected field is mandatory 
$fieldreq = $entity->GetFieldRequiredness($fieldname);
	if ($fieldreq eq $CQPerlExt::CQ_MANDATORY) 
	{ 
		# Since it is, make it optional 
$entity->SetFieldRequirednessForCurrentAction($fieldname, 
																		$CQPerlExt::CQ_OPTIONAL); 
	} 
}

피드백