Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Tutorial — Getting Started : Configuring Private Processes

Configuring Private Processes
TIBCO BusinessConnect EDI Protocol powered by Instream contains an example TIBCO ActiveMatrix BusinessWorks project which sends a UN/EDIFACT ORDERS message to TIBCO BusinessConnect.
This section contains the following parts:
Processes Overview
Process names are different in TIBCO Designer and TIBCO Business Studio. For example, the Receive CONTRL Acknowledgement process in TIBCO Designer equals the Receive_CONTRL_Acknowledgement process in TIBCO Business Studio. The following description takes processes in TIBCO Designer as an example.
The EDIFACT-ORDERS project contains several processes in two folders:
EDIFACT Message Processes   This folder contains the following processes:
Receive CONTRL Acknowledgement  If you are actually communicating with a trading partner in this tutorial, when the trading partner received the ORDERS message it returns a CONTRL acknowledgment.
TIBCO BusinessConnect receives the CONTRL, validates it, and converts it to XML.
TIBCO BusinessConnect publishes a ResponderRequest message containing the XML document. In TIBCO ActiveMatrix BusinessWorks, the Receive CONTRL Acknowledgement process receives a CONTRL message in the form of XML data, and then extracts and logs the status of the original ORDERS message.
Send ORDERS to BC  This process reads a file containing the XML equivalent of a ORDERS message and sends the XML data to TIBCO BusinessConnect.
Error Advisory Processes   This folder contains processes which are activated if TIBCO BusinessConnect sends any advisory messages during the processing of the ORDERS messages. The Error Advisory Processes folder contains the following processes:
Ack Timeout Error Advisory Received  This process is activated when TIBCO BusinessConnect sends a timeout advisory due to not receiving a CONTRL message for the original ORDERS message within the default timeout period of 1440 minutes (24 hours).
General Error Advisory Received  This process is activated when TIBCO BusinessConnect sends a general error advisory. There are several conditions which cause this advisory to be sent. For example, it is sent when an invalid message has been sent from TIBCO ActiveMatrix BusinessWorks to TIBCO BusinessConnect.
For more information on when TIBCO BusinessConnect sends a general error advisory, see TIBCO BusinessConnect EDI Protocol powered by Instream, User’s Guide, Chapter 8, "Private Messages."
Validation Error Advisory Received  This process is activated when TIBCO BusinessConnect sends an advisory indicating that there was a validation error on the original ORDERS message.
Configuring Private Processes in TIBCO Designer
To configure private processes in TIBCO Designer:
1.
2.
Opening the TIBCO ActiveMatrix BusinessWorks Project
To open the sample project:
1.
2.
3.
Select Project > Import Full Project.
4.
Click the ZIP Archive tab.
5.
Navigate to BC_HOME\protocols\tibedi\samples\bw\EDIFACT_ORDERS.
6.
Select EDIFACT_ORDERS.zip and click Open.
7.
Click OK.
The Import - Options dialog is displayed.
8.
In the Options tab, select the Try rename in case of name conflict radio button.
9.
Click Apply.
10.
Select Project > Save As.
11.
In the Project Directory file chooser, navigate to BC_HOME\protocols\tibedi\samples\bw\EDIFACT_ORDERS.
12.
13.
14.
Figure 5 TIBCO ActiveMatrix BusinessWorks Project
15.
Click the Global Variables tab.
16.
Set BCHome to your TIBCO BusinessConnect installation directory and make sure that the TPName variable is defined as “Company2”.
17.
Configuring Connections to TIBCO BusinessConnect
To configure connections to TIBCO BusinessConnect:
1.
Click the Project tab.
2.
Expand the BCServerConnection folder and double-click BCServerConfig.
3.
Select the BusinessConnect Server Access tab.
a.
b.
c.
d.
Click Apply.
4.
Click the Configuration tab.
5.
Click Update from Configuration Store.
If you chose TIBCO Rendezvous as the transport for private communication, the software displays a TIBCO Rendezvous tab.
6.
Select EDIFACT from the Protocol Name list.
7.
Click the Import Selected Business Protocol button.
TIBCO ActiveMatrix BusinessWorks retrieves schema information from the TIBCO BusinessConnect configuration store and puts it in the BCSchemas project folder.
Figure 6 BusinessConnect Server Access
8.
Click Apply.
9.
Configuring Private Processes in TIBCO Business Studio
To configure a private process in TIBCO Business Studio:
1.
2.
Opening the TIBCO ActiveMatrix BusinessWorks Project
To open the TIBCO ActiveMatrix BusinessWorks project in TIBCO Business Studio:
1.
2.
Click File > Import.
3.
On the Import page, expand the General folder and select Existing Studio Projects into Workspace. Click Next.
4.
Click Browse next to the Select archive file field to navigate to the BC_HOME/protocols/tibedi/samples/bw/EDIFACT_ORDERS directory, and select the EDIFACT_ORDERS_for_bw6.zip file. Click Open.
5.
Click Finish.
After importing the sample, you also need to perform the following steps:
1.
Expand EDIFACT_ORDERS > Module Descriptors in the Project Explorer view.
2.
Double-click Module Properties.
3.
Change the default values of the BCHome and TPName properties according to your environment.
Configuring Connections to TIBCO BusinessConnect
To configure connections to TIBCO BusinessConnect:
1.
In the Project Explorer view, expand Resources and double-click BCConnection.bcResource.
2.
Click the Server Access tab.
3.
4.
Click the Configuration tab, and click Update from Configuration Store.
5.
Select EDIFACT from the Protocol Name list.
If you select the Select Operations check box, you can 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, TIBCO ActiveMatrix BusinessWorks retrieves information from the TIBCO BusinessConnect configuration store and puts them in the project folder.
7.
Click Save.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved