Configure auto-complete to match text from any reference field

By default, auto-complete only matches text in the display value column. You can configure a reference field to match text from any additional column the reference field displays.

Before you begin

Role required: personalize_dictionary

About this task

You can add the ref_ac_columns_search attribute to enable auto-complete to match text in any column listed in the ref_ac_columns attribute. Set the ref_ac_columns_search attribute to true to match text from all reference field columns. By default (or when this attribute is false) auto-complete only matches text in the display value column.


  1. Right-click the label of a reference field.
  2. Select Configure Dictionary from the choice list.
  3. Under Related Links, click Advanced view.
  4. In the Attributes field, add the desired auto-completion attributes.
    For example, these attributes add the department field to the caller list and sort callers by their department:
    Figure 1. Auto-complete attribute
    Caller list with name and department
  5. Click Update.


The following example describes how to set the Configuration Item field display the CI class names from auto-complete choices for the Configuration item [cmdb_ci] table.
ref_auto_completer=AJAXTableCompleter ,ref_ac_columns =sys_class_name ,ref_ac_order_by =sys_class_name ,ref_contributions =task_show_ci_map ;ci_show_incidents
Note: The ref_contributions attribute controls the icons that appear next to the reference field.
Additional CI attributes