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