Custom Layout

The Custom Layout allows administrator to re-organise the product configuration layout information (Group/ Sub Group), position of group, subgroup and dynamic attributes) imported from ERP/IMC model (SSC/ IMC configurable product, Classified product). It is also able to support adding of new custom UI controls for the dynamic attributes in a Custom Layout.

E.g. 

• Number selector

• Single Value Select Radio Box (Including Boolean selector for string)

• Multi-Value Select Check Box

Before the release of 1904, all Dynamic Attributes showing on Configurator page are rendered in a Grid View and are in similar size. After the release, Fluid View was introduced together with Custom Layout. It is a new control that automatically adjust its width according to the length of the dynamic attribute values to utilize space. Each row can potentially have more dynamic attributes displayed.

• Before 1904
• After 1904

Settings for Custom Layout

List of UI Controls Supported by Configurator

Steps to Configure Custom Layout

Step 1:

Ensure the EnableCustomLayout is enabled from Administration> Master Data Management> Setting Boolean for Custom Layout to reorganize the layout of the Configurator.

Step 2:

Create a new Custom Layout from Model > Custom Layouts

Step 3:

The image below shows the Overview of a Custom Layout

i. Name - The name of the custom layout is read only once the custom layout is created. This is because the name is using in the Lookup table Custom_Layout as Custom Layout ID to match with the Product ID.

ii. Active – The settings to activate / de-activate a custom layout.

iii. Enable Configurator Fluid View – The setting to enable / disable fluid view by default for a custom layout.

iv.Value Option Threshold – The threshold value for the characteristic’s values to display with/without scroll bar.

Step 4: 

Attribute Tab – To select the list of dynamic attributes from the Model and add into the Custom Layout.

The system lists the dynamic attributes as shown below after the selected DAs being added into the Custom Layout. The position of the DA can be defined here, and the order will be applied to the attributes on the Configurator at Quote level.

The column Custom Control is Available indicates ‘Yes’ if the DA is Enumerable and/or Multivalue, which means the DA is available to apply custom UI control on it. The details of the DA can be viewed by clicking on the DA itself. The DA detail page shows only the selected properties on the DA, full detail of the DA can be viewed from the Model->Attributes.

The property DA Enumerable Single Value Control / DA Enumerable Multi Value Control shows the available custom UI controls which are supported to the DA. If a custom UI control is selected, the system will apply the custom UI control to the DA when the product mapped to a Custom Layout.

Step 5:

Group / Sub Group Tab – To create a new group and sub group in order to group the attributes. Any attribute found in product model (SSC or IMC configurable product) but does not defined in custom layout will show in a general group at the end of all groups defined in custom layout.

Example:

i. A new group was created. The position of the group can be defined on the column Position. Clicks on the localization icon to update the label for the localization supported by the system.

ii. Two Sub Groups are created for the Group. The position of the sub group can be defined at the Column Position.

iii. The list of attributes defined in a sub group with the position defined at the Dynamic Attributes.

Step 6:

Product Tab – To add product into the Custom Layout. The product within the Custom Layout will apply with the settings set in the Custom Layout. One product can only add to a Custom Layout.

The mapping of the product with Custom Layout is stored in the System table ‘Custom_Layout’

Step 7:

Localisation Tab – To update the localization label for the Custom Layout.

Step 8(Last):

Add the Product into a Quote and open the Configurator page to view the Custom Layout.

a. Figure below shows a Configurator page with Custom Layout applied.

b. However, figure below shows Product Configurator layout from the knowledge base. The Default Group contains the DAs found in product model but is not defined in custom layout.

c. Figure below shows Configurator page with Custom Layout and Fluid View

If the fluid view setting is disabled on the custom layout but it is enabled from the user preference, the setting on the user preference will overwrite the settings from the custom layout.