Copyright © TIBCO Software Inc. All Rights Reserved

Tutorial Steps

This tutorial requires that you follow the following steps:

1.	Importing the Tutorial

This step is performed on both the Initiator and the Responder computers.

2.	Configuring the Initiator TIBCO BusinessConnect

This step is performed only on the Initiator computer.

3.	Configuring the Responder TIBCO BusinessConnect

This step is performed only on the Responder computer.

4.	Configuring Private Processes

This step is performed on both the Initiator and the Responder computers.

5.	Running the Tutorial

This step is performed on both the Initiator and the Responder computers.

Importing the Tutorial

Before you can configure trading partners for the Services Plug-in transactions, you must first configure an operation as explained in Configuring Services Plug-in Operations. This tutorial uses pre-configured operations, which are imported together with the tutorial.

To import the tutorial on both computers (Initiator and Responder):

1.	In TIBCO Administrator, click BusinessConnect > Operations Editor.

2.	Click Import.

3.	Click the change link and upload the following file:

−	For TIBCO Designer:

BC_HOME\protocols\ezcomm\samples\interfaces\ezcommtutorial-operations.csx

−	For TIBCO Business Studio:

BC_HOME\protocols\ezcomm\samples\interfaces\ezcommtutorial_for_bw6-operations.csx

4.	Enter a password if it is necessary.

5.	Click Import.

It imports two operations named Manage Widgets and Widget Inventory. The default Notify operation and the two imported operations are displayed on the Edit Operations page:

Figure 1 Imported Operations Manage Widgets and Widget Inventory

6.	Click Done.

Once the operations are imported, continue with configuring the computers.

Configuring the Initiator TIBCO BusinessConnect

In this tutorial, the hosts computer’s name is Buyer, and the partner’s computer name is Seller.

Follow the steps as described in these sections:

•	Configuring the Initiator Default Host

•	Configuring the Initiator Partner

•	Configuring the Initiator Business Agreement

Configuring the Initiator Default Host

See Configuring Services Plug-in for a Host for more information about setting up a host in a business agreement.

1.	Click BusinessConnect > Participants.

2.	Click New.

3.	Type Buyer in the Name field.

4.	Select Host from the Type list.

5.

Click OK.

6.	On the New Host Participant page, select the Active check box.

7.	Click Apply.

For this tutorial, you do not need to do the further edit of the protocols configuration.

8.	Click BusinessConnect > System Settings on the left panel.

9.	Click General.

10.	Verify Buyer is selected from the Default Host list.

11.	Click Save.

Configuring the Initiator Partner

See Configuring Services Plug-in for a Partner for more information about setting up a partner in a business agreement.

1.	Click BusinessConnect > Participants.

2.	Click New.

3.	Type Seller in the Name field.

4.	Select Partner in the Type list.

5.

Click OK.

6.	On the New Partner Participant page, select the Active check box.

7.	Click Apply.

Enable Protocol for the Initiator Partner

8.	On the Edit Partner Participant page, select the Protocols tab.

9.	Click Enable.

10.	Select the EZComm check box.

11.

Click OK.

The EZComm protocol is now in the Protocol Name field.

Add Transport for the Initiator Partner

1.	Click EZComm in the Protocol Name field.

2.	Select the Transports tab.

3.	Click Add.

4.	On the New Transport page, enter data as explained in Table 2.

Table 2 New Transport for the Partner

Field	Description
Name	Enter the name for the transport (required).
Type	Select the transport type from the Type list. For this tutorial, select HTTP.

5.

Click OK.

Define URL

6.	On the New HTTP Transport page, enter information as shown in Table 3.

Table 3 New HTTP Transport

Field	Description
Transport Name	Enter a name for this transport (required).
URL	URL of the company (required): www.hostname:6700/dmz/EZComm.
Use HTTP Basic Authentication	Clear the check box Use HTTP Basic Authentication.
Username	No entry required for this tutorial.
Password	No entry required for this tutorial.
Retry Count	Leave the default (3).
Retry Interval	Leave the default (60).
Socket Timeout (seconds)	Leave the default (300).

7.	Click Save three times.

Configuring the Initiator Business Agreement

This section contains only the steps necessary for this tutorial, see Adding a New Business Agreement for a complete explanation.

After both trading partners are configured, configure the business agreement.

1.	Click BusinessConnect > Business Agreements.

2.	Click New.

Verify that the plug-in is displayed in the Protocols column for both trading partners. If it is missing, return to Enable Protocol for the Initiator Partner and enable it.

3.	Click Buyer in the Host Party area.

4.	Click Seller in the Partner Party area.

5.

Click OK.

6.	Confirm that the Valid check box in the General tab is selected. This makes the agreement valid immediately.

The following steps shows how to add operation bindings for the Initiator Business Agreement

