addCustomFilter (Rujukan API Pelanggan)

Menambah penapis pada hasil yang dipaparkan dalam carian. Setiap penapis akan digabungkan dengan mana-mana penapis yang ditambah sebelum ini sebagai AND syarat.

Jenis kawalan yang disokong

Cari

Sintaks

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

Parameter

• penapis: Rentetan. Elemen penapis fetchXml untuk digunakan. Contohnya:

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

• entityLogicalName: (Pilihan) rentetan. Jika ini ditetapkan, penapis hanya digunakan untuk jenis jadual tersebut. Jika tidak, ia terpakai kepada semua jenis jadual yang dikembalikan.

Ucapan

Kaedah ini hanya boleh digunakan dalam fungsi dalam pengendali acara untuk Peristiwa Pracarian Kawalan Carian.

Contoh

Contoh kod berikut ialah untuk carian Borang Peluang Akaun (parentaccountid). Apabila fungsi Sdk.setParentAccountIdFilter disetkan dalam bentuk Pengendali peristiwa Muat , fungsi Sdk.filterCustomAccounts ditambah pada peristiwa Pracarian untuk carian tersebut. Ingat untuk memilih pilihan untuk lulus dalam konteks pelaksanaan apabila menetapkan fungsi dalam borang Pengendali peristiwa Onload . Hasilnya ialah hanya akaun dengan nilai Kategori (accountcategorycode) Pelanggan Pilihan (1) akan dikembalikan.

// 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");
}

Artikel berkaitan

addPreSearch
bentukKonteks