Auto-complete, also referred to as auto-suggest, is a feature that suggests values in a dropdown list as you type into a textbox. In Profound UI, textbox widgets have a set of auto-complete properties that can either provide a static suggestion list or link to a database for suggestions.



Auto-Complete Choices

These properties allow you to provide a static or program provided list of auto-complete choices.

Choices

Specifies the options for a textbox with auto-complete. The options should be comma separated.
Promptable? YES
Possible Values: Comma separated list of valid choices
Bindable? YES
Product: ProfoundUI, Genie

Choice Values

Specifies alternate option values to send to the application for a textbox with auto-complete. The values should be comma separated.
Promptable? YES
Possible Values: Comma separated list of valid values to be returned to application.
Bindable? YES
Product: ProfoundUI, Genie

Database-Driven Auto-Complete

These properties allow you to provide the needed information to retrieve the list of auto-complete choices from a database file.

Choices Database File

Database file to be used for a dynamic database-driven textbox with auto-complete.
Promptable? NO
Possible Values: Any valid database file name. Can be specified with library in 'LIBRARY/FILE' format.
Bindable? YES
Product: ProfoundUI, Genie

Choice Options Field

Database field name used to retrieve the options for a textbox with autocomplete. Multiple fields can be specified and should be comma separated.
Promptable? YES
Possible Values: Any valid database field name(s) from the Choices Database File
Bindable? YES
Product: ProfoundUI, Genie

Choice Values Field

Database field name used to retrieve the values sent back to the application. If omitted, the choice options field is used. If multiple option fields were specified, the first option field is returned.
Promptable? YES
Possible Values: Any valid database field name from the Choices Database File
Bindable? YES
Product: ProfoundUI, Genie

Choices Selection Criteria

Optional expression identifying which records should be retrieved from the choices database file.
Promptable? YES
Possible Values: Any valid selection criteria for the Choices Database File. Selection criteria should be formatted like a SQL "Where" clause.
Bindable? YES
Product: ProfoundUI, Genie

Max Choices

Optional maximum number of choices to provide for auto-complete. This property controls the size of the auto-complete dropdown list.
Promptable? NO
Possible Values: Any positive integer value
Bindable? YES
Product: ProfoundUI, Genie

Contains Match

When set to true, the auto-complete query finds records that contain the search text. When set to false, the auto-complete query finds records that start with the search text. The default is false.
Promptable? DROPDOWN
Possible Values: True, False
Bindable? YES
Product: ProfoundUI, Genie

Dynamic Auto-Complete

This method allows auto-complete choices to be retrieved from a web service.

Choices URL

Sets the url to a Web service that returns the choice options and values in JSON format. The service can be provided with Profound Logic's RPGsp or another web development framework. RPGsp provides an easy to use platform for developing Web services using ILE RPG. If a choices url is used, the database file, choice options field, choice value field, and max choices properties are ignored.
Promptable? YES
Possible Values: A valid web service URL
Bindable? YES
Product: ProfoundUI, Genie

Events

Onselect

Initiates a client-side script when a selection is made form the selection list of an auto-complete textbox or a combo box. In the case of an auto-complete textbox, the selected record is passed to the function as a JSON object that has properties named after the selected fields.
Promptable? YES
Possible Values: Any valid JavaScript code
Bindable? YES
Product: ProfoundUI, Genie