Industries Order Management

Decomposition
Exercise Guide
Version 1.0
Industries Order Management
Decomposition Exercise Guide

TABLE OF CONTENTS

Preface 4
Overview 4
What You Will Learn 4
Prerequisites 4

Decomposition Overview 5
Industries Order Management Decomposition 5
What is Order Decomposition? 5

Exercise 5-1: Creating One-to-one Decomposition Relationships 7

Task 1: Create a decomposition relationship between the Home Hub Modem and
Home Hub 2000 CFS technical product 9
Task 2: Create a condition rule for the Home Hub Modem -> Home Hub 2000 CFS
decomposition relationship 10
What are Condition Rules? 10
Task 3: Create a static mapping rule for the Home Hub Modem -> Home Hub 2000 CFS
decomposition relationship 14
What are Mapping Rules? 14
Task 4: Test the decomposition relationship 16
Task 5: Display Actions in Decomposition Results 19

Exercise 5-2: Creating One-to-many Decomposition Relationships 20

Task 1: Create a decomposition relationship between the Home Hub Modem and
Home Hub 3000 CFS technical product 21
Task 2: Create condition and mapping rules by editing the JSON data 24
Task 3: Test the decomposition relationships 30

Exercise 5-3: Creating Many-to-one Decomposition Relationships 32

What is many-to-one (M:1) decomposition? 33
Task 1: Review the M:1 decomposition design 34
Task 2: Create the M:1 decomposition relationships 36
Task 3: Test the new M:1 decomposition relationships 45

Exercise 5-4: Creating Multi-level Decomposition Relationships 50

What are multi-level decomposition relationships? 51

© Copyright 2022 Salesforce.com, inc. All rights reserved. 2

Industries Order Management
Decomposition Exercise Guide

Task 1: Review multi-level decomposition design 52

Task 2: Create first level (source) decomposition relationships for the DSL service
product spec 53
Task 3: Configure first level decomposition relationships 55
Task 4: Create third level (destination) decomposition relationships 60
What are Destination Decomposition Relationships? 60
Task 5: Configure third level (destination) decomposition relationships 63
Task 6: Test the new multi-level decomposition relationships 65

Exercise 5-5: Using Product Class for Decomposition Relationships 67

Task 1: Review the product class decomposition model 68
Task 2: Create a product class 70
Task 3: Link cloud storage products to the product class 75
Task 4: Create a decomposition relationship between a product class and the technical
product 77
Task 5: Test the product class decomposition relationship 79

Exercise 5-6: Creating Multi-level Decomposition Relationships Challenge 82

Task 1: Review the modified multi-level decomposition relationships 83
Task 2: Configure the decomposition relationships 84
Task 3: Test the decomposition relationships 85
Task 4: Fun with Connection Types! 86

© Copyright 2022 Salesforce.com, inc. All rights reserved. 3

Industries Order Management
Decomposition Exercise Guide

Preface
These training exercises are based on the Spring ’22 release of Salesforce Industries
Communications, Media, and Energy & Utilities Clouds. For additional information about
the topics covered in this module, see the documentation available in Success Community
at https://success.vlocity.com.

Overview

This module covers fundamental features and functionality of the Industries Order
Management (IOM) application. This module has been designed to review basic Industries
Order Management concepts, the UI (user interface), as well as introduce technical
products in the Industries Shared Catalog.

This is a hands-on course with practical lab exercises. The lab exercises are designed to be
used with the provided training playground.

What You Will Learn

When you complete this training, you will be able to:

● Map commercial product to technical products through decomposition relationships

● Create, configure, and test several types of decomposition relationships, including
multi-level decomposition relationships
● Use condition rules and mapping rules in decomposition relationships
● Configure a product class and use it to reduce the number of decomposition
relationships for similar products

Prerequisites
The prerequisites for this module include a solid understanding of basic Salesforce concepts
and functionality. You should also have a good understanding of the principles of order
management and a working knowledge of the telecommunications, media, or energy and
utilities industry business objectives.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 4

Industries Order Management
Decomposition Exercise Guide

Decomposition Overview
Industries Order Management Decomposition
Industries Order Management offers comprehensive functionality across two primary areas:

1. Order Decomposition (the focus of this exercise guide)

2. Order Orchestration and Management

What is Order Decomposition?

After the capture of a customer order, the first step in processing is to decompose the order
into sub-orders, called fulfillment requests, tailored for specific downstream systems. The
decomposition process enriches information from the original order by executing rules that
derive the technical attributes required to fulfill the order. Industries Order Management
uses Decomposition Relationships to define these rules.

A decomposition relationship creates a one-to-one (1:1) relationship between a source

product and a destination product. To create a one-to-many (1:M) relationship, you can
create multiple decomposition relationships for any given source product. Finally, you can
also create many-to-one (M:1) relationships by using multiple decomposition relationships
and the Scope function, which we will touch on later in this training.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 5

Industries Order Management
Decomposition Exercise Guide

BEST PRACTICE:
Salesforce Industries recommends designing your decomposition
relationships in a diagramming tool or a spreadsheet first rather than
designing them in the system. Like a good carpenter, you want to measure
twice and cut once! By doing so, you can review the decomposition design to
ensure that your decompositions are logical, efficient, and result in the fewest
fulfillment requests and callouts to external systems as possible.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 6

Industries Order Management
Decomposition Exercise Guide

Exercise 5-1: Creating One-to-one

Decomposition Relationships
Scenario
Now Greg needs to define the relationship between the commercial product, the Home
Hub Modem, and a technical product he just created. He does this by creating a
decomposition relationship. This decomposition relationship will be used by Industries
Order Management to translate a commercial product into a technical product, which
provides more detailed product information—information not needed by the customer but
required by downstream fulfillment systems.

Goal
● Decompose commercial orders into fulfillment requests
● Define decomposition relationships between commercial and technical products
● Translate commercial product attributes into decomposition attributes using
mapping rules
● Trigger decomposition using a condition rule

Tasks
1. Create a decomposition relationship between the Home Hub Modem and Home
Hub 2000 CFS technical product
2. Create a condition rule for the Home Hub Modem -> Home Hub 2000 CFS
decomposition relationship
3. Creating a static mapping rule for the Home Hub Modem -> Home Hub 2000 CFS
decomposition relationship
4. Test the decomposition relationship
5. Display Actions in Decomposition Results

Time: 25 mins

© Copyright 2022 Salesforce.com, inc. All rights reserved. 7

Industries Order Management
Decomposition Exercise Guide

NOTE:
This exercise requires the completion of an earlier overview exercise (Creating
Technical Products in the Industries Shared Catalog).

ALERT:
If you’ve just received your training playground, add your email address to the
system administrator profile to ensure you receive all system notifications. In
the upper-right, click on the Avatar and select Settings. Enter your email
address in the Email field on the Personal Information page and click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 8

Industries Order Management
Decomposition Exercise Guide

Task 1: Create a decomposition relationship between the Home Hub

Modem and Home Hub 2000 CFS technical product

NOTE:
Decomposition Relationships are defined using the Products screen, not the
Product Console.

In this exercise, you will build a one-to-one relationship between the Home Hub Modem
and the technical product you created previously, the Home Hub 2000 CFS.

1. In the Lightning search dialog, enter home hub modem.

2. In the search results list, click Home Hub Modem. (Or use the Search feature from
the Salesforce Products tab.)

3. Click the Related tab.

4. In the Decomposition Relationships (Source Product) related list, click New.

5. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name Home Hub Modem -> Home Hub 2000
CFS

Destination (Product) Home Hub 2000 CFS

6. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 9

Industries Order Management
Decomposition Exercise Guide

Task 2: Create a condition rule for the Home Hub Modem -> Home Hub
2000 CFS decomposition relationship

What are Condition Rules?

