Setting Up Global Product Properties

●    Text Input: A standard, single line text box that enables the customer to enter short, free text input value.

●    Multiline Text Input: Similar to the Text Input Control, but enables the customer to enter several lines of text input.

●    Radio Button: Enables the customer to choose the Dial value from a list of options that were defined by the uStore Administrator during the customization setup process. This Input Control displays the choice list to the user as a set of standard radio-style inputs.

●    Dropdown List: Similar to the Radio Box List, but displays the choice list to the user as a standard dropdown control.

●    Image Selector: Suitable for Graphic ADOR Dials, the Image Selector displays the list of images the customer can choose from inside the customization step’s page, alongside other Dials’ Input Controls. The user can choose one of the images displayed on the list, effectively setting the Dial’s value to be the name of the chosen image.

●    Popup Image Selector: Similar to the Image Selector, but the Popup Image Selector displays the list of selectable images in a popup-window, thus making this control more suitable for Asset Sources containing more images than can be conveniently contained inside the regular Customization Step’s page.

●    Extended Image Selector: In addition to capabilities offered by the Image Selector and the Popup Image Selector (selecting or uploading images), this Input Control allows customers to edit the uploaded images. The store administrator can select one of the two available display modes in the Display Mode field: Slider View (for less than 16 images) and Library (grid) View (for more than 16 images).

●    Gallery Image Selector: In addition to capabilities offered by the other Image Selectors (such as, selecting, uploading or cropping images), this Input Control offers customers enhanced editing capabilities. For example, the customers can adjust brightness and contrast, flip and rotate images and control the image opacity.

●    Date Time Picker: Enables customers to specify a date attribute for an order. You can set the date picker to function as a “Popup” (opens when clicked on) or as “Inline” (always visible). You can also set the date picker to a predefined period of time by using the Earliest and Latest date options. Use the Earliest and Latest date options to set exact dates or dates relative to an Order date (for example: X days after an order has been made).

●    Generic: Enables you to embed personalized HTML in uStore (in the Markup field) that will be rendered in real-time as the contents of the dial control. For example, you can embed a flash object or a Web page. When you embed a flash object, make sure you fill in its Client ID in the Object ID field.

You can use the following parameters in the markup code:

§       #DIAL_VALUE#: will be replaced with the value of the dial as saved in the database.

§       #DIAL_DISPLAY_NAME#: will be replaced with the name of the dial as set in Display Name field. See Product Properties page in Setting Up Product Properties.

You can also define a Java Script Callback Function in the Callback Function field, which will be available on the page, and call it to return a value to uStore.

●    Get Order Properties: When selected, allows you to add the Order ID or the Order Item ID values, which are generated automatically, to your product. This way, an order or an order item can be easily distinguished with an ID number.

●    Checkbox: Enables you to add a checkbox as a product property. You can set the value that the dial/property is given when that checkbox is selected (Value when Checked) or unselected (Value when Unchecked). You can also define this checkbox as mandatory by selecting the Customer Must Check checkbox. This way, customers will not be able to continue shopping unless this checkbox is selected. For example, you can add a EULA statement as a product property and ask customers to accept it in order to continue the shopping process.

●    Gallery List View: Enables the customer to choose a value from a list of predefined options. This Input Control displays the choices to the user as a list of icons, with names and description and can also include an overlay image.

●    Gallery Grid View: Enables the customer to choose a value from predefined options. This Input Control displays the choices to the user as a grid of icons, with name and description and can also include an overlay image.

This option is relevant for the default value selection only. To display values used in the previous orders, check this checkbox and select one of the following options:

●    Same Product: the value this customer gave this Dial in the previous order of this product.

●    All Products in the Store: the value this customer gave this Dial in the previous order of any other product, which includes this Dial name and is sold in the same Store.

This option allows you to set values for single option controls (Text Input and Multiline Text Input) and the values in multiple options controls (Radio Button and Dropdown List) with data derived from a database rather than defining it manually.

For example, you can define an input control of type Dropdown List that is populated with the customers’ addresses as registered in the uStore database instead of manually defining each entry of the list. This way, you can present each store shopper a personalized list. You can use the predefined uStore databases or you can define a custom database that conforms to the uStore database structure.

 You can only use either a global Data Source (available for all stores) or a Data Source that was defined for the specific store you are configuring. For more information on how to define a Data Source, refer to Defining Data Sources.

After you select a Data Source from the Data Source list available for the store you are configuring, you can use the wizard to define data binding for that Data Source or define it manually by entering an SQL query.

You can either use the Wizard option to populate personalized values from a Data Source or you can set the personalized values manually by using the Custom option.

If you chose the Wizard to populate the personalized values from a Data Source, you are required to provide the following information:

●    Table or View: select the table or view from which data is pulled.

●    Display Text Field (Multiple Options Input Controls): the text that is displayed in the input control and is associated with a Value field. For example, the presented text may be an address while the associated value field that is passed on to uProduce is a ZIP code. This selection is available only in multiple input controls.

●    Value Field: select the field (column) in the table or view that will be used to populate the input control. For example, you may have a field in your table or view that stores a recipient names; select that field to populate the input control with names from the Recipient column.

●    Conditions: The wizard enables you to define filters by which the specific value in the Value Field is pulled. You can use the following ID filters:

– User ID Field - available in the Users table

– Store ID Field - available in the Stores table

– Product ID Field - available in the Products table

– Language ID Field - available in the Culture table

You can also use any desired ID filters provided they are mapped to the above uStore ID filters. If you are defining a single option input control and the filter you are defining returns several records, only the first one will be displayed to the user.

Default Field (Multiple Options Input Controls): select the field (column) in the table or view that will be used to set the default value of the input control. Then, enter the specific value in that field that actually sets the default value. For example, the default value field can be 'IsDefault' and the actual values that set the default value can be '1' for 'is default' and '0' for 'not default'. In this case, you should select 'IsDefault' in the Default Field list and enter '1' as its value.

Override Default Sorting Field (Multiple Options Input Controls): allows you to sort the input control entries by the order in a specified table field (or view). The sorting order is determined by the data type in the selected field, as follows:

– lexicographic order for text

– alphanumeric order for numbers

– chronological order for dates

To manually define the Data Source for personalized values, select Custom and enter an SQL query in the Query field.

If you are using a single option Input Control such as a Text Box, you should enter a query that returns a single value. You should use one or more of the following parameters: @UserID, @StoreID, @ProductID, @CultureID and @OrderProductID (which is @OrderItemID).

If you are using a multiple options input control such as a Dropdown list, you should enter a query that can return several values. You should use one or more of the following parameters: @UserID, @StoreID, @ProductID, @CultureID and @OrderProductID (which is @OrderItemID).

●    Default Value: the Dial’s default value, which may be overridden by the customer. You can also create a list of values to be used as default values when necessary. To add a fixed value to the Value List, enter the value text in Text field and click Add.

●    Spell Checking: applies only to textual dials and properties that implement text or multiline text input controls. To use the spell checker in a textual control, select the Use Spell Check checkbox, and then select a language from the Language list.