GetFieldsUpdatedThisGroup

説明

BeginNewFieldUpdateGroup の最新の呼び出し以降に変更された、各フィールドの FieldInfo オブジェクトを戻します。

このメソッドは、SetFieldValue の呼び出しのグループの最後をマークする場合に使用します。(以前に BeginNewFieldUpdateGroup を呼び出して、グループの開始をマークしている必要があります。)この手法は、フォーム内のフィールドに行なわれた変更を追跡する必要がある場合がある、Web ベース システムの場合に役立ちます。例えば、ユーザーが別の Web ページに移動する場合、このメソッドを呼び出して、フォームの現在の状態を保存し、ユーザーがそのページに戻るときに復元できます。

構文

VBScript

entity.GetFieldsUpdatedThisGroup 

Perl

$entity->GetFieldsUpdatedThisGroup(); 
識別子
説明
entity
Entity オブジェクトは、ユーザー データ レコードを表します。構文のこの部分を省略すると、フック内では、現在のデータ レコードに対応する Entity オブジェクトが想定されます (VBScript のみ)。
戻り値
Visual Basic の場合、FieldInfo オブジェクトの配列を含む Variant が戻されます。FieldInfo オブジェクトはそれぞれ、最新の BeginNewFieldUpdateGroup 呼び出し以降に値が変更されたフィールドに対応します。 フィールドが更新されなかった場合、このメソッドによって空の Variant が戻されます。Perl の場合は、FieldInfos オブジェクトのコレクションが戻されます。

例

VBScript

BeginNewFieldUpdateGroup 
SetFieldValue "field1", "1" 
SetFieldValue "field2", "submitted" 
SetFieldValue "field3", "done" 
updatedFields = GetFieldsUpdatedThisGroup 

' Iterate over all the fields that changed 
For Each field In updatedFields 
   ' ... 
Next 

Perl

$entity->BeginNewFieldUpdateGroup()

$entity->SetFieldValue("field1", "1" );

$entity->SetFieldValue("field2", "submitted");

$entity->SetFieldValue("field3", "done");

$updatedFields = $entity->GetFieldsUpdatedThisGroup ();

$count = $updatedFields->Count();

# Iterate over all the fields that changed 

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

   {
   $field = $updatedFields->Item($x);

   # do other tasks...

 } 

フィードバック