addCustomFilter (klient-API-referens)

Metoden addCustomFilter lägger till filter i resultaten som visas i en uppslagskontroll i modelldrivna appar. Varje filter kombineras med tidigare tillagda filter som ett AND villkor.

Kontrolltyper som stöds

Sökning

Syntax

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

Parameterar

Name	Type	Description
filter	String	FetchXML-filterelementet som ska tillämpas.
entityLogicalName	String	Optional. Om du anger den här parametern gäller filtret endast för den tabelltypen. Annars gäller det för alla typer av tabeller som returneras.

Använd till exempel följande XML för parametern filter :

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

Anmärkningar

Använd den här metoden i en funktion i en händelsehanterare för Lookup Control PreSearch Event.

Example

Följande kodexempel är för sökningen konto föraffärsmöjlighetsformulär (parentaccountid). När du anger Sdk.setParentAccountIdFilter funktionen i formulärhändelsehanteraren Onload lägger du till Sdk.filterCustomerAccounts funktionen i händelsen för sökningen PreSearch . Kom ihåg att välja alternativet för att skicka in körningskontexten när du ställer in funktionen i formulärhändelsehanteraren Onload . Resultatet är att endast konton med värdet Kategori (accountcategorycode) för önskad kund (1) returneras.

// 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");
};

Relaterade artiklar

addPreSearch
formContext