OMT

BOOTCAMP

OMT Bootcamp

Catalog Versioning
Time: 15 minutes

ServiceNow Telecom, Media, and Technology (TMT)

 OMT
OMT
BOOTCAMP
Bootcamp

Table of contents
Lab instance credentials ................................................................................................................... 3
Lab objectives ............................................................................................................................... 3
Scenario ..................................................................................................................................... 3
Personas .................................................................................................................................... 3
Section 1 Product Offering version management....................................................................................... 4
Section 1.1 Create a new Offering version ............................................................................................ 4
Section 1.2 Place a Product Order for the new Offering version .................................................................... 7
Section 1.3 Retire an Offering Version ................................................................................................. 8
Section 2 Service Specifications version management & Working with Order APIs .............................................. 10
Section 2.1 Create a new Service Specification ..................................................................................... 10
Section 2.2 Create a new Service Specification ..................................................................................... 11
Section 2.3 Submit TMF641 Service Orders for different versions ............................................................... 13
Section 3 Catalog Open APIs ........................................................................................................... 17
Section 3.1 Query Specification ...................................................................................................... 17

2
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Lab instance credentials

Field Value

Username admin

Password As provided with your lab instance / Magic link

Lab objectives
You will achieve the following objectives:
• Understand the Catalog Versioning feature.

Scenario

In this lab, students will configure the Catalog entities to create new versions and submits
orders to validate the Catalog Versioning behavior.

Personas
• James Smithson, Product Catalog Manager
• Mike Davis, Order Fulfilment Manager
• System Admin

3
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Section 1 Product Offering version management

Section 1.1 Create a new Offering version.

1. Impersonate James Smithson, the Product Catalog Manager.

• Select the System Administrator profile photo to open the user menu.
• Select Impersonate User.
• In the impersonate user dialogue box, search for, and select James Smithson.
• Select Impersonate user.

2. Navigate to Workspaces > CSM/FSM Configurable Workspace.

3. Click on the List view icon and navigate to ‘Product Offerings’ from under the Offerings List group.

4. Click to open the Product Offering ‘Premium Home Internet starting from $29’ by clicking
on the PRDOFxxx number.

5. Notice the current version and state of the Offering.

a. Is the version = 1?
b. Is the State = Published?

4
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

6. Click on the Create New Version action button in the top right of the canvas.

7. Notice the State and Version

c. Has the version incremented to 2?

d. Is the State = Draft?

8. Update the following fields –

e. Name = Demo Internet Offer

f. Display Name = Demo Internet Offer

9. Navigate to the Product Offering Characteristics list sub-tab.

g. For the characteristics Usage Type and value Email and Browsing, under the

‘Customer Input Required’ column double click in the white space next to the value of

false.

h. Change the value to true and click OK.

5
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

i. Repeat the same for the value ‘Gaming and Streaming’.

j. Similarly, change the value under Default from false to true for one of the Characteristic

options.

10. Click on Publish.

k. Observe the state changes to ‘Published’.

6
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Section 1.2 Place a Product Order for the new Offering version

1. Impersonate another user as Mike Davis, the fulfilment manager.

2. Navigate to Workspaces > CSM/FSM Configurable Workspace.

3. Click on Lists and navigate to Customer Orders > All.

a. Click on the Number column to make the view descending (optional)

4. Click on the New action button and select ‘Order a new product’ and click Create.

5. Select Account and Contact, followed by Location via the guided steps.

6. On the Select Products step, select the newly created ‘Demo Internet Offer’ and click on

Configure Items.

7. Under the Characteristic tab, observe the Usage Type characteristic with the default value

set in the previous section.

8. Click on Review and Submit the Order.

9. Approve the Order.

10. Open the Order and navigate to the Order Line-Item sub-tab and click open the record.

a. Observe the Product Specification made available via the Offer is Home Internet.

7
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

11. Navigate to Order Line Item > Order Tasks and close each of the Domain Orders in the

following sequence by clicking open them and using the Close button.

a. Resource Order for DSL Modem

b. Service Order for DSL Access Service

c. Service Order for Broadband Service

d. Product Order for Home Internet

12. The Order Line Item and Order moves to Completed state.

Section 1.3 Retire an Offering Version

1. End Impersonation and continue as System Admin.

2. Navigate to Workspaces > CSM/FSM Configurable Workspace.

3. Click on the List view icon and navigate to ‘Product Offerings’ from under the Offerings List
group.

4. Click to open the Product Offering ‘Demo Internet Offer’ that was created in the last

sections.

5. Click on Retire to transition the Offering from Published to Retired state.

6. Observe the State gets updated to ‘Retired’ state.

7. Continue as System Admin and navigate to Lists > Customer Order > All

8. Create a new Product Order.

a. Notice you do not get the Offering that was retired in the selection list on the Select

Products step.
8
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

b. Abandon the order at this step.

9. Create a new Product Order but select the type as ‘Change a Product’.

10. Select the same Account/Contact.

