addPreSearch (справочник по API клиента)

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

Поддерживаемые типы элементов управления

Lookup

Синтаксис

formContext.getControl(arg).addPreSearch(myFunction)

Параметры

Имя	Тип	Обязательно	Description
myFunction	Функция	Да	Функция, которая выполняется непосредственно перед поиском, чтобы предоставить результаты поиска. Эту функцию можно использовать для вызова одной из других функций управления подстановки и улучшения результатов, отображаемых в подстановке. Контекст выполнения автоматически передается в качестве первого параметра этой функции.

Example

В следующем примере onLoad функция устанавливается для события загрузки формы. Он изменяет фильтр поиска для всех элементов управления подстановки, связанных с атрибутом primaryid подстановки, так как может быть несколько.

Она добавляет функцию myPreSearchCallBack с помощью addPreSearch метода. В этом примере требуется, чтобы все возвращаемые записи контактов имели firstname значение "Эрик".

function onLoad(executionContext) {
   var formContext = executionContext.getFormContext()
   var attribute = formContext.getAttribute("primarycontactid") 
   attribute.controls.forEach(control => control.addPreSearch(myPreSearchCallBack))
}

function myPreSearchCallBack(executionContext) {
   var control = executionContext.getEventSource();
   var filter = "<filter><condition attribute='firstname' operator='eq' value='Eric' /></filter>";
   control.addCustomFilter(filter);
}

Связанные статьи

Событие PreSearch
removePreSearch