Using Logic Plug-Ins

 

Logic plug-ins are Java classes that can intercept and process business messages at run time. Plug-ins are business protocol specific. Each business protocol is associated with three standard logic plug-ins:

• Router logic plug-in

• Router enqueue logic plug-in

• Filter logic plug-in

Note: The display of logic plug-ins is controlled by the Preferences tab. For more information, see Hiding Advanced System Configuration Features. When logic plug-ins are hidden, they are not displayed in the navigation tree and none of the logic plug-in configuration tabs are visible.

For more information on creating plug-ins, see Programming BEA WebLogic Collaborate Messaging Applications.

This topic includes the following sections:

• Creating a Logic Plug-In

• Modifying a Logic Plug-In

• Removing a Logic Plug-In

 

---

Creating a Logic Plug-In

You can add custom logic plug-ins to the filter and router chains. For example, use filter plug-ins to control which trading partners or roles receive a message. Use router plug-ins to define algorithms that generate lists of trading partners who should receive the message.

To create a logic plug-in:

1. Click Logic Plug-Ins in the navigation tree to display the Logic Plug-Ins page.

2. In the right pane, click the Create a new Logic Plug-In link at the top of the list. The General tab is displayed.

3. Enter new values or modify the default values for the fields shown in the following table.

   Table 6-1 Login Plug-In Fields

   Field		Description
   Name		Enter the name of the new logic plug-in you want to create. Define the logic plug-in based on code you have written and your goals—what you want to track or accomplish—with regard to the data passing through the hub.
   Description		A brief description of the plug-in.
   Type		Select, from the drop-down list, the type of logic plug-in types desired: either User Filter or User Router.
   Java Class Name		The Java class name, specifying your implementation of this particular logic plug-in. (Read-only)
   Parameters for Java Class		Enter the parameters that define the Java class.
   	Name	The name of the parameter you want to add.
   	Value	The value for the parameter you are adding.
   	Available Parameters	List of available parameters (shown as name/value pairs in the form name=value).

   
    

4. To apply the new values, click Create.

For information on creating and modifying user plug-ins, see Advanced Configuration Tasks in Administering BEA WebLogic Collaborate.

You can find additional information about message-context document structure and creating XPath expressions to reference extended properties in Programming BEA WebLogic Collaborate Messaging Applications.

 

---

Modifying a Logic Plug-In

To modify a logic plug-in:

1. Do one of the following:

   • Click Logic Plug-Ins in the navigation tree to display the Logic Plug-Ins page, then locate and click the appropriate logic plug-ins desired.

   • Click a logic plug-in listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the WebLogic Collaborate Preferences tab as described in Displaying Items in the Navigation Tree.)

     The Logic Plug-In General tab is displayed.

2. In the General tab, click the name of an existing logic plug-in. The General tab is displayed containing the configuration fields and values for that logic plug-in.

3. Modify the values in the fields shown in Table 6-1.

4. To apply the new values, click Apply. You can then modify other elements on other Configuration tabs.

For information on creating and modifying user plug-ins, see Advanced Configuration Tasks in Administering BEA WebLogic Collaborate.

 

---

Removing a Logic Plug-In

To remove an existing logic plug-in:

1. Click Logic Plug-Ins in the navigation tree to display the Logic Plug-Ins page.

2. From the list of available logic plug-ins, select the check box next to the logic plug-in(s) you want to delete.

3. At the bottom of the list, click Remove.

For information on creating and modifying user plug-ins, see Advanced Configuration Tasks in Administering BEA WebLogic Collaborate.