DeleteFieldValue

説明

フィールドの値のリストから指定された値を削除します。

このメソッドは、値のリストをサポートできるフィールドのみを意図しています。 しかし、単一値を使用するフィールドにこのメソッドを使用することは正しい方法です。 (この場合、フィールドの唯一の値は old_value と同じでなければなりません。その後このメソッドにより、フィールドの値が空の値に設定されます。)

このメソッドは、Entity オブジェクトが編集可能な場合にのみ呼び出すことができます。既存の Entity オブジェクトを編集可能にするには、Session オブジェクトの EditEntity メソッドを呼び出します。

構文

VBScript

entity.DeleteFieldValue field_name, old_value 

Perl

$entity->DeleteFieldValue(field_name, value); 
識別子
説明
entity
Entity オブジェクトは、ユーザー データ レコードを表します。構文のこの部分を省略すると、フック内では、現在のデータ レコードに対応する Entity オブジェクトが想定されます (VBScript のみ)。
field_name
この Entity オブジェクトの有効なフィールド名を含む String。
old_value
フィールドの値のリストから削除する値を含む Variant。
value
フィールドの値のリストから削除する値を含む String。
戻り値
フィールドへの変更が許可されている場合、このメソッドは空の文字列を戻します。それ以外の場合、このメソッドは、エラーの説明を含む文字列を戻します。

VBScript

AddFieldValue "field1", "option 1" 
AddFieldValue "field1", "option 2" 
AddFieldValue "field1", "option 3" 
DeleteFieldValue "field1", "option 2" 
DeleteFieldValue "field1", "option 3" 

Perl

$entity->AddFieldValue("field1", "option 1");

$entity->AddFieldValue("field1", "option 2");

$entity->AddFieldValue("field1", "option 3");



$entity->DeleteFieldValue("field1", "option 2");

$entity->DeleteFieldValue("field1", "option 3"); 

フィードバック