addPreSearch (довідник з API клієнта)

Застосовує зміни до підстановок на основі значень, поточних так само, як користувач збирається переглянути результати для підстановки.

Підтримувані типи елементів керування

Підстановка

Синтаксис

formContext.getControl(arg).addPreSearch(myFunction)

Параметри

Ім'я	Тип	Обов'язковий	Опис
myFunction	Function	Так	Функція, яка запускається безпосередньо перед пошуком для надання результатів підстановки. За допомогою цієї функції можна викликати одну з інших функцій керування підстановки та покращити відображення результатів підстановки. Контекст виконання автоматично передається як перший параметр для цієї функції.

Приклад

У наведеному нижче прикладі 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);
}

Пов’язані статті

Подія "Попередній пошук"
removePreSearch