addCustomFilter (חומר עזר עבור API של לקוח)

הוספת מסננים לתוצאות המוצגות בבדיקת המידע. כל מסנן ישולב עם כל המסננים שנוספו קודם לכן כתנה AND .

סוגי פקדים נתמכים

בדיקת מידע

תחביר

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

Parameters

• מסנן: מחרוזת. רכיב המסנן fetchXml להחלה. לדוגמה:

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

• entityLogicalName: מחרוזת (אופציונלי). אם אפשרות זו מוגדרת, המסנן חל רק על סוג טבלה זה. אחרת, הוא חל על כל סוגי הטבלאות המוחזרות.

הערות

ניתן להשתמש בשיטה זו רק בפונקציה במטפל באירועים עבור אירוע PreSearch של פקד בדיקת מידע.

דוגמה

דוגמת הקוד הבאה היא עבור בדיקת המידע של חשבון טופס ההזדמנות (parentaccountid). כאשר הפונקציה Sdk.setParentAccountIdFilter מוגדרת בתבנית המטפל באירועים Onload , הפונקציה Sdk.filterCustomAccounts מתווספת לאירוע PreSearch עבור בדיקת מידע זו. זכור לבחור את האפשרות להעביר בהקשר הביצוע בעת הגדרת הפונקציה בטופס המטפל באירועים Onload . התוצאה היא שרק חשבונות עם ערך קטגוריה (קוד חשבון) של לקוח מועדף (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");
}

מאמרים קשורים

הוסף חיפוש לפני
formContext