addCustomFilter (Клиент API анықтамасы)

Іздеу кезінде көрсетілген нәтижелерге сүзгілерді қосады. Әрбір сүзгі шарт ретінде AND бұрын қосылған сүзгілермен біріктіріледі.

Қолдау көрсетілетін басқару элементтері түрлері

Қарау

Синтаксис

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

Параметрлер

  • сүзгі: Жол. Қолдануға болатын fetchXml сүзгі элементі. Мысалы:

    <filter type="and">
      <condition attribute="address1_city" operator="eq" value="Redmond" />
    </filter>
    
  • entityLogicalName: (Міндетті емес) Жол. Егер бұл орнатылған болса, сүзгі тек сол кесте түріне қолданылады. Әйтпесе, ол қайтарылған кестелердің барлық түрлеріне қолданылады.

Ескертулер

Бұл әдісті тек Іздеу басқару элементінің алдын-ала іздеу оқиғасы үшін оқиға өңдеушісіндегі функцияда ғана пайдалануға болады.

Мысал

Келесі код үлгісі Мүмкіндік пішіні тіркелгісі (parentaccountid) іздеуге арналған. Sdk.setParentAccountIdFilter функциясы Оқиғаны жүктеу өңдеушісі түрінде орнатылған кезде, сол іздеу үшін PreSearch оқиғасына Sdk.filterCustomAccounts функциясы қосылады. Функцияны Оқиға өңдегішін жүктеу пішінінде орнатқанда орындау контекстінде беру параметрін таңдауды ұмытпаңыз. Нәтижесінде, Артықшылықты тұтынушының (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
пішінКонтекст