ビュー内の列の値に基づいて文書タイプのビューエントリを検索します。 ユーザーはキーまたはキーのベクトルを作成し、それぞれのキーはビュー内のソートされた列の値に対応します。 このメソッドは、列の値がキーに一致するすべてのエントリを返します。
getAllEntriesByKey(keys:java.util.Vector) : NotesViewEntryCollection
getAllEntriesByKey(key:any, exact:boolean) : NotesViewEntryCollection
getAllEntriesByKey(keys:java.util.Vector, exact:boolean) : NotesViewEntryCollection
パラメータ | 説明 |
---|---|
key | ビュー内のソートされた最初の列と比較される String、Number、NotesDateTime、NotesDateRange オブジェクト。 |
keys | ビュー内のソートされた列と比較される String、Number、NotesDateTime、NotesDateRange オブジェクト。ベクトルの最初の要素は、ビュー内のソートされた最初の列と比較され、 2 番目の要素はソートされた 2 番目の要素と比較されるというように対応します。 |
exact | 完全一致で検索する場合は true を指定します。 部分一致で検索する場合は、このパラメータに false を指定するか、省略します。 |
戻り値 | 説明 |
---|---|
NotesViewEntryCollection | ビュー内で列の値が各キーの値と一致したすべての文書タイプのエントリ。 一致するエントリがない場合、コレクションは空になり、カウントはゼロです。 |
このメソッドは、列の値がキーと一致した文書タイプのすべてのビューエントリを返します。 最初のエントリのみを検索するには、 getEntryByKey を使用してください。
このメソッドにより返されるエントリはビューの順序で表示され、また列の値へアクセスできます。
一致するアイテムの大文字、小文字は区別されません。 例えば、Turban は turban と一致します。 完全一致では、cat は cat と一致しますが、category とは一致しません。 また、20 は 20 と一致しますが、201 とは一致しません。 部分一致の場合、T は Tim や turkey と一致しますが、 attic とは一致しません。 また、cat は catalog や category と一致しますが、 coat や bobcat とは一致しません。 部分一致を複数のキーで使用すると、結果として一部のエントリが検索されない場合があります。 最初のキーを部分一致にした場合、2 番目の列でそのキーが完全一致と同じようにソートされていないと、順序の異なるエントリは検索されません。
このメソッドは、getAllDocumentsByKey と類似しています。
同じ列内で (「¥¥」特殊文字を使用して) カテゴリとサブカテゴリの両方によってフォーマットされている列がある場合、このメソッドではエントリは検出されません。
var v:NotesView = database.getView("main");
var vec:NotesViewEntryCollection = v.getAllEntriesByKey(requestScope.query);
if (vec.getCount() == 0) {
requestScope.status = "No subjects starting with that query";
return;
}
var entry:NotesViewEntry = vec.getFirstEntry();
while (entry != null) {
requestScope.status += "¥n" +
entry.getDocument().getItemValueString("subject");
var tmpentry = vec.getNextEntry();
entry.recycle();
entry = tmpentry;
}
var v:NotesView = database.getView("categorized");
var query = new java.util.Vector();
query.addElement("Category 1");
query.addElement(requestScope.query);
var vec:NotesViewEntryCollection = v.getAllEntriesByKey(query);
if (vec.getCount() == 0) {
requestScope.status = "No subjects starting with that query";
return;
}
var entry:NotesViewEntry = vec.getFirstEntry();
while (entry != null) {
requestScope.status += "¥n" + entry.getDocument().getItemValueString("subject");
var tmpentry = vec.getNextEntry();
entry.recycle();
entry = tmpentry;
}