bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

B2B Console Help

Using Logic Plug-Ins

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

- Router logic plug-in

- Router enqueue logic plug-in

- Filter logic plug-in

This section explains how to create logic plug-ins and, if possible, how to change and delete them from your WebLogic Integration system. It includes the following topics:

- Creating a Logic Plug-In (Deprecated)

- Modifying a Logic Plug-In (Deprecated)

- Removing a Logic Plug-In (Deprecated)

Note: The display of logic plug-ins is controlled by the Preferences tab in the B2B Console. For more information, see Displaying 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 a detailed description of plug-ins see Using Advanced Trading Partner Configuration Options. For information on creating plug-ins, see Programming Logic Plug-Ins for B2B Integration.

Creating a Logic Plug-In (Deprecated)

Note: Using custom logic plug-ins is deprecated in this release of WebLogic Integration. For information about the features that are replacing custom logic plug-ins, see BEA WebLogic Integration Release Notes.

WebLogic Integration supports the addition of custom logic plug-ins to the filter and router chains. Why might you want to add custom logic plug-ins?

- You may want to use filter plug-ins to control which trading partners or roles receive a message.

- You may want to use router plug-ins to define algorithms that generate lists of trading partners who should receive a message.

For more information, see Using Advanced Trading Partner Configuration Options.

1. In the navigation tree, click the Logic Plug-Ins node. The Logic Plug-Ins page is displayed in the right pane.

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

3. On the General tab, enter new values or modify the default values in the fields described in the following table.

   Table 6-1 General Tab for Logic Plug-In Fields

   Field | Description
   --- | ---
   Name | Enter the name of the plug-in you want to create. We recommend that you select a a name that suggests the purpose of the plug-in.
   Description | Enter a brief description of the plug-in.
   Type | Select, from the drop-down list, the type of logic plug-in desired: User Filter or User Router.
   Java Class Name | Enter the Java class name, specifying your implementation of this particular logic plug-in.
   Parameters for Java Class | Enter the parameters that define the Java class.
   Name | Name of the parameter you want to add.
   Value | Value for the parameter you want to add.
   Available Parameters | List of available parameters (shown as name/value pairs in the form name=value).

4. When you complete your changes, click Create.

For information about creating and modifying, see Advanced Configuration Tasks in Administering B2B Integration.

For additional information about message-context document structure and instructions for creating XPath expressions to reference extended properties, see Programming Logic Plug-Ins for B2B Integration.

Modifying a Logic Plug-In (Deprecated)

Note: Using custom logic plug-ins is deprecated in this release of WebLogic Integration. For information about the features that are replacing custom logic plug-ins, see BEA WebLogic Integration Release Notes.

To modify a logic plug-in:

1. Select a logic plug-in by performing one of the following steps:

   - In the navigation tree, click the Logic Plug-Ins node. The Logic Plug-Ins page is displayed in the right pane. On that page, select the appropriate logic plug-in.

   - In the navigation tree, select a logic plug-in.

   Note: The second method is available only if the Display entities on the navigation tree option is selected on the Preferences tab in the B2B Console, as described in Displaying Entities in the Navigation Tree.)

   The General tab for logic plug-ins is displayed.

2. On the General tab, select a logic plug-in. The values for the specified logic plug-in are displayed in the fields on the General tab.

3. Modify, as necessary, the values of the fields described in Table 6-1. Click Apply.

You can now modify other elements on other configuration tabs.

For information about creating and modifying user plug-ins, see Advanced Configuration Tasks in Administering B2B Integration.

Removing a Logic Plug-In (Deprecated)

Note: Using custom logic plug-ins is deprecated in this release of WebLogic Integration. For information about the features that are replacing custom logic plug-ins, see BEA WebLogic Integration Release Notes.

To remove a logic plug-in:

1. In the navigation tree, click the Logic Plug-Ins node. The Logic Plug-Ins page is displayed in the right pane.

2. On the Logic Plug-Ins page, select the logic plug-in you want to delete. Click Remove.

For information about creating and modifying user plug-ins, see Advanced Configuration Tasks in Administering B2B Integration.