Entity オブジェクトに行なわれたすべての変更を破棄します。
このメソッドは、レコードが編集可能であったトランザクションを終了する場合に使用します。 レコードを変更しようとして、Validate メソッドからエラーの文字列を戻された場合には、このメソッドを呼び出します。
このメソッドは、Entity オブジェクトが編集可能な場合にのみ呼び出すことができます。既存の Entity オブジェクトを編集可能にするには、Session オブジェクトの EditEntity メソッドを呼び出します。新規に作成された Entity オブジェクト (BuildEntity メソッドで作成されたオブジェクト) でこのメソッドを呼び出すと、このメソッドによってレコードのサブミットがキャンセルされます。
このメソッドは、Entity のフィールドを、データベースに保存されていた値に戻します。Entity は、元に戻されると、編集可能でなくなります。したがって、新規の変更を行うには、EditEntity メソッドを再度呼び出す必要があります。
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