11. Observe, the Product Inventory shows the record for the Product Offering that has been

retired.

12. Validate you can submit an order for the inventory record, by changing the Usage Type

characteristic value.

9
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Section 2 Service Specifications version management & Working

with Order APIs

In this section, we will create a Service Specification by copying an existing specification and create one or

more versions of it. Using this, we will submit orders via the TMF641 Service Order API.

Section 2.1 Create a new Service Specification

1. Impersonate James Smithson, the Product Catalog Manager.

2. Navigate to Workspaces > CSM/FSM Configurable Workspace.

3. Click on the List view icon and navigate to ‘Service Specifications’ from under the Specifications
List group.

4. Click to open the ‘Broadband Service’ by clicking on the SERSPxxxx number.

5. Observe the Version = 1, and State = Published.

6. Also Observe the Specifications Characteristic and Specifications Relationships.

7. Use the Copy action button from top right to a create a copy of the Spec.

10
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

8. With the Copy, notice the following:

• Version = 1, since a new version was not created.

• Also, the State = Draft.

• The Spec Characteristics and Specification Relationships are also copied over.

9. Set the following fields,

• Name = Lab Test Broadband Service

• Display Name = Lab Test Broadband Service

• Category = Default

10. Click on Publish and validate the State changes to Published.

11. Click on the Create New Version action button.

12. Notice the following –

• Display Name automatically gets populated with v2 at the end, such as ‘Lab Test

Broadband Service v2’.

• Version is incremented to 2.

13. Click on Publish and validate the State changes to Published.

14. Repeat the process from Step 11 to 13 to create v3 of the same Service Specification

Section 2.2 Create a new Service Specification

1. End Impersonation and continue as System Admin.

2. Navigate to Workspaces > CSM/FSM Configurable Workspace.

3. Navigate to Lists > Specifications > Service Specifications.

4. Click on the Number column title to get a descending list.

11
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

5. Click to open the base version (v1) of the Service specification created – Lab Test Broadband

Service.

6. Click on the three dots next to Service Specification as shown below and copy the sys_id. Make

a note of the sys_id somewhere.

12
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Section 2.3 Submit TMF641 Service Orders for different versions

1. Continue as System Admin.

2. Duplicate the browser window and navigate to All > Self Service > Knowledge > Telecom

Knowledge

3. Under Telecom Knowledge, click on the article ‘TMF641 Service Order for Catalog Versioning’.

4. This downloads the TMF641 payload json file in your default downloads folder.

5. Open the json file in a text editor.

6. Observe the contents of the payload

• There is a single Order Line Item

• The Line Item is of type Service

13
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

• Under Specification, the name = ‘Lab Test Broadband Service’.

• Id = xxxx

• internalVersion = yyyy

7. Set the Id = <Sys Id of the base version noted in previous section>

8. Set the internalVersion = “” (i.e. blank)

9. Save the json file.

10. Back to the ServiceNow instance, navigate to All > REST API Explorer.

• Click on Explore.

11. For the Service Order submission, set the following –

• Namespace = sn_ind_tmt_orm

• API Name = Service Order Open API

• API version = latest

• Click on the Create Order (POST) API

12. On the right canvas, scroll until the Request Body section and click on the Raw tab.

• Copy and paste the JSON payload here.

• Click on Send to submit the Order.

• Click on OK on the confirmation pop-up.

14
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

13. Continue as System Admin and navigate to Workspaces > CSM/FSM Configurable

Workspace.

14. Navigate to Lists, Customer Orders > All, Refresh the list or page and click open the latest

order submitted.

15. For the Order, Navigate to the Order Line Items tab.

16. Validate the Service Specification mapped against the Order Line Item.

• Is it ‘Lab Test Broadband Service v3’?

15
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Note: When no version is passed, Order Management picks the latest Active version of the Specifications from all the Active
versions

17. Update the payload to set the internalVersion as 2 without changing the ‘id’, submit the Order

and validate the Service Speciation version mapped against the Order Line Item in the Order.

18. Repeat the process for internalVersion as 1 and do the same validation.

16
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

Section 3 Catalog Open APIs

In this section, we will query the Catalog using Catalog API to query the Specifications created.

Section 3.1 Query Specification

1. Continue as System Admin.

2. Navigate to All > REST API Explorer.

3. For the Catalog Query, set the following –

• Namespace = sn_prd_pm_adv

• API Name = Product Catalog Open API

• API version = latest

• Click on the List Service Specifications API

17
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
 OMT
OMT
BOOTCAMP
Bootcamp

4. On the right canvas, under Prepare Request > Query parameters

• Click on Add query parameter

5. Type in the left space ‘initial_version’ and in the right space copy paste the sys_id of the base
version of the Service Specification.

6. Click on Send.

7. On getting a HTTP 200 OK response, copy the response payload in your text editor (or online json
viewer) and validate if there are 3 versions of the specifications returned.

Congratulations! You have completed this lab.

18
© 2023 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks are trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.