addCustomFilter (Klienta API atsauce)

Pievieno filtrus uzmeklēšanas rezultātiem. Katrs filtrs tiks apvienots ar visiem iepriekš pievienotajiem filtriem kā nosacījums AND .

Atbalstītie vadīklu veidi

Uzmeklēšana

Sintakse

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

Parameters

  • filtrs: virkne. Lietojamais fetchXml filtra elements. Piemēram:

    <filter type="and">
      <condition attribute="address1_city" operator="eq" value="Redmond" />
    </filter>
    
  • entityLogicalName: (neobligāta) virkne. Ja tas ir iestatīts, filtrs attiecas tikai uz šo tabulas tipu. Pretējā gadījumā tas attiecas uz visu veidu atgrieztajām tabulām.

Piezīmes

Šo metodi var izmantot tikai notikumu apdarinātāja funkcijā uzmeklēšanas vadīklas pirmsmeklēšanas notikumam.

Piemērs

Tālāk sniegtais koda paraugs ir paredzēts iespējas veidlapas konta (parentaccountid) uzmeklēšanai. Ja funkcija Sdk.setParentAccountIdFilter ir iestatīta veidlapā Onload notikumu apdarinātājs, funkcija Sdk.filterCustomAccounts tiek pievienota šīs uzmeklēšanas notikumam PreSearch . Atcerieties atlasīt opciju, kas jānodod izpildes kontekstā, iestatot funkciju formā Onload notikumu apdarinātājs. Rezultātā tiks atgriezti tikai konti, kuru kategorijas (konta kategorijas kods) vērtība ir Vēlamais klients (1).

// A namespace defined for SDK sample code
// You should define a unique namespace for your libraries
var Sdk = window.Sdk || {};

// set 'Sdk.setParentAccountIdFilter' in the Opportunity form onload event handler
Sdk.setParentAccountIdFilter = function (executionContext) {

    // get the form context
    formContext = executionContext.getFormContext();
    formContext.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
}

Sdk.filterCustomerAccounts = function () {

    // Only show accounts with the type 'Preferred Customer'
    var customerAccountFilter = "<filter type='and'><condition attribute='accountcategorycode' operator='eq' value='1'/></filter>";
    formContext.getControl("parentaccountid").addCustomFilter(customerAccountFilter, "account");
}

addPreSearch
formKonteksts