Configure ID naming rules for color parts

You can configure ID naming rules based on preferences when creating color parts from less finish parts. These rules determine how part IDs are generated for less finish parts or assemblies based on color specifications and themes.

Procedure

1. From Launcher, click Preferences.

   If this option is unavailable, search for it. You can pin it from the search results for future access.

2. Search for and open the PSESolutionVariantItemProperties preference, and then set the value for the preference and save your changes.

   If you want advanced control when generating the color part ID, use the following format to generate the color part ID in two parts: an ID for a prefix and an ID for a post-fix. The combination of these two parts creates the complete color part ID. Multiple values using this format are supported within the preference.

   Example:

   item_type_and_id_format="generic_item_type=Part;sv_item_type=Part;prefix=Item.item_id;seperator=-;postfix_start_value=Clr0ColorAppearance.clr0VisAppCode,Cb0ColorTheme.cb0ColorThemeCode;finish_type=Less Finish"
   

   Guidelines for generating the IDs:

   • The keyword item_type_and_id_format creates the advanced logic for generating the color part ID and Item Type.
   • Use generic_item_type to specify the less-finish structure Item type; values can be blank, Item, or any subtype of Item.
   • Use sv_item_type to specify the item type for the Color Item to be created. The values can be blank, Item, or any subtype of Item. If left blank, the default color item type is used.
   • Use prefix to define the initial part of the color part ID. The format is Item.item_id[N], where N indicates that only the first N characters from the source item's item_id is used for the prefix. For example, prefix=Item.item_id[6] uses the first six letters from the source structure.
   • Use postfix_start_value to define the trailing part of the color part ID, used in conjunction with the prefix. You can use an alphanumeric incrementing counter without special characters. For example, if you specify A0A0A0, the post-fix value is automatically incremented to A0A0A1, A0A0A2, and so on. You can use business object properties, such as Clr0ColorAppearance.clr0VisAppCode and Cb0ColorTheme.cb0ColorThemeCode.
   • Use a separator as an optional, single special character to be inserted between the generated prefix and post-fix strings.

   Note: The preference values must include a Finish Type qualifier: finish_type. The corresponding post-fix value must be based on the color specification for individual parts and the color theme ID for assemblies. If Less Finish is specified in the preference, at least the color appearance property must be present in the postfix. The other properties are optional. Components with None as the Finish Type retain their original IDs, regardless of theme application.

Example naming table

The following table shows how the color parts are named after setting the PSESolutionVariantItemProperties preference (using prefix=Item.item_id[6]), and how the Cb0EnforceColorCodeAtAssemblyLevel preference value affects color part generation for less-finish assemblies and parts:

Part type	Item ID	Finish Type	Theme Code	Color Code Assigned	Color Code	Cb0EnforceColorCodeAtAssemblyLevel = false (Default)	Cb0EnforceColorCodeAtAssemblyLevel = true
Assembly 1	A00001-XXX	Less Finish	THM-01	Yes	BLU	Color part ID generated with color code (A00001-BLU)	Color part ID generated with color code (A00001-BLU)
└─ Leaf Part 1	P00001-XXX	Less Finish	THM-01	Yes	GRN	Color part ID generated with color code (P00001-GRN)	Color part ID generated with color code (P00001-GRN)
└─ Leaf Part 2	P00002-XXX	Less Finish	THM-01	Yes	BLK	Color part ID generated with color code (P00002-BLK)	Color part ID generated with color code (P00002-BLK)
└─ Leaf Part 3	P00003-XXX	Less Finish	THM-01	Yes	RED	Color part ID generated without color code (P00003-RED)	Color part ID generated with color code (P00003-RED)
Assembly 2	A00002-XXX	Less Finish	THM-02	No	-	Color part ID generated with theme code (A00002-THM-02)	No color part ID generated
└─ Leaf Part 4	P00004-XXX	Less Finish	THM-02	Yes	GRN	Color part ID generated with color code (P00004-GRN)	Color part ID generated with color code (P00004-GRN)
└─ Leaf Part 5	P00005-XXX	Less Finish	THM-02	Yes	BLK	Color part ID generated with color code (P00005-BLK)	Color part ID generated with color code (P00005-BLK)
└─ Leaf Part 6	P00006-XXX	Less Finish	THM-02	Yes	RED	Color part ID generated with color code (P00006-RED)	Color part ID generated with color code (P00006-RED)

Results

The part IDs are generated based on color specifications and themes.