Condividi tramite


addPreSearch (informazioni di riferimento sulle API client)

Applica le modifiche alle ricerche in base ai valori correnti proprio come l'utente sta per visualizzare i risultati per la ricerca.

Tipi di controllo supportati

Ricerca

Sintassi

formContext.getControl(arg).addPreSearch(myFunction)

Parametri

Nome TIPO Obbligatorio Description
myFunction Funzione Yes Funzione eseguita poco prima che venga eseguita la ricerca per fornire risultati per una ricerca. È possibile usare questa funzione per chiamare una delle altre funzioni di controllo di ricerca e migliorare i risultati da visualizzare nella ricerca. Il contesto di esecuzione viene passato automaticamente come primo parametro a questa funzione.

Example

Nell'esempio seguente la onLoad funzione viene impostata per l'evento onload del modulo. Modifica il filtro di ricerca per tutti i controlli di ricerca associati all'attributo primaryid di ricerca, perché potrebbero essere presenti più controlli.

Aggiunge la myPreSearchCallBack funzione usando il addPreSearch metodo . Questo esempio richiede che tutti i record di contatto restituiti abbiano il firstname valore di '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 PreSearch
removePreSearch