JAVA/CORBA CLASSES
Finds a document based on its column values within a view. You create a key or vector of keys, where each key corresponds to a value in a sorted column in the view. The method returns the first document with column values that match the keys.
Defined in
View
Syntax
public Document getDocumentByKey(java.util.Vector keys) throws NotesException
public Document getDocumentByKey(Object key) throws NotesException
public Document getDocumentByKey(java.util.Vector keys, boolean exact) throws NotesException
public Document getDocumentByKey(Object key, boolean exact) throws NotesException
Parameters
java.util.Vector keys
Document
For the getDocumentByKey method to work using a key, you must have at least one column sorted for every key in the vector.
This method returns only the first document with column values that match the strings you indicate. To locate all matching documents, use getAllDocumentsByKey.
Matches are not case-sensitive. For example, "Turban" matches "turban". In an exact match, "cat" matches "cat" but does not match "category," while "20" matches "20" but does not match "201." In a partial match, "T" matches "Tim" or "turkey," but does not match "attic," while "cat" matches "catalog" or "category," but does not match "coat" or "bobcat."
To get view entry information about the document, use the getEntryByKey method.
Language cross-reference
GetDocumentByKey method in LotusScript NotesView class
FileOpenDatabase @command in formula language
Example See Also