addPreSearch (Referință API client)

Aplică modificări la căutări pe baza valorilor curente, la fel ca utilizatorul, pentru a vizualiza rezultatele căutării.

Tipuri de control acceptate

Căutare

Sintaxă

formContext.getControl(arg).addPreSearch(myFunction)

Parametri

Nume	Tip	Obligatoriu	Descriere
myFunction	Funcţie	Da	Funcția care rulează chiar înainte de căutare pentru a furniza rezultate pentru o căutare are loc. Puteți utiliza această funcție pentru a apela una dintre celelalte funcții de control al căutării și a îmbunătăți rezultatele de afișat în căutare. Contextul de execuție este transmis automat ca prim parametru pentru această funcție.

Exemplu

În exemplul următor, funcția onLoad este setată pentru evenimentul de încărcare a formularului. Aceasta modifică filtrul de căutare pentru toate controalele de căutare asociate cu atributul primaryid de căutare, deoarece pot exista mai multe.

Aceasta adaugă funcția myPreSearchCallBack utilizând addPreSearch metoda. Acest exemplu necesită ca toate înregistrările de persoane de contact returnate să aibă firstname valoarea "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);
}

Articole asociate

Eveniment PreSearch
removePreSearch