FTSearch (NotesDatabase - LotusScript®)

データベース内のすべての文書に対して全文検索を実行します。

定義位置

NotesDatabase

構文

Set notesDocumentCollection = notesDatabase .FTSearch( query$ , maxdocs% , [ sortoptions% ], [ otheroptions% ] )

パラメータ

query$

String 型。フルテキストの照会です。構文については以下を参照してください。

maxdocs%

整数。照会で返される文書の最大数。このパラメータを 0 に設定すると、検索条件に一致するすべての文書 (最大 5,000 まで。下の「使用法」セクションを参照。) を取得します。

sortoptions%

整数。オプション。ソートオプション。次のいずれかを選択します。

otheroptions%

整数。オプション。検索オプション。オプションは、追加して組み合わせます。

戻り値

notesDocumentCollection

NotesDocumentCollection. フルテキストの照会に一致した文書のコレクション。選択したオプションでソートされています。

使用法

このメソッドは、start パラメータを含まないこと以外は FTSearchRange メソッドと同じです。

データベースが全文索引付きでない場合、このメソッドは有効ですが、効率は低下します。索引があるかどうかを調べるには NotesDatabase の IsFTIndexed プロパティを使用します。全文索引が変更後に更新されていない場合、データベースの内容を完全には反映しません。ローカルデータベース上で索引の作成や更新を行うには、UpdateFTIndex メソッドを使用します。

このメソッドは、デフォルトでは最大 5,000 文書を返します。Notes.ini 変数 FT_MAX_SEARCH_RESULTS は、索引付きデータベース、または索引付きでなくてもクライアントのエージェントで実行されているデータベースについてのこの制限より優先されます。索引付きでなくても、サーバーのエージェントで実行されているデータベースについては、TEMP_INDEX_MAX_DOC Notes.ini 変数も設定する必要があります。絶対的な最大値は 2,147,483,647 となります。

このメソッドはデータベースのすべての文書を検索します。特定のビューにある文書のみを検索するには、NotesView の FTSearch メソッドを使用してください。 特定の文書コレクション内の文書のみを検索するには、NotesDocumentCollection の FTSearch メソッドを使用してください。

ソートオプションを指定しないと、文書は関連性スコアを基準にしてソートされます。 一連の文書を関連性を基準にしてソートすると、関連性が最も高い文書が先頭に表示されます。 コレクションの各文書の適合スコアにアクセスするには、NotesDocument の FTSearchScore を使用します。

日付でのソートを要求すると、関連性スコアは得られません。結果の DocumentCollection を NotesNewsletter オブジェクトへ渡す場合、文書リンクは使用したソートオプションに応じて文書作成日か適合スコアでフォーマットされます。

データベースにマルチデータベース索引がある場合は、マルチデータベース検索が実行されます。結果の文書コレクション内を移動する速度が遅くなることもありますが、コレクションからニュースレターを作成できます。

コレクションが空の場合、返された NotesCollection の Count プロパティは 0 になります。

照会構文

語または句を検索するには、その語または句をそのまま入力します。ただし、検索キーワードを引用符で囲む必要があります。リテラル内の二重引用符はエスケープ処理してください。

ワイルドカードや演算子などの構文も使用できます。構文規則の詳細については、『Notes ヘルプ』の「演算子を使用して検索条件を絞り込む」を参照してください。Domino Designer Eclipse のヘルプシステムまたはインフォメーションセンター (例えば、http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp) (どちらも Notes を含みます) で、「構文規則」を検索してください。

クロスリファレンス

Java™ Database クラスの FTSearch メソッド