Just like you might expect, a condition rule places a condition on the decomposition
relationship so that it will only be initiated if the decomposition condition is true. Essentially,
condition rules are like a WHERE clause in SoQL or other query languages. Condition rules
can evaluate attributes or fields on the order item, as well as other fields that are related to
the order item as long as the entire order is included in the fulfillment request.

In Infiwave’s scenario, the Home Hub Modem’s Grade attribute will be evaluated. The values
of this attribute can be either Good or Better. If they select Good or Better, they will be
provisioned the Home Hub 2000 CFS. The truth is, Greg knows when the new Home Hub
3000 is released it will provide customers with the best throughput option, but he’ll have to
figure that out later.

NOTE:
When condition rules are evaluated against values from an attribute picklist,
the matching algorithm evaluates the VALUE property of the picklist. (Not the
LABEL. However, often the VALUE and the LABEL are the same.)

© Copyright 2022 Salesforce.com, inc. All rights reserved. 10

Industries Order Management
Decomposition Exercise Guide

1. Click the Home Hub Modem -> Home Hub 2000 CFS decomposition relationship
that you just created. Scroll down and locate the Conditions section, and make sure
it is expanded.

NOTE:
When configuring conditions, both simple and complex Boolean expressions
are supported. By default, No Condition is put in place.

2. Click the down arrow for the No Condition option, then click OR.

The left and right side of an OR expression is started for you. The user interface (UI) will
help you fill out the rest of the boolean expression.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 11

Industries Order Management
Decomposition Exercise Guide

3. Click in the first empty field of the expression. This is where you specify the product
and attribute for the conditional expression.

4. Click on the Internet Services-Grade attribute, then click Select. (The product is
already selected for you.)

With the product and attribute selected, you are ready to fill out the rest of the mapping
information.

5. Make sure the Operator is set to = then enter Good in the last field.

6. Fill out the second condition similarly, but enter Better in the last field.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 12

Industries Order Management
Decomposition Exercise Guide

7. Click Save Conditions when ready.

Now that you’ve defined the decomposition relationship and the condition to control when
it fires, you can create mapping rules to provide data to the fulfillment requests that will
result as a part of the decomposition process.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 13

Industries Order Management
Decomposition Exercise Guide

Task 3: Create a static mapping rule for the Home Hub Modem ->
Home Hub 2000 CFS decomposition relationship

What are Mapping Rules?

Mapping rules are used to define the information from the source product that will be
passed to the destination product, and thereby to downstream systems. The source product
data can be a field or an attribute, but the destination product data MUST be stored as an
attribute.

There are three types of mapping rules:

● ad-verbatim: the source value is copied as is to the destination attribute

● list: list mappings are configured as pairs of source and destination values, and if the
source value is matched, the corresponding destination value is copied to the
destination attribute
● static: allows you to specify a static text string as the destination attribute value

Next, you’ll create a static mapping rule to provide the modem standard code for the Home
Hub 2000 modem product. This rule will specify that any time this decomposition
relationship fires, the decomposition process will set the Modem Standard attribute to
“G.992.3;G.992.5.”

1. Scroll up and find the Mapping Rules section.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 14

Industries Order Management
Decomposition Exercise Guide

2. Click + Add New Rule.

3. In the Mapping Rule, set the Mapping Type to static.

4. Then, enter the following information. (For the Destination Attribute, use the search
dialog to select the Modem Standard attribute.)

Field / Property Value

Attribute/Field/Value G.992.3;G.992.5

Destination Attribute Technical Attributes-Modem Standard

5. Click Save. (Note the Source Type will switch from Attribute to blank once saved.)

6. Refresh the page and expand the Advanced section.

Notice the Condition Data and Mappings Data fields are now populated with JSON to
reflect what you configured in the UI.

At this point, you’ve created a decomposition relationship between the Home Hub Modem
and the Home Hub 2000 CFS. During decomposition, this relationship will function as a
one-to-one relationship, and when the customer orders the Home Hub Modem with an
internet grade of “Good” or “Better”, they will receive the Home Hub 2000 CFS. Let’s test it
to make sure it’s working as planned!

© Copyright 2022 Salesforce.com, inc. All rights reserved. 15

Industries Order Management
Decomposition Exercise Guide

Task 4: Test the decomposition relationship

1. In the Lightning tab navigation bar, click the Orders tab.

2. Click New.

3. On the New Order page, enter the following information.

Field / Property Value

Order Name Home Hub 1:1 Order

Account Name White, Noah

Order Start Date [today]

Price List B2C Price List

4. Click Save.

5. Select Configure Order in the Power Launcher. This will launch the cart.

TIP:
In the Power Launcher, you can also scroll to see additional options, or begin
typing and the launcher will help you narrow in on related options. For
example, type view. Several options beginning with “View” are displayed.
Notice View Decomposition. Orders can only be decomposed one time. With
this option, you can view previously decomposed orders though.

6. In the PRODUCTS panel, find Home Hub Modem, and click Add to Cart.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 16

Industries Order Management
Decomposition Exercise Guide

7. On the red notification message, click the Take Me There icon to invoke the
configuration window.

8. Set the Grade attribute to Better in the dropdown.

9. Click Close.

10. In the cart header, click Decompose Order.

NOTE:
The Decompose Order action and button are provided for testing, training,
and debugging purposes. In a production environment, the decomposition
process typically happens automatically when the order is submitted from
CPQ to IOM and would then immediately kick off the orchestration process.
Depending on your browser configuration, you may need to allow pop-ups to
decompose the order.

This action will invoke the decomposition process and bring you to the Order
Decomposition page, which lets you visualize the results of the decomposition process. On
the left side, you can see the Source Orders and on the right side, you can see the
decomposed fulfillment requests.

11. On the Source Orders side, click the link icon next to the Home Hub Modem.
The highlight shows the link between the source order and the decomposed
fulfillment request. In a simple order like this, it may not seem impressive; but in a
larger order, it certainly is!

Notice that the Home Hub Modem with the Grade attribute set to Better was successfully
decomposed to the Home Hub 2000 CFS, and the static mapping rule set the Modem
Standard (G.992.3;G.992.5) attribute value correctly.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 17

Industries Order Management
Decomposition Exercise Guide

Just to be thorough, test another decomposition relationship by placing another order, but
this time configure the Grade attribute to “Good”. After decomposing the order, you should
see the Home Hub 2000 CFS product beneath the Decomposed Fulfilment Requests. The
Modem Standard attribute should be set to “G.992.3;G.992.5” as well. Recall that the
condition rule configured earlier was if the Grade was set to “Good” OR “Better” then the
Home Hub Modem should be mapped to the Home Hub 2000. That is why both orders
have similar decomposition results. Don’t worry, that is about to change.

TIPS:
To easily test other attribute configurations, Clone the first order, and then
launch the cart to add the modem. Remember to change the new order’s
name and set the Status to Draft. You cannot save a cloned order when the
Status is already Activated.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 18

Industries Order Management
Decomposition Exercise Guide

Task 5: Display Actions in Decomposition Results

You can configure the basics to display on the decomposition results page. The most
important of these is the Actions for each Order Line Item (OLI).

1. In the Lightning tab navigation bar, click the Orders tab.

2. Click the link in the Order Number column corresponding to the Home Hub 1:1
Order you just created.

3. Enter View Decomposition and select it from the Power Launcher. The Order
Decomposition results for the Home Hub Modem order are displayed again.

4. Click the gear icon in the upper right and then click the Show Actions checkbox.

Notice the Add action associated with the Home Hub Modem line item (commercial
product) and the Home Hub 2000 CFS (technical product). These are basic results from a
basic order. However, if there were additional line items in the order, they would be
displayed as well along with their actions. Most orders contain line items that are added to
them in similar fashion. However, later on you will learn about other actions when more
complex orders are decomposed and fulfilled using Industries Order Management (IOM).
For example, MACD (Modify Add Change Delete) orders and in-flight order cancellations.
The product combined with the action are both critical when it comes to order fulfillment,
which is carried out by the orchestration component of IOM. Enough of that for now! You
will be stepped through the details later. For now, just realize you are free to toggle the
display of actions as you see fit.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 19

