Configuration Menu Attributes

Single Select Menus: Single Select Menu, Radio Button Horizontal, and Radio Button Vertical

The following image shows the Legacy Display Types for Single Select Menus.

Multi Select Menus: Multi Select Menu, Checkbox Horizontal, and Checkbox Vertical

The following image shows the Legacy Display Types for Multi Select Menus.

Image Menus - Legacy Display Type Drop-down Menu and Grid options are available when Image Menus are enabled for Single Select Menus, Multi Select Menus, or Single Select Pick Lists.

• Drop-down Menu - Images are displayed compactly in a menu box that is only visible when selecting. This is typically used when Users need to see a visualization while making their selection, but otherwise it is preferred to keep this attribute compact.

• Grid - All images are displayed in a grid format on the layout. This is typically used when Users need to see a visualization while making their selection and to see that selection even after making their choice.

The following image shows the Legacy Display Type Image Menus. The Drop-down Menu is a Multi Select Menu and the user can select multiple items from the drop-down. The Grid is a Single Select Menu and only one item can be selected.

1. Navigate to Admin Home page.

2. Click Catalog Definition in the Products section.

3. Navigate to the applicable configuration item (All Product Families, Product Family, Product Line, or Model)

4. Select Attributes from the applicable Navigation drop-down, and then click List.

5. Click Add. The Attribute Editor page opens.

   

6. Enter information for the fields listed below.

   Note: Fields preceded by an asterisk (*) are required.

   Field	Description
   *Name	Enter the attribute name.
   *Variable Name	The Variable Name field populates automatically. Variable names can only contain alpha-numeric characters and underscores. The entry can be changed before saving, but after saving the value is read-only. Note: Customers should not use any of the following names for Configuration attribute variable names. Using these values may cause issues with customer configurations and could possibly alter site functionality. action_id bm_cm_process_id _bom_ bs_id commerce_doc_url_params commerce_list_id document_id document_number folder_id formaction from_config scrollTop shopping_cart_id step_id token version_id
   *Category	Select Configurable Attribute.
   Array Type	Select this checkbox if the attribute can be used as a column in an array set.
   *Data Type	Select Text, Float, or Integer. The Image Menu option does not appear when an attribute is being created. It only appears in an attribute that has been saved during creation, or has been re-opened.
   Attribute Type	Select Single Select Menu or Multi Select Menu. Refer to Single Select Pick Lists to add or edit Single Select Pick Lists:
   Average Value Pricing	Select Static Pricing to enable Attribute Value Pricing functionality. For more information, see the topic Attribute Value Pricing (AVP).

7. Enter menu items in the Menu Population section.

   You must create at least one menu entry before you can save menu attributes.

• Enter a value for Displayed Text.

  The Variable Name field populates automatically. Variable names can only contain alpha-numeric characters and underscores. The entry can be changed before saving, but after saving the value is read-only.

• Click Add Entry.

  The values you entered for Displayed Text and Variable Name appear in the list.

• Click Entry Manager or Show Entry Details to edit the order of the menu attribute, change the menu display names, or add images to each menu value.
• Set a Default menu value by selecting a menu value and clicking Set.

8. Click one of the following:

   • Cancel to return to the Attributes List page without saving changes.
   • Add and New to save changes and create another attribute.
   • Add to save changes and open the Menu Attribute Editor, proceed to Edit a Single Select or Multi-Select Menu Attribute.

1. Navigate to Admin Home page.

2. Click Catalog Definition in the Products section.

3. Navigate to the applicable configuration item (All Product Families, Product Family, Product Line, or Model)

4. Select Attributes from the applicable Navigation drop-down, and then click List.

5. Click on the applicable attribute..

