addCustomFilter (sklic na API odjemalca)

Doda filtre v rezultate, prikazane v iskalnem polju. Vsak filter bo združen z dodanimi filtri kot AND pogoj.

Podprte vrste kontrolnikov

Iskanje

Sintaksa

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

Parametri

• filter: niz. Element filtra fetchXml, ki ga želite uporabiti. Na primer:

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

• entityLogicalName: (Izbirno) niz. Če je ta možnost nastavljena, filter velja le za to vrsto tabele. V nasprotnem primeru velja za vse vrste vrnjenih tabel.

Pripombe

Ta način je mogoče uporabiti le v funkciji v rutini za obravnavo dogodkov za dogodek PreSearch kontrolnika za iskanje.

Primer

Ta vzorec kode je za iskanje kupca obrazca priložnosti (parentaccountid). Ko je funkcija Sdk.setParentAccountIdFilter nastavljena v obliki Rutina za obravnavo dogodkov Onload , je funkcija Sdk.filterCustomAccounts dodana dogodku PreSearch za to iskanje. Ne pozabite izbrati možnosti, ki jo želite opraviti v kontekstu izvajanja, ko nastavljate funkcijo v rutini za obravnavo dogodkov Onload . Rezultat tega je, da bodo vrnjeni le računi z vrednostjo Category (accountcategorycode) želene stranke (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");
}

Povezani članki

addPreSearch
formContext