Set Up Decoration Strips

 

In the kitchen planner, wall cabinets can be enhanced with a decoration strip. The "deco strip" option is editable by the customer in the Edit panel.

❗️ Even if there is no dependency with the bottom and side cover panels and the worktop light of the wall cabinet, the deco strip strongly links to these two options.

➡️️ Click here 🔗 to open the complete sample to define deco strips through API.

---

Definitions

The table below lists all the definitions around decoration strips.

Term	Definition
Deco strip	A decoration strip is a linear that can be added under the wall cabinet on the front and/or on left and right sides. This strip can have different colors and shapes provided by dedicated products of the catalog. As a linear feature, deco strips of adjacent cabinets are merging if they are aligned and are generated from the narrow bottom path.
Deco strip section	Dedicated product which contain the parametric cross section to be used on horizontal or vertical orientation. This section is used to generate deco strip through a path via a sweep function.
Narrow bottom path	Defines in the .BMA of the box the front boundaries of the wall cabinet to provide the start and end points (at least) of the linear and its direction and position.
outer top path	Defines in the .BMA of the box the back boundaries of the wall cabinet to provide the start and end points (at least) of the linear and its direction and position.

---

Illustrations

Below are illustrations of concepts regarding decoreative strips that are documented hereinafter.

Vertical deco strip

Horizontal deco strip

---

Specify the Basic Information

The minimum information required to create a decoration strip is common to every kind of products.

Connect to 3DCloud and click Products on the CONTENT menu. Then, click New product.

This is:

1. The name: The name will be displayed in the planner (in the Edit panel) and should be available for all languages. If not, the planner will display the name in the fallback language.
2. Mandatory information: The product reference, the brand and the product type.
3. Product information: This information is not mandatory but highly recommended, especially the short and long descriptions that are displayed in the planner.
4. Product representation: This is where you specify among others the 3D resource, the thumbnail and the parameters.
5. Pricing: This is where you specify the pricing type (regular, discount...).

❗️ Select your product type carefully because it will trigger the applicative rules: deco strips.

---

Specify the 3D Resource and the Thumbnail

The required resource for a decoration strip is a .BMA file that defines the section(s) to be used among other components (see hereinafter).

Click Upload a 3D model to browse for your .BMA file and add it to the datasheet.

📌 There is no preview to display in this area because the 3D resource is not a texture, unlike to other linears and the BMA of a deco strip is only the definition of the section of the strip, i.e. a set of points.

In addition, a texture (.BM3MAT file) is needed as a material parameter of the deco strip product; this material must be available in the current catalog (see below Define the material).

In some use cases, one second .BMA resource might be needed to define the cross section itself in a dedicated product (see below Define the section product).

---

Specify the Dimension Parameters

Dimension parameters are always mandatory, specifically the width that is used to calculate the price.

Parameter	Type	Possible values	Default value
width	Continuous length	[0 ;∞]	0 ≤ 2210 ≤ ∞
depth	Discrete length	[0 ;∞]	20
height	Discrete length	[0 ;∞]	60

Click Add variable dimension in the Product representation tab to define the default width, depth and height of the decoration strip.

The ecoFeeCategory Parameter

ecoFeeCategory has a usage:

• Define to find the same category in the range where the weight of the board lies and to retrieve the ecofee value of that weight.

❗️ This parameter is mandatory to trigger EcoFeeRule.

Parameter	Type	Possible values
ecoFeeCategory	string	any string

The linearWeight Parameter

linearWeight has a usage:

• Define to calculate the weight of linear using length and linearWeight and the calculated weight will be returned by EcoFeeRule.

❗️ This parameter is mandatory to trigger EcoFeeRule. PreciselylinearWeight should be in kilograms per meter.

Parameter	Type	Possible values
linearWeight	number	[0 ;∞]

---

Define the Material

Click Add material replacement to set the material parameter.

Parameter	Type	Possible values
material	Material variation	External dbID

The material parameter defines the texture to apply on the generated deco strip. This material must be available in the standard material 🔗 library.

---

Define the Section Products

Decoration strips can be used vertically or horizontally (see the illustrations above).

That is why two product variations must be defined:

• decostripHorizontalSection to define the cross section, i.e. the shape of the strip when placed horizontally under the wall cabinet;
• decostripVerticalSection to define the cross section, i.e. the shape of the strip when placed vertically back from the front.

Both parameters link to products that must be available in the catalog of the Legal Entity.

Parameter	Type	Possible values	Default value
decostripHorizontalSection	Product variation	External dbID	External dbID
decostripVerticalSection	Product variation	External dbID	External dbID

Click Add product replacement to define the list of compatible products.

About Section Products

The products linked to the deco strip via the decostripHorizontalSection and decostripVerticalSection parameters should have the following:

• The product type "Accessories": indeed, sections do not need a specific type because they are pointed by their ID;
• The dimension parameters specified both in their datasheet and in their .BMA;
• The BMA as 3D resource 🔗 because a section is defined by an output set.

---

Pricing

Like every product, wall edge strips support different pricing 🔗 types: regular, reduced, membership, etc. Click the Pricing tab to define the price(s).

---

Parameters to Add at Upper Level

Deco strip option is an indirect product feature. This means that it is not mandatory to list the deco strip products at the top-assembly level.

However, some settings have to be made at cabinet level:

• Enable the deco strip option;
• Enable the extension of the deco strip to the sides;
• Enable the modification of the orientation of the deco strip.

Enable the Deco Strip Option

Setting the decoStripOption to 'true' in the top-assembly (cabinet) datasheet will enable a choice of deco strips in the planner corresponding to products available in the catalog.

Enable the Extension to the Sides

To allow the customer to enable or disable the extension of the deco strip on the left and/or right sides of the cabinet, two others parameters are needed on cabinet level:

• Define leftDecoStripBack with 'true' as default value;
• Define rightDecoStripBack with 'true' as default value.

📌 Because these parameters will impact the size and the position of the panel, it is also necessary to overload the values at cabinet level with the values of the panel sub-assembly as an input value.

Enable the Modification of the Orientation

To allow the customer to change the orientation of the deco strip (either vertical or horizontal), the parameter sectionOrientation is required at cabinet level.

📌 Because this parameter will impact the size and the position of the panel, it is also necessary to overload values from the cabinet level to the panels sub assembly as an input value.

---

Compatibility with Other Products

In some cases, you might have an incompatibility between worktop light and side deco strip.

Indeed, when the worktop light width equals the cabinet width, it is impossible to mount side deco strips.

In those cases, we suggest to use a product rule to manage that incompatibility.

1. Go to Product rules in the CONTENT menu. Then, click New rule.
2. Enter a name for the rule.
3. Choose Compatibility in the Type drop-down list.
4. Click Add option to specify the parameters that will be involved by the rule: a. Enter worktopLight with the type product. b. Enter leftDecoStripBack with the type boolean. c. Enter righttDecoStripBack with the type boolean.
5. Click Next at the bottom of the page.

Now enter the Rule specification.

📌 The options are now the column headers.

1. Click New rule to enter data in the table.
2. Click Add product in the worktopLight column to search for the wall cabinets concerned by the incompatibility.
3. Click Select a value in the leftDecoStripBack column to choose between True / False / True or false.
4. Click Select a value in the rightDecoStripBack column to choose between True / False / True or false.
5. Click Save.

📌 Add as many lines as products that are concerned by the rule by clicking New rule.