Defining Business Process Client Connectivity Components

In Business Process client projects, the Connectivity Map contains business logic and information about how data is transferred between the master index application and external systems through a Business Process. The Business Process defines how data is transformed before being sent to the master index application.

Note - Before you can add the master index application to the client Connectivity Maps, you need to create and Environment and deployment profile for the master index server project, and then build the project. This adds the master index external application to the Connectivity Map Editor toolbar under the External System icon. Instructions for creating the Environment are under Building an Environment. Instructions for building and deploying the master index server project are under Deploying the Master Index (Repository) Server Project in Deploying Master Indexes (Repository) .

The following topics describe how to incorporate master index methods into a Business Process, create the Connectivity Map, and then add and connect the connectivity components.

• Including Master Index Methods in a Business Process

• Connecting the Business Process Components

• Creating the Business Process Client Connectivity Map

• Connecting Business Process Client Connectivity Map Components

  Note - Refer to Designing Business Processes in the Sun Business Process Manager for more details about performing any of the processes described in this section.

Including Master Index Methods in a Business Process

You can process data through a Collaboration, a Business Process, or both. If you are processing data by both methods, be sure the processing logic is the same for both. Before including the master index application in the Connectivity Map for the Business Process client project, you need to add master index methods to a Business Process. For more information about the available methods, see theWorking with the Master Index Java API (Repository) in Understanding Sun Master Index Processing (Repository) .

To Include Master Index Methods in a Business Process

1. Plan and design a new Business Process.
2. In the NetBeans Projects window, right-click the name of the Business Process client project, point to New, and then select Business Process.
3. Enter a new name for the Business Process and then press Enter.
4. In the Business Process Designer, create the components of the Business Process.
5. For each master index method to include, do the following:
   1. In the master index server project, expand the method OTD folder to display the method list.
   2. Drag the method you want to use into the Business Process Designer.

      Note - The method OTD is the node in the master index server project with the same name as the master index application.

6. Save the Business Process and continue to the next step, Connecting the Business Process Components.

Connecting the Business Process Components

This topic describes how to connect the components of a Business Process that incorporates master index methods. Make sure you have completed all of the steps in Including Master Index Methods in a Business Process and that the Business Process is open in the Business Process Designer.

To Connect the Business Process Components

1. In the Business Process Designer, place the cursor over the arrow to the right of the Start icon until the cursor turns into a hand.
2. Click the arrow and drag it to the first Business Process component.
3. Follow the same procedure to link each activity in the order in which they should be processed.
4. For each link you create, do the following:
   1. Right-click the link and select Add Business Rule.
   2. Configure the business rule to map data from the input to output activity.
5. Create any additional processing logic as needed.
6. Save the Business Process to the Repository.

Creating the Business Process Client Connectivity Map

Connectivity between the master index application and Business Processes is defined in the Connectivity Map of the Business Process client project. This topic describes how to create and configure the Business Process client Connectivity Map. You can optionally include a JMS Topic (for information and instructions, see Adding the JMS Topic to the Collaboration Client Connectivity Map). You only need to incorporate the topic if you added a JMS Topic to the server project and if you want to publish master index application messages to external systems.

Note - The master index application icon in this Connectivity Map comes from the External Applications menu on the Connectivity Map Editor toolbar. Make sure the master index project has been built before creating the client Connectivity Map. Instructions for creating the Environment are under Building an Environment. Instructions for building and deploying the master index server project are under Deploying Master Indexes (Repository) .

To Create the Business Process Client Connectivity Map

1. In the Projects window, right-click the project to which you want to add the Connectivity Map.
2. Point to New, and then click Connectivity Map.

   A Connectivity Map icon is added to the project and the Connectivity Map Editor appears.

3. Enter a new name for the Connectivity Map, and then press Enter.
4. To add External Applications, do the following:
   1. On the Connectivity Map Editor toolbar, click the down arrow next to the External Applications icon.
   2. Select the check box next to the name of the External Application that will send messages to the master index application.

      The External Application icon appears in the Connectivity Map Editor toolbar.

   3. Drag the External Application icon from the Connectivity Map Editor toolbar to the canvas.
   4. If your data flow includes a destination External Application, repeat the above steps for the destination application, placing the icon to the far right of the source External Application icon.
5. In the Connectivity Map toolbar, click Service and drag it onto the canvas to the right of the External Application icon.
6. Drag the Business Process created in Including Master Index Methods in a Business Process into the Service.
7. To add the master index application, do the following:
   1. On the Connectivity Map Editor toolbar, click the down arrow next to the External Applications icon.
   2. Select the check box next to the name of the master index application you want to add.

      The master index application icon appears in the Connectivity Map Editor toolbar.

   3. Drag the master index application icon from the Connectivity Map Editor toolbar onto the canvas to the lower right of the Collaboration icon.
8. Save the Connectivity Map to the Repository.

Connecting Business Process Client Connectivity Map Components

Once you create the components of a Connectivity Map, you must link them to define the flow of data through the system. Before you connect the components, make sure you have completed all of the steps in Creating the Business Process Client Connectivity Map.

To Connect Business Process Connectivity Map components

1. In the Business Process Connectivity Map, double-click the Service icon to display the Service Binding dialog box.
2. Drag the sending application in the Implemented Services box in the Service Binding dialog box to the input External Application icon on the Connectivity Map Editor.
3. Drag the master index application from the Invoked Services box in the Service Binding dialog box to the master index application icon on the Connectivity Map Editor.

   Note - This is the service with the same name as the master index application.

4. Drag the receiving application in the Invoked Services box in the Service Binding dialog box to the output External Application icon on the Connectivity Map Editor.
5. Close the Service Binding dialog box.
6. Double-click the Adapter icon to configure the Adapters (for more information, see the configuration topics for the type of Adapter).
7. To add a JMS Topic to the Connectivity Map, follow the instructions under Adding the JMS Topic to the Collaboration Client Connectivity Map and Configuring the Outbound Collaboration.
8. Save the Connectivity Map to the Repository.