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...

 } 

フィードバック