addCustomFilter (Klienta API atsauce)

Metode addCustomFilter pievieno filtrus rezultātiem, kas redzami meklēšanas kontrolē modeļu vadītās lietotnēs. Katrs filtrs tiek kombinēts ar iepriekš pievienotajiem filtriem kā nosacījums AND .

Atbalstītie vadīklu veidi

Uzmeklēšana

Sintakse

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

Parameters

Vārds, uzvārds Type Apraksts
filter Virkne Jālieto FetchXML filtra elements.
entityLogicalName Virkne Neobligāts arguments. Ja iestatāt šo parametru, filtrs attiecas tikai uz šo tabulas tipu. Pretējā gadījumā tas attiecas uz visu veidu atgrieztajām tabulām.

Piemēram, izmantojiet šādu XML filter parametram:

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

Piezīmes

Izmantojiet šo metodi funkcijā notikumu apstrādātājā Lookup Control PreSearch notikumam.

Piemērs

Nākamais koda paraugs ir paredzēts Opportunity formas konta (parentaccountid) meklēšanai. Kad iestatāt Sdk.setParentAccountIdFilter funkciju formu Onload notikumu apstrādātājā, pievienojiet šo Sdk.filterCustomerAccounts funkciju PreSearch notikumam šim meklējumam. Atcerieties izvēlēties opciju nodot izpildes kontekstā, iestatot funkciju formu Onload notikumu apstrādātājā. Rezultātā tiek atgriezti tikai konti ar Vēlamā klienta (1) kategorijasaccountcategorycode () vērtību.

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