Top
Systemwalker Runbook Automation Studio User's Guide
Systemwalker

11.10 Defining Java Agents

A Java Agent is a special Java program that gathers information or performs some well-defined tasks in the background without your immediate presence and on some regular schedule. Java Agents are created to run automatically and act asynchronously on your behalf. You can use Java Agents to access external systems, such as legacy systems. Using Java Agents, you can incorporate these external services into your process instances.

Systemwalker Runbook Automation Studio allows you to add several Java Agents to your Workflow Application projects. For configuring new Java Agents, Systemwalker Runbook Automation Studio provides an XML file called agentsConfig.xml. Once a new Java Agent is configured, it can run as an activity in a process instance by assigning it to an Activity Node. A Java Agent is assigned to an Activity Node in the same manner that a Role is assigned to an Activity Node. The Java Agent then takes the place of the activity.

To define a new Java Agent:

  1. [Right-click your project in the Navigator view and select New > Agents from the pop-up menu.

    A new Java Agent file (agentsConfig.xml) is automatically stored in the Resources folder of your Workflow Application project. The default agentsConfig.xml file automatically opens in the Resource editor.

  2. Type in the properties that are required for the new Java Agent. Refer to "C.1 Java Agent File (agentsConfig.xml)" for information on the Java Agent file (agentsConfig.xml).

  3. Click Save on the toolbar to save the new agent.

    You can use the new Java Agent to carry out specific tasks in the background.