addCustomFilter (İstemci API başvurusu)

Aramada 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

• filter: Dize. Uygulanacak fetchXml filtre öğesi. Örneğin:

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

• entityLogicalName: (İsteğe bağlı) Dize. Bu ayarlıysa, 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.

Açıklamalar

Bu yöntem yalnızca Arama Denetimi Ön Arama Olayı için bir olay işleyicisindeki bir işlevde kullanılabilir.

Example

Aşağıdaki kod örneği, Fırsat formu Hesabı (parentaccountid) araması içindir. Sdk.setParentAccountIdFilter işlevi Onload olay işleyicisi biçiminde ayarlandığında, Sdk.filterCustomAccounts işlevi bu arama için PreSearch olayına eklenir. İşlevi Onload olay işleyicisi biçiminde 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
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");
}

İlgili makaleler

addPreSearch
formContext