addPreSearch (Αναφορά API προγράμματος-πελάτη)

Εφαρμόζει αλλαγές σε αναζητήσεις με βάση τις τρέχουσες τιμές, ακριβώς όπως ο χρήστης πρόκειται να προβάλει τα αποτελέσματα για την αναζήτηση.

Υποστηριζόμενοι τύποι στοιχείων ελέγχου

Αναζήτηση

Σύνταξη

formContext.getControl(arg).addPreSearch(myFunction)

Παράμετροι

'Ονομα	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
myFunction	Function	Ναι	Η συνάρτηση που εκτελείται λίγο πριν από την αναζήτηση για την παροχή αποτελεσμάτων για μια αναζήτηση. Μπορείτε να χρησιμοποιήσετε αυτήν τη συνάρτηση για να καλέσετε μία από τις άλλες συναρτήσεις στοιχείου ελέγχου αναζήτησης και να βελτιώσετε τα αποτελέσματα που θα εμφανίζονται στην αναζήτηση. Το περιβάλλον εκτέλεσης διαβιβάζεται αυτόματα ως η πρώτη παράμετρος σε αυτήν τη συνάρτηση.

Παράδειγμα

Στο παρακάτω παράδειγμα, η onLoad συνάρτηση έχει οριστεί για το συμβάν onload φόρμας. Τροποποιεί το φίλτρο αναζήτησης για όλα τα στοιχεία ελέγχου αναζήτησης που σχετίζονται με το primaryid χαρακτηριστικό αναζήτησης, επειδή μπορεί να υπάρχουν περισσότερα από ένα.

Προσθέτει τη myPreSearchCallBack συνάρτηση χρησιμοποιώντας τη addPreSearch μέθοδο . Αυτό το παράδειγμα απαιτεί όλες οι εγγραφές επαφής που επιστρέφονται να έχουν την firstname τιμή "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);
}

Σχετικά άρθρα

Συμβάν PreSearch
κατάργησηPreSearch