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

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

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

بحث

بناء الجملة

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

المعلمات

Name النوع Description
filter سلسلة عنصر عامل تصفية FetchXML لتطبيقه.
entityLogicalName سلسلة اختياري. إذا قمت بتعيين هذه المعلمة، ينطبق عامل التصفية فقط على نوع الجدول هذا. وإلا، فإنه ينطبق على جميع أنواع الجداول التي تم إرجاعها.

على سبيل المثال، استخدم XML التالي للمعلمة filter :

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

الملاحظات

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

مثال

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

// 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