addCustomFilter (client-API-verwijzing)

Hiermee worden filters toegevoegd aan de resultaten die worden weergegeven in de zoekactie. Elk filter wordt gecombineerd met eventuele eerder toegevoegde filters als voorwaarde AND .

Ondersteunde besturingstypen

Lookup

Syntaxis

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

Parameterwaarden

• filter: Tekenreeks. Het filterelement fetchXml dat moet worden toegepast. Voorbeeld:

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

• entityLogicalName: (Optioneel) Tekenreeks. Als dit is ingesteld, is het filter alleen van toepassing op dat tabeltype. Anders geldt dit voor alle typen tabellen die worden geretourneerd.

Opmerkingen

Deze methode kan alleen worden gebruikt in een functie in een gebeurtenis-handler voor de Gebeurtenis Lookup Control PreSearch.

Example

Het volgende codevoorbeeld is voor het opzoeken van het verkoopkansformulieraccountaccount (parentaccountid). Wanneer de functie Sdk.setParentAccountIdFilter is ingesteld in de gebeurtenis-handler van het formulier Onload , wordt de functie Sdk.filterCustomAccounts toegevoegd aan de PreSearch-gebeurtenis voor die zoekopdracht. Vergeet niet om de optie te selecteren die moet worden doorgegeven in de uitvoeringscontext bij het instellen van de functie in de gebeurtenis-handler van het formulier Onload . Het resultaat is dat alleen accounts met de categoriewaarde (accountcategorycode) van Preferred Customer (1) worden geretourneerd.

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

Verwante artikelen

addPreSearch
formContext