FTSearchSorted (NotesView - LotusScript®)
ビュー内のすべての文書の全文検索を実行してビューをフィルタし、全文照会に一致する文書のみをソートされた順序で示すようにします。
定義位置
構文
numDocs& = = notesView .FTSearchSorted( query [maxDocs%] [column] [ascending] [exact] [variants] [fuzzy] )
パラメータ
| パラメータ | 説明 |
|---|---|
| query | Variant 型。フルテキストの照会、または複数照会の共通部分。照会の構文については、以下を参照してください。 |
| maxdocs% | 整数。オプション。検索で返される文書の最大数。 照会に一致するすべての文書を取得する場合は、0 を指定します。デフォルトは 0 です。 |
| column | Variant 型。オプション。ソートする列の名前または 0 ベースの索引。 NotesView.VIEW_FTSS_RELEVANCE_ORDER (512) と指定すると、大文字小文字の厳密な識別、活用形、あいまい検索のための拡張フラグの使用が有効になり、関連度の順に結果が返されます。 |
| ascending | Boolean 型。オプション。true の場合、列のデータを昇順にソートし、false の場合、降順にソートします。デフォルトは true です。 NotesView.VIEW_FTSS_RELEVANCE_ORDER が有効な場合は無視されます。列を昇順または降順にソートできるかどうかは、列のプロパティの [ソート] タブの [列のヘッダーをクリック時にソート] によって決まります。該当するオプションは、[昇順]、[降順]、[両方] です。サポートされない方向に列をソートしようとすると、NOTES_ERR_INVALIDVIEWRESORT 例外がスローされます。 |
| exact | Boolean 型。オプション。true の場合、EXACTCASE フィルタの厳密な識別を検索に適用します。デフォルトは false。 |
| variants | Boolean 型。オプション。true の場合、検索結果に単語の活用形を返します。デフォルトは false。 |
| fuzzy | Boolean 型。オプション。true の場合、検索結果につづりが異なる語句を返します。デフォルトは false。 |
戻り値
numDocs&
検索後のビュー内の文書数。 これらの文書はすべて query を満たしています。
使用法
このメソッドを呼び出した後、通常の NotesView メソッドを使用して、ビュー内の文書のサブセットである結果をナビゲートできます。query 引数だけを渡す場合、サブセット内の文書はデフォルト照合の 0 を使用してソートされます。文書を別の照合パスで検索するには、オプションの検索フラグを使用して、ソートする列の名前または索引を渡します。メソッド GetFirstDocument はサブセット内の最初の文書を返し、GetLastDocument は最後の文書を返します。
全文検索のフィルタをクリアするには、Clear メソッドを使用します。 Clear の後では、NotesView のメソッドは、ビューの文書全体に対して機能します。
データベースの全文索引が作成されていない場合、このメソッドはエラーを発行します。索引が作成されているかどうかを調べるには IsFTIndexed プロパティを使用します。ローカルデータベースに索引を作成するには、UpdateFTIndex メソッドを使用します。
照会構文
語または句を検索するには、その語または句をそのまま入力します。ただし、検索キーワードを引用符で囲む必要があります。リテラル内の二重引用符はエスケープ処理してください。
ワイルドカードや演算子などの構文も使用できます。構文規則の詳細については、『IBM Notes ヘルプ』の「演算子を使用して検索照会を絞り込む」を参照してください。IBM Domino Designer Eclipse のヘルプシステムまたはインフォメーションセンター (例えば、http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp) (どちらも Lotus Notes を含みます) で、「構文規則」を検索してください。
この照会は、単一ストリングまたは検索時に AND で結合される String 型の配列のいずれかである Variant 型です。
クロスリファレンス
Java View クラスの FTSearchSorted メソッド
JavaScript NotesView クラスの FTSearchSorted メソッド