Object-Type "Parameter"

Production > Product Configurator > Product configurator definition > Configuration structure > Object-Type "Parameter"

Top  Previous  Next
Expand/Collapse Toggles

A parameter  is used for input or selection of possible options in the configuration. The available types of parameters are as follows:

Normal: Alphanumerical values.
Checkbox: Enable or disable the option (Yes/No).
Selection: A selection objects need to be assigned to this parameter type: radiobox or drop-down list.

Product_Config_INPUTtab

Window artikel_produktkonfigurator_detail.psr

 

The following fields and properties are available in the header of the window:

Field

Description

Name

Parameter name (ID)

Type

The Type of Parameter

Auto

Beas determines whether the parameter is a number or a string depending on the value.

If the value is a number or "0", Beas interprets this parameter as a number.
If the value is empty or not a number, Beas interprets this parameter as a string.

 

Example 1:

Parameter: "color" is "red"

Formula: 'the color is ' || [color]

HANA SQL: select 'the color is' || 'red' -> all ok

 

Formula: 10 + [color]

SQL: 10 + 'red' -> produce error

 

Example 2:

Parameter: "color" is "5.3"

 

Formula: 'the color is ' || [color]

HANA SQL: select 'the color is' || 5.3 -> produce error

 

Formula: 10 + [color]

SQL: 10 + 5.3 -> all ok

 

The evaluation of a formula is always dependent on the contents of the parameter.

All configurations created with beas 9.2 PL 5 Build 32 or older, use parameter type "Auto" as standard.

 

Working with Beas system variables or custom defined variables starting with "e_", the parameter can be interpreted as a string or number. With the following Beas script setup the type can be permanently defined as string type, if the value is a Beas variable. This must be executed only once per database or client.

setsetup=config_default_e_type=c

String

This parameter type allows a string. If working with formulas, Beas inserts a ‘ (single quotation mark) at the left and right side of the parameter.

If you create a new parameter, the string type is the default option.

 

Example 1:

Parameter: "color" is "red"

Formula: 'the color is ' || [color] (HANA SQL)

MS SQL: select 'the color is' + N'red'

HANA SQL: select 'the color is '  || ' red'

 

Example 2:

Parameter: "color_number" is "5,3"

Formula: '10' + [color_number]

MS SQL: '10' + '5,3' -> all ok

 

Formula: 'the color is ' + [color]

DataWindow Syntax: 'the color is' + 'red'

Number

This parameter type allows numbers only. If the content is not a number, Beas replaces it with “0”. The decimal delimiter is based on what it is defined in the system, but Beas internally replaces it with decimal point.

 

Example:

Parameter: "color_number" is "5,3" (Regional setting is Germany)

Formula: [color_number] * 3

SQL: 5.3 * 3

 

help-achtung

If you use a parameter both as a string or numeric value, then it is advantageous to specify this directly in the formula.

 

String formula: 'color is ' || [color,dbstring]

Number formula: if [color_number,dbnum] > 10 then 1 else 100 end

Image

 

A picture to be displayed at this group. When the user selects the group, the picture is displayed. To select a picture, click on the drop-down arrow in the field and a screen opens to browse for the required image. Beas saves the image in the SAP Picture share folder.

 

The image display size can also be defined.

The size parameter is not supported fin the WEB version and in the WEB Configurator the image is always the original size.

 

The following sizes are supported in the internal view:

250 x 250

450 x 450

650 x 650

300 x 250

500 x 450

700 x 650

 

configurator_picturesize

 

 

hmtoggle_plus1Input tab

 

Field

Description

Mandatory

 

You can define a parameter as mandatory:

Configuration saved with mandatory fields missing have "Draft" status.

NOTE: The field must be filled, otherwise you cannot create a Precalculation or work order with this configuration.

 

configurator_statusdraft

 

Mandatory entries are marked with a question mark.

configurator_mandatory_question

 

pk_cancel indicates that the area is not completed.

pk_ok indicates that the area is completed.

 

beas 9.3 PL 2

Type of input

 

Value

Description

Normal

