Configuration Float and Integer Attributes
Overview
Float and Integer attributes are defined in a Text Attribute Editor page, although different options appear depending on which type of attribute is being edited. These attributes can be displayed as text fields for legacy Configuration UIs and as text fields, spinners, horizontal sliders, or vertical sliders for JET Configuration UIs, which were introduced in release 19B. Float and integer attributes can also be displayed as Single Select Menus, Multi-Select Menus, or Single Select Pick Lists.
-
Float attributes are floating point number fields validate numbers with decimal values. View display options for Float attributes
The following images show the different display options available for Float attributes.
-
Legacy Display Type: Text
-
JET Display Type: Text, Spinner, Slider Horizontal, and Slider Vertical
-
-
Integer attributes are integer fields that validate whole numbers (i.e. numbers without decimal values). View display options for Integer attributes
The following images show the different display options available for Integer attributes.
-
Legacy Display Type: Text
-
JET Display Type: Text, Spinner, Slider Horizontal, and Slider Vertical
-
Administration
Add a Float Attribute
-
Navigate to the Attributes Administration List page.
-
Click Admin to go to the Admin Home Page.
-
Click Catalog Definition in the Products section.
The Supported Products page opens.
-
In the Navigation column, select Attributes and then click List.
The Attributes Administration List page opens.
-
-
Click Add. The Attribute Editor page opens.
-
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 or Signed Punch-in Attribute.
A Signed Punch-in Attribute functions identically to Configuration attributes except they require verification of digital signature data before pricing data is provided to the end customer. See Signed Punch-in Attributes for more information.
Array Type
Select this checkbox if the attribute can be used as a column in an array set.
Refer to Managing Arrays and Sets for more information.*Data Type
Select Float.
Attribute Type
Select Text Field, Single Select Menu, Multi Select Menu, or Single Select Pick List.
Signed Punch-in Attributes cannot be Array attributes, Multi Select Menu attributes, Single Select Menu attributes, Picklist attributes, and HTML attributes.Refer to the following topics for more information on Single Select Menu, Multi Select Menu, or Single Select Pick Lists:
-
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 Text Attribute Editor, proceed to Edit a Float Attribute.
Edit a Float Attribute
-
Navigate to the Attributes Administration List page.
-
Click Admin to go to the Admin Home Page.
-
Click Catalog Definition in the Products section.
The Supported Products page opens.
-
In the Navigation column, select Attributes and then click List.
The Attributes Administration List page opens.
-
-
Click the name of an attribute with Text in the Attribute Type column, or create a new attribute.
The Text Attribute Editor page opens.
Note: The Attribute Editor defines the default display type properties for all layouts.
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.Display Type
The following Display Types are available:
- Legacy Display Type: Text
- JET Display Type: Text, Spinner, Slider Horizontal, or Slider Vertical
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.
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.
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.
Display Type Field Options Text - Default: (Optional) Enter a default value for the attribute.
- Validation: Select a validation option.
- None - A validation will not be run.
- Positive Number - Check for a positive number.
- Range Check- Enter a Minimum Value and a Maximum Value
Spinner - Default: (Optional) Enter a default value for the attribute.
- Validation: Select a validation option.
- None - A validation will not be run.
- Positive Number - Check for a positive number.
- Range Check- Enter a Minimum Value and a Maximum Value
- Increment Value: Enter the value the for the spinner increments
Slider Horizontal
-or-
Slider Vertical
- Default: (Optional) Enter a default value for the attribute.
- Validation: Range Check is required for Slider Horizontal and Slider Vertical Display Types
- Enter a Minimum Value and a Maximum Value
- Increment Value: Enter the value the for the slider increments
- This field is required for Slider Horizontal and Slider Vertical Display Types
-
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.
-
Add an Integer Attribute
-
Navigate to the Attributes Administration List page.
-
Click Admin to go to the Admin Home Page.
-
Click Catalog Definition in the Products section.
The Supported Products page opens.
-
In the Navigation column, select Attributes and then click List.
The Attributes Administration List page opens.
-
-
Click Add. The Attribute Editor page opens.
-
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 or Signed Punch-in Attribute.
A Signed Punch-in Attribute functions identically to Configuration attributes except they require verification of digital signature data before pricing data is provided to the end customer. See Signed Punch-in Attributes for more information.
Array Type
Select this checkbox if the attribute can be used as a column in an array set.
Refer to Managing Arrays and Sets for more information.*Data Type
Select Integer.
Attribute Type
Select Text Field, Single Select Menu, Multi Select Menu, or Single Select Pick List.
Signed Punch-in Attributes cannot be Array attributes, Multi Select Menu attributes, Single Select Menu attributes, Picklist attributes, and HTML attributes.Refer to the following topics for more information on Single Select Menu, Multi Select Menu, or Single Select Pick Lists:
This section is used to associate a Configuration Integer Attribute or a Boolean Attribute to a single Parts database record, without the use of Recommended Item Rules. Refer to Attribute - Part Association for more information.
Field Description Part Number
Begin typing in the desired associated Part Number. The Part Number field will auto-suggest Part Numbers from the Parts database.
A green check mark indicates the entered part is valid. A red X icon indicates the entered part is invalid because it does not exist in the Parts database.
Comment
The Comment field is grayed out if the Part Number is invalid; it will remain uneditable until the Part Number is valid.
-
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 Text Attribute Editor, proceed to Edit an Integer Attribute.
Edit an Integer Attribute
-
Navigate to the Attributes Administration List page.
-
Click Admin to go to the Admin Home Page.
-
Click Catalog Definition in the Products section.
The Supported Products page opens.
-
In the Navigation column, select Attributes and then click List.
The Attributes Administration List page opens.
-
-
Click the name of an attribute with Text in the Attribute Type column, or create a new attribute.
The Text Attribute Editor page opens.
Note: The Attribute Editor defines the default display type properties for all layouts.
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.Display Type
The following Display Types are available:
- Legacy Display Type: Text
- JET Display Type: Text, Spinner, Slider Horizontal, or Slider Vertical
Array Control Attribute
An array control attribute is used as the Set Size attribute. They are used to define the size of the array. An array control attribute is a special kind of integer attribute that has been marked as an Array Control attribute. When you create an attribute with an integer data type and a text field attribute type, there will be a field called Array Control attribute. Checking this box marks the attribute as available for use as a Set Size Attribute for use in Array Sets.
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.
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.
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.
This section is used to associate a Configuration Integer Attribute or a Boolean Attribute to a single Parts database record, without the use of Recommended Item Rules. Refer to Attribute - Part Association for more information.
Field Description Part Number
Begin typing in the desired associated Part Number. The Part Number field will auto-suggest Part Numbers from the Parts database.
A green check mark indicates the entered part is valid. A red X icon indicates the entered part is invalid because it does not exist in the Parts database.
Comment
The Comment field is grayed out if the Part Number is invalid; it will remain uneditable until the Part Number is valid.
Display Type Field Options Text - Default: (Optional) Enter a default value for the attribute.
- Validation: Select a validation option.
- None - A validation will not be run.
- Positive Number - Check for a positive number.
- Range Check- Enter a Minimum Value and a Maximum Value
Spinner - Default: (Optional) Enter a default value for the attribute.
- Validation: Select a validation option.
- None - A validation will not be run.
- Positive Number - Check for a positive number.
- Range Check- Enter a Minimum Value and a Maximum Value
- Increment Value: Enter the value the for the spinner increments
Slider Horizontal
-or-
Slider Vertical
- Default: (Optional) Enter a default value for the attribute.
- Validation: Range Check is required for Slider Horizontal and Slider Vertical Display Types
- Enter a Minimum Value and a Maximum Value
- Increment Value: Enter the value the for the slider increments
- This field is required for Slider Horizontal and Slider Vertical Display Types
-
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.
-
Notes
- NULL and blank Integer values are treated as separate values:
- NULL= 0
- Blank = ""
- Using NULL as an attribute value is strongly discouraged.
- If you use logic that tests for NULL values in rule conditions or BML, confirm that the logic takes this difference into account.
Attribute range calculations are validated on the Value Punch-In.
Example: If the value was passed in the URL to the Configuration, it will be validated and an error message will appear.
This affects both Mobile and Desktop.