Industries Order Management
Decomposition Exercise Guide

Exercise 5-2: Creating One-to-many

Decomposition Relationships
Scenario
With the pending release of a newer model Home Hub modem, Greg plans to extend the
existing one-to-one (1:1) decomposition model into a one-to-many (1:M) model, all with
minimal effort! He's confident Marketing will be ecstatic how quickly he can have IOM ready
to go for the new product launch. Maybe less is more? That is, less effort results in more
products! IOM coupled with intelligent product modelling in the shared catalog is a
win-win!

Goal
● Transition the existing one-to-one product model to a one-to-many model
● Copy, paste, and modify existing JSON data for a new technical product
● Learn more about the IOM user interface (UI)

Tasks
1. Create a decomposition relationship between the Home Hub Modem and Home
Hub 3000 CFS technical product
2. Create condition and mapping rules by editing the JSON data
3. Test the decomposition relationships

Time: 25 mins

NOTE:
This exercise requires the completion of an earlier overview exercise (Creating
Technical Products in the Industries Shared Catalog).

© Copyright 2022 Salesforce.com, inc. All rights reserved. 20

Industries Order Management
Decomposition Exercise Guide

Task 1: Create a decomposition relationship between the Home Hub

Modem and Home Hub 3000 CFS technical product
It's important to realize that getting a newer generation product (e.g. Home Hub 3000)
offering new and improved functionality is a common occurrence. Also important is the
ability to introduce the new product into an existing service without having to modify or
remodel the currently offered service. The shared catalog and IOM team up nicely to enable
bringing this new product to market quicker without overhauling the existing product
models. You have already created two technical products earlier - the Home Hub 2000 CFS
and the Home Hub 3000 CFS. In this exercise, you will extend the existing one-to-one
relationship into a one-to-many relationship between the Home Hub Modem product and
the two technical products created earlier.

1. Use Search or the Products tab and return to the Home Hub Modem’s Related tab.

2. In the Decomposition Relationships (Source Product) related list, click New.

3. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name Home Hub Modem -> Home Hub 3000
CFS

Destination (Product) Home Hub 3000 CFS

NOTE:
Condition and Mappings Data can be entered in JSON format directly when
creating a new decomposition relationship, but be warned—every comma,
colon, and curly brace counts! That is why the previous exercise used the UI to
configure and generate the data. Less potential for pesky syntax errors! (It’s
nice to know you have options though.)

4. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 21

Industries Order Management
Decomposition Exercise Guide

At this point, you’ve created decomposition relationships between the Home Hub Modem
and two technical products, the Home Hub 3000 CFS and the Home Hub 2000 CFS. During
decomposition, these relationships as they are currently defined will function as a
one-to-many relationship, and when the customer orders the Home Hub Modem, they will
get the Home Hub 2000 CFS and the Home Hub 3000 CFS.

But, obviously, they don’t need two modems, right? You must create the logic for the
decomposition process to decide which modem they need. You will do this with condition
rules for the decomposition relationship you just created for the new Home Hub 3000
modem.

For Infiwave’s scenario, the Home Hub Modem’s Grade attribute will be evaluated. The
values of this attribute are Good, Better and Best. If the customer selects Best, they should
be provisioned with the Home Hub 3000 CFS product. If they select Good or Better, they
will be provisioned the Home Hub 2000 CFS. You will complete the configuration next, and
learn a new trick along the way.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 22

Industries Order Management
Decomposition Exercise Guide

© Copyright 2022 Salesforce.com, inc. All rights reserved. 23

Industries Order Management
Decomposition Exercise Guide

Task 2: Create condition and mapping rules by editing the JSON data
You just learned the basics for setting up conditions and mapping rules for decomposition
relationships. This time you’ll learn a new trick: copy, paste, and modify. That is, use existing
JSON data to copy, paste, then modify either directly or in the UI as needed for a slightly
different product.

NOTE:
This “trick” is optional. Creating conditions and mapping rules from scratch
with the UI is always available to you. Condition and Mappings Data can be
entered in JSON format directly when creating a new decomposition
relationship, but the syntax can be a challenge!

1. Navigate to the Home Hub Modem -> Home Hub 2000 CFS decomposition
relationship you created earlier.

2. Scroll to the Advanced section and expand it so you can see the Condition Data and
Mappings Data.

TIP:
When copying and pasting JSON data, you can use any text editor as a
temporary buffer. However, using a free website such as www.jsonlint.com
works well, especially if you want to validate the JSON and have it formatted
so it is easier to read. IOM permits unformatted JSON. It has to be valid of
course, but a single string run together is perfectly fine. This lab uses two
browser tabs with jsonlint.com (but again, this is not mandatory).

3. Open up www.jsonlint.com in two browser tabs. You will use one for Conditions
Data and the other for Mappings Data.

4. Click the edit pencil icon adjacent to the Conditions Data.

5. Place your cursor in the Condition Data field. Copy all of the JSON.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 24

Industries Order Management
Decomposition Exercise Guide

TIP:
You can click, scroll and select with your mouse, but it’s even easier to use the
following to select and copy everything into a buffer:
● Command+a Command+c (on a Mac)
● Control+a Control-c (on a PC)
Later, to paste data from the buffer:
● Command+v (Mac)
● Control+v (PC)

6. Paste the Conditions JSON into the left-most jsonlint.com browser tab. (Organizing
the left and right this way parallels the page layout in the decomposition
relationship, so it is less error prone.)

7. Place your cursor in the Mappings Data field. Copy all of the JSON.

8. Paste the Mappings JSON into the right-most jsonlint.com browser tab.

9. Click Cancel to avoid accidental edits on the Home Hub Modem -> Home Hub
2000 CFS decomposition relationship.

10. Click Validate JSON in both of your jsonlint.com browser tabs.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 25

Industries Order Management
Decomposition Exercise Guide

Both should be valid and formatted JSON. Next you can use the Home Hub 2000 JSON
data as a starting point for the Home Hub 3000 data.

11. Navigate to the Home Hub Modem -> Home Hub 3000 CFS decomposition
relationship you created earlier.

12. Scroll to the Advanced section and expand it so you can see the Condition Data and
Mappings Data.

13. Click the pencil icon so you can edit the Condition Data and Mappings Data.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 26

Industries Order Management
Decomposition Exercise Guide

14. Paste in the Condition Data from the left-most jsonlint.com browser tab (what was
originally from the Home Hub 2000).

15. Paste in the Mappings Data from the right-most jsonlint.com browser tab.

16. Click Save and then refresh your browser. With the JSON data saved, scroll down and
notice the Mapping Rules and Conditions sections are filled out. You are ready to
modify it using the UI so it is correct for the new Home Hub 3000 modem. (This
time you will tackle Mappings first, because it is a bit simpler.)

17. Click the pencil icon to edit the existing Mapping Rule. Change the
Attribute/Field/Value to G.993.2 and click Save. (Note: The trailing “.” is
punctuation, and should not be entered in the field.)

18. Click the garbage can icon to delete the first Single Condition (e.g. “Good”).

19. Change “Better” to “Best”, and then click Save Conditions.

If you refresh your browser and view the Condition Data again, the JSON reflects the
changes you just made via the UI. You will also notice there is still a logical OR in the JSON,
but only one grade attribute (“Best”) when there used to be two (“Better” and “Best”).
Technically, this is valid JSON, and it will produce the correct results for the decomposition
relationship. However, some may not sleep well without elegant JSON, so the next step will
clean it up (and reinforce the fact you can copy, paste, and modify JSON via the UI and/or
directly without hindering IOM at all).

