Partilhar via


addPreSearch (referência da API do cliente)

Aplica alterações a pesquisas com base em valores atuais assim que o usuário está prestes a exibir os resultados da pesquisa.

Tipos de controlo suportados

Busca

Sintaxe

formContext.getControl(arg).addPreSearch(myFunction)

Parâmetros

Nome Tipo Obrigatório Description
myFunction Função Yes A função que é executada imediatamente antes da pesquisa para fornecer resultados para uma pesquisa ocorre. Você pode usar essa função para chamar uma das outras funções de controle de pesquisa e melhorar os resultados a serem exibidos na pesquisa. O contexto de execução é automaticamente passado como o primeiro parâmetro para esta função.

Example

No exemplo a seguir, a onLoad função é definida para o evento onload do formulário. Ele modifica o filtro de pesquisa para todos os controles de pesquisa associados ao primaryid atributo de pesquisa porque pode haver mais de um.

Ele adiciona a myPreSearchCallBack função usando o addPreSearch método. Este exemplo requer que todos os registros de contato retornados tenham 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);
}

Evento de pré-pesquisa
removePreSearch