This section contains only the steps necessary for this tutorial, see Configuring Agreement Protocol Binding for Services Plug-in for a complete explanation.

To add a protocol binding for this business agreement:

1.	Click Add Protocol Bindings on the New Agreement page.

2.	Select the EZComm check box.

3.

Click OK.

The Plug-in now is displayed in the Agreement Protocol Binding list.

4.	Click EZComm.

The Edit Protocol Binding page is displayed with the Operation Bindings tab selected by default.

Operation Bindings Tab

5.	Enter information according to Table 4.

Table 4 Edit Protocol Binding: Operation Binding Tab

Field	Description
Allow All Operations	For this tutorial, clear the Allow All Operations check box.
Non-Repudiation Logging	For this tutorial, select the Non-Repudiation Logging check box.

Add Binding for the Host

6.	On the Host can initiate panel, click Add Operation Binding.

For this tutorial, select the Manage Widgets/1.0/buyWidgets check box.

7.

Click OK.

The selected operation is displayed in the Operation Name list.

To configure the Host can Initiate: Override Outbound Settings section:

1.	Click Manage Widgets/1.0/buyWidgets in the Host can initiate section.

2.	Click the Transports tab.

 

Transports Tab

3.	Configure transport settings as shown in Table 5.

Table 5 Override Outbound Settings: Transports Tab

Field	Description
Override Transports	For this tutorial, select the Override Transports check box.
Override Outbound Transports
Primary Transport	For this tutorial, select HTTP.

4.	Click Save.

This creates an operation binding for the buyWidget operation that overrides any outgoing request for this operation.

The same binding is used for the incoming response for this request; for example, if you want to override the schema validation for an incoming response, you can select the desired value in the Operation Settings tab for this binding.

Configuring the Responder TIBCO BusinessConnect

This section describes how to configure the Responder TIBCO BusinessConnect on another computer, where your previous host becomes a partner, and the previous partner is now the host. If the second computer does not contain a deployed version of TIBCO BusinessConnect, proceed as follows:

1.	Repeat all pre-deployment and deployment steps for the second computer, as described in Prerequisites and Importing the Tutorial.

2.	Start TIBCO Administrator and click the TIBCO BusinessConnect link.

3.	Follow the steps as described in these sections:

−	Configuring the Responder Default Host

−	Configuring the Responder Partner

−	Configuring the Responder Business Agreement

Configuring the Responder Default Host

See Configuring Services Plug-in for a Host for more information about setting up a host in a business agreement.

1.	Click BusinessConnect > Participants.

2.	Click New.

3.	Type Seller in the Name field.

4.	Select Host from the Type list.

5.

Click OK.

6.	On the New Host Participant page, select the Active check box.

7.	Click Apply.

For this tutorial, there is no need to further edit protocol configuration.

8.	Click BusinessConnect > System Settings on the left panel.

9.	Click General.

10.	Verify that Seller is selected from the Default Host list.

11.	Click Save.

Configuring the Responder Partner

See Configuring Services Plug-in for a Partner for more information about setting up a partner in a business agreement.

1.	Click BusinessConnect > Participants.

2.	Click New.

3.	Type Buyer in the Name field.

4.	Select Partner from the Type list.

5.

Click OK.

6.	On the New Partner Participant page, select the Active check box.

7.	Click Apply.

Enable Protocol for the Responder Partner

8.	On the Edit Partner Participant page, click the Protocols tab.

9.	Click Enable.

10.	Select the EZComm check box.

11.

Click OK.

The EZComm protocol is now in the Protocol Name list.

For this tutorial, there is no need to further edit protocol configuration.

Add Transport for the Responder Partner

1.	Click the EZComm link.

2.	Click the Transports tab.

3.	Click Add.

4.	On the New Transport page, enter data as explained in Table 6.

Table 6 New Transport for the Partner

Field	Description
Name	Enter the name for the transport (required)
Type	Select the transport type from the dropdown list. For this tutorial, select HTTP.

5.	Click OK. The New HTTP Transport page is displayed.

Define URL

6.	Enter the data related to this new transport, as explained in Table 3:

www.hostname.com:6700/dmz/EZComm.

7.	Click Save three times.

Configuring the Responder Business Agreement

This section only contains the steps that are necessary for this tutorial. See Adding a New Business Agreement for a complete explanation regarding this topic.

1.	Click BusinessConnect > Business Agreements.

2.	Click New.

3.	Select Seller in the Host Party panel.

4.	Select Buyer in the Partner Party panel.

5.

Click OK.

6.	Confirm that the Valid check box is selected. It makes the agreement valid immediately.

7.	Click Add Protocol Bindings.

8.	Select the EZComm check box.

9.

Click OK.

EZComm now is displayed in the Agreement Protocol Binding list.

10.	Click Save.

To add operation bindings for the Responder Business Agreement:

