addCustomFilter(클라이언트 API 참조)

조회에 표시된 결과에 필터를 추가합니다. 각 필터는 이전에 추가된 필터와 조건으로 결합됩니다 AND .

지원되는 컨트롤 형식

Lookup

Syntax

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

매개 변수

• filter: String. 적용할 fetchXml 필터 요소입니다. 다음은 그 예입니다.

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

• entityLogicalName: (선택 사항) 문자열입니다. 이 설정이 설정되면 필터는 해당 테이블 형식에만 적용됩니다. 그렇지 않으면 반환된 모든 유형의 테이블에 적용됩니다.

비고

이 메서드는 Lookup Control PreSearch 이벤트에 대한 이벤트 처리기의 함수에서만 사용할 수 있습니다.

Example

다음 코드 샘플은 기회 양식 계정 (parentaccountid) 조회에 대한 것입니다. Sdk.setParentAccountIdFilter 함수가 Onload 이벤트 처리기 형식으로 설정되면 Sdk.filterCustomAccounts 함수가 해당 조회에 대한 PreSearch 이벤트에 추가됩니다. Onload 이벤트 처리기 형식에서 함수를 설정할 때 실행 컨텍스트에 전달하는 옵션을 선택해야 합니다. 그 결과 기본 고객(1)의 범주(accountcategorycode) 값이 있는 계정만 반환됩니다.

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