© Copyright 2022 Salesforce.com, inc. All rights reserved. 27

Industries Order Management
Decomposition Exercise Guide

20. Remove the following four lines from the JSON in the Conditions Data:

a. Remove the 1st two lines (“type” and “singleconditions”)

b. Remove “right-side-type”: “value”
c. Remove the closing “}]” which is no longer needed with a simple condition.

NOTE:
The following screen-shots are provided to make the before and after JSON
very clear. They use formatted JSON (from jsonlint.com) inside an expanded
Conditions Data field. (Notice the handle in the lower right of the field that
allows you to scroll for a larger view, able to accommodate formatted JSON.)

Before editing the JSON directly:

© Copyright 2022 Salesforce.com, inc. All rights reserved. 28

Industries Order Management
Decomposition Exercise Guide

After editing JSON directly:

21. Click Save when finished with the edits.

You are ready to test out the new decomposition relationship which helped transition from
a one-to-one to a one-to-many model.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 29

Industries Order Management
Decomposition Exercise Guide

Task 3: Test the decomposition relationships

1. In the Lightning tab navigation bar, click the Orders tab.

2. Click New.

3. On the New Order page, enter the following information.

Field / Property Value

Order Name Home Hub 1:M Order

Account Name White, Noah

Order Start Date [today]

Price List B2C Price List

4. Click Save.

5. Select Configure Order in the Power Launcher to launch the cart.

6. In the PRODUCTS panel, find Home Hub Modem, and click Add to Cart.

7. On the red notification message, click the Take Me There icon to invoke the
configuration window.

8. Set the Grade attribute to Best.

9. Click Close.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 30

Industries Order Management
Decomposition Exercise Guide

10. In the cart header, click Decompose Order.

Once again, this action will invoke the decomposition process and bring you to the Order
Decomposition page.

11. On the Source Orders side, click the link icon next to the Home Hub Modem.
The highlight shows the link between the source order and the decomposed
fulfillment request.

This time the Home Hub Modem (commercial product) with the Grade attribute set to Best
was successfully decomposed to the Home Hub 3000 CFS (technical product), and the
static mapping rule set the Modem Standard (G.993.2) attribute value correctly.

Time and interest permitting, place additional orders. If the Grade attribute is set to “Good”
or “Better” the result is the Home Hub 2000. When set to “Best” it is the Home Hub 3000.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 31

Industries Order Management
Decomposition Exercise Guide

Exercise 5-3: Creating Many-to-one

Decomposition Relationships
Scenario
For Greg’s next trick, he will combine two order line items into one fulfillment request using
a many-to-one decomposition relationship. He impresses himself with his efficiency and
advanced decomposing!

Goal
● Streamline fulfillment requests using many-to-one (M:1) decomposition and product
scope
● Specify source fields in decomposition relationships
● Configure ad-verbatim and list mapping types in decomposition relationships

Tasks
1. Review the M:1 decomposition design
2. Create the M:1 decomposition relationships
3. Test the new M:1 decomposition relationships

Time: 30 mins

© Copyright 2022 Salesforce.com, inc. All rights reserved. 32

Industries Order Management
Decomposition Exercise Guide

What is many-to-one (M:1) decomposition?

To allow for more efficient and streamlined process execution, Industries Order
Management allows for the results of a particular decomposition to be re-used rather than
re-instantiated. Multiple products that are in the same order can be decomposed to a single
fulfillment request that is used to fulfill these products. This is many-to-one (M:1)
decomposition.

This type of decomposition is triggered by setting the Scope field on the product entity to
“Account”.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 33

Industries Order Management
Decomposition Exercise Guide

Task 1: Review the M:1 decomposition design

1. Review the M:1 decomposition design.

a. In this decomposition design, you will decompose the Installation product

spec and the Home Hub Modem product spec to the Installation System
Resource product entity, which will make a callout to the external installation
system.
b. Notice that the attributes from the Installation product and the modem
product can be aggregated into the single Installation System product entity,
which is added to the fulfillment request created by the decomposition
process. You will also capture data coming from the source product fields
(rather than attributes) and pass those along to the destination product’s
attributes.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 34

Industries Order Management
Decomposition Exercise Guide

ALERT:
If you have attributes that have the same name when using a M:1
decomposition relationship, only the value from the most recently modified
attribute will be decomposed in the request. Thus, when designing your
product model, it is important to ensure that any attributes intended for use in
a M:1 decomposition relationship have unique names.

When designing a M:1 decomposition, note that you cannot create a

multi-level M:1 decomposition. Referring to the diagram in Task 1 of this
exercise, you cannot specify a commercial product from the 1st level and a
technical product from the 2nd level and aggregate those in a technical
product in the 3rd level. Instead, you can aggregate commercial products
from the 1st level into technical products, either on the 2nd or 3rd levels like the
above example.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 35

Industries Order Management
Decomposition Exercise Guide

Task 2: Create the M:1 decomposition relationships

Thus far when creating decomposition relationships, you set the mapping rule’s source type
to attribute. In this task you will learn how to set the source type to a field.

1. In the Lightning search dialog, enter install.

2. In the search results list, click Installation System Resource.

3. Click the Related tab.

4. In the Decomposition Relationships (Destination Product) related list, click New.

5. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name Installation -> Installation System

Resource

Source Product Installation

6. Click Save.

7. Click the new decomposition relationship that you just created.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 36

Industries Order Management
Decomposition Exercise Guide

8. In Mapping Rules, click + Add New Rule.

9. In the mapping rule dialog, enter the following information.

Field / Property Value

Source Type Attribute

Attribute/Field/Value Services-Installation Type

Mapping Type ad-verbatim

Destination Attribute Services-Installation Type

10. Click + Add New Rule, and scroll down to the second mapping rule entry fields.

11. In the mapping rule dialog, set the Source Type to Field.

12. To set the Source Field, click the search icon, and then click the following in the
FIELD SELECTION dialog:

a. Order ID<OrderId>
b. Account ID<AccountId>
c. Account Name<Name>

13. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 37

Industries Order Management
Decomposition Exercise Guide

14. Complete the rest of the rule by entering the following information.
Field / Property Value

Mapping Type ad-verbatim

Destination Attribute Technical Attributes-Install Account Name

15. Scroll to the top of the Mapping Rules section, and click + Add New Rule.

16. Scroll down to the third mapping rule entry fields.

17. In the mapping rule dialog, set the Source Type to Field.

18. To set the Source Field, click the search icon, and then click the following in the
FIELD SELECTION dialog:

a. Order ID<OrderId>
b. Account ID<AccountId>
c. Shipping Street<ShippingStreet>

19. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 38

Industries Order Management
Decomposition Exercise Guide

20. Complete the rest of the rule by entering the following information.
Field / Property Value

Mapping Type ad-verbatim

Destination Attribute Technical Attributes-Install Street

21. Scroll to the top of the Mapping Rules section, and click + Add New Rule.

22. Scroll down to the fourth mapping rule entry fields.

23. In the mapping rule dialog, set the Source Type to Field.

24. To set the Source Field, click the search icon, and then click the following in the
FIELD SELECTION dialog:

a. Order ID<OrderId>
b. Account ID<AccountId>
c. Shipping Zip/Postal Code<ShippingPostalCode>

25. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 39

Industries Order Management
Decomposition Exercise Guide

26. Complete the rest of the rule by entering the following information.
Field / Property Value

Mapping Type ad-verbatim

Destination Attribute Technical Attributes-Install Zip Code

27. At the bottom of the Mapping Rules, click Save.

28. Scroll up to the top of the page, and under Destination (Product), click the link to
the Installation System Resource product.

29. Click the Related tab.

30. In the Decomposition Relationships (Destination Product) related list, click New.

