Actions

Action commands are used in the user interface to convert user interaction to business logic commands. In most cases, the default implementation is sufficient. However, in some special cases or in customizing, you must adapt or supplement the behavior. For this, use a class mapping which simplifies customizing. All classes associated with this mapping must contain the IActionCommand interface.

The definition of Action command mappings consists of several parts. One part is the definition of ActionCommandIds, which contains a list of all valid commands and their explanation.

<commandIds>

<commandId id="create" description="create new objects" />

<commandId id="delete" description="delete objects, version objects will

be deactivated (see 'reactivate')"/>

<commandId id="duplicate" description="creates a duplicate out of the

selected object"/>

<commandId id="edit" description="open the selected object for

editing"/>

<commandId id="reactivate" description="reactivate deactivated objects" />

<commandId id="save" description="make changes on objects persistent" />

...

</commandIds>

The other parts are:

Each of these areas consists of a list of <commandSet> elements. Each set requires a name attribute. This attribute specifies what the following command definitions refer to. For objectTypeCommands, it refers to the unique identifier of the object type, for listCommands, it is the unique identifier of the list, etc.

A special commandSet is "common". It includes the default implementation for all object types, lists, etc., so that only special implementations must be specified individually. For example, if multiple lists use the same implementation, you can enter all lists, separated by commas, as names of the commandSet. A list can occur in several commandSets at the same time.

<listCommands>

<commandSet name="common">

<actionCommand commandId="applyFilter" clsName="BaseApplyFilterCommand" />

...

</commandSet>

<commandSet name="riskList,controlList">

<actionCommand commandId="applyFilter" clsName="SpecialApplyFilterCommand" />

</commandSet>

<commandSet name="riskList">

<actionCommand commandId="resetFilter" clsName="SpecialResetFilterCommand" />

</commandSet>

</listCommands>