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


Chapter 2 Tutorials — Getting Started : TEXT_DATA Tutorial

TEXT_DATA Tutorial
This section steps you through the activities you need to perform to configure the host and trading partner on the Initiator machine for the TEXT_DATA tutorial.
As explained before, this tutorial is run on a single (Initiator) machine and when the POINBOUNDARV transaction is sent to the trading partner, the transport properties are defined to store the request in a directory on the local file system.
To proceed with the tutorial, perform the following steps:
Set Up a Host for TEXT Protocol
If this is the first time you are configuring a host on this machine after installing EDI protocols, follow the following steps:
1.
2.
3.
Start Creating a New Host
To create and set up the default host, perform the following steps:
1.
Using TIBCO Administrator, select BusinessConnect > Participants.
2.
Click the New button in the right panel.
3.
Type Company1 in the Name field.
4.
Select Host from the Type list.
5.
Click OK.
6.
Click Apply.
Enable the TEXT Protocol for the New Host
All EDI protocols are enabled by default after installation. In order to configure and activate any of the protocols, you must disable all other unconfigured protocols. Once the protocols are configured, they can be enabled or disabled at any time: this procedure is needed only when configuring protocols for the first time.
1.
a.
b.
Click Disable.
If protocols have not been enabled:
a.
Click Enable.
b.
Set the Domain Identity for the Host
1.
Click the TEXT link.
2.
In the Edit Enabled Protocol dialog, click the Add New link next to the Default Domain Identity field.
3.
4.
From the Domain list, select 01.
5.
In the Identity field, type a name, such as 123456789.
6.
Click Save.
7.
8.
9.
Click Save.
Activate the Host
1.
Select BusinessConnect > Participants again.
Verify that the host, Company 1, has the Domain Identity you defined in the step Set the Domain Identity for the Host: (01)123456789.
2.
Click on the Company1 link.
3.
4.
Click Save.
5.
Select BusinessConnect > System Settings > General and verify that Company1 is selected as the default host.
Set Up a Partner for the TEXT Protocol
The trading partner setup consists of the following steps:
Create a Partner
If you already have set up a Responder trading partner Company2, continue to the section Enable the TEXT Protocol.
To set up the Responder trading partner, perform the following steps:
1.
Click the BusinessConnect > Participants link in the left panel.
2.
Click the New button in the right panel.
3.
Type Company2 in the Name field.
4.
Select Partner from the Type list.
5.
6.
Select the Active check box.
7.
Click Save. The new partner Company2 appears on the Participants list, with no identity defined.
Enable the TEXT Protocol
1.
2.
Click the Protocols tab.
3.
Click Enable.
4.
Select the TEXT check box.
5.
Set the Domain Identity
1.
Click the TEXT link.
2.
Click the Add New link next to the Default Domain Identity field.
3.
Click the Add New button.
4.
From the Domain list, select 01.
5.
In the Identity field, type 987654321.
6.
Click Save.
7.
8.
From the Default Domain Identity list, select 01-987654321.
9.
Click Save.
Set the Transport
To set the transport:
1.
Click the TEXT link.
2.
Click the Transports tab.
3.
Click Add.
4.
Provide the transport name as FILE and select FILE from the Type list.
5.
6.
In the URL field, type C:/testEDI/out.
7.
Click Save three times.
Configure the Business Agreement for the TEXT Protocol
1.
Click the BusinessConnect > Business Agreements link in the left panel.
2.
Click the New button in the right panel.
3.
Select the Company1 radio button in the Host Party area and the Company2 radio button in the Partner Party area.
4.
5.
Click the Add Protocol Binding button.
6.
Select the TEXT check box.
7.
8.
Click the TEXT link.
9.
Click the Transports tab.
10.
Make sure that FILE is selected in the Primary Transport list in the Outbound Transports for Host ‘Company1’ area.
11.
Click Save twice.
The new agreement between Company1 and Company2 with the enabled protocol TEXT appears.
Set Up the Initiator Server for the TEXT_DATA Tutorial
The Initiator server must be set up to communicate with its trading partners. To do so, follow the following steps:
Create the deployment configuration. See TIBCO BusinessConnect Interior Server Administration for information on deployment configurations.
Configuring the Private Process for the TEXT_DATA Tutorial
This section describes how to configure private processes in the following ways:
Configuring Private Processes in TIBCO Designer
To configure private processes in TIBCO Designer:
1.
2.
Opening the TIBCO ActiveMatrix BusinessWorks Project
To open one of the sample projects:
1.
2.
3.
Select Project > Import Full Project.
4.
Click the ZIP Archive tab.
5.
Navigate to BC_HOME\protocols\tibedi\samples\bw\TEXT_Data.
6.
Select Text_Data.zip and click Open.
7.
Click OK.
The Import - Options dialog appears.
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\TEXT_Data.
12.
13.
14.
Figure 4 Text_DATA project
15.
Click the Global Variables tab.
16.
Set BCHome to your TIBCO BusinessConnect installation directory.
17.
Configuring Connection to BusinessConnect
To configure connections to BusinessConnect, perform the following steps:
1.
2.
Expand the Text_Data folder.
3.
4.
Click the BusinessConnect Server Access tab.
a.
b.
c.
d.
Click the Apply button.
5.
Click the Configuration tab.
6.
Click the Update from Configuration Store button. If you chose TIBCO Rendezvous as the transport for private communication, the software displays a TIBCO Rendezvous tab.
7.
Select TEXT from the Protocol Name list.
8.
Click the Import Selected Business Protocol button.
ActiveMatrix BusinessWorks retrieves schema information from the BusinessConnect configuration store and puts it in the project folder.
9.
Click Apply and Save.
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/TEXT_Data directory, and select the Text_Data_for_bw6.zip file. Click Open.
5.
Click Finish.
After importing the sample, you also need to perform the following steps:
1.
Expand Text_Data > Module Descriptors in the Project Explorer view.
2.
Double-click Module Properties.
3.
Configuring Connections to TIBCO BusinessConnect
To configure connections to TIBCO BusinessConnect:
1.
In the Project Explorer view, expand Resources and double-click BCServerConfigTEXT.bcResource.
2.
Click the Server Access tab.
3.
4.
Click the Configuration tab, and click Update from Configuration Store.
5.
Select TEXT 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.
Run the TEXT_DATA Tutorial
To run the tutorial, follow the following steps:
1.
2.
3.
Set the Input Data
1.
Expand the TEXT_Data > EDI Outbound folder.
2.
3.
BCHOME: BC_HOME (such as C:\tibco\bc\x.x)
DataFile: POINBOUNDARV.xml
TPName: Company2
4.
Send Outbound EDI-TEXT Message
The Send EDI-TEXT Message process is shown in Figure 5.
Figure 5 Send EDI-TEXT Message
This process performs the following operations:
1.
2.
To run the process:
1.
Click the Tester tab.
2.
Click Start testing viewed process .
Figure 6 Select Process to Load
3.
Select the check box next to Send EDI-TEXT Message in the EDI Outbound folder.
4.
Click Load Selected.
5.
Select the Send TEXT Message process in the Jobs list.
6.
If everything was configured and run properly, you will get the result shown in Figure 7, TEXT Transaction, Read from a File.
Figure 7 TEXT Transaction, Read from a File
Expected Results
Once the TEXT is received by TIBCO BusinessConnect EDI Protocol powered by Instream:
1.
2.
What you can observe:
The directory c:\testEDI\out should contain a file which contains the that was sent to the trading partner by TIBCO BusinessConnect EDI Protocol powered by Instream.
See Viewing the Audit Log.
Viewing the Audit Log
To view the audit log on the Initiator machine, perform the following steps:
1.
Using TIBCO Administrator, click the BusinessConnect > Log Viewer link in the left panel.
2.
Click the TEXT link in the right panel.
3.
Select items from the following lists: Status, Connection, and Date Range.
4.
Click Search.
Figure 8 Search Audit Logs for TEXT
5.
Click the Details icon in the Search Results area for a specific operation to view details of the transaction.
Figure 9 Transaction Details
6.
Figure 10 RECEIVED_FROM_PP
 

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