Configuration Recommended Items

Overview

Recommended Item rules enable you to associate parts and models with products based on user-configured values. The items recommended may be models or parts.

If the recommended item is mandatory, then the user must buy the selected model with the recommended item. There is no way to delete the item association in the Commerce Process and buy the selected model without the recommended item.

If the item is not mandatory, then the user can opt to not buy the recommended item.

How They Work

A Recommended Item rule also has a condition and an action. The values of the attribute(s) selected as the condition attribute(s) determine the result of the condition, which when true triggers an action to show the recommended items models and/or parts selected.

There is a site option to allow the display of the price of the recommended items on the Model Configuration page. Also, the comment for the rule can be a simple comment or can be specified through an advanced rule.

ClosedRecommended Items Pricing

You can define prices for your recommended items, other than the base price of parts or models. When you define prices for the recommended items in your Recommended Items Rules page, this price is given the highest precedence over the other prices defined (in the Price Book and/or the base price). If you do not define any recommended item advanced pricing rules, the system looks for the prices defined in the Price Book and displays this price to the user. In case the Price Book is turned off, the system displays the base price for the part or model to the user.

When several rules recommending the same item are fired at the same time, then the recommended item price is picked up from the rule that is last in the order. The quantity of the recommended item is decided by adding the quantities that each of the rules provide. This is not true if the option to not sum is turned on.

How Recommended Items Pricing Works

If you define the recommended items advanced pricing, then the price of the item is given by the price specified in the rule. If you do not specify price in your rule:

  • For a model, the base price is passed to the commerce transaction.
  • For a part, if a Price Book is available and the user has access to it, then the Price Book price is passed to commerce.
  • For a part, if a user has access to multiple Price Books, then the user must choose the Price Book on the Model Configuration / Recommended Items page. The price from the chosen Price Book is then passed to Commerce.
  • For a part, if a Price Book is not available, then the price is given by the base price of the part.

Administration

ClosedCreating a Recommended Item Rule

  1. ClosedNavigate to the Recommended Items: Rules List page.
    1. Click Admin to go to the Admin Home Page.
    2. Click Catalog Definition in the Products section.

      The  Supported Products page opens.

    3. In the Navigation drop-down menu, choose Recommended Items and click List.

      The Recommended Items: Rules List page opens.

  2. Enter the rule ClosedProperties.

    This section is where you will enter basic details about the rule. For example, the name, status and where it will be applied.

    Configuration Rule Basic Details


  3. Select your ClosedCondition Type.

    Configuration rule Condition section

    The condition section allows you to select the logic that specifies when a rule should run. There are three options: Always True, Simple Condition and Advanced Condition.

    • Always True: The rule will fire automatically, every time, because a specific condition does not need to be met.
    • Simple Condition: The rule will fire based on define condition attribute values that you select from a menu.
    • Advanced Condition: The rule will fire based on an advanced function written with BML.

      Conditions are returned as Boolean.

    ClosedConfiguration Context Attribute

    Beginning in Oracle CPQ 24B the Config Operation Context (_config_operation_context) configuration system attribute can be used to identify the operation that initiated the current Configuration session. This read only system attribute will reflect unique values for new configurations, reconfigurations, search flows, and ABO Modify actions.

    The Config Operation Context system attribute is available for use in all Configuration Rule type conditions and in BML advanced conditions and/or actions. For example, when a Config Operation Context attribute is selected in a simple condition, the possible values (new, reconfigure, modify_asset, and search_flow) can be selected in the Values drop-down.

    Config Context Attributes

    The Config Operations Context attribute can be used in Configuration Rules to allow Administrators to better manage the configuration experience if necessary. For example, if an administrator would like to define a rule that should only execute for a new configuration, or resulting from a modify asset action, they can use this new attribute to control execution.


  4. Choose to apply the rule to either Configuration, Selection, or both. Configuration is the default selection.
  5. Select Mandatory, if the recommended items are required and should display as read-only.
  6. Type any Comments that you would like to display with the Recommended Items.
  7. Choose the Action type: 
    • Advanced:  You will use a BML script to return models or parts to the rule.

      The expected return format is:
      (item1~quantity1~comment1~price1[~identifier]|^|item2~quantity2~comment2~price2[~identifier2])

      Identifier is an optional parameter that is used to define a unique identifier. When part numbers are grouped, they will only be grouped if they have the same identifier.

      In this format, price is not mandatory in the string format. If you pass 0.00 or the part's configured price is 0.00, the users get ”On Request” against the Price field on the Model Configuration/Recommended Items page. If you do not pass a price or pass an invalid or a blank string, the price of the item is picked up from the Price Book/base price.

    • Simple:  You will use the UI to add parts or models to the rule.
    • Table Lookup: Select attribute values from a table. See the topic Table-Based Rules for more information.
  8. Add the Part or Model and the Quantity of each that you would like to recommend when the condition is met. In this case, it is a part. Click Add.

    Add Simple Conditions

  9. Click Update and Back to save the rule and return to the Recommended Item Rules page.

ClosedSum Recommended Item Quantities

An option, Sum Recommended Items Quantities, is available in Configuration Settings.

By default this is set to yes.

For example, let's say that you are using a Recommended Item rule to go through all of your indices of an array set:

Line Part Quantity
1 000S1 1
2 000P1 4
3 000S1 6

In this case, lines one and three, which have the same part number, would roll into one quantity.

If this is set to no, the quantities for the same item that is recommended by different rules will not be summed, and these items will appear as separate line items in the commerce document.

Quantities are still summed if the same item is recommended multiple times by the same rule or by different rules with the same variable name.

For more information, see the topic Configuration Settings.


ClosedUnderstanding the Configuration XML <selected> tag within Pipeline Viewer

The XML <selected> tag in Configuration XML within the Pipeline Viewer shows admins if items in the Recommended Parts section of the current Configuration have been selected by the sales user.

ClosedSelected

If a part has been selected, the tag will be marked “true”.

Selected Item in Pipeline viewer


ClosedNot selected

If a part has not been selected, the tag will be marked “false”.

Unselected Item in Pipeline viewer


Notes

Notes:

  • To identify how recommended item pricing interacts with other pricing methods, refer to Pricing Overview.
  • Mandatory items cannot be unchecked and will always be part of the main model at the time of invocation.
  • Prices defined for recommended items are assumed to be in the base currency format.
The user will not be able to invoke a transaction or reconfigure with missing or unavailable mandatory items.

Related Topics

Related Topics Link IconSee Also