addCustomFilter (kliendi API viide)

Lisab otsingus kuvatavatele tulemitele filtrid. Iga filter kombineeritakse tingimusena AND kõigi varem lisatud filtritega.

Toetatud juhtelemenditüübid

Otsing

Süntaks

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

Parameetrid

• filter: String. Rakendatav filtrielement fetchXml. Näiteks:

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

• entityLogicalName: (valikuline) string. Kui see on seatud, rakendatakse filter ainult sellele tabelitüübile. Muul juhul kehtib see kõigi tagastatavate tabelitüüpide kohta.

Märkused

Seda meetodit saab kasutada ainult otsingujuhtelemendi eelotsingu sündmuse sündmuseohjuri funktsioonis.

Näide

Järgmine koodinäide on võimalusevormi konto (parentaccountid) otsingu jaoks. Kui funktsioon Sdk.setParentAccountIdFilter on määratud vormil Sündmuseohjur Onload , lisatakse selle otsingu jaoks funktsioon Sdk.filterCustomAccountssündmusele PreSearch . Funktsiooni seadmisel vormil Laadimissündmuse ohjur ärge unustage valida täitmiskontekstis edastamissuvandit. Tulemuseks on see, et tagastatakse ainult kontod, mille kategooria (accountcategorycode) väärtus on Eelistatud klient (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");
}

Seotud artiklid

addPreSearch
formContext