To View and Maintain Agents: To View and Maintain Agents:Use a Web browser to navigate to the Event Manager, using a responsibility and navigation path specified by your system administrator. Then choose the Agents tab. See: Oracle Workflow Developer Navigation Paths.
Search for the agents you want to display. The main search option is:
Name - Enter the internal name of the agent you want to display. You can enter a partial value to search for agents whose internal names contain that value.
You can also enter the following additional search criteria.
Protocol - Select the protocol of the agent you want to display.
Address - Enter the address of the agent you want to display.
System - Select the system of the agent you want to display.
Direction - Select In or Out as the direction of the agents you want to display.
Type - Select Agent or Group as the type of the agents you want to display.
Status - Select Enabled or Disabled as the status of the agents you want to display.
If you have workflow administrator privileges, you can use the administration icons and buttons to perform administrative operations.
To update an agent, choose the update icon for that agent. See: To Create or Update an Agent and To Create or Update an Agent Group.
To delete an agent, select the agent and select the Delete button.
Note: You can only delete agents that do not have any subscriptions referencing them and that do not belong to any agent groups.
To create a new individual agent, select the Create Agent button. See: To Create or Update an Agent.
To create a new agent group, select the Create Agent Group button. See: To Create or Update an Agent Group.
Note: Whenever you make changes to your agents that affect the physical implementation required for message propagation, you should recheck your propagation setup. See: Setting Up the Business Event System.
To Create or Update an Agent:Navigate to the Create Agent page or to the Update Agent page. The Create Agent page and the Update Agent page are identical, except that the fields in the Update Agent page are populated with previously defined information for the selected agent.
Note: You should not use the Create Agent page to create agent definitions for inbound agents on external systems that have Oracle Workflow installed. Instead, you should use the Register External System page to automatically register the system identifier information for that external system, including inbound agent definitions. See: Registering External Systems.
Enter the internal name of the agent in the Name field. The agent's internal name must be unique within the agent's system.
Important: The internal name must be all-uppercase and should not include any single or double quotation marks (' or ") or spaces.
Enter a display name for the agent.
Enter an optional description for the agent.
Select the message communication protocol that the agent supports.
If the agent supports inbound communication to its system, enter the address for the agent. The format of the address depends on the protocol you select.
For agents that use the SQLNET protocol, the address must be in the following format to enable AQ propagation:
<schema>.<queue>@<database link>
<schema> represents the schema that owns the queue, <queue> represents the queue name, and <database link> represents the database link to the instance where the queue is located.
Note: You must enter the database link name exactly as the name was specified when the database link was created. See: Creating Database Links.
Select the system in which the agent is defined.
Enter the queue handler for the agent. A queue handler is a PL/SQL or Java package that translates between the Workflow event message format (WF_EVENT_T datatype or BusinessEvent Java object) and the message format required by the queue associated with the agent. Define only one queue handler for an agent, either PL/SQL or Java. See: Standard APIs for a Queue Handler.
To assign the agent a PL/SQL queue handler, enter the PL/SQL package name in the Queue Handler field in all uppercase. You can run both PL/SQL and Java agent listeners on an agent with a PL/SQL queue handler.
To assign the agent a Java queue handler, enter the Java package name in the Java Queue Handler field. You can run only Java agent listeners on an agent with a Java queue handler.
Note: For an agent that is not implemented as a queue, such as an agent on a non-Oracle system, you can leave the Queue Handler and Java Queue Handler fields blank.
Enter the name of the queue that the local system uses to interact with the agent. Since only the local system refers to this queue name, the queue name should be within the scope of this system, without requiring a database link. Use the following format to specify the queue name:
<schema>.<queue>
<schema> represents the schema that owns the queue, and <queue> represents the queue name.
Important: You must enter the queue name in all uppercase.
Note: For an agent that is not implemented as a queue, such as an agent on a non-Oracle system, you can leave the Queue field blank.
In the Direction field, select In for an agent that supports inbound communication to its system, or select Out for an agent that supports outbound communication from its system.
Select Enabled or Disabled as the agent status. If you disable an agent, its definition remains in the Event Manager for reference, but you cannot use the agent in active subscriptions.
To Create or Update an Agent Group:Navigate to the Create Agent Group page or to the Update Agent Group page. The Create Agent Group page and the Update Agent Group page are identical, except that the fields in the Update Agent Group page are populated with previously defined information for the selected agent group.
Enter the internal name of the agent group in the Name field. The agent group's internal name must be unique within the agent group's system.
Important: The internal name must be all-uppercase and should not include any single or double quotation marks (' or ") or spaces.
Enter a display name for the agent group.
Enter an optional description for the agent group.
Select the system on which the agent group is defined.
Note: Although an agent group is defined on a particular system, you can include agents from other systems as members within the group.
Since agent groups are used only for inbound communication, the direction for an agent group is automatically set to In.
Select Enabled or Disabled as the agent group status. If you disable an agent group, its definition remains in the Event Manager for reference, but you cannot use the agent group in active subscriptions.
Select the Apply button to save the agent group definition.
To add a member agent to the group, select the Add Agents to Group button.
Note: An agent group can contain only individual agents as its members. It cannot contain another group.
In the Add Agents to Group page, search for the agents you want to add. The main search option is:
Name - Enter the internal name of the agent you want to add. You can enter a partial value to search for agents whose internal names contain that value.
You can also enter the following additional search criteria.
Protocol - Select the protocol of the agent you want to add.
Address - Enter the address of the agent you want to add.
System - Select the system of the agent you want to add.
Status - Select Enabled or Disabled as the status of the agents you want to add.
Select the agent or agents that you want to add to your agent group, and select the Add Agents to Group button.
You can optionally enter new search criteria to search for other agents to add to the agent group.
After you finish adding agents to the agent group, select the Apply button to save the agent group members.
To delete a member agent from the group, select the agent in the Create Agent Group or Update Agent Group page and select the Delete button.
Note: Deleting a member agent from an agent group does not delete the agent definition for the individual agent. The individual agent remains in the Event Manager.