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");