addCustomFilter (Rujukan API Pelanggan)

Kaedah ini addCustomFilter menambah penapis pada hasil yang dipaparkan dalam kawalan carian dalam aplikasi berasaskan model. Setiap penapis digabungkan dengan mana-mana penapis yang telah ditambah sebelum ini sebagai satu AND syarat.

Jenis kawalan yang disokong

Cari

Sintaks

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

Parameter

Nama Type Perihalan
filter Rentetan Elemen penapis FetchXML untuk digunakan.
entityLogicalName Rentetan Tidak wajib Jika anda menetapkan parameter ini, penapis hanya terpakai kepada jenis jadual tersebut. Jika tidak, ia terpakai kepada semua jenis jadual yang dikembalikan.

Sebagai contoh, gunakan XML berikut untuk filter parameter:

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

Ucapan

Gunakan kaedah ini dalam fungsi dalam pengendali acara untuk Acara Pracarian Kawalan Carian.

Contoh

Contoh kod berikut adalah untuk carian borang Peluang Akaun (parentaccountid). Apabila anda menetapkan Sdk.setParentAccountIdFilter fungsi dalam pengendali acara borang Onload , tambah Sdk.filterCustomerAccounts fungsi tersebut ke acara PreSearch untuk carian tersebut. Ingat untuk memilih pilihan untuk dihantar dalam konteks pelaksanaan apabila menetapkan fungsi dalam pengendali acara borang Onload . Hasilnya, hanya akaun 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
bentukKonteks