addPreSearch (クライアント API 参照)

ユーザーが検索結果を表示しようとするときの値に基づき、検索に変更を適用します。

サポートされているコントロールの種類

参照

構文

formContext.getControl(arg).addPreSearch(myFunction)

Parameters

件名	タイプ	Required	Description
myFunction	Function	はい	検索発生時に検索が結果を提供する直前に実行される関数です。 この関数を使用してその他の検索コントロールのいずれかを呼び出すことができ、検索に表示される結果を改善できます。 実行コンテキストは、この関数に最初のパラメーターとして自動的に渡されます。

例

次の例では、onLoad 関数がフォーム onload イベントに設定されています。 複数の検索コントロールが存在する可能性があるため、primaryid 検索属性に関連付けられたすべての検索コントロールの検索フィルターが変更されます。

addPreSearch メソッドを使用して myPreSearchCallBack 関数を追加します。 この例では、返されたすべての取引担当者レコードの firstname 値が "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);
}

関連記事

PreSearch イベント
removePreSearch

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。