Creating and Changing Actions

Context

Business Object Builder (BO Builder) provides you with a wizard for creating an action.

Procedure

Starting the Wizard
Note
You can assign actions only to the following types of nodes:
- Nodes that are created in the current open enhancement
  
  The system marks these nodes blue in the Node Browser navigation.
- Extensible nodes belonging to a base object.
  
  The system marks these nodes black in the Node Browser navigation.
Open the business object or the business object enhancement (enhancement) in which you want to create an action. In the Node Browser navigation, choose the node to you need to extend with an action. To start the Create Action wizard, choose Create Action in the context menu of the node.

Name and Description

In this step, you enter the name and the description of the action.

Input Field	Description
Node Name	This displays the node to which the action is assigned in the model of the business object or of the enhancement.
Action Name	The name of the action must be unique in the business object. If the action is created in an enhancement, it must start with the namespace or the prefix of the enhancement. This ensures that the entities of different enhancements are clearly separated. The namespace or prefix must be completed with the action name. Example `<namespace or prefix>_<action name>`
Description	Enter a short description of the action.

Input Field

Description

Node Name

This displays the node to which the action is assigned in the model of the business object or of the enhancement.

Action Name

The name of the action must be unique in the business object. If the action is created in an enhancement, it must start with the namespace or the prefix of the enhancement. This ensures that the entities of different enhancements are clearly separated.

The namespace or prefix must be completed with the action name.

Example

<namespace or prefix>_<action name>

Description

Enter a short description of the action.

Implementing Class

In this step, you specify the implementing class and the parameter structure of the action. Furthermore, you choose the action cardinality.

Entry Field	Description
Implementing Class	The implementing class contains the business logic of the action. The system automatically creates the implementing class after finishing the wizard. You must implement it manually. Since the implementing class name must meet naming conventions, the wizard automatically suggests a valid class name. You can also define an existing class by implementing the /BOBF/IF_FRW_ACTION interface. This is useful if the business logic of another action can be reused. The system does not overwrite existing implementing classes.
Action Cardinality	The action cardinality defines how many node instances the action can operate on during one action call. You can choose from the following action cardinality types: Multiple Node Instances The action operates on one or more node instances. Single Node Instance The action operates on exactly one single node instance. Static Action (No Node Instances) The action does not operate on any node instances.
Parameter Structure	Some actions need an additional importing parameter. Enter a name for the parameter structure and create and activate the structure using forward navigation.

Entry Field

Description

Implementing Class

The implementing class contains the business logic of the action. The system automatically creates the implementing class after finishing the wizard. You must implement it manually.

Since the implementing class name must meet naming conventions, the wizard automatically suggests a valid class name.

You can also define an existing class by implementing the /BOBF/IF_FRW_ACTION interface. This is useful if the business logic of another action can be reused. The system does not overwrite existing implementing classes.

Action Cardinality

The action cardinality defines how many node instances the action can operate on during one action call. You can choose from the following action cardinality types:

Multiple Node Instances

The action operates on one or more node instances.
Single Node Instance

The action operates on exactly one single node instance.
Static Action (No Node Instances)

The action does not operate on any node instances.

Parameter Structure

Some actions need an additional importing parameter. Enter a name for the parameter structure and create and activate the structure using forward navigation.

Extensibility
This option appears only if you create an action within a business object enhancement. Choose if the action can be enhanced with the following enhancements:
- Pre-action enhancement
- Post-action enhancement
- Action validations
Finishing the Wizard
To create the action and finish the wizard, see Finishing the Wizard in Creating and Changing a Business Object.

Results

The system adds the new action to model of the business object or of the enhancement.

It displays the action in the Entity Browser navigation when you select the corresponding node.
The implementing class of the action is generated and must be implemented.
The constants interface of the business object or of the enhancement is regenerated and contains a unique constant identifying this action.

The consumer needs the constant to execute the action.

After you have created an action, you can change the following specifications:

Action Name
Description
Implementing Class
Action Cardinality
Parameter Structure

Next Steps

Implementation of Actions