GetFieldsUpdatedThisEntireAction

설명

초기화 후크에 이루어진 변경사항을 포함하여 전체 조치에 의해 수정된 각 필드의 FieldInfo 오브젝트를 리턴합니다. GetFieldsUpdatedThisEntireAction 메소드 (버전 2003.03.15의 새로운 기능)는 조치를 수행하는 중에 변경된 필드를 판별할 때 사용되는 논리에 대한 문제점을 해결합니다.

이 메소드는 BuildEntity 또는 EditEntity를 호출하기 전에 변경된 모든 필드를 비롯하여 전체 조치 중에 변경된 필드를 보고합니다. 조치 초기화 중에 내재적으로 변경된 필드(FIELD_DEFAULT_VALUE 후크 설정 초기 기본 필드 값을 포함함)가 보고됩니다. 조치 초기화 중에 후크에 의해 수정된 필드도 보고됩니다. 이 메소드는 조치의 초기화 단계 이후에 후크에 의해 변경된 필드를 보고합니다. 후크 실행 순서 및 타이밍에 대해서는 Rational® ClearQuest® Designer 문서를 참조하십시오.

참고: 이 메소드는 버전 2003.06.13부터 사용 가능해졌습니다.

구문

VBScript

entity.GetFieldsUpdatedThisEntireAction 

Perl

$entity->GetFieldsUpdatedThisEntireAction(); 
ID
설명
entity
사용자 데이터 레코드를 나타내는 Entity 오브젝트입니다. 후크 내에서 구문에 이 부분을 생략할 경우, Entity 오브젝트가 현재 데이터 레코드에 해당한다고 가정합니다(VBScript에만 해당).
Return value
VBScript의 경우, FieldInfo 오브젝트 배열을 포함하는 Variant 값이 리턴됩니다. 각 FieldInfo 오브젝트는 최신 조치가 초기화된 이후에 값이 변경된 Entity 오브젝트의 필드에 해당합니다. 필드가 업데이트되지 않았으면 이 메소드에서 빈 Variant 값이 리턴됩니다. Perl의 경우, FieldInfos 오브젝트 콜렉션이 리턴됩니다.

예제

VBScript

DIM CQFieldInfo
DIM CQFieldInfos
DIM sessionObj
set sessionObj = GetSession 
' Report any fields that changed during the recent action
CQFieldInfos = CQEntity.GetFieldsUpdatedThisEntireAction
' Get the list of field names returned by this function ...
For Each CQFieldInfo In CQFieldInfos
' Report the fields to the user
   sessionObj.OutputDebugString "Field " & CQFieldInfo.GetName & " changed."
Next

Perl

my(@ActualUpdatedFields);
my($CQFieldInfos);
my($CQEntity);
# Report any fields that changed during the recent action
$CQFieldInfos = $CQEntity->GetFieldsUpdatedThisEntireAction();
# Get the list of field names returned by this function ...
@ActualUpdatedFields = &GetFieldNames($CQFieldInfos);

피드백