Defining action objects

By using Event Designer, you can define an action object in an existing action, or you can share an existing action object in another action.

Before you begin

Open the Event perspective in Event Designer. The Event Explorer view opens.

About this task

You can create different types of action objects:

Defining a new action object

Procedure

  1. In Event Designer, right-click the action where you want to create the action object. Click New > Action Object. The New Action Object wizard opens.
  2. Select Add a new blank action object and click Next.
  3. Enter a name for the action object. The following must be considered when naming action objects:

    When choosing the name of an action object, note that:

    • The action object name must match the name used for the action object in the action connector.
    • The action object name must be unique across all folders.
  4. Select the event project where you want to create the action object.
  5. Select the action that you want to add the action object to.
  6. Click Finish. The Action Object editor opens.

    To complete the action object definition, you must add action object fields.

    You can also define action object properties.

    You can automatically copy fields between business objects and event objects (and vice versa) and between business objects and action objects (and vice versa), by dragging and dropping fields between them. Appropriate mappings, including building field constructors, are automatically defined. For more information, see Creating mappings between business object fields and action or event object fields.

Defining a new variant action object

About this task

You can create variant action objects only under variant actions, see Variant actions and variant action objects.

Procedure

  1. In Event Designer, right-click the variant action where you want to create the variant action object. Click New > Action Object. The New Action Object wizard opens.
  2. Select Add an action object as a variant of an existing action object and click Next.
  3. Enter a name for the action object. The following must be considered when naming action objects:

    When choosing the name of an action object, note that:

    • The action object name must match the name used for the action object in the action connector.
    • The action object name must be unique across all folders.
  4. Select the event project where you want to create the action object.
  5. Select the action that you want to add the action object to and click Next.
  6. Click the action object on which the new variant action object is based. You cannot select an action object that is defined in the action where you are creating the variant action object.
    Restriction: Variant action objects can be created only if the source object is in the same folder.
  7. Click Finish. The Action Object editor opens.

    Each variant action object is created with a name that consists of the base object name followed by a unique number and the original base action name in parentheses. For example, a variant action object created from the Give Silver Discount action object is called Give Silver Discount1 (Give Silver Discount)

    To complete the action object definition, you can click Edit Base Asset to update the action object fields.

    You can also define action object properties.

    You can automatically copy fields between business objects and event objects (and vice versa) and between business objects and action objects (and vice versa), by dragging and dropping fields between them. Appropriate mappings, including building field constructors, are automatically defined. For more information, see Creating mappings between business object fields and action or event object fields.

Defining a new template action object

Procedure

  1. In Event Designer, right-click the action where you want to create the action object. Click New > Action Object. The New Action Object wizard opens.
  2. Select Add a new action object from a template and click Next.
  3. Enter a name for the action object. The following must be considered when naming action objects:

    When choosing the name of an action object, note that:

    • The action object name must match the name used for the action object in the action connector.
    • The action object name must be unique across all folders.
  4. Select the event project where you want to create the action object.
  5. Select the action that you want to add the action object to and click Next.
  6. Click Browse to select the action object template that you want to use.
  7. Click Finish. The Action Object editor opens.

    To complete the action object definition, you must add action object fields.

    You can also define action object properties.

    You can automatically copy fields between business objects and event objects (and vice versa) and between business objects and action objects (and vice versa), by dragging and dropping fields between them. Appropriate mappings, including building field constructors, are automatically defined. For more information, see Creating mappings between business object fields and action or event object fields.

Defining an action object reused in more than one action

Procedure

  1. In Event Designer, double-click the action that is to include the action object. The Action editor opens.
  2. in the Action Objects section, click Add. The Add action objects wizard opens.
  3. Select Share existing action object. From the list of available action objects, click the action object that you want to share.
    Restriction: Shared action objects can be created only if the source object is in the same folder.
  4. Click Finish. The shared action object is added to the list of action objects in the Overview tab.

Creating an action object from a business object

If you want an action object to be identical to an existing business object, and you want the action object to be defined from the business object, then you can create the action object from the business object. Each of the fields in the new action object, are automatically defined from the corresponding business object field.

Procedure

  1. In Event Designer, right-click the business object from which you want to create the action object.
  2. Click Create Action Object from this Business Object The New Action Object wizard opens.
  3. Enter a name for the action object. The following must be considered when naming action objects:

    When choosing the name of an action object, note that:

    • The action object name must match the name used for the action object in the action connector.
    • The action object name must be unique across all folders.
  4. Select the event project where you want to create the action object.
  5. Select the action that you want to add the action object to.
  6. Click Next.
  7. Select the action object fields that you want to create and map from the business object fields.
  8. Click Finish. The action object is opened in its editor.

    In the Fields section, the fields copied from the business object are displayed.

    You can add or remove action object fields to complete the action object definition.

  9. Complete the action object definition and save your changes.

Creating an action object from another action object

You can create an action object by copying another action object. You can also drag an action object to create an action object.

About this task

You can copy and paste an existing action object between event projects.

You can copy action objects by using the drag-and-drop function. For more information, see Event Designer drag-and-drop

Complete the action object definition and save your changes.