6. Edit information in the following sections, as required.

   Main Information

   

   Field	Description
   Name	The name of the attribute The Name value appears as the attribute label when this item is added to a Configuration layout.
   Image Menu	Select Yes to enable Image Menus. Individual images are added in the Menu Population section and display options are set in the Image Properties section.
   Display Type	The following Display Types are available: Legacy Display Type: Single Select Menus without Image Menus: Single Select Menu, Radio Button Horizontal, Radio Button Vertical Multi Select Menus without Image Menus: Multi Select Menu, Checkbox Horizontal, Checkbox Vertical Image Menus Enabled: Drop-down Menu and Grid Note: Array type attributes only allow the Single Select Menu option. JET Display Type: Single Select Menus without Image Menus: Select Choice, Film Strip Horizontal, Film Strip Vertical, Cards, Radio Button Horizontal, Radio Button Vertical Multi Select Menus without Image Menus: Select Choice, Film Strip Horizontal, Film Strip Vertical, Cards, Checkbox Horizontal, Checkbox Vertical Image Menus Enabled: Select Choice, Film Strip Horizontal, Film Strip Vertical, Cards Note: Array type attributes only allow the Select Choice option.
   Average Value Pricing	Select Static Pricing to enable Attribute Value Pricing functionality. For more information, see the topic Attribute Value Pricing (AVP).
   Description	The attribute description. When an attribute Help Icon is displayed on a layout, the description appears when the user hovers over the help icon. Refer to Help Icons for more information.

   Properties

   

   Field	Description
   Set Type	None: The user can input any value without encountering an error message. Set: A recommendation rule can change the value entered by the user unless the attribute is locked by the user. Auto Lock - When Auto Lock is on, user selections made to an attribute after a Recommendation rule “Set” the attribute to a different value will be retained if the Recommendation Rule is fired again (such as upon an Update). Auto Lock Example Recommendation rule 1 runs and sets Attribute X to A. The user then sets Attribute X to B. The user then clicks Update, and Attribute X retains its value of B. The recommendation message defined in Recommendation rule 1 for option A will appear. Auto Lock is on by default for all Recommendation rules that have a set type of “Set.” The Admin can turn Auto Lock off within an attribute by selecting “Set” for the set type and by not selecting Auto Lock. If this were done to Attribute X, the user would experience the following: Recommendation rule 1 runs and sets Attribute X to A. The user then sets Attribute X to B. The user then clicks Update, and Recommendation rule 1 runs and sets Attribute X to A. Forced Set: A recommendation rule will change the value of the attributes regardless of what the user enters and if the attribute is locked or not.
   Required	This will require the user to enter a value before proceeding to a commerce transaction.
   Hidden	This attribute will not appear to the user. It can be used in rules.
   Auto Update	This will by updated by the system without the user invoking an action.
   Legacy Constrained Values Display:	Removed: Constrained attribute values will be removed from the menu. Marked: Constrained attribute values will be marked with an asterisk (*) in the menu. Normal: Constrained attribute values will appear in menus without being marked.
   JET Constrained Values Display:	Disabled: Constrained attribute values will be disabled. Removed: Constrained attribute values will be removed from the menu. Normal: Constrained attribute values will appear in menus without being marked. Strike Through: Constrained attribute values will be struck through (i.e. crossed out). The Strike Through option is not available for Image Menus.
   Hide Transaction	This attribute is hidden within a commerce document.
   Status	Active: An attribute that is active will appear to the buyer and/or be included in rules. All attributes are active by default. Inactive: An inactive attribute cannot appear in a rule to the user. Internal: An internal attribute will only appear to FullAccess users. Show Start/End Dates: Click to specify how long the attribute will remain in the chosen status. If no duration is specified, the attribute maintains its status until the administrator changes it.

   Attribute Value Pricing (Attribute Value Pricing Properties and Menu Entry Prices appear when Average Value Pricing is set to Static Pricing)

   

   1. Set Attribute Value Pricing Properties

      • Pricing Display Options: Choose None if you don't want to display the attribute value price or choose Show Pricing Next to Attribute Values.

      • Display Price at Bottom to User: Select to display the attribute value price in the Price section on the configuration layout.

        Depending on the configuration layout you've chosen, this might not be at the bottom.

      • Include in Total Price:  Select to include the attribute value price in the Grand Total in the Price section on the configuration layout.

        Zero static price is not shown in the Pricing Section - If the AVP price for a menu attribute is zero, then this price is not shown in the pricing section.

   2. Add pricing in Menu Population section.

      • Create new menu values and add pricing for each available currency.

      • Click Entry Manager to add a price to individual menu values.

        

   • When AVP price is not given for a certain currency and exchanges rates are not defined, the user is shown the message that the price is not defined.
   • Negative prices are not supported.

   • When a newly added currency is assigned to an AVP attribute and the new currency is not enabled prior to migration, the AVP value for that currency does not migrate.
   • When AVP price is not given for a certain currency, the price for that currency is calculated using the AVP price in the base currency and the defined exchange rate.
   • Attributes displayed on the Search Flow and subsequently on the Configuration Flow exhibit AVP pricing behavior based on the value retained from the Search Flow.
   • The user cannot save changes to the value of this attribute.
   • It is recommended that the FullAccess user either hide the attributes carried over from the search flow or make them read-only for the benefit of the end user.

   ---

   Image Menu Properties (Image Menu Properties appear when Image Menus are enabled)

   

   Image Menu Properties

   • Fix Dimension: Base the image size on Height or Width.

     The images will be auto-scaled to preserve the proportions of the image to fit the layout.

   • Image Size: Set the image size in pixels.

     Create your images in a size similar to the one in which they will be displayed, to keep the image dimensions consistent and avoid distortion.

   Legacy Properties

   • Label and Price Location: Select: Above Image, Below Image, or Hover

     Sets where the menu item labels and the optional attribute value prices are displayed. View location examples

     

   • Rows and Columns:  Set the number of Rows and/or Columns.

     If Rows are set to "0", the number of rows will be auto-populated based on the number of columns.

     • To display 12 menu items in rows of 3, enter 3 for Columns.
       
     • To display just the first 2 rows, instead of displaying all 4 rows, set the number of Rows to 2. The image menu will contain a scroll bar so users can scroll to view the rest of the rows.

   JET Properties

   • Control Display: Set film strip pagination controls

     *Available for Film Strip Horizontal and Film Strip Vertical

     View Arrow and Paging Controls example

     

     View Arrows example

     

     View Paging Controls example

     

     View Arrows and Paging Information example

     

   • Label and Price Location: Select: Above Image, Below Image, or Hover

     Sets where the menu item labels and the optional attribute value prices are displayed. View location examples

     

   • Height and Width: Set the image frame size View frame size example

     *Available for: Film Strip Horizontal, Film Strip Vertical, Cards

     

   • Page Size: Set the number of frames displayed in the vertical film strip View page size example

     *Available for Film Strip Vertical

     

   ---

   Menu Population

   

   1. Enter menu items

      • Enter a value for Displayed Text.

        The Variable Name field populates automatically. Variable names can only contain alpha-numeric characters and underscores. The entry can be changed before saving, but after saving the value is read-only.

      • Click Add Entry.

        The values you entered for Displayed Text and Variable Name appear in the list.

      • Click Entry Manager or Show Entry Details to edit the order of the menu attribute, change the menu display names, or add images to each menu value.
      • Set a Default menu value by selecting a menu value and clicking Set.

   2. (Optional) If desired define cardinality. Only available for Multi-Select Menus

      1. Select Cardinality form the Validation drop-down.

      2. Enter the desired values for the Min Selectable Items and/or Max Selectable Items.

         

         Valid values:

         • Any positive, non-zero integer that doesn't exceed the total number of associated menu entries.

         • Blank values - Blank means there either is no min or max depending on the field(s) left blank.

   3. (Optional) Add images for Image Menus.

      Images can be added using the Entry Manager or Entry Details.

      Make sure your images have already been uploaded to the File Manager.

      • Entry Manager Method

        • In the Menu Population section, click Entry Manager.

          If you get a message about saving attributes, click OK.

          The Menu Items List page opens.

        • For each Menu Item, click Browse to search the File Manager and select the image you'd like to correspond with your menu value.

          Click Clear to clear an existing image.

        • Click Apply to save changes and remain on the Menu Items List page, click Update to save changes and return to the Configurable Attributes Administration List Menu Attribute Editor.

      • Entry Details Method

        • In the Menu Population section, select a Menu Item and click Show Entry Details.

        • Click Browse to search the File Manager and select the image you'd like to correspond with your menu value.

        • Click Clear to clear an existing image.

   ---

