addCustomFilter (referenca klijentskog API-ja)

Metoda addCustomFilter dodaje filtre u rezultate prikazane u kontroli pretraživanja u aplikacijama utemeljenima na modelu. Svaki filtar kombinira se s prethodno dodanim filtrima kao AND uvjetom.

Podržane vrste kontrola

Pretraživanje

Sintaksa

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

Parametri

Name Vrsta Opis
filter String Element filtra FetchXML koji će se primijeniti.
entityLogicalName String Neobavezno. Ako postavite taj parametar, filtar se primjenjuje samo na tu vrstu tablice. U suprotnom se primjenjuje na sve vrste vraćenih tablica.

Za parametar, primjerice, koristite sljedeći filter XML:

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

Primjedbe

Ovu metodu koristite u funkciji u rukovatelj događajima za događaj pretraživanja prije pretraživanja kontrole pretraživanja.

Primjer

Sljedeći je primjer koda za pretraživanje računa obrascaposlovne prilike (parentaccountid). Kada postavite funkciju Sdk.setParentAccountIdFilter u rukovatelj događajima Onload obrasca, dodajte Sdk.filterCustomerAccounts funkciju događaju PreSearch za to pretraživanje. Ne zaboravite odabrati mogućnost prosljeđivanja u kontekstu izvršavanja prilikom postavljanja funkcije u rukovatelj događajima Onload obrasca. Rezultat je da se vraćaju samo računi s vrijednošću Kategorija (accountcategorycode) preferiranog klijenta (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
oblikKontekst