GetFieldsUpdatedThisEntireAction

説明

アクション全体で変更された各フィールドの FieldInfo オブジェクトを戻します (すべての初期化フックで行なわれた変更を含む)。GetFieldsUpdatedThisEntireAction メソッド (バージョン 2003.03.15 で新規導入) は、アクション中に変更されたフィールドを判別するために使用するロジックで問題を解決します。

このメソッドは、アクション全体の中で変更されたフィールドのレポートを作成します。これには、BuildEntity または EditEntity の呼び出しから戻される前に変更されたフィールドをすべて含みます。 アクションの初期化中に暗黙的に変更されたフィールド (FIELD_DEFAULT_VALUE フックで設定するデフォルトの初期フィールド値を含む) がレポートされます。アクションの初期化中にフックによって変更されたフィールドもレポートされます。このメソッドは、アクションの初期化フェーズ後にフックによって変更されたフィールドをレポートします。フックのタイミングおよび実行順序については、ClearQuest® Designer の資料を参照してください。

注: このメソッドは、バージョン 2003.06.13 で使用可能になります。

構文

VBScript

entity.GetFieldsUpdatedThisEntireAction 

Perl

$entity->GetFieldsUpdatedThisEntireAction(); 
識別子
説明
entity
Entity オブジェクトは、ユーザー データ レコードを表します。構文のこの部分を省略すると、フック内では、現在のデータ レコードに対応する Entity オブジェクトが想定されます (VBScript のみ)。
戻り値
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);

フィードバック