addPreSearch (Referència de l'API del client)

Aplica canvis a les cerques basades en valors actuals just quan l'usuari està a punt de veure els resultats de la cerca.

Tipus de control admesos

Cerca

Sintaxi

formContext.getControl(arg).addPreSearch(myFunction)

Paràmetres

Nom	Tipus	Necessari	Descripció
myFunction	Function	Sí	La funció que s'executa just abans de la cerca per proporcionar resultats per a una cerca. Podeu utilitzar aquesta funció per cridar una de les altres funcions de control de cerca i millorar els resultats que es mostraran a la cerca. El context d'execució es passa automàticament com a primer paràmetre a aquesta funció.

Exemple

A l'exemple següent, la onLoad funció es defineix per a l'esdeveniment de càrrega del formulari. Modifica el filtre de cerca per a tots els controls de cerca associats amb l'atribut primaryid de cerca perquè pot haver-ne més d'un.

Afegeix la myPreSearchCallBack funció mitjançant el addPreSearch mètode. Aquest exemple requereix que tots els registres de contacte retornats tinguin el firstname valor "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);
}

Articles relacionats

Esdeveniment de cerca prèvia
removePreSearch