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