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

피드백