Small input field

Normal Large

Large input field

Check Box

Checkbox with result Y/N (yes/no)

Selection - Radio Box

Radio box. Selection options can be defined:

Using a SQL statement or Cross Reference to generate the radio buttons
By right-clicking on the created radio box parameter in the configurator and adding a New selection

configurator_outputvariants_selections

 

Selection - Dropdown

Create a drop-down field. A reference must be defined using a SQL statement or Cross Reference to chose the contents of the drop-down list.

 

configurator_outputvariants_def

 

configurator_outputvariants

Cross Reference

hmtoggle_plus1 Define values using a SQL Statement or product Cross Rererence

 

This option can be used for check box, radio box, or drop-down selection.

 

You can insert the SQL statement clicking the SQL icon or you can create a Cross Reference and can insert the link to this Cross Reference.
Cross Reference: SQL Statement or manual values are supported

 

SQL Command

The generated SQL Command must return 3 string parameters:

return value
description
picture (only for radiobox)

 

Tip

If a SQL statement is used, the configuration can be easily copied from one database to another.

 

SQL example:

Create a list of all Items starting with "SofaCloth".

 

Use SQL Editor or type the commands:

[select id,description,bitmapname from table where ...]

 

For all items starting with "SofaCloth":

[select "ItemCode","ItemName" from "OITM" where "ItemCode" like 'SofaCloth%']

 

The result of using this statement for radio box and selection drop-down:

configurator_crossreference

 

Default Value

If a default value is defined, it is assigned to the parameter. Note, that this filed is case sensitive.

youtube Working with Default values

 

Fixed value

Text or numeric value (as required)

Example: test or 123

Variables, which are defined before opening in the Configurator window (that is, with Beas script in "Windowevent open"). These variables must be defined with "e_".

Example: [e_cardcode]

As empty value
  Choose [CurrentEntry]
Previously defined parameters. These defaults are dynamically changed.

Example: [so_mysetobject]

 

 

Fixed value

A fixed value is set if:

a new configuration is loaded
if a previously invalid default value becomes valid

 

Example of an invalid default value becoming valid again:

A radio box is defined with 3 elements: red, yellow, green. The default value is yellow. But the visibility rule specifies that yellow is invisible, and therefore invalid. In this case, "yellow" is invalid,so there is no default. Every time the configuration is changed, the system checks whether yellow is valid. If it becomes visible again, the parameter is set if the default has not yet been overwritten.

 

Default is a parameter

If the default value is a parameter, it is always reset if something is changed before the parameter.

 

Example:

WheelSize

defcolor (set object): case when[WheelSize] <30 then 'red' else 'blue' end

Color (Default=[defcolor])

 

If WheelSize is changed, the content of Color is also reset because WheelSize is BEFORE Color. If values are changed after Color, Color the value is not set again.

 

Manual changes have priority

If Color is changed manually, the manual change takes precedence, that is even if WheelSize is changed, the default value of Color is not reset, except, if the manually selected value loses its validity.

 

Example:

 

Color is a radio box

// Red only available, if WheelSize < 30

// Blue only available, if WheelSize>24

Red = case when [WheelSize] <30 then 1 else 0 end

Blue= case when [WheelSize] >24 then 1 else 0 end

 

If Blue is manually selected and then WheelSize is set to 22, Blue becomes invalid, so the manual entry loses its priority and the default value is set. In this case red and the entry is marked as "not changed manually".

If the default value is also invalid, the entry is marked as "not set".

 

hmtoggle_plus1Output tab

 

The Description of the Input tab can be replaced with another text defined in this field.

Field

Description

Text

Definition of an the output text

 

configurator_text

 

 

hmtoggle_plus1Tab Price

 

Config_Object_Price

artikel_produktkonfigurator_detail

 

 

Field

Description

Price determination

 

Value

Description

Formula

Create a formula to calculate the price

Manually

Insert the price manually in the Price field

Price List

Use price from a Price List

- Use default price list, defined in Calculation Header

- Use a special price list from a customer, if it is activated in the Calculation Header

 

