Using the
Application Options have Application Actions relationship, an AWM application can be assigned actions which are executed on the application level. Action descriptors referenced using this relationship appear either in the context menu of the application entry or are executed automatically on specific conditions. Actions can be hidden or deactivated on certain conditions. An action Visible or Enabled condition determines when an action should be visible and activated. See
Enabled/Visible Condition for more information.
Attribute
|
Type
|
Description
|
TargetID *
|
ActionDescriptor
|
The reference to the action descriptor.
|
ActionVisibleCondition
|
ActionVisibleCondition
|
This complex attribute lets you define rules for when the action should be visible in the context menu of the application.
|
ActionEnabledCondition
|
ActionEnabledCondition
|
This complex attribute lets you define rules for when the action is activated. Non-activated actions are disabled, and cannot be executed by the user.
|
Default_Action [U]
|
Boolean
|
Defines whether this action should be carried out by a double-click on the application entry. Only one application action can be declared as the Default_Action.
The default value is
false.
|
Label [O]
|
String
|
Labeling of the action in the context menu. If no label is stated, the label of the referenced action descriptor is used.
|
Separator_After
|
Boolean
|
Determines whether to insert a separation line behind the context menu entry.
The default value is false.
|
SeqNo
|
Integer
|
The Position Number of the action in the context menu of an element.
|
Execution Type *
|
Selection
|
Determines when to execute the action.
Valid values are:
- Manual
- The action appears in the context menu of the application entry.
- OnLoad
- The action is executed when the AWM model is loaded. This can be when the application is loaded manually or automatically when starting Eclipse.
- OnFirstLoad
- The action is executed when the AWM model is loaded but only once during an Eclipse session.
- OnUnload
- The action is executed when the AWM model is unloaded. This can be when another application is loaded manually or automatically when closing Eclipse.
Note: Manual is the default value.
|
Skip model update check
|
Boolean
|
Determines whether a model update check should be executed if the action is executed. This is only relevant for actions which are executed when loading the model.
|
Example
Application actions of execution type
Manual can be actions to create a new object. Another sample can be an action to display and change application specific options.
Application actions of execution type
OnLoad or
OnFirstLoad can be actions to initialize the connection to a remote application system, for example, a remote database system. In this case, the execution type depends on the point in time when the connection is shut down (with the unload of the application loading another application or only when closing the Eclipse session).
Application actions of execution type OnUnload could be actions to shutdown the connection to a remote application system, for example, a remote database system.