Revert

説明

Entity オブジェクトに行なわれたすべての変更を破棄します。

このメソッドは、レコードが編集可能であったトランザクションを終了する場合に使用します。 レコードを変更しようとして、Validate メソッドからエラーの文字列を戻された場合には、このメソッドを呼び出します。

このメソッドは、Entity オブジェクトが編集可能な場合にのみ呼び出すことができます。既存の Entity オブジェクトを編集可能にするには、Session オブジェクトの EditEntity メソッドを呼び出します。新規に作成された Entity オブジェクト (BuildEntity メソッドで作成されたオブジェクト) でこのメソッドを呼び出すと、このメソッドによってレコードのサブミットがキャンセルされます。

このメソッドは、Entity のフィールドを、データベースに保存されていた値に戻します。Entity は、元に戻されると、編集可能でなくなります。したがって、新規の変更を行うには、EditEntity メソッドを再度呼び出す必要があります。

構文

VBScript

entity.Revert 

Perl

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

VBScript

Dim entityToEdit
set sessionObj = GetSession
set entityToEdit = sessionObj.GetEntity ("Defect", "SAMPL00000002")
sessionObj.EditEntity entityToEdit, "modify"
' ...make modifications to the entity object
' Revert the changes to the record
entityToEdit.Revert 

Perl

# Get the current session
$sessionobj = $entity->GetSession();

# Select an entity to modify
$entityobj = $session->GetEntity("defect","BUGID00000042");
# Take the modify action on the entity object
$sessionobj->EditEntity($entityobj,"modify");
# ...make modifications to the entity object
# Revert the changes
$entityobj->Revert();
# At this point, the entity object is no longer modifiable 

フィードバック