addCustomFilter (Referensi API Klien)

Menambahkan filter ke hasil yang ditampilkan dalam pencarian. Setiap filter akan dikombinasikan dengan filter yang ditambahkan sebelumnya sebagai kondisi AND .

Jenis kontrol yang didukung

Pemeriksaan

Syntax

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

Parameter-parameternya

• filter: String. Elemen filter fetchXml untuk diterapkan. Contohnya:

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

• entityLogicalName: (Opsional) String. Jika ini diatur, filter hanya berlaku untuk jenis tabel tersebut. Jika tidak, ini berlaku untuk semua jenis tabel yang dikembalikan.

Komentar

Metode ini hanya dapat digunakan dalam fungsi dalam penanganan aktivitas untuk Peristiwa PreSearch Kontrol Pencarian.

Example

Sampel kode berikut adalah untuk pencarian Akun formulir Peluang (parentaccountid). Ketika fungsi Sdk.setParentAccountIdFilter diatur dalam formulir Penanganan aktivitas Onload , fungsi Sdk.filterCustomAccounts ditambahkan ke peristiwa PreSearch untuk pencarian tersebut. Ingatlah untuk memilih opsi untuk meneruskan konteks eksekusi saat mengatur fungsi dalam formulir Penanganan aktivitas Onload . Hasilnya adalah bahwa hanya akun dengan nilai Kategori (accountcategorycode) dari Pelanggan Pilihan (1) yang 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 terkait

addPreSearch
formContext