addPreSearch (Referencia da API do cliente)

Aplica os cambios nas buscas baseadas nos valores actuais xusto cando o usuario está a piques de ver os resultados da busca.

Tipos de control soportados

Busca

Sintaxe

formContext.getControl(arg).addPreSearch(myFunction)

Parámetros

Nome	Tipo	Obrigatorio	Descripción
myFunction	Function	Si	A función que se executa xusto antes da busca para proporcionar resultados para unha busca. Pode usar esta función para chamar a unha das outras funcións de control de busca e mellorar os resultados que se mostrarán na busca. O contexto de execución pasa automaticamente como primeiro parámetro a esta función.

Exemplo

No seguinte exemplo, a onLoad función está establecida para o evento de carga do formulario. Modifica o filtro de busca para todos os controis de busca asociados ao primaryid atributo de busca porque pode haber máis dun.

Engade a myPreSearchCallBack función usando o addPreSearch método. Este exemplo require que todos os rexistros de contacto devoltos teñan o firstname valor 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);
}

Artigos relacionados

Evento de busca previa
removePreSearch