Rules for creating LotusScript agents that execute from a Web browser.

Author: Tripp W Black

Created: 08/26/1999 at 07:51 PM

 

Category:
Notes Developer Tips
Agents, LotusScript

General Information

1. A Web browser can execute a LotusScript agent in the following three ways:
- From the $$QueryOpenAgent field
- From the $$QuerySaveAgent field
- Using the ?OpenAgent Domino command

2. While Java scripts are executed on individual Web user’s browsers, LotusScript agents are processed on the Domino server. This means that when a Web browser attempts to execute a LotusScript agent on a Domino server, the agent gets added to the server’s agent queue and, only after the agent request has passed through the queue and executed, will the user be able to continue browsing the Domino Web site. Because of this, it is important to keep LotusScript agents small so that they can be processed quickly.

3. The NotesDatabase UnprocessedDocuments property will not return a document handle.

4. In order to access the current document, use the DocumentContext property of a NotesSession object.

5. Front end classes may not be used.

6. All Domino LotusScript agents must be set to
“Run Once” with a trigger option of
“Manually from the actions menu.”

$$QueryOpenAgent specifics

1. These agents run before the document is loaded.
2. They can write to fields from a new document.
3. They cannot read field values from a new document.
4. Output functions (such as the Print command) are ignored.


$$QuerySaveAgent specifics

1. These agents run after the document has been saved.
2. They cannot write to fields from a new document.
3. They can read field values from a new document.
4. Output functions will display in a new output window on the Web browser.

$$OpenAgent specifics

1. These agents can be called from anywhere that you can enter a URL (for example, from a hotspot).
2. They cannot read field values from a new document.
3. Output functions will display in a new output window on the Web browser.

http://208.228.111.61/march/index8.htm



previous page