9.66 DOM_SEARCH_DOCUMENTS

9.66 DOM_SEARCH_DOCUMENTS

Þ 注：組み込み関数の規則

ドキュメント/データ・ノート用のデータベースを選択条件によるマッチングまたはすでに作成されているビューを使用して検索します。選択条件もビューも指定されていない場合は、データベース内のドキュメント/データ・ノートがすべてマッチします。

この組み込み関数の結果はノートIDテーブルです。このノートIDテーブルとDOM_GET_NXT_DOCUMENT組み込み関数を使ってドキュメントを順次読むことができます。選択条件が指定された場合、選択式がコンパイルされ、選択条件にマッチするすべてのドキュメントのノートIDテーブルが生成されます。ビューが指定された場合は、ビューのコレクションが生成され、そのコレクションのノートIDがすべてノートIDテーブルに追加されます。

選択条件を指定する場合、Notesの@ファンクション、フィールド名、論理演算子を使用したビューの選択式と同じ構文にする必要があるので注意してください。選択条件は正しく引用する必要があります。選択条件の構文は検証されません。

すべてのドキュメントに対する処理を完了する時は、DOM_END_SEARCH_DOCS組み込み関数を使用します。

ビューと選択条件の使用を比較した一般的なガイドラインを以下に示します。

·         選択条件を使用してデータベースからドキュメントを選択するのは、実行時まで選択条件がわからない場合やプログラムのパフォーマンスが重要ではない場合、またプログラムを時々しか実行しない場合などです。

·         ビューを使用してデータベースからドキュメントを選択するのは、ある決まった順序でドキュメントを処理する場合や、プログラムのパフォーマンスが重要な場合などです。通常、同じものを選択する場合、選択条件よりもビューを使用したほうがより速くドキュメントを選択できます。

各製品の対応

引数

戻り値

例

次のDomino組み込み関数の例を参照してください。

例2：ビューを使ってデータベースからドキュメントを選択

例4：ブラウズ・リストから選択したドキュメントの更新

技術ノート

この組み込み関数は、Lotus Notesの標準APIであるAPIs IDCreateTable、NSFFormulaCompile、NSFSearch、IDEntries、IDInsert、NIFFindView、NIFOpenCollection、IDCreateTable、NIFReadEntries、NIFCloseCollectionを使用します。この組み込み関数の使用に関するセキュリティと整合性の問題は、すべてLotus Notes APIを現在のプラットフォームで通常に使用したときに発生する問題によるものです。