GetFieldsUpdatedThisAction

설명

최근의 조치에 의해 수정된 각 필드의 FieldInfo 오브젝트를 리턴합니다.

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

예를 들어, 사용자가 CHANGE_STATE 조치를 시작하면 레코드의 "상태" 필드에 있는 값이 변경되어도 이 메소드에서는 보고하지 않습니다. 마찬가지로, 조치의 조치 초기화 후크가 필드를 수정해도 변경사항은 보고되지 않습니다. 그러나, 필드 값 변경 후크 또는 유효성 검증 후크 중에 발생한 변경사항은 조치가 완전히 초기화된 이후에 발생하므로 보고됩니다.

구문

VBScript

entity.GetFieldsUpdatedThisAction

Perl

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

Perl의 경우, FieldInfos 오브젝트 콜렉션이 리턴됩니다.

예제

VBScript

set sessionObj = GetSession 

' Report any fields that changed during the recent action
fieldList = GetFieldsUpdatedThisAction
For Each field in fieldList
      ' Report the fields to the user
      sessionObj.OutputDebugString "Field " & field.GetName & "
         changed."
Next

Perl

$sessionobj = $entity->GetSession(); 

# Report any fields that changed during the recent action

$fieldlist = $entity->GetFieldsUpdatedThisAction();

# Find out how many duplicates there

# are so the for loop can iterate them

$updatedfields = $fieldlist->Count();

for ($x = 0; $x < $updatedfields ; $x++)

{

 # Report the fields to the user

 $sessionobj->OutputDebugString("Field ".$fieldlist->Item($x)->GetName."
       changed." )

}

피드백