This section only contains the steps that are necessary for this tutorial. See Configuring Agreement Protocol Binding for Services Plug-in for a complete explanation regarding this topic.

1.	Click the Business Agreement link.

2.	On the Edit Agreement page, click the EZComm link.

The Edit Protocol Binding page is displayed with the Operation Bindings tab selected by default.

Operation Bindings Tab

3.	Enter information according to Table 7.

Table 7 Edit Protocol Binding: Operation Binding Tab

Field	Description
Allow All Operations	Clear the check box for this tutorial.
Non-Repudiation Logging	Select the check box for this tutorial.

Add Binding for the Partner

4.	In the Responding Operations section, click Add Operation Binding.

For this tutorial, select Manage Widgets/1.0/buyWidgets.

5.

Click OK.

The selected operation is displayed in the Operation Name list.

To configure the Partner can Initiate: Override Inbound Settings section:

1.	Click Manage Widgets/1.0/buyWidgets in the Responding Operations panel.

2.	Click the Transports tab.

 

Transports Tab

3.	Configure transport settings as shown in Table 8.

Table 8 Override Inbound Settings: Transports Tab

Field	Description
Override Transports	Check the check box for this tutorial.
Override Outbound Transports
Primary Transport	For this tutorial, select HTTP.

4.	Click Save.

This creates an operation binding for the buyWidget operation that overrides any incoming request for this operation.

The same binding is used for the outgoing response for this request; for example, if you want to override the schema validation for an outgoing response, you can select the desired value in the Operation Settings tab for this binding.

Configuring Private Processes

This section describes how to configure the private processes on the Initiator and Responder computers in the following ways:

•	Configuring Private Processes in TIBCO Designer

•	Configuring Private Processes in TIBCO Business Studio

To configure private processes, installing TIBCO BusinessConnect Palette in TIBCO Designer or TIBCO ActiveMatrix BusinessWorks Plug-in for BusinessConnect in TIBCO Business Studio are required. To install TIBCO BusinessConnect Palette or TIBCO ActiveMatrix BusinessWorks Plug-in in BusinessConnect, see TIBCO BusinessConnect Palette Installation or TIBCO ActiveMatrix BusinessWorks Plug-in for BusinessConnect Installation for more details.

Configuring Private Processes in TIBCO Designer

To configure private processes in TIBCO Designer:

•	Task A, Open the BusinessWorks Project

•	Task B, Configure Connections to Initiator TIBCO BusinessConnect

•	Task C, Configure Connections to Responder TIBCO BusinessConnect

Task A Open the BusinessWorks Project

To open the TIBCO ActiveMatrix BusinessWorks project in TIBCO Designer:

1.	Start TIBCO Designer.

2.	Click New empty project.

3.	On the Save Project page, click Cancel.

4.	Click Project > Import Full Project.

5.	Click Select a file from the file system next to the File field of the ZIP Archive tab to navigate to the ezcomm.zip file.

The sample is located in the BC_HOME/protocols/ezcomm/samples/tutorial directory.

6.	Click Open and then click OK.

7.	In the Options tab, click Try rename in case of name conflict.

8.	Click Apply.

9.	Click Project > Save As.

10.	Click Select a file from the file system next to the Project Directory field to navigate to a folder where you want to save the sample project.

If you want to restore the project for later use, you must select a directory other than the BC_HOME/protocols/ezcomm/samples/tutorial directory. If your select the same directory, the .zip file is deleted.

11.	Select ISO8859-1 from the TIBCO Messaging Encoding list.

Select None from the Multi-User System list.

12.

Click OK.

Figure 2 TIBCO Designer: BusinessWorks Project

Task B Configure Connections to Initiator TIBCO BusinessConnect

To configure connections to TIBCO BusinessConnect on the Initiator computer:

1.	In the expanded project tree, double-click the Initiator connection icon.

2.	Click the BusinessConnect Server Access tab.

3.	Enter information as explained in Table 9.

Table 9 BusinessConnect Server Access Tab

Field	Description
JDBC Driver Type	Select the JDBC driver that you use to communicate with the BusinessConnect configuration store from the JDBC Driver Type list.
JDBC Driver	Select the JDBC driver to use with the database.
JDBC URL	Type the URL for the configuration store.
DB User	Provide a valid user name for the database.
DB Password	The password associated with the database user name.

4.	Click Apply.

5.	Click Update from Configuration Store in the Configuration tab.

6.	Select EZComm from the Protocol Name list.

If you select the Select Operations check box, you could select any of the configured/imported operations. For this tutorial, select all operations and click OK.

7.	Click Import Selected Business Protocol.

The INIATOR (BusinessConnect Connection) screen is displayed.

Figure 3 INITIATOR (BusinessConnect Connection)

In the Imported Operations field, you could see the operations that you have imported in Importing the Tutorial.