31. In the New Decomposition Relationship dialog, enter the following information.
Field / Property Value

Decomposition Relation Home Hub Modem -> Installation

Name System Resource

Source Product Home Hub Modem

32. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 40

Industries Order Management
Decomposition Exercise Guide

33. Click the link to the new decomposition relationship that you just created.

34. In Mapping Rules, click + Add New Rule.

35. In the mapping rule dialog, enter the following information.

Field / Property Value

Source Type Attribute

Attribute/Field/Value Internet Services-Grade

Mapping Type list

Destination Attribute Technical Attributes-Modem Standard

36. Click Toggle expand.

37. Click + Add New Transform/Mapping three times.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 41

Industries Order Management
Decomposition Exercise Guide

38. In the Transform/Mapping, enter the following values.

Source Value Destination Value

Best VDSL2+

Better ADSL2+

Good ADSL

39. Click Save.

40. Scroll to the top of the Mapping Rules window, and click + Add New Rule.

41. Scroll down to the second mapping rule entry fields, and set the Source Type to
Field.

42. To set the Source Field, click the search icon, and then click the following in the
FIELD SELECTION dialog:

a. Price Book Entry ID<PricebookEntryId>

b. Product Code<ProductCode>

© Copyright 2022 Salesforce.com, inc. All rights reserved. 42

Industries Order Management
Decomposition Exercise Guide

43. Click Save.

44. Complete the rest of the rule by entering the following information.
Field / Property Value

Mapping Type ad-verbatim

Destination Attribute Technical Attributes-Product Code

© Copyright 2022 Salesforce.com, inc. All rights reserved. 43

Industries Order Management
Decomposition Exercise Guide

45. At the bottom of the Mapping Rules window, click Save.

Let’s take a look at the new M:1 decomposition relationships in action!

© Copyright 2022 Salesforce.com, inc. All rights reserved. 44

Industries Order Management
Decomposition Exercise Guide

Task 3: Test the new M:1 decomposition relationships

To test the M:1 decomposition relationships you just set up, you’ll need to set the Scope
field on the destination product and create two orders. Product Scope controls how many
fulfillment requests are created for the destination product. In order to highlight how the
scope affects the decomposition, you’ll set the Scope before creating the orders. First, you’ll
set it to Order Item. For the second order you’ll set it to Account. The number of resulting
fulfillment requests after decomposition will reflect the Scope change of the product.

1. In the Lightning search dialog, enter installation system resource.

2. In the search results list, click Installation System Resource.

3. Using the dropdown action menu, click Edit.

4. Set the Scope to Order Item.

5. Click Save.

6. In the Lightning tab navigation bar, click Orders.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 45

Industries Order Management
Decomposition Exercise Guide

7. Click New.

8. On the New Order page, enter the following information.

Field / Property Value

Order Name M:1 Order

Account Name White, Noah

Order Start Date [today]

Price List B2C Price List

9. Click Save.

10. Select Configure Order in the Power Launcher to launch the cart.

11. In the PRODUCTS panel, find the Installation product, and click Add to Cart.

12. In the PRODUCTS panel, find the Home Hub Modem product, and click Add to
Cart.

13. In the red notification message, click the Take Me There icon to invoke the
configuration window.

14. Set the Grade attribute to Best.

15. Click Close.

16. Now that both products are in the cart, click Decompose Order.

17. On the Order Decomposition page, click the link icons to review the linked
fulfillment requests.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 46

Industries Order Management
Decomposition Exercise Guide

18. Notice that the Installation product has been decomposed to the Installation
System Resource, and the Home Hub Modem has been decomposed to the
Installation System Resource as well, albeit with different attributes. (Recall that the
Home Hub 3000 CFS fulfillment request also appears as a result of the
decomposition relationship we created in a prior exercise.)

Notice the Installation System Resource is part of two Fulfilment Requests. For efficiency in
the callout processing, you can combine the Installation System Resource into one
fulfillment request by setting the Scope field on the destination product (which is the
Installation System Resource).

© Copyright 2022 Salesforce.com, inc. All rights reserved. 47

Industries Order Management
Decomposition Exercise Guide

19. In the Lightning search dialog, enter install system resource.

20. In the search results list, click Installation System Resource.

21. Using the dropdown action menu, click Edit.

22. Set the Scope to Account.

23. Click Save.

Now create a new order so you can review the effects of the Scope field on the
decomposition.

24. In the Lightning tab navigation bar, click Orders.

25. Click on your M:1 Order that you created earlier.

26. Using the dropdown action menu, click Clone.

27. Change the Order Name to M:1 Order #2.

28. Make sure the Status field is set to Draft.

29. Click Save.

30. Select Configure Order in the Power Launcher.

31. Find the Installation and Home Hub Modem products in the PRODUCTS panel and
add them to the cart. (Remember to click on the Take me there icon, set the Grade
to Best, and then close out the window. You can’t decompose the order until all
required attributes are filled out.)

32. In the cart header, click the Decompose Order button.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 48

Industries Order Management
Decomposition Exercise Guide

33. Review the Order Decomposition page.

34. Notice that there is now only one fulfillment request for Installation System
Resource and the attributes have been combined.

The Scope setting impacted the fulfillment requests.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 49

Industries Order Management
Decomposition Exercise Guide

Exercise 5-4: Creating Multi-level Decomposition

Relationships
Scenario
Now that Greg has the hang of decomposition relationships, he decides to take it to the
next level: Multi-level decomposition! Infiwave’s DSL Service product spec is bundled in the
Back to School Student Offer as part of the Home Internet Solution product spec, and it
needs to be decomposed first into CFS products and then into resource products. This will
require multi-level decomposition relationships.

Goal
● Create multiple levels of decomposition relationships

Tasks
1. Review multi-level decomposition design
2. Create first level (source) decomposition relationships for the DSL service product
spec
3. Configure first level decomposition relationships
4. Create third level (destination) decomposition relationships
5. Configure third level decomposition relationships
6. Test the new multi-level decomposition relationships

Time: 30 mins

© Copyright 2022 Salesforce.com, inc. All rights reserved. 50

Industries Order Management
Decomposition Exercise Guide

What are multi-level decomposition relationships?

There are many factors that should be considered when designing your product model; we
discussed some of them in the earlier exercises on technical products. In addition to those
considerations, Industries Order Management also recommends that there be separate
product entities (usually a resource) per downstream system callout. Often, you will need to
design one or two levels in between the commercial product entity and the resource entity
in order to ensure that the correct information is available to the downstream systems.

With this kind of product model, you will need multi-level decomposition relationships to
fully translate the commercial product entity through the CFS or RFS product entity and on
to the resource product entity that will make the callout.

BEST PRACTICE:
Salesforce Industries recommends that you design no more than 4 levels in
your decomposition relationships in order to minimize both complexity and
the impact on performance.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 51

Industries Order Management
Decomposition Exercise Guide

Task 1: Review multi-level decomposition design

1. Review the above diagram.

a. Notice the commercial product, DSL Service, will be decomposed into one of
two CFS product entities, based upon the Download Speed attribute set in
the customer order.
b. The 2nd level product entities are then decomposed into resources in the 3rd
level.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 52

Industries Order Management
Decomposition Exercise Guide

Task 2: Create first level (source) decomposition relationships for the

DSL service product spec

NOTE:
This exercise uses a Picklist for the Download Speed attribute. It was created
for you in the training playground.

1. In the Lightning search dialog, enter dsl service.

2. In the search results list, click DSL Service.

3. Click the Related tab.

4. Click New to create a new Decomposition Relationship (Source Product).

© Copyright 2022 Salesforce.com, inc. All rights reserved. 53

Industries Order Management
Decomposition Exercise Guide

5. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name DSL Service -> ADSL2+ CFS

Destination Product ADSL2+ CFS

6. Click Save & New.

7. This time use the following information:

