addPreSearch (klienta API atsauce)

Lieto izmaiņas uzmeklēšanai, pamatojoties uz pašreizējām vērtībām tieši tad, kad lietotājs gatavojas skatīt uzmeklēšanas rezultātus.

Atbalstītie vadīklu veidi

Uzmeklēšana

Sintakse

formContext.getControl(arg).addPreSearch(myFunction)

Parametrus

Vārds	Tips	Nepieciešams	Apraksts
myFunction	Function	Jā	Funkcija, kas tiek palaista tieši pirms meklēšanas, lai nodrošinātu uzmeklēšanas rezultātus. Šo funkciju var izmantot, lai izsauktu kādu no citām uzmeklēšanas vadības funkcijām un uzlabotu uzmeklēšanā parādāmos rezultātus. Izpildes konteksts tiek automātiski nodots kā pirmais parametrs šai funkcijai.

Piemērs

Nākamajā piemērā onLoad funkcija ir iestatīta notikumam veidlapas ielāde. Tas modificē meklēšanas filtru visām uzmeklēšanas vadīklām, kas saistītas ar uzmeklēšanas atribūtu primaryid , jo var būt vairākas uzmeklēšanas vadīklas.

Tas pievieno funkciju, myPreSearchCallBackaddPreSearch izmantojot metodi. Šajā piemērā ir nepieciešams, lai visiem atgrieztajiem kontaktpersonu ierakstiem firstname būtu vērtība '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);
}

Saistītie raksti

Pirmsmeklēšanas pasākums
removePreSearch