Платформа CUBA. Руководство по разработке приложений
4.5.2.1. Компоненты

Для работы компонента SearchPickerField необходимо создать collectionDatasource, и задать в нем запрос, содержащий условия поиска. Условие обязательно должно содержать параметр с именем custom$searchString - именно в него компонент передает введенную пользователем подстроку при нажатии Enter. Источник данных с условием поиска должен быть указан в атрибуте optionsDatasource компонента. Например:

<dsContext>
<datasource id="carDs" class="com.company.sample.entity.Car" view="_local"/>
<collectionDatasource id="coloursDs" class="com.company.sample.entity.Colour" view="_local">
    <query>
        select c from sample$Colour c
        where c.name like :(?i)custom$searchString
    </query>
</collectionDatasource>
</dsContext>
<layout>
<searchPickerField datasource="carDs" property="colour" optionsDatasource="coloursDs"/>

В данном случае компонент будет искать экземпляры сущности Colour по вхождению подстроки в ее атрибут name. Префикс (?i) служит для регистро-независимого поиска (см. Раздел 4.5.3.2.4, «Поиск подстроки без учета регистра»). Выбранное значение подставится в атрибут colour сущности Car, находящейся в источнике данных carDs.

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

В контроллере экрана для компонента можно реализовать методы, вызываемые в двух случаях:

Пример реализации методов для вывода на экран сообщений:

@Inject
private SearchPickerField colourField;

@Override
public void init(Map<String, Object> params) {
colourField.setSearchNotifications(new SearchField.SearchNotifications() {
    @Override
    public void notFoundSuggestions(String filterString) {
        showNotification("No colours found for search string: " + filterString,
            NotificationType.TRAY);
    }

    @Override
    public void needMinSearchStringLength(String filterString, int minSearchStringLength) {
        showNotification("Minimum length of search string is " + minSearchStringLength,
            NotificationType.TRAY);
    }
});
}

SearchPickerField реализует интерфейсы LookupField и PickerField, поэтому все описанное для этих интерфейсов в части работы с сущностями верно и для него. Исключением является список действий по умолчанию, добавляемых при определении компонента в XML: для SearchPickerField это действия lookup и open .