LOTUSSCRIPT/COM/OLE CLASSES
Conducts a full-text search of the documents in a database that the current agent considers to be unprocessed.
Note This method is new with Release 6.
Note This method is not implemented in COM.
Defined in
NotesDatabase
Syntax
Set notesDocumentCollection = notesDatabase.UnprocessedFTSearchRange( query$, maxdocs%, [ sortoptions% ], [ otheroptions% ], [ start&] )
Parameters
query$
notesDocumentCollection
This method is the same as UnprocessedFTSearch plus the start parameter.
This method is valid only for agent scripts and view actions and may be invoked only on NotesDatabase objects obtained from the CurrentDatabase property in NotesSession. In scripts that are not a part of an agent or view action, this method returns a NotesDocumentCollection with zero documents. When invoked on a NotesDatabase object that was not obtained from the CurrentDatabase property, this method raises an error.
How does it work?
This method works in two parts:
What documents are returned?
The following table describes the documents that are returned by the UnprocessedFTSearch method. Document selection occurs once, before the agent runs.
Meet the full-text search criteria specified in this method
Created or modified since the agent last ran
Meet the search criteria specified in Agent Properties box
or
View action
Mailed to the database since the agent last ran
Modified since the agent last ran
Pasted into the database since the agent last ran
For agents that run on new and modified documents, newly received mail documents, pasted documents, or newly modified documents, you must use the UpdateProcessedDoc method in NotesSession to mark each document as "processed," which ensures that a document gets processed by the agent only once (unless it's modified, mailed, or pasted again). If you do not call this method for each document, the agent processes the same documents the next time it runs.
UpdateProcessedDoc marks a document as processed only for the particular agent from which it is called. Using UpdateProcessedDoc in one agent has no effect on the documents that another agent processes.
In all other agents and view actions, UpdateProcessedDoc has no effect.
View actions
When used in a view action, UnprocessedFTSearch returns the same documents as an agent that runs on selected documents.
Full-text indexes
If the database is not full-text indexed, this method works, but less efficiently. To test for an index, use the IsFTIndexed property in NotesDatabase. If the full-text is not updated after changes are made, it does not fully reflect the content of the database. To create or update an index on a local database, use the UpdateFTIndex method.
This method returns a maximum of 5,000 documents by default. The Notes.ini variable FT_MAX_SEARCH_RESULTS overrides this limit for indexed databases or databases that are not indexed but that are running in an agent on the client. For a database that is not indexed and is running in an agent on the server, you must set the TEMP_INDEX_MAX_DOC Notes.ini variable as well. The absolute maximum is 2,147,483,647.
Options
If you don't specify any sort options, the documents are sorted by relevance score. When the collection is sorted by relevance the highest relevance appears first. To access the relevance score of each document in the collection, use FTSearchScore in NotesDocument.
If you ask for a sort by date, you don't get relevance scores. If you pass the resulting NotesDocumentCollection to a NotesNewsletter object, it formats its doclink report with either the document creation date or the relevance score, depending on the sort options.
Query syntax
To search for a word or phrase, enter the word or phrase as is, except that search keywords must be enclosed in quotes. Remember to escape quotes if you are inside a literal.
Wildcards, operators, and other syntax are permitted. For the complete syntax rules, see "Finding documents in a database" in Lotus Notes Help.
Language cross-reference
unprocessedFTSearchRange method in Java AgentContext class
Example See Also