Field / Property Value

Decomposition Relation Name DSL Service -> VDSL2 CFS

Destination Product VDSL2 CFS

8. Click Save. You have created two new first level decomposition relationships that are
ready to be configured.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 54

Industries Order Management
Decomposition Exercise Guide

Task 3: Configure first level decomposition relationships

First you will configure mapping and conditions for the VDSL2 CFS, as it is slightly simpler
than ADSL+ CFS.

1. Click on the DSL Service -> VDSL2 CFS decomposition relationship.

2. Click + Add New Rule. (Use this to add two rules.)

a. Add Internet Services-Connection Type, set the Mapping Type to
ad-verbatim, to the Internet Services-Connection Type (destination
attribute).
b. Add Internet Services-Download Speed, set the Mapping Type to list, to the
Technical Attributes-Traffic Code (destination attribute).

Now you can configure the transform for the list Mapping Type.

3. On the right side of the mapping rule, click Toggle expand.

4. Click + Add New Transform/Mapping and change to the following transform values.

Field / Property Value

Source Value 40Mbps

Destination Value 40Mbps_TC1,500Mbps_TC4

© Copyright 2022 Salesforce.com, inc. All rights reserved. 55

Industries Order Management
Decomposition Exercise Guide

5. Click Save.

NOTE:
When creating a mapping or transform rule that evaluates an attribute with a
picklist, the decomposition process will evaluate the source value entered in
the mapping rule against the picklist VALUE of the attribute. The matching
algorithm is case-insensitive.

The condition when to fire is still missing and must be configured.

6. Expand the Conditions section and set the condition type to Single Condition.

7. Fill out the remainder of the Condition.

Field / Property Value

attribute Internet Services-Download Speed

operator =

Value 40Mbps

8. Click Save Conditions. Now you will configure the other decomposition relationship.

9. Click on the DSL Service -> ADSL2+ CFS decomposition relationship.

10. Click + Add New Rule. Similar to the steps at the start of this Task, add two new
rules. This time, you will also add two transforms for the Traffic Code.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 56

Industries Order Management
Decomposition Exercise Guide

Field / Property Value

Source Value 12Mbps

Destination Value 12Mbps_TC1,75Mbps_TC4

Source Value 20Mbps

Destination Value 20Mbps_TC1,200Mbps_TC4

11. Click Save.

12. Expand the Conditions section and set the condition type to OR.

13. Fill out the (first) Single Condition.

Field / Property Value

attribute Internet Services-Download Speed

operator =

Value 12Mbps

© Copyright 2022 Salesforce.com, inc. All rights reserved. 57

Industries Order Management
Decomposition Exercise Guide

14. Fill out the (second) Single Condition.

Field / Property Value

attribute Internet Services-Download Speed

operator =

Value 20Mbps

15. Click Save Conditions.

With these rules in place, the Connection Type attribute on the DSL Service product will be
copied directly to the Connection Type attribute on the CFS products. Additionally,
Download Speeds will be transformed into Traffic Codes for ADSL2+ and VDSL2 CFS
technical products.

ALERT:
When evaluating values, every character matters. For example, the inclusion
(or exclusion) of white space is factored in. (“12 Mbps” is not equal to
“12Mbps”.)

Now you can move on to creating Destination Decomposition Relationships. (That is, for the
Level 3 products in the original multi-level product model diagram shown earlier.)

16. (optional) Preliminary test of first level decomposition relationships.

TIP:
Configuring multi-level decomposition relationships can be complex.
Sometimes it is helpful to test decomposition as you build out each level.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 58

Industries Order Management
Decomposition Exercise Guide

● Place an order for DSL Service and configure the Download Speed to 20Mbps.
Decompose the order. Does it look correct thus far?

● Place an order for DSL Service and configure the Download Speed to 40Mbps.
Decompose the order. Does it look correct?

© Copyright 2022 Salesforce.com, inc. All rights reserved. 59

Industries Order Management
Decomposition Exercise Guide

Task 4: Create third level (destination) decomposition relationships

What are Destination Decomposition Relationships?

Destination Decomposition Relationships simply lists all of the decomposition relationships
for which the current product is the destination product entity, as opposed to the source
product.

In our example, we can see that we have multiple decomposition relationships that must
be created from 2nd level products to 3rd level products. Note, however, that this is not a
one-to-many (1:M) relationship because at run-time, only one product will be selected at
the 2nd level of decomposition, and that single product will be decomposed using the
appropriate decomposition relationship.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 60

Industries Order Management
Decomposition Exercise Guide

1. Use Search to bring up the Bonded Copper Pair Resource product.

2. Click the Related tab.

3. In the Decomposition Relationships (Destination Product) related list, click New.

4. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name VDSL2 CFS -> Bonded Copper Pair

Resource

Source Product VDSL2 CFS

5. Click Save.

6. Use Search to bring up the Copper Pair Resource product.

7. Click the Related tab.

8. In the Decomposition Relationships (Destination Product) related list, click New.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 61

Industries Order Management
Decomposition Exercise Guide

9. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name ADSL2+ CFS -> Copper Pair Resource

Source Product ADSL2+ CFS

10. Click Save.

11. Use Search to bring up the DSLAM Port Resource product.

12. Click the Related tab.

13. In the Decomposition Relationships (Destination Product) related list, click New.

14. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name ADSL2+ CFS -> DSLAM Port Resource

Source Product ADSL2+ CFS

15. Click Save & New.

16. In the New Decomposition Relationship dialog, enter the following information.

Field / Property Value

Decomposition Relation Name VDSL2 CFS -> DSLAM Port Resource

Source Product VDSL2 CFS

17. Click Save.

You have created the four level 2 to level 3 decomposition relationships from the original
decomposition relationship data model. Now you are ready to configure them accordingly.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 62

Industries Order Management
Decomposition Exercise Guide

Task 5: Configure third level (destination) decomposition relationships

NOTE:
In the interest of time, the mappings and conditions for the 2nd to 3rd level
decomposition relationships are kept simple. However, everything you have
learned thus far could be applied to multi-level decomposition relationships
as well. (Such as the ability to map fields or attributes to attributes, set up
conditions, copy/paste/modify conditions and mappings or build them from
scratch in the UI, etc.)

1. Use Search to bring up the Copper Pair Resource product.

2. Click the Related tab.

3. Click the ADSL2+ CFS -> Copper Pair Resource.

4. Expand Mapping Rules and click + Add New Rule.

5. Map the Traffic Code through ad-verbatim.

6. Click Save.

No further changes are needed from the attributes already mapped from the 1st to the 2nd
level. Configure a similar mapping for the Bonded Copper Pair Resource.

7. Use Search to bring up the Bonded Copper Pair Resource product.

8. Click the Related tab.

9. Click the VDSL2 CFS -> Bonded Copper Pair Resource.

10. Expand Mapping Rules and click + Add New Rule.

11. Map the Traffic Code through ad-verbatim.

12. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 63

Industries Order Management
Decomposition Exercise Guide

These decomposition relationships will decompose the DSL service CFS product entities in
the 2nd level to the local loop resources in the 3rd level. Neither of the Copper Pair
relationships need a condition. None of the DSLAM Port relationships need further
mapping or conditions, so you are ready to test out your multi-level decomposition
relationships!

© Copyright 2022 Salesforce.com, inc. All rights reserved. 64

Industries Order Management
Decomposition Exercise Guide

Task 6: Test the new multi-level decomposition relationships

1. In the Lightning tab navigation bar, click Orders.

2. Click New.

3. On the New Order page, enter the following information.

Field / Property Value

Order Name Multi-Level Order

Account Name White, Noah

Order Start Date [today]

Price List B2C Price List

4. Click Save.

5. Select Configure Order from the Power Launcher.

6. In the PRODUCTS panel, find the DSL Service product, and click Add to Cart.

