Tutorials for Trading Partner Integration

Introduction

This topic introduces the trading partner integration tutorials and describes the setup steps required before starting the tutorials. It contains the following sections:

• About the Tutorials for Trading Partner Integration
• Before You Begin
• Setting Up the Tutorials
• Next Steps

 

---

About the Tutorials for Trading Partner Integration

This document provides the following tutorials:

Table 1-1 Tutorials in This Document 

Tutorial	Description	Business Protocol
Tutorial: Building ebXML Solutions	Describes how to build the ebXML (Electronic Business using eXtensible Markup Language) business process examples.	http://www.ebXML.org
Tutorial: Building RosettaNet Solutions	Describes the components of two completed RosettaNet examples (PIP3B2 and PIP3A4) and suggests how to adapt the examples for other PIP implementations.	http://www.rosettanet.org

 

These are standalone tutorials. You can complete both tutorials, if you want, but you can also complete just the ebXML tutorial without the RosettaNet tutorial, and vice versa.

 

---

Before You Begin

Before you begin using the trading partner integration tutorials:

• You must have WebLogic Platform 8.1 installed on your system. For more information, see Installing WebLogic Platform, which is available at http://download.oracle.com/docs/cd/E13196_01/platform/docs81/install/index.html.
• It is recommended that you complete the following tutorials so that you know how to build business processes and create data transformations in WebLogic Workshop:
• Tutorial: Building Your First Business Process, which is available at http://download.oracle.com/docs/cd/E13226_01/workshop/docs81/doc/en/integration/tutorial/tutWLIProcessIntro.html
• Tutorial: Building Your First Data Transformation, which is available at http://download.oracle.com/docs/cd/E13226_01/workshop/docs81/doc/en/integration/dttutorial/tutWLIDataTransIntro.html
• You should be familiar with basic trading partner integration concepts, as described in Introducing Trading Partner Integration, which is available at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/tpintro/index.html.
• You should first create the tptutorial domain and install the tutorial files, as described in Setting Up the Tutorials.

 

---

Setting Up the Tutorials

Before you start using the trading partner integration tutorials, you need to complete the following steps:

• Step 1: Create a New WebLogic Integration Domain
• Step 2: View the Default Trading Partner Information
• Step 3: Install the Tutorial Files

Step 1: Create a New WebLogic Integration Domain

The trading partner integration tutorials require a WebLogic Integration domain that you must create using the BEA WebLogic Platform Configuration Wizard. The domain name used in this document is tptutorial, but you can use any valid domain name you want.

Note: You can also use an existing WebLogic Integration for these tutorials. However, creating a new, separate domain ensures that the required default trading partner configuration is available for use with the tutorials.

To create a new WebLogic Integration domain:

Start the Configuration Wizard:
• Windows: From the Start menu, choose Programs—>BEA WebLogic Platform—>Configuration Wizard.
• Unix: Open a command shell, change to the /common/bin subdirectory of the product installation directory (such as /bea/weblogic81/common/bin), and enter the following command: sh config.sh.

The Configuration Wizard starts and displays the initial screen.




 

In the Configuration Wizard, make the following selections in each screen, and then click the Next button to continue:

Note: These instructions assume mostly default selections. For more information about advanced configuration options, see the Configuration Wizard online help.

Table 1-2 Selections in the Configuration Wizard 

Screen Name	Recommended Selection
Create or Extend a Configuration	Create a new WebLogic configuration (default)
Select a Configuration Template	Basic WebLogic Integration Domain (from the list of WebLogic configuration templates).
Choose Express or Custom Configuration	Express (default)
Configure Administrative Username and Password	Specify the administrator password (required) and change defaults as needed.
Configure Server Start Mode and Java SDK	Startup Mode: Development Mode (default) Java SDK Selection: Sun SDK (default)
Create WebLogic Configuration	For Configuration Name, specify tptutorial or another name that you want to use for this domain.


 
Click the Create button.

By default, the Configuration Wizard creates the new domain in BEA_HOME\user_projects\domains\domainName, where:

• BEA_HOME is the BEA home directory (such as c:\bea).
• domainName is the name of the domain you created (such as tptutorial).
On the Creating Configuration screen, select (click) Start Admin Server.
Click the Done button.

Step 2: View the Default Trading Partner Information

When you create a new WebLogic Integration domain using the Configuration Wizard, the Configuration Wizard automatically populates the Trading Partner Management (TPM) repository with default trading partners and protocol bindings. The trading partner integration tutorials use this default configuration. To learn more about the TPM repository, see Trading Partner Management (available at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/manage/tpm.html) in Managing WebLogic Integration Solutions.

By default, BEA WebLogic Integration runs in Test (development) mode, which allows you to use the default protocol bindings and to run business processes from separate trading partners on the same machine (collocated). In a production environment, each trading partner would run its respective business process on its own separate BEA WebLogic Integration server, service profiles would need to be explicitly configured, both trading partners would need to be enabled, and the service profile would need to be enabled. For more information about the Test and Production modes, see "Configuring the Mode and Message Tracking" in Trading Partner Management (available at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/manage/tpm.html) in Managing WebLogic Integration Solutions.

Default Trading Partners

The WebLogic Integration domain provides two preconfigured trading partners for development and testing:

Table 1-3 Default Trading Partner Configuration in WebLogic Integration Domain 

Trading Partner Name	Trading Partner ID	Description
Test_TradingPartner_1	000000001	Default local trading partner. In the tutorials, this trading partner is usually the initiator of conversations. In the absence of specific trading partner information, the default trading partner is designated as the trading partner used for sending or receiving messages for the local host system
Test_TradingPartner_2	000000002	In the tutorials, this trading partner is usually the participant in conversations.

 

Default Protocol Bindings

Each default trading partner comes with the following preconfigured protocol bindings:

• ebXML 1.0
• ebXML 2.0
• RosettaNet Implementation FrameWork (RNIF) 1.1
• RNIF 2.0

Each protocol binding (except ebXML 1.0) is marked as default. At run-time, the default binding can be used automatically in the absence of specific protocol information.

Viewing Trading Partner Information (Optional)

You view and update the contents of the TPM repository using the WebLogic Integration Administration Console. If you want, you can use the WebLogic Integration Administration Console to browse the preconfigured settings in the TPM repository. The trading partner integration tutorials use the preconfigured settings, so no changes to the TPM repository are required unless otherwise stated in the tutorials.

Note: If you make any changes to the preconfigured settings in the TPM repository, you should adjust the instructions in the tutorials accordingly. For configuration instructions, see Trading Partner Management (available at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/manage/tpm.html) in Managing WebLogic Integration Solutions.

To view the default trading partner information:

Start the WebLogic Integration Administration Console by doing either of the following:
• From the Start menu, choose Programs—>BEA WebLogic Platform—>Examples—>WebLogic Integration—>Integration Admin Console.
• In a browser, enter the following URL: http://localhost:7001/wliconsole.
When prompted, specify the username and password.

The WebLogic Integration Administration Console displays the home page.




 

Note: If you want more information about a particular screen in the WebLogic Integration Administration Console, click the Help icon.

Select the Trading Partner Management module to see the Trading Partner Management home page.




 
On the Trading Partner Management home page, select the Profile Management module to see the profiles for the preconfigured trading partners.




 
From the left panel, select Bindings, select Test_TradingPartner_1, and click the Go button to see the preconfigured bindings for the default trading partner.

 




 

Note: By default, trading partner endpoints are configured to listen on localhost:7001. If you configured WebLogic Server to listen on a different port, adjust the trading partner binding information accordingly.

Step 3: Install the Tutorial Files

The documentation and example files for the trading partner integration tutorials are distributed in an archive file (tptutorial.zip) that you obtain from BEA's dev2dev Online site. This archive file contains the completed ebXML and RosettaNet applications used in the tutorials, as well as schema files and sample XML files.

To install the files for the trading partner integration tutorials:

Download the tptutorial.zip file from the WebLogic Integration 8.1 page at the following URL:

http://dev2dev.bea.com/codelibrary/code/tptutorial.jsp

Extract the contents of the tptutorial.zip file (using folder names) to a local directory. The extracted files have the following directory structure:

Table 1-4 Contents of tptutorial.zip 

Folder / File	Description
tptutorialapps\tptutorial.pdf	Documentation for the trading partner integration tutorials.
tptutorialapps\ebxml	Completed application that you can refer to if you encounter difficulties while building the business processes during the ebXML tutorial. Also contains schema files and sample XML data files.
tptutorialapps\rosettanet	Application containing example implementations of PIPs 3B2 and 3A4.


 

 

---

Next Steps

After you have set up the tutorial domain and extracted the tutorial files, you can begin using the following tutorials:

• Tutorial: Building ebXML Solutions
• Tutorial: Building RosettaNet Solutions

Both tutorials use the same WebLogic Integration domain that you created in Setting Up the Tutorials. These are standalone tutorials. You can complete both tutorials, if you want, but you can also complete just the ebXML tutorial without the RosettaNet tutorial, and vice versa.