MAIL


Using Domino Web Access agents
You can use agents to process or manipulate data on forms or subforms in IBM® Lotus® Domino™ Web Access. There are two Domino Web Access agents, QueryOpen and QuerySave, which are the equivalent of the Web agents WebQuerySave and WebQueryOpen.

When determining which forms to customize using Domino Web Access agents, keep in mind how often the form is used. Design your agents to run only on the specific page you want to act on. An agent that acts on a form or subform that runs constantly may impact performance adversely.

Create the agents

You create Domino Web Access agents in IBM® Lotus® Domino™ Designer by adding two NOTESVARS to the dictionary for the form you want to customize. The NOTESVARS specify the names of the QueryOpen and QuerySave agents (in the user's mail file or in the Mail (R8) template (MAIL8.NTF). In Domino Designer, edit the form or subform you want the agents to act on, adding the following lines between the <NotesDictionary> tags:


Example

To add QueryOpen and QuerySave agents to the Memo, Reply, and Reply with History forms, open FORMS8.NSF and add $$QueryOpenAgent and $$QuerySaveAgent NOTESVARS to the s_mailMemoDictionary subform. Using the names testopen and testsave, for example, the edited subform would look like this:


For information about creating and using Web agents, see the section on Programming Domino for Web Applications in the Domino Designer help. If you have not installed Domino Designer Help, go to http://www.lotus.com/ldd/doc to download or view Designer Help.

See also