addCustomFilter (Referensi API Klien)

Metode menambahkan addCustomFilter filter ke hasil yang ditampilkan dalam kontrol pencarian di aplikasi berbasis model. Setiap filter dikombinasikan dengan filter yang ditambahkan sebelumnya sebagai kondisi AND .

Jenis kontrol yang didukung

Pemeriksaan

Syntax

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

Parameter-parameternya

Nama Type Description
filter String Elemen filter FetchXML untuk diterapkan.
entityLogicalName String Optional. Jika Anda mengatur parameter ini, filter hanya berlaku untuk jenis tabel tersebut. Jika tidak, ini berlaku untuk semua jenis tabel yang dikembalikan.

Misalnya, gunakan XML berikut untuk filter parameter :

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

Komentar

Gunakan metode ini dalam fungsi dalam penanganan aktivitas untuk Peristiwa PreSearch Kontrol Pencarian.

Example

Sampel kode berikut adalah untuk pencarian Akun formulir Peluang (parentaccountid). Saat Anda mengatur Sdk.setParentAccountIdFilter fungsi dalam penanganan aktivitas formulir Onload , tambahkan Sdk.filterCustomerAccounts fungsi ke peristiwa untuk pencarian tersebut PreSearch . Ingatlah untuk memilih opsi untuk meneruskan konteks eksekusi saat mengatur fungsi dalam penanganan aktivitas formulir Onload . Hasilnya adalah bahwa hanya akun dengan nilai Kategori (accountcategorycode) Pelanggan Pilihan (1) yang dikembalikan.

// A namespace defined for SDK sample code
// You should define a unique namespace for your libraries
const Sdk = (window.Sdk ??= {});

// set 'Sdk.setParentAccountIdFilter' in the Opportunity form onload event handler
Sdk.setParentAccountIdFilter = (executionContext) => {
  const formContext = executionContext.getFormContext();
    formContext.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
};

Sdk.filterCustomerAccounts = (executionContext) => {
  const control = executionContext.getEventSource();
  const customerAccountFilter = `
    <filter type="and">
      <condition attribute="accountcategorycode" operator="eq" value="1" />
    </filter>`;
  control.addCustomFilter(customerAccountFilter, "account");
};

addPreSearch
formContext