7. In the red notification message, click the Take Me There icon to invoke the
configuration window.

8. Set the Download Speed attribute to 40 Mbps.

9. Click Close.

10. In the cart header, click Decompose Order.

11. In the Order Decomposition page, click the link icon next to DSL Service to highlight
the linked request.

Because you selected “40 Mbps” for the Download Speed attribute, the DSL Service is
decomposed to the VDSL2 CFS product, and the Download Speed should have been
translated to a Traffic Code, as in the screenshot below. Further, the VDSL2 CFS should have
been decomposed to the Bonded Copper Pair Resource and the DSLAM Port Resource.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 65

Industries Order Management
Decomposition Exercise Guide

12. Notice that the VDSL2 CFS Fulfilment Request also has a link icon. Click the link icon
to see what it decomposes to.

As shown above, both DSLAM Port Resource and Bonded Copper Pair Resource are
highlighted.

13. Now go back and further test the DSL Service by placing an order with other
download speeds (12Mbps or 20Mbps), to ensure that the other decomposition
mappings and conditions are working.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 66

Industries Order Management
Decomposition Exercise Guide

Exercise 5-5: Using Product Class for

Decomposition Relationships
Scenario
Greg is feeling better about order decomposition. However, he knows several products in
the shared catalog decompose similarly. Currently, each product requires its own
decomposition relationship. He decides to create a new Class, associate the similar
products to the Class, and create just one decomposition relationship so all the similar
products decompose to the same technical product. (He prefers to think of this as efficient,
not lazy.)

Goal
● Create a new product in the shared catalog with a record type of Class (e.g. Product
Class)
● Associate similar commercial products with a Product Class
● Create a decomposition relationship that leverages attributes and inheritance of
Object Types to decompose based on a Product Class
● Verify the decomposition works correctly

Tasks
1. Review the product class decomposition model
2. Create a product class
3. Link cloud storage products to the product class
4. Create a decomposition relationship between a product class and the technical
product
5. Test the product class decomposition relationship

Time: 45 mins

© Copyright 2022 Salesforce.com, inc. All rights reserved. 67

Industries Order Management
Decomposition Exercise Guide

Task 1: Review the product class decomposition model

Salesforce Industries recommends that you diagram your decomposition relationships
using the tool of your choice. But it’s your lucky day—we’ve created this one for you. To that
end, the components in blue and gold will be further explained in this task.

NOTE:
The focus of this exercise is on new concepts, indicated by the shaded gold
box in the diagram above.

1. Review the above diagram.

a. Notice the Smart Cloud Storage bundle. Each child product represents a
different commercial product, describing a set storage limit.
b. Notice that the Cloud Storage products inherit the Storage Limit attribute,
along with its associated picklist, from the Cloud Storage Product Spec object
type.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 68

Industries Order Management
Decomposition Exercise Guide

c. Look at the Cloud Storage Class product class. This product class is the key to
set up a single decomposition relationship for similar products. The Cloud
Storage Class product class is the source product in the decomposition
relationship.
d. Technical Cloud Storage is the destination product in the decomposition
relationship. Regardless of the child product in the bundle selected for an
order (based on the storage limit), this one decomposition relationship is all
that is needed to decompose the order to fulfillment requests.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 69

Industries Order Management
Decomposition Exercise Guide

Task 2: Create a product class

From a purely Salesforce perspective, a product class is any product that has the record type
set to “Class”. Hence, “product class” is an abbreviated reference to such products. In reality,
a product class is not a commercial product, it’s not part of the commercial catalog. It’s not
a technical product or specification either. A product class can be used to differentiate
between an abstract product and real products. In this exercise, a product class is used to
identify similar types of products (cloud storage products) that have the same behavior in
order decomposition. (Product class is not native to Salesforce. It’s a Salesforce Industries
enhancement used for the purposes of order management.)

Creating a new product class is the key to this exercise. Without it, you would have to create
a decomposition relationship for each similar individual commercial product that needs to
be decomposed to the same technical product. In this task, you will create a new Cloud
Storage Class and set its record type to Class (not the default Product). Later, it will be used
as the source part of the decomposition relationship.

NOTE:
Products with record types of Class do not display in the product list of the
Cart.

1. In the Lightning navigation bar, click Vlocity Product Console.

2. Under the Product Management section, click + to create a new Product.

3. In the New Product dialog, fill out the following Object Type and General
Properties information.
Field Value

Object Type Cloud Storage Product Spec

Name Cloud Storage Class

Product Code C-CSP-001

Specification Type Product

4. Click Save.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 70

Industries Order Management
Decomposition Exercise Guide

5. From the General Properties facet, fill out the following additional General
Properties information.
Field Value

Product Description Product class used to map one decomposition

relationship for multiple similar
commercial products

Status Active

6. Fill out the following Effectivity information.

Field Value

Active ✔

Selling Start Date [today’s date]

Fulfillment Start Date [today’s date]

Note that when selecting a date, the time is automatically populated. You can leave the
default time.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 71

Industries Order Management
Decomposition Exercise Guide

7. Click Save. Once saved, you are placed in the General Properties facet of the new
product. (Note: Please disregard any slight differences in the layout of your fields,
including the appearance of the Product Family field. This field is not needed or used
in this or any labs in this course.)

8. Click the Attribute Properties facet. Notice the Storage Limit attribute has been
inherited from the Cloud Storage Product Spec object type. Isn’t object inheritance
a beautiful thing? Set it up once, reuse it as needed.

9. Click the Details link adjacent to the Storage Limit attribute. Notice the Attribute
Metadata includes a Storage Unit picklist, with several storage limit values (100GB,

© Copyright 2022 Salesforce.com, inc. All rights reserved. 72

Industries Order Management
Decomposition Exercise Guide

1TB, etc.). These values will be passed from the child products through the product
class to the technical product.

Referring back to the diagram, your new Cloud Storage Class has the Storage Limit attribute
now. However, by default, new products are created with a record type of “Product”, and it
needs to be “Class”. You’ll tackle that next.

10. In the Lightning navigation bar, click Products.

11. Locate and click Cloud Storage Class.

12. Notice the Product Record Type is set to the default value (Product).

13. Click the Change Record Type icon for the Product Record Type field.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 73

Industries Order Management
Decomposition Exercise Guide

14. Make sure the Change Product Record Type is set to Class and click Next.

15. Click Save in the Edit Cloud Storage Class dialog.

Now your product class is created and configured properly. It’s time to associate the child
products in the bundle with the product class.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 74

Industries Order Management
Decomposition Exercise Guide

Task 3: Link cloud storage products to the product class

Now that you have built the product class, you can link it to each of the tiered storage
products as shown in the original diagram by the gold arrow.

NOTE:
The product bundle is not important with respect to the configuration in
getting product class decomposition relationships to work. The tiered storage
products don’t have to be part of a bundle. They could be individual products,
and this exercise would still work fine.

1. In the tab navigation bar, click Products, and then All Products in the List Views
dropdown.

2. Click on the Cloud Storage – 100GB commercial product.

3. Click Edit in the dropdown in the upper right.

Notice the Parent Class field is currently null. That is about to change.

4. In the Parent Class field, select Cloud Storage Class.

5. Click Save.

6. Repeat the same process, setting the Parent Class to Cloud Storage Class for Cloud
Storage – 1TB (and 10TB) products. Remember to save changes for both products.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 75

Industries Order Management
Decomposition Exercise Guide

Of course, all setup and configuration processes are important, but establishing the
relationship between the commercial products and the parent class like this is critical. So is
the actual decomposition relationship, which is the last task before testing everything from
end to end.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 76

Industries Order Management
Decomposition Exercise Guide

Task 4: Create a decomposition relationship between a product class

