Справочник — это обычный CSV-файл:

• Плоский: даже если в исходном справочнике есть иерархия, перед подключением к подсказкам он должен быть переведен в плоский вид. 
• С заголовочной строкой: она используется в настройках.
• В названии самого справочника и конфигурационного файла можно использовать только строчные латинские буквы, цифры и подчеркивание.
• В заголовках полей можно использовать только латинские буквы и подчёркивание.
• В кодировке UTF-8 (без BOM).

Особенности и ограничения

Если надо, чтобы подсказки возвращали вычисляемые поля (например, «ФИО», составленное из фамилии, имени, и отчества) — эти столбцы тоже должны быть в справочнике. Сами подсказки их делать не умеют.

Если нужен поиск по синонимам (хендай, хенде → hyundai) или с учетом опечаток (менежер → менеджер) — варианты написания нужно перечислить в отдельном столбце справочника через запятую. Подсказки не умеют автоматически искать с учетом опечаток или придумывать синонимы.

Если одни записи справочника более «весомые», чем другие (например, головные организации против филиалов), то веса должны быть предрассчитаны для всех записей и вынесены в отдельный столбец — сами подсказки этого делать не будут.

Подсказки используют префиксный поиск. Вот что это значит на примере. Допустим, есть запись справочника «Волкова Татьяна Анатольевна». Тогда:

• запрос «волк» найдет запись;
• запрос «волкова» найдет запись;
• запрос «волкова тат» найдет запись;
• запрос «волкова татьяна» найдет запись;
• запрос «волк тат» не найдет запись;
• запрос «волк татьяна» не найдет запись.

Таким образом, в тексте запроса допускается частичное совпадение только по последнему слову, по предыдущим словам совпадение должно быть полным.

По умолчанию значения полей подсказки трактуют как строки, даже если по факту это числа или даты.

Пример справочника