Measure the Cost of Change

Set up Order Management to measure the cost of change.

Cost of change is a numeric value that measures how much a change impacts an orchestration process. For example, the monetary cost to your company, or the difficulty that's associated with incorporating the change. You can create a business rule that measures the cost of change for an orchestration process.

If your fulfillment system requests a determination for cost of change, then Order Management calculates the value, then returns it to the fulfillment system so you can choose whether to proceed with the change. The fulfillment system can request the value before it submits the sales order. Order Management also calculates the cost after it compensates the order.

You use a business rule to assign the cost of change to an orchestration process. If you choose not to use values for the cost of change, then Order Management uses a value of zero to calculate cost.

Assume you need a business rule that measures the cost of change your company will incur when your customer requests a change. If fulfillment line status is:

• Scheduled, then cost is low

• Shipped, then cost is high

You will create these rules.

• If fulfillment line status is Scheduled, then cost of change is 5.

• If fulfillment line status is Shipped, then cost of change is 50.

This example includes a simple business rule you can use with an orchestration process that includes only one line. You use advanced rules to write a rule for more than one line. For details, see Overview of Using Business Rules With Order Management.

Summary of the Steps

1. Set up your fulfillment system.

2. Create If statement for first rule.

3. Create Then statement for first rule.

4. Create If statement for second rule.

5. Create Then statement for second rule.

6. Test your set up.

This topic uses example values. You might need different values, depending on your business requirements.

Set Up Your Fulfillment System

Order Management doesn't display the result when it calculates the cost of change. Instead, you must set up your fulfillment system to get the result from Order Management, then display it so someone who uses the fulfillment system can take the necessary action. You can use REST API to get this result.

Create If Statement for First Rule

Here's the first rule.

where

Object	Description
DooSeededOrchestrationRules	Dictionary that contains rule sets, facts, functions, variables and so on for order orchestration.
DOOFLine	Fact in DooSeededOrchestrationRules. It contains fulfillment line attributes. DOOFLine is an abbreviation for distributed order orchestration (DOO) fulfillment line (FLine). The phrase distributed order orchestration is an earlier name for Oracle Order Management.
statusCode	Fulfillment line attribute. The entire value isn't visible in the screen capture. Here's the full value. DooSeededOrchestrationRules.DOOFLine.statusCode
SCHEDULED	One value that statusCode might contain.
Result	Fact in DooSeededOrchestrationRules. You use it to store the results of the business rule you're defining.
resultObjKey	Property of the Result fact.
esultObjKey:5	Sets the value of resultObjKey to 5.

Create If statement for first rule.

1. In the Setup and Maintenance work area, go to the task.

   • Offering: Order Management

   • Functional Area: Orders

   • Task: Manage Orchestration Process Definitions

2. On the Manage Orchestration Process Definitions page, locate the orchestration process where you must add the cost of change rule, then open it for editing.

3. In the Orchestration Process area, next to Cost of Change Rule, click Click for Rule.

4. In the Cost of Change Rule dialog, click Add > General Rule > Properties, then set the values.

   Attribute	Value
   Name	Cost of Change for Scheduled Lines
   Description	This rule measures the cost to change a sales order when the fulfillment line status is Scheduled. It sets the cost of change to 5.

5. Click Left Value.

6. In the Condition Browser dialog, expand DooSeededOrchestrationRules > DOOFLine, then click StatusCode > OK.

7. In the Right Value attribute, enter "SCHEDULED". You must include the double quotation marks.

Create Then Statement for First Rule

1. In the Then area, click Add Action > Assert New.

2. Click Select a Target > DooSeededOrchestrationRules.Result.

3. Click Edit Properties.

4. In the Properties dialog, in the resultObjKey row, enter this value, then click OK.

   Attribute	Value
   Value	5

5. Click Collapse.

Create If Statement for Second Rule

Here's the second rule.

Create the If statement for the second rule.

1. Click Add > General Rule > Properties, then set the values.

   Attribute	Value
   Name	Cost of Change for Shipped Lines
   Description	This rule measures the cost to change a sales order when fulfillment line status is Shipped. It sets the cost of change to 50.

2. Click Left Value.

3. In the Condition Browser dialog, expand DooSeededOrchestrationRules > DOOFLine, then click StatusCode > OK.

4. In the Right Value attribute, enter "SHIPPED". You must include the double quotation marks.

Create Then Statement for Second Rule

1. In the Then area, click Add Action > Assert New.

2. Click Select a Target > DooSeededOrchestrationRules.Result.

3. Click Edit Properties.

4. In the Properties dialog, in the resultObjKey row, in the Value column, enter 50, then click OK.

5. In the Cost of Change Rule dialog, click Save.

6. On the Edit Orchestration Process Definition page, click Save.

Test Your Set Up

1. Modify a sales order that's at the Scheduled fulfillment line status.

2. Wait for Order Management to process the change.

3. Verify that your fulfillment system displays a value of 5 for the cost of change.

4. Modify a sales order that's at the Shipped fulfillment line status.

5. Wait for Order Management to process the change.

6. Verify that your fulfillment system displays a value of 50 for the cost of change.