addCustomFilter (İstemci API başvurusu)

yöntemi, addCustomFilter model temelli uygulamalarda arama denetiminde görüntülenen sonuçlara filtreler ekler. Her filtre, koşul olarak daha önce eklenen filtrelerle birleştirilir AND .

Desteklenen denetim türleri

Arama Listesi

Sözdizimi

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

Parametreler

İsim	Type	Description
filter	String	Uygulanacak FetchXML filtre öğesi.
entityLogicalName	String	Optional. Bu parametreyi ayarlarsanız, filtre yalnızca bu tablo türüne uygulanır. Aksi takdirde, döndürülen tüm tablo türleri için geçerlidir.

Örneğin, parametresi için aşağıdaki XML'yi filter kullanın:

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

Açıklamalar

Arama Denetimi Ön Arama Olayı için olay işleyicisindeki bir işlevde bu yöntemi kullanın.

Example

Aşağıdaki kod örneği Fırsat formu Hesabı (parentaccountid) araması içindir. İşlevi Sdk.setParentAccountIdFilter form Onload olay işleyicisinde ayarladığınızda, işlevi bu aramanın olayına PreSearch ekleyinSdk.filterCustomerAccounts. İşlevi form Onload olay işleyicisinde ayarlarken yürütme bağlamını geçirme seçeneğini belirtmeyi unutmayın. Sonuç olarak yalnızca Tercih Edilen Müşteri (1) Kategori (accountcategorycode) değerine sahip hesaplar döndürülür.

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

İlgili makaleler

addPreSearch
formContext