Skip navigation.

eDocs Home > BEA WebLogic Integration 8.5 Documentation > Tutorials for Trading Partner Integration > Introduction

Tutorials for Trading Partner Integration

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents Index View as PDF   Get Adobe Reader

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

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:

 

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

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:

  1. Start the Configuration Wizard:

    2. The Configuration Wizard starts and displays the initial screen.


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

    3. 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.


     
  3. Click the Create button.

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

  4. On the Creating Configuration screen, select (click) Start Admin Server.
  5. 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, 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 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:

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:

  1. Start the WebLogic Integration Administration Console by doing either of the following:
  2. When prompted, specify the username and password.

    3. 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.

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


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


    5.  
  5. 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.


    6.  


     

    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:

  1. Download the tptutorial.zip file from the WebLogic Integration 8.1 page at the following URL:
    2. http://dev2dev.bea.com/codelibrary/code/tptutorial.jsp
  2. Extract the contents of the tptutorial.zip file (using folder names) to a local directory. The extracted files have the following directory structure:

    3. 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:

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.

 

Skip navigation bar  Back to Top Previous Next