addPreSearch (referencia de la API de cliente)

Aplica cambios a búsquedas basadas en valores actuales mientras el usuario está a punto de ver los resultados de la búsqueda.

Tipos de control admitidos

Lookup

Sintaxis

formContext.getControl(arg).addPreSearch(myFunction)

Parámetros

Name	Type	Obligatorio	Description
myFunction	Function	Sí	La función que se ejecuta justo antes de que se produzca la búsqueda para proporcionar resultados para una búsqueda. Puede usar esta función para llamar a una de las otras funciones de control de búsqueda y mejorar los resultados que se mostrarán en la búsqueda. El contexto de ejecución se pasa automáticamente como el primer parámetro a esta función.

Ejemplo

En el siguiente ejemplo, la función onLoad está configurada para el evento de carga del formulario. Modifica el filtro de búsqueda para todos los controles de búsqueda asociados con el atributo de búsqueda primaryid porque puede haber más de uno.

Agrega la función myPreSearchCallBack usando el método addPreSearch. Este ejemplo requiere que todos los registros de contacto devueltos tengan el valor firstname de 'Eric'.

function onLoad(executionContext) {
   var formContext = executionContext.getFormContext()
   var attribute = formContext.getAttribute("primarycontactid") 
   attribute.controls.forEach(control => control.addPreSearch(myPreSearchCallBack))
}

function myPreSearchCallBack(executionContext) {
   var control = executionContext.getEventSource();
   var filter = "<filter><condition attribute='firstname' operator='eq' value='Eric' /></filter>";
   control.addCustomFilter(filter);
}

Artículos relacionados

Evento PreSearch
removePreSearch

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).