Processing agent parameters from event handler notification method 'Run an agent'

HCL Domino Domino Forum
, , ,
1

Does anyone know how to process / use the "agent parameters" from an event handler notification method "Run an agent"?

Community-Pasted-Attachment-1728642096203.png510×490 16.7 KB

I tried to get it via session.DocumentContext.Query_String_Decoded and agent.ParameterDocID in the started agent - but both is empty...

Thankx in advance.

Pierre

2

Hi Pierre,

Here's an example of how you might pass custom parameters to an agent in IBM Domino:

Let's say you have an agent that processes customer orders. You want to pass the following custom parameters to the agent:

  • OrderID: The unique identifier for the order.
  • CustomerID: The unique identifier for the customer.
  • Priority: The priority level of the order (e.g., high, medium, low).

Here's how you can set this up:

  1. Open Domino Administrator:

    • Launch the Domino Administrator client and connect to the server where you want to set up the event handler.

  2. Access the Monitoring Configuration:

    • Navigate to the "Configuration" tab.
    • Expand "Monitoring Configuration" and select "Event Handlers."

  3. Create or Edit an Event Handler:

    • Click on "Add Event Handler" to create a new event handler or select an existing one to edit.

  4. Specify Event Criteria:

    • Define the criteria for the events you want to monitor. This can include specific event types, severity levels, and other conditions.

  5. Choose the "Run an Agent" Notification Method:

    • In the notification methods section, select "Run an Agent."

  6. Configure Agent Details:

    • Specify the agent name, the server, and the database containing the agent.
    • Enter the custom parameters you want to pass to the agent. For example: 
      OrderID=12345 CustomerID=67890 Priority=High

  7. Enable the Event Handler:

    • Once configured, enable the event handler to start monitoring and running the agent based on the defined criteria.

  8. Save and Test:

    • Save your changes and test the event handler to ensure it works as expected.

In this example, the agent will receive the parameters OrderID=12345, CustomerID=67890, and Priority=High, which it can then use to process the order accordingly.

Hope this helps.

Best Regards,

Jho

3

If anyone has the same question, I found the solution today:

In the called agent you can access the "parameter" document with NotesSession.DocumentContext.

This document contains a field named "AgentParams" which contains the "Agent Parameters" of the event handler document.

Pierre

4

@Pierre Laule
Thanks a lot !