addCustomFilter (ügyfél API-referencia)

Szűrőket ad hozzá a keresésben megjelenített eredményekhez. A rendszer minden szűrőt feltételként AND kombinál a korábban hozzáadott szűrőkkel.

Támogatott vezérlőtípusok

Lookup

Szemantika

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

Paraméterek

• szűrő: Sztring. Az alkalmazni kívánt fetchXml szűrőelem. Például:

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

• entityLogicalName: (nem kötelező) sztring. Ha ez be van állítva, a szűrő csak az adott táblatípusra vonatkozik. Ellenkező esetben minden visszaadott táblatípusra vonatkozik.

Megjegyzések

Ez a módszer csak a Keresési vezérlő elősearch esemény eseménykezelőjében használható függvényben.

Example

A következő kódminta a Lehetőség űrlapfiók (parentaccountid) kereséséhez készült. Ha az Sdk.setParentAccountIdFilter függvény be van állítva az Onload eseménykezelőben, az Sdk.filterCustomAccounts függvény hozzá lesz adva a keresés előzetes eseményéhez. Ne felejtse el kiválasztani a végrehajtási környezetben átadni kívánt lehetőséget, amikor a függvényt az Űrlap betöltés eseménykezelőjében állítja be. Az eredmény az, hogy csak az előnyben részesített ügyfél (1) kategória (accountcategorycode) értékével rendelkező fiókok lesznek visszaadva.

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

Kapcsolódó cikkek

addPreSearch
formContext