addCustomFilter (مرجع واجهة برمجة تطبيقات العميل)

إضافة عوامل تصفية إلى النتائج المعروضة في البحث. سيتم دمج كل عامل تصفية مع أي عوامل تصفية تمت إضافتها مسبقا كشرط AND .

أنواع عناصر التحكم المدعومة

بحث

بناء الجملة

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

المعلمات

• عامل التصفية: سلسلة. عنصر عامل التصفية fetchXml لتطبيقه. على سبيل المثال:

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

• entityLogicalName: (اختياري) سلسلة. إذا تم تعيين هذا، ينطبق عامل التصفية فقط على نوع الجدول هذا. وإلا، فإنه ينطبق على جميع أنواع الجداول التي تم إرجاعها.

الملاحظات

يمكن استخدام هذا الأسلوب فقط في دالة في معالج الأحداث لحدث البحث المسبق للتحكم في البحث.

مثال

نموذج التعليمات البرمجية التالي هو للبحث عن حساب نموذج الفرصة (parentaccountid). عند تعيين الدالة Sdk.setParentAccountIdFilter في نموذج معالج أحداث Onload ، تتم إضافة الدالة Sdk.filterCustomAccounts إلى حدث PreSearch لهذا البحث. تذكر تحديد خيار التمرير في سياق التنفيذ عند تعيين الدالة في نموذج Onload event handler. والنتيجة هي أنه سيتم إرجاع الحسابات التي لها قيمة الفئة (accountcategorycode) للعميل المفضل (1) فقط.

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

المقالات ذات الصلة

addPreSearch
formContext