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

Προσθέτει φίλτρα στα αποτελέσματα που εμφανίζονται στην αναζήτηση. Κάθε φίλτρο θα συνδυάζεται με οποιαδήποτε φίλτρα έχουν προστεθεί προηγουμένως ως AND συνθήκη.

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

Αναζήτηση

Σύνταξη

formContext.getControl(arg).addCustomFilter(filter, entityLogicalName)

Παράμετροι

• filter: Συμβολοσειρά. Το στοιχείο φίλτρου fetchXml που θα εφαρμοστεί. Για παράδειγμα:

  <filter type="and">
    <condition attribute="address1_city" operator="eq" value="Redmond" />
  </filter>
  

• entityLogicalName: (Προαιρετικό) Συμβολοσειρά. Εάν οριστεί αυτό, το φίλτρο ισχύει μόνο για αυτόν τον τύπο πίνακα. Διαφορετικά, ισχύει για όλους τους τύπους πινάκων που επιστρέφονται.

Παρατηρήσεις

Αυτή η μέθοδος μπορεί να χρησιμοποιηθεί μόνο σε μια συνάρτηση σε ένα πρόγραμμα χειρισμού συμβάντων για το συμβάν PreSearch του στοιχείου ελέγχου αναζήτησης.

Παράδειγμα

Το ακόλουθο δείγμα κώδικα αφορά την αναζήτηση Λογαριασμός φόρμας ευκαιρίας (parentaccountid). Όταν η συνάρτηση Sdk.setParentAccountIdFilter οριστεί στη μορφή Χειρισμός συμβάντων Onload , η συνάρτηση Sdk.filterCustomAccounts προστίθεται στο συμβάν PreSearch για αυτήν την αναζήτηση. Θυμηθείτε να επιλέξετε να μεταβιβάσετε το περιβάλλον εκτέλεσης κατά τη ρύθμιση της συνάρτησης στη φόρμα Χειρισμός συμβάντων Onload . Το αποτέλεσμα είναι ότι θα επιστραφούν μόνο λογαριασμοί με την τιμή Κατηγορία (accountcategorycode) προτιμώμενος πελάτης (1).

// A namespace defined for SDK sample code
// You should define a unique namespace for your libraries
var Sdk = window.Sdk || {};

// set 'Sdk.setParentAccountIdFilter' in the Opportunity form onload event handler
Sdk.setParentAccountIdFilter = function (executionContext) {

    // get the form context
    formContext = executionContext.getFormContext();
    formContext.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
}

Sdk.filterCustomerAccounts = function () {

    // Only show accounts with the type 'Preferred Customer'
    var customerAccountFilter = "<filter type='and'><condition attribute='accountcategorycode' operator='eq' value='1'/></filter>";
    formContext.getControl("parentaccountid").addCustomFilter(customerAccountFilter, "account");
}

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

addPreSearch
formContext