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