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


Chapter 2 Tutorials — Getting Started : TEXT_to_EDI Tutorials

TEXT_to_EDI Tutorials
This section steps you through the activities you need to perform to configure the host and trading partner on the Initiator machine.
As explained before, this tutorial is run on a single (Initiator) machine and when the Delimited_D99A_ORDERS (or Positional_4040_850) 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 the EDIFACT (or X12) Protocol
If this is the first time you are configuring a host on this machine after installing EDI protocols, follow the following steps:
For the EDIFACT Protocol:
See TIBCO BusinessConnect EDI Protocol powered by Instream EDIFACT Configuration, "Set Up a Host for the EDIFACT Protocol."
For the X12 Protocol:
See TIBCO BusinessConnect EDI Protocol powered by Instream X12 Configuration, "Setting Up a Host."
Set Up a Partner for the EDIFACT (or X12) Protocol
If this is the first time you are configuring a partner on this machine after installing EDI protocols, follow the following steps:
For the EDIFACT Protocol:
See TIBCO BusinessConnect EDI Protocol powered by Instream EDIFACT Configuration, "Set Up a Partner."
For the X12 Protocol:
See TIBCO BusinessConnect EDI Protocol powered by Instream X12 Configuration, "Setting Up a Partner."
Configure the Business Agreement for the TEXT_to_EDI Tutorial
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 and EDIFACT (or X12) check box.
7.
8.
Click the EDIFACT or X12 link, and then the Transports tab to set up the transport.
9.
Make sure that FILE is selected from the Primary Transport list in the Outbound Transports for Host ‘Company1’ area.
10.
Click Save twice.
The new agreement between Company1 and Company2 with the enabled protocol TEXT and EDIFAXCT (or X12) appears.
Set Up the Initiator Server for the TEXT_to_EDI 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 Private Processes for the TEXT_to_EDI Tutorial
This section describes how to configure private processes in the following ways:
Configuring 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\TEXT_Data.
6.
Select TEXT_to_EDI.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\TEXT_to_EDI.
12.
13.
14.
 
Figure 11 TEXT_to_EDI Project
15.
Configuring Connection to BusinessConnect
To configure connections to BusinessConnect, perform the following steps:
1.
2.
Expand the TEXT_to_EDI 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.
10.
Click the Save icon to save the project.
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_to_EDI_for_bw6.zip file. Click Open.
5.
Click Finish.
After importing the sample, you also need to perform the following steps:
1.
Expand TEXT_to_EDI > 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_to_EDI Tutorials
To run the tutorials, follow the following steps:
1.
2.
3.
Set the Input Data
1.
Expand the TEXT_to_EDI > TEXT message process folder.
2.
and press the F12 key.
3.
BCHOME: BC_HOME (such as C:\tibco\bc\x.x)
TPName: Company2
4.
Send TEXT Message (convert to EDIFACT)
The Send TEXT Message (convert to EDIFACT) process is shown in Figure 12.
Figure 12 Send TEXT Message (convert to EDIFACT)
This process performs the following operations:
1.
Reads the sample TEXT file located in BC_HOME/ /protocols/tibedi/ samples/sampleDocs/Delimited_D99A_ORDERS.dat
2.
To run the process:
1.
Click the Tester tab.
2.
Click Start testing viewed process .
3.
Figure 13 Select Process to Load
4.
Click Load & Start Current.
Expected Results
Once the TEXT is received by TIBCO BusinessConnect EDI Protocol powered by Instream:
1.
2.
What You Can Observe
After 24 hours, TIBCO BusinessConnect EDI Protocol powered by Instream will send an acknowledgment timeout error advisory to TIBCO ActiveMatrix BusinessWorks. However, for the purposes of this tutorial, it is not necessary to wait for this advisory message to arrive..
In the Input tab of the Send Request activity, certain fields cannot take effect for TEXT_to_EDI conversion: transactionID, encoding, perMessage, txnGroupingID, destinationFileName, and controlNuminfo.
Viewing the Audit Log
The audit log for this transaction will have two parts:
Audit Log for TEXT
To view the TEXT 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 14 Audit Log: TEXT
5.
Click the Details icon in the Search Results area for a specific operation to view details of the transaction, such as EDI/Outbound to check whether TEXT date has been successfully convert to EDIFACT.
Figure 15 Transaction Details: TEXT_to_EDI
6.
Click on the icon next to the specific transaction to see more details.
Figure 16 Transaction Details
Audit Log for EDIFACT
To view the EDIFACT audit log, perform the following steps:
1.
Using TIBCO Administrator, click the BusinessConnect > Log Viewer link in the left panel.
2.
Click the EDIFACT link in the right panel.
3.
Select items from the following lists: Status, Connection, and Date Range.
4.
Click Search.
Figure 17 Audit Log for EDIFACT
5.
Click the Details icon in the Search Results area for a specific operation to view details of the transaction, such as 3/D99A/ORDERS.
Figure 18 Transaction Details: EDI Document sent to the Trading Partner
Send TEXT Message (convert to X12)
The Send TEXT Message (convert to X12) process is shown in Figure 19.
Figure 19 Send TEXT Message (convert to X12)
This process performs the following operations:
1.
Reads the sample TEXT file located in BC_HOME/ /protocols/tibedi/ samples/sampleDocs/Positional_4040_850.dat
2.
To run the process:
1.
Click the Tester tab.
2.
Click Start testing viewed process .
3.
4.
Click Load & Start Current.
Expected Results
Once the TEXT is received by TIBCO BusinessConnect EDI Protocol powered by Instream:
1.
2.
What you Can Observe
After 24 hours, TIBCO BusinessConnect EDI Protocol powered by Instream will send an ack timeout error advisory to TIBCO ActiveMatrix BusinessWorks. However, for the purposes of this tutorial, it is not necessary to wait for this advisory message to arrive.
In the Input tab of the Send Request activity, certain fields cannot take effect for TEXT_to_EDI conversion: transactionID, encoding, perMessage, txnGroupingID, destinationFileName, and controlNuminfo.
Viewing the Audit Log
The audit log for this transaction will have two parts:
Audit Log for TEXT
To view the TEXT 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 20 Audit Log: TEXT
5.
Click the Details icon in the Search Results area for a specific operation to view details of the transaction, such as EDI/Outbound to check whether TEXT date has been successfully convert to X12.
Figure 21 Transaction Details: TEXT_to_EDI
6.
Figure 22 Transaction Details
Audit Log for X12
To view the X12 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 X12 link in the right panel.
3.
Select items from the following lists: Status, Connection, and Date Range.
4.
Click Search.
Figure 23 Audit Log for X12
5.
Click the Details icon in the Search Results area for a specific operation to view details of the transaction, such as 00403/004040/850.
Figure 24 Transaction Details: EDI Document sent to the Trading Partner

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