Freigeben über

addPreSearch (Client-API-Referenz)

  • Artikel

Wendet Änderungen für Suchen basierend auf aktuellen Werten an, wenn dem Benutzer Ergebnisse der Suche angezeigt werden.

Unterstützte Steuerelementtypen

Nachschlagefeld

Syntax

formContext.getControl(arg).addPreSearch(myFunction)

Parameter

Name des Dataflows Type Erforderlich Beschreibung
myFunction Function Ja Das ist eine Funktion, die kurz vor Suche ausgeführt wird, um Ergebnisse für eine Suche bereitzustellen. Sie können diese Funktion verwenden, um eine der anderen Suchsteuerelementfunktionen aufzurufen und die in der Suche anzuzeigenden Ergebnisse zu optimieren. Der Ausführungskontext wird automatisch bei der ersten der zu den Funktionen übergeben, die mithilfe des Codes festgelegt wird.

Beispiel

Im folgenden Beispiel wird die onLoad-Funktion für das Formular-Onload-Ereignis festgelegt. Es ändert den Suchfilter für alle Suchsteuerelemente, die mit dem Suchattribut primaryid verknüpft sind, da es möglicherweise mehr als eines gibt.

Es fügt die Funktion myPreSearchCallBack mit der Methode addPreSearch hinzu. In diesem Beispiel müssen alle zurückgegebenen Kontaktdatensätze den firstname-Wert „Eric“ haben.

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);
}

PreSearch-Ereignis
removePreSearch

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).