Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Service Bus
11g Release 1 (11.1.1.7)

Part Number E15867-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

10 Split-Joins

This chapter describes how to create, locate, edit, and delete Split-Join resources using the Oracle Service Bus Administration Console.

Split-Joins let you send message invocations in parallel (in addition to sequentially) and to aggregate the responses. To learn more about Split-Joins, see "Improving Service Performance with Split-Join" in the Oracle Fusion Middleware Administrator's Guide for Oracle Service Bus. See also, "Working with Split-Join" and the "Split-Join User Interface Reference" in the Oracle Fusion Middleware Developer's Guide for Oracle Service Bus.

You access Split-Joins through Flow transport-typed business services. For more information, see the Section 19.2.10, "Flow Transport Configuration Page."

10.1 Locating Split-Joins

To locate Split-Joins:

  1. Do either of the following:

    • Select Project Explorer to display the Projects View page or the Project/Folder View page. Then navigate through projects and folders to find the Split-Join.

    • Select Resource Browser > Split-Joins. The Summary of Split-Joins page displays the information shown in Table 10-1. For a more detailed description of the properties, see Section 10.3, "Editing Split-Joins."

  2. To restrict the number of items in the list, you can filter by name, path, or both. In the Name and Path fields, enter the name and path of the search target(s), then click Search.

  3. Click View All to remove the search filters and display all Split-Joins.

Table 10-1 Split-Join Details

Property Description

Split-Join Name

The name assigned to the Split-Join. The name is a link to the Split-Join Configuration page. See Section 10.3, "Editing Split-Joins."

Path

The path is the project name and the name of the folder in which the Split-Join resides. It is a link to the project or folder that contains this resource. See Section 4.1.1, "Qualifying Resource Names Using Projects and Folders."

Options

Click the Delete icon to delete a specific Split-Join. See Section 10.4, "Deleting Split-Joins."


10.2 Adding Split-Joins

Before you begin

Split-Joins require a .flow file which is created when you create a Split-Join using the Oracle Service Bus plug-ins for Eclipse or when you import a Split-Join configuration JAR into the plug-in. The .flow file might have references to proxy services, business services, or to external WSDL resources. Resources on which the Split-Join depends must be present on the server before activating the Split-Join.

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Select Project Explorer, then select a project or folder in which to add the Split-Join. The Project/Folder View page is displayed.

  3. From the Create Resource list, select Split-Join to display the Create a New Split-Join Resource page.

    Specify the parameters shown in Table 10-2.

    Table 10-2 Split-Join Parameters

    Property To create or edit...

    Resource Name

    Enter a unique name for this Split-Join.

    Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.

    Resource Description

    Enter a description for the Split-Join.

    Split-Join

    Click Browse to locate a .flow file on your system, typically located under MW_HOME\user_projects\workspaces\your_workspace.

    Dispatch Policy

    Select the instance of WebLogic Server Work Manager used to create threads (parallel branches) to execute the Split-Join. The default Work Manager is used if no other Work Manager exists.

    For information about Work Managers, see:


  4. Click Save. The Split-Join is created and saved in the current session.

    Note:

    Resources on which the Split-Join depends must be present before activating the Split-Join.

  5. To end the session and deploy the configuration to the runtime, click Activate under Change Center.

10.3 Editing Split-Joins

To modify Split-Join properties:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Locate the Split-Join, as described in Section 10.1, "Locating Split-Joins."

  3. Click the Split-Join name.

    The View a Split-Join - Configuration page displays the information shown in Table 10-3.

    Table 10-3 Split-Join Details

    Property Description

    Last Modified By

    The user who created this Split-Join or imported it into the configuration.

    Last Modified On

    The date and time that the user created this Split-Join or imported it into the configuration. Click the date and time link to view the change history of this resource. See Section 4.23, "View Change History Page."

    References

    The number of objects that this Split-Join references. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources."

    Referenced by

    The number of objects that reference this Split-Join. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources."

    Description

    A description of this Split-Join, if one exists.


  4. You can make the following operational settings to a Split-Join:

    Table 10-4 Split-Join Operational Settings

    Property Description

    Logs

    To capture log information in a Split-Join, select Enable Logging and select the logging level you want to capture.

    Execution Tracing

    To enable runtime tracing, select Enabled.


  5. Click Update to commit the updates in the current session.

  6. To end the session and deploy the configuration to the runtime, click Activate under Change Center.

10.4 Deleting Split-Joins

To delete a Split-Join:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Select Resource Browser > Split-Joins to display the Summary of Split-Joins page.

  3. Click the Delete icon in the Options field of the Split-Join you want to delete. The Split-Join is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.

  4. To end the session and deploy the configuration to the runtime, click Activate under Change Center.