addCustomFilter (referință API client)

Metoda addCustomFilter adaugă filtre la rezultatele afișate într-un control de căutare din aplicațiile bazate pe modele. Fiecare filtru este combinat cu orice filtre adăugate anterior ca AND condiție.

Tipuri de control acceptate

Căutare

Sintaxă

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

Parametri

Nume Type Descriere
filter String Elementul filtru FetchXML de aplicat.
entityLogicalName String Opțional. Dacă setați acest parametru, filtrul se aplică doar la acel tip de tabel. În caz contrar, se aplică la toate tipurile de tabele returnate.

De exemplu, utilizați următorul XML pentru filter parametru:

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

Remarci

Utilizați această metodă într-o funcție dintr-o rutină de tratare eveniment pentru evenimentul preSearch control căutare.

Exemplu

Următorul exemplu de cod este pentru căutarea contului oportunitate (parentaccountid) a formularului Oportunitate. Atunci când setați funcția Sdk.setParentAccountIdFilter în rutina de tratare a evenimentelor de formular Onload , adăugați Sdk.filterCustomerAccounts funcția la PreSearch eveniment pentru acea căutare. Nu uitați să selectați opțiunea de a trece în contextul de execuție atunci când setați funcția în rutina de tratare a evenimentelor de formular Onload . Rezultatul este că se returnează numai conturile cu valoarea Categorie (accountcategorycode) a Clientului preferat (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