Supports all price list rules, but unit groups are not supported.

 

If you insert [cprice] in a formula, you see the price determination result by Price List in this parameter.

No

Price determination is not activated for this entry.

beas 9.3 PL 2

Price

Use the entered price, if price determination is set to Manually

Item

Choose the item directly or insert a parameter.

 

For example for the following sofa cushions there are two parameters:

- Cushions Yes/No: whether cushions are needed

- Number of quantity: how many cushions are needed

 

In Cushion we the price determination is set to No, so it does not affect the price.

In Number of Quantity we define the price by a price list.

 

Price comes from price list from "SofaCushion"  item that was added to the Item field.

Quantity comes from the current "Number of Cushions" parameter (nrcushion), so the [nrcushion] parameter is chosen in the Quantity field.

 

configurator_pricedetermination

 

Result:

Beas searches in the price list for the sofa cushion item.

 

Total Quantity = Quantity from Sales Order / Quotation * Quantity from [nrcushion]

Result = Price from Price List * Quantity from [nrcushion]

 

Use the Test button in the product configurator definition list to test the setup.

beas 9.3 PL 2

Quantity

 

Insert a number manually or use a parameter.

 

Two quantities are calculated:

Required quantity for 1 product (cquantity)

Required total quantity (calculated quantity * quantity from sales order = ctotalquantity)

 

For an example, see Item.

beas 9.3 PL 2

Script / Formula

If the price is calculated by a formula (Price determination is set to Formula), insert the formula.

The Parameter Insert field provides a shortcut to all available parameters.

 

If the "[price]" field is in the formula, Beas determines the price using the price list.

 

See Script Syntax

 

The following standard parameters are available

Parameter Name

Description

cprice

Price from a price list (only for the Price calculation field)

cpricequantity

Calculated quantity for this item (only for the Price calculation field)

cpricetotalquantity

Calculated quantity * Quantity from sales order / quotation (only for the Price calculation field)

cdiscount

Discount of the current business partner

cpricelist

Price list of the current business partner

currentuser

Current user

cardcode

Business partner from the sales order

cquantity

Quantity from the sales order

cdocdate

Date from the sales order in yyyy/mm/dd format

cshortvariant

Short variant A-Z

The check button

Check for syntax errors in the entered script

Flag

flaggreen – The rule is error free

flagyellow – Warning (default)

flagred – Error in rule

Result

Shows the result of the evaluated formula. The result must be a number.

Attention: Price determination by price list is not working here, [cprice] is always 0.

Evaluation of the rule

Shows the evaluated formula with a status message.

 

hmtoggle_plus1Tab Visible Rule

 

Some rules can be defined to display the block with specific values or parameters. The rules determine whether a configuration option is presented to the operator, based on previous configuration selection. This way, it is possible to restrict options. The rule is created in SQL syntax.

Field

Description

Parameter Insert

Parameters and Set Objects that are already defined, are displayed in a selection list. They can be used to create of a rule.

Script

The language syntax that the rule is written in. Available options are:

DW Script
SQL formula
JavaScript formula
Java script
VBScript formula
VBScript

See Script Syntax

Input field

Insert the visible rule for the object. All defined parameters and Set-Objects can be used in the configuration.

 

Example:

[a] = 5

[color] = red

[a] > 5 or [b] = 3

 

To have a parameter not visible (maybe for special cases):

1 = 2

 

see Script Syntax

 

help-achtungNote:

When using the SQL formula, database accesses may reduce the performance of the configurator window.

The check button

Check for syntax errors in the entered script.

Flag

flaggreen – The rule is error free

flagyellow – Warning (default)

flagred – Error in rule

Result line

Shows the result of the evaluated rule.

Evaluation of the rule

Shows the evaluated rule with status message.

 

hmtoggle_plus1Tab Extented

 

 

Field

Description

Bitmap

Select the icon for the specific block. By default, Beas selects a folder icon.

Color

Select a display color for the text of the block name.

 

 


Help URL: https://help.beascloud.com/beas202102/index.html?pk_typ_parameter.htm