and the technical product
With everything that needs to be created or configured behind you, the last task at hand is
to create the decomposition relationship itself. Referring back to the diagram, you’ll recall
that the relationship is between Cloud Storage Class (the product class) and Technical
Cloud Storage (the technical product).

1. Navigate to Products > All Products view, and select Cloud Storage Class.

2. Switch from the Details to the Related tab.

3. In the Decomposition Relationships (Source Product) related list, click New.

4. Enter the following New Decomposition Relationship information:

Field Value

Decomposition Relationship Name CloudStorageClass ->

TechnicalCloudStorage

Destination (Product) Technical Cloud Storage

© Copyright 2022 Salesforce.com, inc. All rights reserved. 77

Industries Order Management
Decomposition Exercise Guide

5. Click Save.

6. Click the decomposition relationship just created.

7. Expand Mapping Rules and click Add New Rule.

8. In the Add New Rule dialog, enter the following information.

Field Value

Source Type Attribute

Attribute/Field/Value Internet Services-Storage Limit

Mapping Type ad-verbatim

Destination Attribute Internet Services-Storage Limit

9. Click Save.

This decomposition relationship will map the Storage Limit attribute of Cloud Storage Class
(which is the source) to the Storage Class attribute of Technical Cloud Storage (which is the
destination), and the ad-verbatim mapping rule essentially says don’t change the data at all.
The mapping value will pass through unchanged. Now you are ready to test everything.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 78

Industries Order Management
Decomposition Exercise Guide

Task 5: Test the product class decomposition relationship

With everything fully configured, it’s time to test and see if the decomposition relationship
works. You should be able to place an order for the cloud storage bundle, select any one of
the storage tiers (based on the attribute for their storage limits), and decompose the order
to the same technical product. Recall that you created a single decomposition relationship,
and by virtue of the product class, all products linked to the product class will share this
decomposition relationship. Otherwise, every commercial product would need its own
decomposition relationship. In a large Shared Catalog, with thousands of products, this
would take significantly more time to create, configure, and maintain.

1. In the Lightning navigation bar, click Orders.

2. Click New.

3. In the New Order dialog, enter the following information. (Note the price list is B2B
this time, not B2C!)
Field Value

Order Name Test Decomp 100Gb

Account White, Carole

Order Start Date [today’s date]

Price List B2B Price List

4. Click Save.

5. Select Configure Order from the Power Launcher.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 79

Industries Order Management
Decomposition Exercise Guide

6. Add Smart Cloud Storage to the cart.

Notice the design-time attribute for the storage limit can be added to the order with a
single click.

NOTE:
Long product names are sometimes displayed with an ellipsis. If you can’t see
the entire name, such as the 100GB, 1TB, or 10TB above, simply hover over to
see the entire product name.

7. Add any one of the child products to the order. (The example shown is based on the
100GB tier, but which one you select is not important.)

8. In the cart header, click Decompose Order.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 80

Industries Order Management
Decomposition Exercise Guide

NOTE:
Occasionally a browser refresh may be required to see the decomposed order.

9. Create another new order. This time add either one of the other child products
(Cloud Storage – 1TB or 10 TB) from the cloud storage bundle to the cart.

10. Decompose the order. The same decomposition relationship is used to decompose
to the same fulfillment request as the previous order, despite different commercial
products being added to the order. Notice the Storage Limit attribute should differ
on the fulfillment request, depending on which child product is selected. This was
passed through from the commercial product, via the product class, with the
decomposition relationship configured earlier.

Your training playground has a simple Shared Catalog. But even in our simple training
playground, it’s easy to see the benefit that is gained by using product class decomposition
relationships!

© Copyright 2022 Salesforce.com, inc. All rights reserved. 81

Industries Order Management
Decomposition Exercise Guide

Exercise 5-6: Creating Multi-level Decomposition

Relationships Challenge
Scenario
Infiwave recently started servicing a new geographic area. Unfortunately, the infrastructure
in the area is ADSL, and does not support speeds even close to true broadband. As a short
term solution Greg decides to configure a previously discontinued ADSL offering with 7
Mbps download speed.

Goal
● Repeat key concepts just learned to become more familiar with the mechanics of
creating multiple-level decomposition relationships

Tasks
1. Review the modified multi-level decomposition relationships
2. Use the Creating Multi-level Decomposition Relationships exercise as a guideline for
configuring the multi-level relationship in this challenge
3. Test the decomposition relationships
4. Test an ad-verbatim mapping of an attribute (that is a picklist)

Time: 60 mins

© Copyright 2022 Salesforce.com, inc. All rights reserved. 82

Industries Order Management
Decomposition Exercise Guide

Task 1: Review the modified multi-level decomposition relationships

Look at the decomposition diagram above to get an idea of the decomposition

relationships required for this challenge.

There are two ways to approach the details of this challenge:

● Minimal help – Primarily use the diagram above and the decomposition skills
learned earlier to build out all the needed decomposition relationships. Look at the
relationships in IOM as needed.
● Maximal help – Read through the steps in the exercises and view the relationships
you built out earlier in IOM as you work through this Challenge.

Minimal or maximal help? Either approach is perfectly fine and up to you. Rumor has it (and
backed up by his last status report) that Chad first used maximal help. Then he circled back
and completed the Challenge again with minimal help. Well done Chad!

© Copyright 2022 Salesforce.com, inc. All rights reserved. 83

Industries Order Management
Decomposition Exercise Guide

Task 2: Configure the decomposition relationships

1. Map the same source and destination attributes, using the same type of mapping.
For the Download Speed to Traffic Code, use these values.

Field / Property Value

Source Value 7Mbps

Destination Value 7Mbps_TC1,50Mbps_TC4

2. As shown in the product model diagram (and implied in the mapping above), use
7Mbps as the download speed in the condition.

NOTE:
Look at the product model diagram for this Challenge. The 2nd level CFS’ use
ADSL CFS, ADSL2+ CFS and VDSL2 CFS. However, there is another ADSL2 CFS
in your training playground. ADSL2 CFS is not used in this Challenge. It is used
in an Orchestration exercise later on. (You can ignore it.)

© Copyright 2022 Salesforce.com, inc. All rights reserved. 84

Industries Order Management
Decomposition Exercise Guide

Task 3: Test the decomposition relationships

Testing is always the moment of truth. If your decomposition relationships are configured
correctly, the results should be identical to those if a decomposition matrix had been used.

1. Create an order and add DSL Service to the cart. Set the download speed to 7Mbps.

2. Decompose the order.

3. Confirm the decomposition looks similar to the following.

© Copyright 2022 Salesforce.com, inc. All rights reserved. 85

Industries Order Management
Decomposition Exercise Guide

Task 4: Fun with Connection Types!

(Time and interest permitting)

1. Notice the default Connection Type on the order for DSL Service is Dynamic.
2. Place another order for DSL Service, but this time set the Connection Type to Static.
(Set the download speed to whatever you want.)
3. Before decomposing the order, having seen how it was mapped when set to
Dynamic, what do you think it will map to when set to Static?
4. Decompose the order. Did it map to what you thought it would? Perhaps not! (That’s
ok, Greg was fooled at first too!)

HINT
Use the Vlocity Product Console to look up the Connection Type picklist. View
the Picklist Items facet.

In this example, an attribute that is a picklist is mapped ad-verbatim. When the Connection
Type is set to Dynamic, the attribute is mapped to Dynamic as well. However, when changed
to Static, the mapped attribute is Static IP (not Static). It’s important to realize that although
the Label and the Value are often the same (as they are when the Connection Type is set to
Dynamic), they don’t have to be. Further, it’s the Value that is critical here. The Value stored
in the Attribute/Field is mapped to the destination (not the Label).

© Copyright 2022 Salesforce.com, inc. All rights reserved. 86

Industries Order Management
Decomposition Exercise Guide

Yay! All done!

© Copyright 2022 Salesforce.com, inc. All rights reserved. 87