Configuration Boolean Attributes

Overview

Boolean attributes allow you to define a field as any two choice option. Common uses are to indicate true/false, either/or, valid/invalid or to include/not include.

The following images show the different display options available for Boolean attributes.

Administration

ClosedAdd a Boolean Attribute Watch Video  Video icon

  1. ClosedNavigate to the Attributes Administration List page.

    1. Click Admin to go to the Admin Home Page.

    2. Click Catalog Definition in the Products section.

      The Supported Products page opens.

    3. In the Navigation column, select Attributes and then click List.

      The Attributes Administration List page opens.

  2. Click Add. The Attribute Editor page opens.

    Attribute Editor with Boolean selected

  3. 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 Boolean.

    Attribute Type Select Text Field.

    Part Information

    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.

  4. 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 Boolean Attribute Editor, proceed to Edit a Boolean Attribute.

ClosedEdit a Boolean Attribute Watch Video  Video icon

  1. ClosedNavigate to the Configurable Attributes Administration List page.

    1. Click Admin to go to the Admin Home Page.

    2. Click Catalog Definition in the Products section.

      The Supported Products page opens.

    3. In the Navigation column, select Attributes and then click List.

      The Attributes Administration List page opens.

  2. Click the name of an attribute with Text in the Attribute Type column, or create a new attribute.

    The Text Attribute Editor page opens.

    Boolean Attribute Editor

    Note: The Attribute Editor defines the default display type properties for all layouts.

    ClosedMain Information

    ClosedProperties

    ClosedPart Information

    ClosedDefault Data

  3. 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.


Use Cases

Boolean attributes can be used in the condition, action, condition input, and action input like other configuration attributes. There are a couple of things to be aware of:

ClosedAdding a Boolean Attribute in a Rule

Here is a simple use case for adding a Boolean attribute in a rule. This assumes you have already created a Boolean attribute.

Goal: You don't want to display the desserts array on the UI unless Would You Like a Dessert = TRUE.

  1. ClosedNavigate to the Hiding Attribute: Rules List page.

    1. Click Admin to go to the Admin Home Page.
    2. Click Catalog Definition in the Products section.

      The Supported Products page opens.

    3. Ensure that Product Families is selected in the Navigation column and click List.

      The Supported Product Families page opens.

    4. For the Product Family containing desserts, select Hiding Attributes in the Navigation column and click List.

      The Hiding Attribute: Rules List page opens.

  2. Click Add.

    The Hiding Rule: New Rule page opens.

  3. Enter a Name, Variable Name and Description.

    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.

  4. In the Condition section, select the condition type Simple Condition.

    An Add Row section appears.

  5. Click Add Row and enter the following:

    Adding a Boolean attribute to a Rule

  6. Set Row Grouping.
  7. In the Action section, add the Actions that you will hide when the condition is met.

    In this example, the attributes with the red X next to them are the parts of the User Interface that will be hidden when "Would you like a dessert?" is false, or unchecked.

     attributes with the red X next to them are the parts of the User Interface that will be hidden when "Would you like a dessert?" is false, or unchecked

  8. Click Add.

Example of the User-Side (Hidden Array - Condition is met)


Example of the User-Side (Visible Array - Condition is not met)


Notes

There is no option to hide/show a label.

Boolean attributes are displayed to the user as a checkbox; this functionality differs from Commerce when attributes are read-only.

When set as read-only, Boolean attributes display as a disabled checkbox.

Have as few attributes "auto-update" as possible.

Related Topics

Related Topics Link IconSee Also