addCustomFilter (ügyfél API-referencia)

A addCustomFilter metódus szűrőket ad hozzá a modellalapú alkalmazások keresési vezérlőjében megjelenő 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

Name Típus Description
filter String Az alkalmazni kívánt FetchXML szűrőelem.
entityLogicalName String Nem kötelező megadni. Ha ezt a paramétert állítja be, a szűrő csak az adott táblatípusra vonatkozik. Ellenkező esetben minden visszaadott táblatípusra vonatkozik.

Használja például a következő XML-t a filter paraméterhez:

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

Megjegyzések

Ezt a metódust egy függvényben használhatja a Keresési vezérlő elősearch esemény eseménykezelőjében.

Example

A következő kódminta a Lehetőségűrlapfiók (parentaccountid) kereséséhez készült. Amikor beállítja a függvényt Sdk.setParentAccountIdFilter az űrlapesemény-kezelőben Onload , adja hozzá a Sdk.filterCustomerAccounts függvényt a PreSearch keresés eseményéhez. Az űrlapesemény-kezelőben Onload a függvény beállításakor ne felejtse el kiválasztani a végrehajtási környezetben átadni kívánt beállítást. 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
const Sdk = (window.Sdk ??= {});

// set 'Sdk.setParentAccountIdFilter' in the Opportunity form onload event handler
Sdk.setParentAccountIdFilter = (executionContext) => {
  const formContext = executionContext.getFormContext();
    formContext.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
};

Sdk.filterCustomerAccounts = (executionContext) => {
  const control = executionContext.getEventSource();
  const customerAccountFilter = `
    <filter type="and">
      <condition attribute="accountcategorycode" operator="eq" value="1" />
    </filter>`;
  control.addCustomFilter(customerAccountFilter, "account");
};

addPreSearch
formContext