When you import the protocol, BusinessWorks retrieves information from the TIBCO BusinessConnect configuration store and puts it in the project folder.

8.	Click Apply.

9.	Click Save.

Task C Configure Connections to Responder TIBCO BusinessConnect

On the Responder computer, complete all steps explained in Task B, Configure Connections to Initiator TIBCO BusinessConnect, replacing all instances of Initiator with Responder.

Configuring Private Processes in TIBCO Business Studio

To configure the private process in TIBCO Business Studio:

•	Task A, Open the BusinessWorks Project

•	Task B, Configure Connections to Initiator TIBCO BusinessConnect

•	Task C, Configure Connections to Responder TIBCO BusinessConnect

 

Task A Open the BusinessWorks Project

To open the TIBCO ActiveMatrix BusinessWorks project in TIBCO Business Studio:

1.	Start TIBCO Business Studio.

2.	Click File > Import.

3.	On the Import page, expand the General folder and select the Existing Studio Projects into Workspace item. Click Next.

4.	Click Browse next to the Select archive file field to navigate to the ezcomm_for_bw6.zip file. Click Finish.

The sample project is located in the BC_HOME/protocols/ezcomm/samples/tutorial directory.

After importing the sample, you also need to do the following steps:

1.	Expand Module Descriptors in the Project Explorer view.

2.	Double-click Module Properties.

The the Module Properties editor is displayed.

3.	In the User tab, change the default value of the BC_HOME_DIR property to your BC_HOME. By default, the vaule is D:/tibco/bc/.

Task B Configure Connections to Initiator TIBCO BusinessConnect

To configure connections to TIBCO BusinessConnect on the Initiator computer:

1.	In the Project Explorer view, click Resources > ezcomm_demo> INITIATOR.bcResource.

2.	Click the Server Access tab.

3.	Enter information as explained in Table 9.

4.	Click Update from Configuration Store in the Configuration tab.

5.	Select EZComm from the Protocol Name list.

If you select the Select Operations check box, you could select any of the configured/imported operations. For this tutorial, select all operations and click OK.

6.	Click Import Selected Business Protocol.

When you import the protocol, BusinessWorks retrieves information from the TIBCO BusinessConnect configuration store and puts them in the project folder.

7.	Click Save.

Task C Configure Connections to Responder TIBCO BusinessConnect

On the Responder computer, complete all steps explained in Task B, Configure Connections to Initiator TIBCO BusinessConnect, replacing all instances of Initiator with Responder.

Running the Tutorial

To see the complete tutorial for the Asynchronous Request Response operation, you must run it on both computers, Buyer and Seller.

• You can also run the Synchronous Request Response and Notify transactions using the processes provided in this tutorial. • The steps of how to load and run private processes in TIBCO Business Studio are similar to TIBCO Designer. See TIBCO ActiveMatrix BusinessWorks Documentation for more details.

Running the Tutorial on the Seller Computer

1.	In TIBCO Designer, expand the RESPONDER folder.

2.	Click Asynchronous Request Response > Receive Async Request.

3.	Click Read File > Input Tab > ReadActivityInput and verify that the path given in the fileName field is valid.

4.	Click the Tester tab.

5.	Click Start testing viewed process .

The Select Process to Load page is displayed.

Figure 4 Select Process to Load

6.	Select the Receive Async Request(current) check box.

7.	Click Load Selected.

Once the request is received from the Buyer computer, this process receives the RESPODER.REQUEST message and then send the RESPONDER.RESPONSE message to TIBCO BusinessConnect.

Running the Tutorial on the Buyer Computer

1.	In TIBCO Designer, click INITIATOR > Asynchronous Request Response.

2.	Click the Send ASync Request process.

3.	Click the SendRequest activity.

Figure 5 SendRequest (Input)

4.	Enter Buyer in the fromTP field and Seller in the toTP field in the Input Tab, as shown in Figure 5.

5.	Click Read File > Input Tab > ReadActivityInput and verify that the path given in the fileName field is valid.

6.	Click Apply and Save.

7.	Click the Tester tab.

8.	Select two processes:

−	INITIATOR/Asynchronous Request Response/Send Async Request

−	INITIATOR/Asynchronous Request Response/Receive Response processes.

9.	Click Load selected.

10.	On the Tester page, select the Send ASyncRequest operation and click Create a job.

Figure 6 Create Job for the Send ASyncRequest operation

It sends an INITIATOR.REQUEST to the INITIATOR TIBCO BusinessConnect. At the same time, the Receive Response activity receives the INITIATOR.RESPONSE message.

Figure 7 Send INITIATOR.REQUEST and Receive INITIATOR.RESPONSE

 

Figure 8 Send Async Request

Figure 9 RESPONDER AsynchronousRequestResoponse Process

 

Copyright © TIBCO Software Inc. All Rights Reserved