Triggering an agent on an event

Action menu selection

User-activated agents or for WebQuerySave or WebQueryOpen agents.

Agent list selection

Agents that are only to be called by other agents and for agents that are still being developed or are run from Designer.

Before new mail arrives

Processing mail before it is deposited in the mail databases; for example, to move incoming mail to a folder.

With this option, the agent runs before the message is listed in the database. Therefore, be careful what other options you choose. For example, do not use the "Mark Documents Read" simple action because documents will always be marked unread when they are listed in the database.

Note that this option is limited to one agent per database.

After new mail has arrived

Processing incoming mail: to respond to it, forward it, or file it.

Interactive functions and functions that read or modify data external to the current document are ignored when documents are mailed into the database. For example: @DbColumn, @DbCommand, @DbLookup, @MailSend, @Prompt, @Command, or @PostedCommand are all ignored.

Note that you can use this option multiple times within the same database.

After documents are created or modified

Workflow tasks where a task is performed based on new or changed documents. This trigger is actually a scheduled agent handled by the Agent Manager and can execute either on the local Notes® client or on a server.

When you select "After documents are created or modified," an "Edit settings" button appears. If you click the button, the Schedule dialog box appears. Here you can set a start and end date for the agent, tell the agent not to run on weekends, and either choose a server for the agent to run on or choose the local Notes® client. You can also specify that the server is chosen when the agent is enabled.

The delay time using this agent varies between 5 to 30 minutes, depending on the server load.

When documents are pasted

Documents that are pasted into the database and need to be modified as they are being pasted. Note that this event requires action by the user and does not happen in the background.

Paste-activated agents cannot use @Command or @PostedCommand.

When server starts

Agents that are only to be called when the server starts, and are not called at other times. If you want an agent to be called when the server starts, but also at other times while the server is running, use the agent list selection trigger, and create a separate agent triggered when server starts that calls that agent.