addPreSearch (odkaz na klientske rozhranie API)

Použije zmeny na vyhľadávania na základe aktuálnych hodnôt rovnako ako sa používateľ chystá zobraziť výsledky vyhľadávania.

Podporované typy ovládacích prvkov

Vyhľadávanie

Syntax

formContext.getControl(arg).addPreSearch(myFunction)

Parametre

Meno Typ Požaduje sa Popis
myFunction Function Áno Spustí sa funkcia, ktorá sa spustí tesne pred vyhľadávaním s cieľom poskytnúť výsledky vyhľadávania. Pomocou tejto funkcie môžete vyvolať jednu z ďalších funkcií ovládacieho prvku vyhľadávania a zlepšiť výsledky, ktoré sa majú zobraziť vo vyhľadávaní. Kontext spustenia sa automaticky odovzdá ako prvý parameter do tejto funkcie.

Príklad

V nasledujúcom príklade onLoad je funkcia nastavená pre udalosť načítanie formulára. Filter vyhľadávania upraví pre všetky ovládacie prvky vyhľadávania priradené k atribútu primaryid vyhľadávania, pretože môže existovať viac ako jeden.

Pridá myPreSearchCallBack funkciu pomocou addPreSearch metódy . V tomto príklade sa vyžaduje, aby všetky vrátené záznamy kontaktov mali firstname hodnotu Eric.

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);
}

Udalosť PreSearch
removePreSearch