Bindings configuration

The Bindings tab of the Add to Cart button dialog configures the data source for the available cart columns defined in the eCart Object. As well, it determines how the item is added to the cart, and if a redirect takes place based on the item's addition to the cart.

To complete Bindings configuration for the Add to Cart button:

  1. Click on the Bindings tab to continue with configuration. Bindings information correlates item properties with the columns that store the data within the cart, as well as the method used to populate the item into the cart contents.
  2. The configuration window lists all shopping cart columns available for the specified eCart Object (see Columns for more information) and their corresponding values for the given item. The following default columns are always available for any eCart object definition:
    • ID
    • Name
    • Description
    • Weight
    • Quantity
    • Price
    Note: If you have previously configured an Add to Cart button and then add a custom column to the corresponding eCart object, you must return to the Add to Cart and manually bind the new column or you will get an error. The new column will not be automatically detected from the eCart Object for the Add to Cart button configuration.

    Values for each column are specified by selecting a column from the display pane and specifying the data for that column in the Default value: field.

    Default columns require a value of zero if no data is bound to them.
    • To configure static items, enter static values to bind to the ID, Name, Description, Weight, Quantity and Price of the item.
    • To configure items retrieved from a recordset, select recordset columns to specify the ID, Name, Description, Weight, and Price of the item through the available data bindings:

  3. You have the option of making a column value editable and including an updateable form field to the user to specify the information for that column.

    You may configure any column to be updateable. If a column is updateable, you may then select the type of form field that will retrieve the associated column's data for this item.

    Note
    : Using a select list to update a cart column requires that you configure the list's options after insertion of the Add to Cart Button. This can be done directly through the Property Inspector for the list.

    By default, the Quantity of the item added to the cart is automatically configured to be set using a text field placed on the page with the Add to Cart button. If the quantity of the item added to the cart is not determined by the user:
    • Change the binding to reflect how the quantity is to be set (static or server-side code).
    • Uncheck the Updateable: checkbox.
  4. In the If Item in Cart section, select one of the following options from the Action list to determine how the item is populated into the shopping cart if the same item is already present:
    • Sum: increases the quantity of the item in the cart.
    • Ignore: does not allow the item to be added.
    • Add New: creates a new instance of that item in the cart separate from the existing instance.
    • Replace: adds the item to the shopping cart and replaces the existing item
    If you wish the user to redirect to a page other than the current page, click the Redirect checkbox and enter a relative URL or a full http;// address where the user is to be directed to upon adding the item to the shopping cart. This redirect will override the redirect specified on the General tab for this situation when a location is specified.