EditEntity
Description
Performs the specified action on a record and makes the record available for editing.
The Entity object you specify in the
entity parameter must have been previously obtained by calling GetEntityByDbId
or GetEntity
,
or by running a query. If you created the Entity object using BuildEntity
and
have not yet committed it to the database, the object is already available
for editing.
To obtain a list of legal values
for the edit_action_name parameter, call the GetActionDefNames
method
of the appropriate EntityDef object.
After calling
this method, you can call the methods of the Entity object to modify
the fields of the corresponding record. When you are done editing
the record, validate it and commit your changes to the database by
calling the Entity object's Validate
and Commit
methods,
respectively.
Syntax
VBScript
session.EditEntity
entity, edit_action_name
Perl
$session->EditEntity
(entity, edit_action_name);
- Identifier
- Description
- session
- The Session object that represents the current database-access session.
- entity
- The Entity Object corresponding to the record that is to be edited.
- edit_action_name
- A String containing the name of the action to initiate for editing. (For example: "modify" or "resolve")
- Return value
- None.
Examples
VBScript
set sessionObj = GetSession
' Edit the record whose ID is "BUGDB00000010" using the "modify" ' ' action
set objToEdit = sessionObj.GetEntity("defect", "BUGDB00000010")
sessionObj.EditEntity objToEdit, "modify"
Perl
$sessionobj = $entity->GetSession();
# Edit the record whose ID is "BUGDB00000010" using the "modify"
# action
$objtoedit = $sessionobj->GetEntity("defect", "BUGDB00000010");
$sessionobj->EditEntity($objtoedit,"modify");