addCustomFilter (referencia de la API de cliente)

  • Artículo

Agrega filtros a los resultados mostrados en la búsqueda. Cada filtro se combinará con cualquier filtro agregado anteriormente como una condición AND.

Tipos de control admitidos

Búsqueda

Sintaxis

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

Parámetros

  • filter: cadena. El elemento de filtro fetchXml a aplicar. Por ejemplo:

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

  • entityLogicalName: cadena (opcional). Si se establece, el filtro solo se aplica a ese tipo de tabla. De lo contrario, se aplica a todos los tipos de tablas devueltas.

Comentarios

Este método solo se puede usar en una función en un controlador de eventos para el Evento PreSearch de control de búsqueda.

Ejemplo

El siguiente ejemplo de código es para la búsqueda de Cuenta del formulario de oportunidad (parentaccountid). Cuando la función Sdk.setParentAccountIdFilter se establece en el controlador de eventos Onload del formulario, la función Sdk.filterCustomAccounts se agrega al evento PreSearch para esa búsqueda. No olvide seleccionar la opción que pasar en el contexto de ejecución al establecer la función en el controlador de eventos Onload del formulario. El resultado es que solo se devuelven las cuentas con el valor Categoría (accountcategorycode) de Cliente preferido (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
formContext

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).