Introduction

Auto complete provides suggestions when you type in the following text fields:

• quick search (on the home page and the header of all pages)
• attributes on the advanced search (including search builder)
• attributes on the asset add/edit page and variants of it (e.g. bulk update)

Security and Performance Considerations

Auto complete does not check the visibility of attributes when deciding which completions to show a user.  This means that the data shown to users as auto complete suggestions could be data that would otherwise be invisible to them.  For this reason it is recommended that you disable auto complete if your Asset Bank contains highly sensitive data.

If users are given a lot of completions that don't have any search results the completions could be coming from text in document assets that are not visible to them.  Setting auto-complete-include-file-keywords to false may help (you need to rebuild the auto complete index after changing this setting).

Rebuilding the auto complete index can take a very long time if your Asset Bank has a lot of assets and/or attributes, so we do not recommend enabling auto complete if your Asset Bank is very large.  Disabling auto complete based on text in documents can also improve performance (you can do this by changing auto-complete-include-file-keywords to false).

Enabling or Disabling Auto Complete

Auto complete is completely disabled if the auto-complete-enabled property in ApplicationSettings.properties is set to false. If you want to use any this setting must be enabled. If you enable auto complete after assets have been added to your Asset Bank (i.e. not when you are initially setting it up) then you will need to rebuild the auto complete index.

Data for all attributes that have "Include in keyword searches" enabled will be included in the suggestions for quick search.

Auto completion is enabled on the advanced search and asset edit pages for the individual attributes that have "Auto complete" turned on on the "Edit Attribute" page. The suggestions are based on the values of the attribute for existing attributes, except for keyword picker attributes where the suggestions are based on the keywords in the master list.

Indexing

The auto complete index is separate from the main search index. Like the search index the auto complete index is usually updated by Asset Bank automatically but there are some circumstances in which it is necessary to rebuild the index.

You can rebuild the auto complete index by going to Admin -> Attributes -> reindex the auto complete index.

The auto complete index needs to be rebuilt when:

• You change auto-complete-enabled to true in ApplicationSettings.properties.
• You edit an attribute and enable or disable "Include in keyword searches" or "Auto complete".
• You rebuild the main search index (you should rebuild the auto complete index after the main index because the main index is used when building the auto complete index).
• You change include-category-names-in-keyword-search in ApplicationSettings.properties.