Action Descriptor

An action descriptor describes a sequence of tools. Actions can be executed at the following locations:

In the context menus of the application entry and of elements, filters, and file descriptors. The context menus are modeled for each type using the relationship Has_Action.
In the context menu of an Eclipse text editor modeled as a global action.
In the IDEs main menu bar and in the context menu of a global action entry visible under the application's entry in the Application Explorer view if the action is defined as a global action.
Determining/updating the property values of an element (the Get_All_Properties attribute of the element type).
Creating/updating an element list or expanding a container element within tree view.
Saving/closing the editor during an editing procedure.
Determining the permitted values for a property.
Actions associated to Application Options can be executed automatically when the application is loaded or unloaded.
Validate the values entered in an AWM modeled dialog.

Attribute	Type	Description
ID *	ID *	The ID of the action descriptor.
Label [O]	String	The labeling of the action descriptor. The label of an action descriptor is mainly seen in the context menu. References to a property within the label are resolved to the current property value.
Execution Mode	Selection	Valid values are MODAL or MODELESS. The action is executed in the background if you are using the MODELESS option which means that the UI is not blocked until the action has finished.
Table Structure [O]	Element List Structure	Only to be set if a tool returns an element list. The element list is then assigned to the selected element list structure. See Table Structure for more information.
Key Binding Context [O]	Selection	The binding context in which a set key binding sequence is active, see Key Binding for more information. The key binding context is ignored if no key binding sequence has been set. The default value is `AWM Team Developer Element Views`.
Key Binding Sequence [O]	Key Sequence	The keystroke combination to execute the action, see Key Binding for more information.
Link Element List	Boolean	Only to be set if a tool returns an element list. If set to `true`, the created element links to the context resource of the action. Ignored if no element list is created. See Linked Element List for more information. The default value is `true`.
Mass Processing	Boolean	To be set if enabling mass processing for multi selections. If set to `true`, the action executes only once, even if several elements are selected. Tools of the action must support mass processing to process the whole selection. See Mass Processing Overview for more information. The default value is `false`.
Related_Save_Action [O]	ActionDescriptor	To be set if dealing with an Edit action. The selected Save action executes when saving the editor.
Related_Close_Action [O]	ActionDescriptor	To be set if dealing with an Edit or Browse action. The selected Close action executes when closing the editor.
Show Progress Monitor	Boolean	Specifies whether to show a progress monitor dialog while the action is executing. The default value is `true`.
Refresh_List	Boolean	If the action is executed on elements in the Table Results view and this attribute is set to `true`, the current element list is refreshed at the end of the action by executing the action that was used to create the list. This attribute does not support refreshing element lists in the Application Explorer view. The default value is `false`.
Icon [O]	Icon	The icon of an action descriptor can be seen in context menus.
Table_View_ID [O]	String	The Team Developer View secondary ID, which shows element lists created by this action. You can overwrite this value with the value set in the element list structure.
Table_View_Label [O]	String	The label that the Table Results view takes when showing element lists created by this action. You can overwrite this value with the value set in the element list structure.
Custom Error Message [O]	String	This attribute enables you to specify an alternative error message to the default error message displayed in the AWM Error dialog box. Note: Specifying a custom error message does not alter the text displayed when you click Details.

Relationship	Cardinality	Description
Has_Tool	1..*	Relationship to a tool descriptor. The tool sequence for an action arises through these relationships.

Example

Action descriptor SVN_ACT_CONT_AddRepository

Attribute	Value	Description
Element List Creation:	Not relevant as the action does not create an element list.
Essential:
ID	SVN_ACT_CONT_AddRepository	Unique identifier of the action in this model.
Key Binding:	Not relevant as no short key is defined for the action.
Optional:
Custom Error Message	No custom error message defined for this action.
Execution Mode	Modal	The action is blocking any parallel Eclipse activity in the foreground.
Icon	---	There is no icon associated with this action.
Label	Add Repository...	Label shown in the context menu for the action.
Mass Processing	false	The tools of this action are not designed to support processing more than one element per call.
Refresh List	false	The element list should not be refreshed after the execution of this action.
Save/Close:	Not relevant as the action is not an edit action.

Action descriptor SVN_ACT_CONT_MoveResource

Attribute	Value	Description
Element List Creation:	Not relevant as the action does not create an element list.
Essential:
ID	SVN_ACT_CONT_MoveResource	Unique identifier of the action in this model.
Key Binding:	Not relevant as no short key is defined for the action.
Optional:
Custom Error Message	No custom error message defined for this action.
Execution Mode	Modal	The action is blocking any parallel Eclipse activity in foreground.
Icon	---	There is no icon associated with the action.
Label	Move...	Label shown in the context menu for the action.
Mass Processing	true	The tools of this action are capable of processing several input elements in one call.
Refresh List	false	The element list should not be refreshed after the execution of this action.
Save/Close:	Not relevant as the action is not an edit action.