Show TOC

Creating and Changing DeterminationsLocate this document in the navigation structure

Context

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

Procedure

  1. Starting the Wizard
    Note

    You can assign determinations only to the following types of nodes:

    • Extensible nodes that are created in the business object that is currently open

    • Extensible nodes that are created in the business object enhancement (enhancement) that is currently open

    • Extensible nodes that are created in the base object of the enhancement

    Open the business object or the enhancement in which you want to create a determination.

    In the Node Browser navigation, choose the node you need to extend with the determination. To start the Create Determination wizard, choose Create Determination in the context menu of the node.

  2. Name and Description

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

    Input Field

    Description

    Node Name

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

    Determination Name

    The name of the determination must be unique in the business object. If the determination 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 a determination name.

    Example

    <namespace or prefix>_<node name>

    Description

    Enter a short description of the determination.
  3. Implementing Class

    The implementing class contains the business logic of the determination. The implementing class is automatically created after finishing the wizard and you must subsequently 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_DETERMINATION interface. This is useful if the action logic of another determination can be reused. The system does not overwrite existing implementing classes.

  4. Determination Pattern

    Depending on the selected pattern, the trigger condition of the determination is checked by Business Object Processing Framework (BOPF) at different points during the current transaction. For more information.

    Depending on the determination pattern you choose, the wizard provides you with different specifications to define:

    • Derive dependent data immediately after modification

      1. Request Nodes

        You can define the trigger condition of the determination. The displayed nodes are linked using associations to the node to which the determination is assigned. For each node you can define whether the creation, update, or deletion of one of its instances will trigger the execution of the determination.

        At least one request node must be selected in order to ensure that the determination is executed.

      For more information about this pattern, see Pattern: Derive Dependent Data Immediately After Modification.

    • Derive dependent data before saving

      If you choose this determination pattern, please follow the steps described in determination pattern Derive dependent data immediately after modification.

      For more information about this pattern, see Pattern: Derive Dependent Data Before Saving.

    • Fill transient attributes of persistent nodes

      This pattern can be selected only if the node to which the determination is assigned contains transient attributes.

      For more information about this pattern, see Pattern: Fill Transient Attributes of Persistent Nodes.

    • Derive Instances of transient nodes

      This pattern can be selected only if a transient subnode of the node to which the determination is assigned exists.

      1. Transient Node

        Select the transient subnode whose instances are to be modified by the determination.

      For more information about this pattern, see Pattern: Derive Instances of Transient Nodes.

    • Create Property

      For more information about this pattern, see Pattern: Create Property.

  5. Write Nodes
    Note

    This screen only appears if there is more than one locking shadow defined in the base object.

    Select all nodes whose instances are created or modified by the determination.

  6. Execution Sequence
    Note

    This screen only appears if at least two determinations of the same node are configured to the same determination pattern. This can only be the case for the Derive dependent data immediately after modification and Derive dependent data before saving patterns.

    Select the determinations that must be processed before or after the current determination. The trigger condition of the determination must be fulfilled.

    Caution

    Determinations of enhancements are always executed after determinations of the base object. This means that dependencies can be defined only between determinations belonging to the same enhancement or to the same business object.

    Example

    The CALCULATE_TOTAL_AMOUNT determination sums all item amounts to the total invoice amount. Therefore it must be executed after determination CALCULATE_ITEM_AMOUNT, which calculates the item amounts (quantity x price).

  7. Finishing the Wizard

    To create the determination and finish the wizard, see Finishing the Wizard in Creating and Changing a Business Object.

Results

  • The system adds the new determination to the model of the enhancement or of the business object and displays it in the Entity Browser navigation.

  • The implementing class is generated. You must implement it manually.

  • The constants interface of the enhancement or of the business object is regenerated and contains a unique constant identifying this determination.

After you have created a determination, you can change the following specifications:

  • Determination Name

  • Description

  • Implementing Class

  • Determination Pattern

    Note

    Depending on the determination pattern you choose while changing the determination, you can define different specification during the process of change (see step Determination Pattern).

Next Steps

Implementation of Determinations