Domino & Notes error

Unsupported trigger and search in the background or embedded agent

Reported when running agents in the background, from the web or from code. Fix details are based on forum reports rather than an HCL topic. Exact wording may vary between Domino and Notes versions.

What it means

The agent's trigger or document target is one that only works when a user runs it from the Notes client, not in the background.

Common causes

  • An agent set to act on selected documents run from code, the web or RunOnServer
  • An agent called from WebQueryOpen or WebQuerySave with a client-only target
  • The agent trigger left on an Actions menu setting instead of Agent list selection

Quick fixes

  1. Open the agent properties in Domino Designer and set the trigger to Agent list selection
  2. Set the target to None and get documents in code, for example with DocumentContext or a search
  3. Save and re-sign the agent, then test again

Need a hand with this?

Paste your exact message into What's That Error? for a plain-English explanation, or get in touch. I've been supporting Domino and Notes for 28 years.

Disclaimer

The errors, causes and fixes on this site are carefully researched, drawing on HCL documentation and 28 years of hands-on Domino and Notes experience. Every environment is different, though, and a solution that works in one may not be right for yours. Exact wording can also vary between Domino and Notes versions.

This information is general guidance only and is provided without warranty of any kind. Always back up your data and test changes on a non-production system first. To the extent permitted by law, Bruinsma Services Pty Ltd accepts no responsibility or liability for any loss, damage, downtime or other consequence arising from use of this information. For advice specific to your environment, please contact me.