addCustomFilter (odkaz na klientske rozhranie API)

Metóda addCustomFilter pridá filtre do výsledkov zobrazených v ovládacom prvku vyhľadávania v modelom riadených aplikáciách. Každý filter je skombinovaný so všetkými predtým pridanými filtrami ako podmienkou AND .

Podporované typy ovládacích prvkov

Vyhľadávanie

Syntax

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

Parametre

Name Type Description
filter String Použije sa prvok filtra FetchXML.
entityLogicalName String Voliteľný argument. Ak nastavíte tento parameter, filter sa vzťahuje len na tento typ tabuľky. V opačnom prípade sa vzťahuje na všetky typy vrátených tabuliek.

Pre parameter použite napríklad nasledujúci XML filter :

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

Poznámky

Túto metódu použite vo funkcii v obsluhe udalostí pre udalosť Lookup Control PreSearch Event.

Príklad

Nasledujúca ukážka kódu je pre vyhľadávanie konta formulára príležitosti (parentaccountid). Keď nastavíte Sdk.setParentAccountIdFilter funkciu v obsluhe udalostí formulára Onload , pridajte Sdk.filterCustomerAccounts funkciu do PreSearch udalosti pre toto vyhľadávanie. Pri nastavovaní funkcie v obsluhe udalostí formulára Onload nezabudnite vybrať možnosť odovzdať do kontextu spustenia. Výsledkom je, že sa vrátia iba kontá s hodnotou Kategória (accountcategorycode) preferovaného zákazníka (1).

// 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