Maintaining an Auto-Complete Field for an Agency View

On the Autocomplete component, you can specify the contents and behavior of an auto-complete field on an agency view. Auto-complete fields can be displayed within larger user interface controls, such as a list, details area, accordion, or collapsible container.

Note: To use an auto-complete field in an agency view, the corresponding agency entity field must be configured with a Type of "Numeric". In addition, the value for the Precision validation rule must be changed from "10,2" to "18,0". Both of these conditions must be met regardless of whether or not the values you choose to search and display in the auto-complete are text or greater than 18 characters in length.

To access the Autocomplete component, go to the Agency View Summary and open the control that includes an auto-complete field. On the summary component for that control, locate the row for the auto-complete field, and then select Open from the Actions menu on the field's row.

You can view or change values in these fields:

Click in a field and add, change, or delete information as needed.

For information about using a Where Clause to create a query in the Search Filter field, refer to the System Administration Customization Guide, included in the web-based AASHTOWare Project installation package.

You must enter a value in either the Search Agency Entity ID field or the Search Entity ID field, but not in both.

Note: To associate the auto-complete field with one or more dependent fields on a single scrollable grid control, ensure that all the associated fields have the same value entered in either the Search Agency Entity ID or Search Entity ID fields. Matching values within the same scrollable grid control creates the dependency between auto-complete and dependent fields (see Maintaining a Dependent Text Field for an Agency View Scrollable Grid and Maintaining a Scrollable Grid for an Agency View).

In the Fields to Search section, each row indicates a database Field from the selected entity that will be searched for matching values when text is entered in the auto-complete field.

In the Fields to Display section, each row indicates a database Field from the selected entity that will be displayed in the auto-complete field when text is entered. For example, if the auto-complete field will be used to specify a reference item, you can choose to display the reference item name, description, and unit system in the auto-complete field. For one of the display fields, you must select the Make this the stored value check box. This selection determines which field value is stored in the database when the user selects a value in the auto-complete field.

To add a new field to search or display, enter a value in the empty row at the bottom of the appropriate list. Field names must be formatted as Entity.FieldName. If the control that contains the auto-complete field is based on an agency entity rather than a system entity, you can also use a field from the agency entity's parent by formatting the field name as ParentEntity.FieldName.

To delete a saved field from either list, click the Mark for Deletion button at the end of the field row. To reverse the mark for deletion, click the Undo button.

When you are finished, click the Save button. The system displays a message to confirm that your changes were saved.