Product Administration Guide > Siebel Configurator Scripts >

About Product Path in Siebel Configurator Scripts

The product path is the path from the root of a product with components to a component product within it. The path is a string that specifies the product with components root and all relationship names leading to the component product. All or part of the product path are arguments to several scripting methods.

The syntax for product paths is as follows:

$.[Root Product]#1.[Relationship]#[Component Product]

Observe the following guidelines for product paths:

• The $ before .[Root Product] refers to a special configuration object called the basket. The basket contains all the objects in the product with components.
• The #1 after [Root Product] refers to the first instance of the root product in the basket.
• Use a dot (.) to specify a relationship.
• Use a # to specify a component product within a relationship.
• Enclose relationship names and component product names in square brackets
  ([ ]). Use product name syntax to specify the name of a component product.
• All paths must end with a product name.

Figure 13 shows the structure of product with components CP1.

Figure 13. Product with Components Structure

Product with components CP1 has two relationships R1 and R2. Relationship R1 contains two component products P1 and P2. Relationship R2 contains the product with components CP2. CP2 contains one relationship R3, which has two component products P3 and P4.

The product paths for this product with components are as follows:

• For P1. $.[CP1]#1.[R1]#[P1]
• For P2. $.[CP1]#1.[R1]#[P2]
• For CP2. $.[CP1]#1.[R2]#[CP2]
• For P3. $.[CP1]#1.[R2]#[CP2].[R3]#[P3]
• For P4. $.[CP1]#1.[R2]#[CP2].[R3]#[P4]

Here are examples of using product paths in script methods:

1. To add 1 P1:

   AddItem("$.[CP1]#1", "R1", "P1", "1")

2. To add 1 P3:

   AddItem("$.[CP1]#1.[R2]#[CP2]", "R3", "P3", "1")

3. To reduce the quantity of P3 to 0:

   RemoveItem("$.[CP1]#1.[R2]#[CP2].[R3]#[P3]")

4. To set the attribute Color to Red for P1:

   SetAttribute("$.[CP1]#1.[R1]#[P1]", "Color", "Red")