7. Select one of the following options:

   • If translations are required, click Translations and provide translated values for the label and description fields.

   • Click Apply to save changes and remain on the Attribute Editor page.

   • Click Update to save changes and return to the Configurable Attributes Administration List.

   • Click Update and New to define another attribute.

   • Click Back to return to the Configurable Attributes Administration List without saving changes.

Customers can constrain the same Configurable Attribute differently depending on different conditions. Administrators can override the "Constrained Value Display" option defined in single select and multi-select menu-type configurable attributes within the action area of a constraint rule. For example, a customer has two constraint rules that have different Override Constrained Values Display options. The first constraint rule has the Override Constrained Values Display set to Disabled for "Sports" and "Luxury" vehicle values when the "Outright SUV buy" option is selected.

When a sales user chooses the "Outright SUV buy" option, the Sports and Luxury options are grayed out (i.e. disabled).

The second constraint rule has the Override Constrained Values Display set to Normal and user message displayed for the "Luxury" vehicle value when the "SUV Lease" option is selected and the "Expense Limit" is less than $1000.

When a sales user chooses the "SUV Lease" option, sets the "Expense Limit to $500, and selects the Luxury option, the option appears normal, but the vehicle options are outlined in red to indicate an error and the defined error message is displayed.

The Constrained Value Display Override is applied from the last constraint rule executed on the attribute. The order is defined by the order of the rules on the Constraint: Rules List page.