Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle B2B
11g Release 1 (11.1.1)

Part Number E10229-01
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
View PDF

2 Getting Started with Oracle B2B

Oracle B2B provides a Web-based interface for creating B2B transactions.

This chapter contains the following topics:

2.1 What You Need to Get Started with Oracle B2B

In addition to installing Oracle SOA Suite, which includes Oracle B2B, you will need to install:

Use the standards-based templates of Oracle B2B Document Editor to create guideline files. Then, using Oracle B2B, you create and deploy the transaction as part of a B2B agreement. To include the B2B transaction in a SOA composite application, use Oracle JDeveloper, as shown in Figure 2-1.

Figure 2-1 Oracle JDeveloper: A SOA Composite Application with a B2B Binding Component

Description of Figure 2-1 follows
Description of "Figure 2-1 Oracle JDeveloper: A SOA Composite Application with a B2B Binding Component"

See the following for more information:

2.2 Logging in to Oracle B2B

These instructions assume that you have installed Oracle SOA Suite, which includes Oracle B2B. See Oracle Fusion Middleware Installation Guide for Oracle SOA Suite for more information.

Use a supported Web browser:

To log in to Oracle B2B:

  1. Open a supported Web browser and go to:



    • hostname is the name of the host on which Oracle SOA Suite is installed

    • port is the port number used by the Managed Server to listen for regular HTTP (non-SSL) connections. (In a cluster environment, the port can be the router port.)

      See "Finding Port Information" for more information.


      To access Oracle B2B when SAML is enabled or in Windows Native Authentication Environments, use the following protected servlet URL for automatic authentication:
  2. On the log-in page, enter the following:

    For This Field... Do...
    Username Enter the default administrator user name.
    Password Use the administrator password from your Oracle Fusion Middleware 11g installation.

  3. Click Login.

2.2.1 Finding Port Information

You can find port number information in the following ways:

  • From Oracle WebLogic Server Administration Console

    1. Log in to the console.

    2. In the Domain Structure pane, expand Environment and click Servers.

      Weblogic Console
      Description of the illustration bb_portnums.gif

    3. Note the Listen Port column for your server.

  • From FMW_HOME/user_projects/domains/your_domain_name/config/config.xml


2.2.2 Enabling the weblogic User for Logging in to Oracle B2B

For the weblogic user in Oracle Internet Directory (OID) to log in to Oracle B2B as an administrator and search for users, the OID Authenticator must have an Administrators group, and the weblogic user must be a member of that group.

To enable the weblogic user:

  1. Create a weblogic user in OID using the LDAP browser. The users.ldif file is imported to OID as follows:

    dn: cn=weblogic,cn=Users,dc=us,dc=oracle,dc=com
    objectclass: inetorgperson
    objectclass: organizationalPerson
    objectclass: person
    objectclass: orcluser
    objectclass: orcluserV2
    objectclass: top
    sn: weblogic
    userpassword: welcome1
    uid: weblogic 
  2. Create an Administrators group in OID and assign the weblogic user to it. The groups.ldif file is imported to OID as follows:

    dn: cn=Administrators,cn=Groups,dc=us,dc=oracle,dc=com
    objectclass: groupOfUniqueNames
    objectclass: orclGroup
    objectclass: top
    owner: cn=orcladmin,cn=Users,dc=us,dc=oracle,dc=com
    uniquemember: cn=weblogic,cn=Users,dc=us,dc=oracle,dc=com

2.3 Using the Oracle B2B Interface

B2B activities are grouped as follows:

2.3.1 Administration

Use the tabs of the Administration page, shown in Figure 2-2, to manage document protocols, deployments, types, importing and exporting, batching, callouts, purging, listening channels, and configuration.

See Part III, "Oracle B2B Administration" for more information.

Figure 2-2 Administration Activities

Administration tab shows the admin activities
Description of "Figure 2-2 Administration Activities"

2.3.2 Partners

Use the tabs of the Partners page, shown in Figure 2-3, to create and update trading partner information, create and update agreement information, add user information, associate documents with trading partners, set up channels, and configure the key store.

See Part II, "Oracle B2B Process Flow" for more information.

Figure 2-3 Partner Activities

Design tab shows B2B process flow activities
Description of "Figure 2-3 Partner Activities"

2.3.3 Reports

Use the tabs of the Reports page, shown in Figure 2-4, to create and view reports about the instance (run-time) data.

See Chapter 16, "Creating Reports," for more information.

2.3.4 Metrics

Use the tabs of the Metrics page, as shown in Figure 2-5, to see information about deployed agreements, such as lists of the active document types and trading partners, and run-time status, such as error messages and message counts.

See Chapter 17, "Using B2B Metrics," for more information.

2.4 Creating a B2B Transaction: An Overview of the Process Flow

Figure 2-6 shows the B2B process flow, which starts with creating B2B guideline files in Oracle B2B Document Editor and continues with using the Oracle B2B interface to create document definitions, configure trading partners, and create and deploy agreements.

Figure 2-6 Oracle B2B Process Flow

Process flow
Description of "Figure 2-6 Oracle B2B Process Flow"

Step 1: Create guideline files (ECS and optional XSD files) in Oracle B2B Document Editor

Using Oracle B2B Document Editor, shown in Figure 2-7, create transaction documents based on templates for hundreds of industry-standard protocols. The Oracle B2B Document Editor is required only when translation is needed. For XML documents, the editor is not used.

Figure 2-7 Creating a Document in Oracle B2B Document Editor

Document editor
Description of "Figure 2-7 Creating a Document in Oracle B2B Document Editor"

For information on Oracle B2B Document Editor, see the following:

Step 2: Create document definitions

Using the Administration > Document tab of Oracle B2B, shown in Figure 2-9, select from a list of document protocols, and then provide a document protocol version name, a document type name, and a document definition name. (For a Custom document, rather than selecting from the list of document protocols, you add a custom protocol name to the list in the Document Protocols folder.)

Figure 2-9 Creating a Document Definition

Document definitions
Description of "Figure 2-9 Creating a Document Definition"

After selecting the ECS and optional XSD files you created in Step 1, you have created the document definition.

For more information, see Chapter 4, "Creating Document Definitions."

Step 3: Configure trading partners

Using the tabs of the Partners page of Oracle B2B, shown in Figure 2-10, add or update trading partner names, add identifiers and optional contact information, view parameters, add documents and delivery channels, and add key store information.

Figure 2-10 Configuring Trading Partners

Trading partner identifiers
Description of "Figure 2-10 Configuring Trading Partners"

For more information, see Chapter 5, "Configuring Trading Partners."

Step 4: Create agreements

Using the Partners > Agreement tab of Oracle B2B, shown in Figure 2-11, create an agreement that specifies the trading partners involved and associates the document definitions, channels, and identifiers with the agreement.

Figure 2-11 Creating a Trading Partner Agreement

Partner agreements
Description of "Figure 2-11 Creating a Trading Partner Agreement"

For more information, see Chapter 6, "Creating and Deploying Trading Partner Agreements."

Step 5: Deploy agreements

Using the Administration > Deploy tab of Oracle B2B, shown in Figure 2-12, search for and deploy agreements.

Figure 2-12 Searching for and Deploying Agreements

Description of Figure 2-12 follows
Description of "Figure 2-12 Searching for and Deploying Agreements"

2.5 Using Oracle B2B in the Oracle JDeveloper Environment

To include Oracle B2B in an SOA composite application, use the B2B Configuration Wizard as follows:

To access the B2B binding component:

  1. In Oracle JDeveloper, open the composite for which you want to add a B2B binding component.

  2. From the SOA > Service Adapters panel of the Component Palette, drag B2B to one of the following:

    • To the Exposed Services area when B2B is used as a service (inbound) to receive messages from trading partners and deliver them to SOA composite applications. Oracle B2B is the entry point to the SOA composite application.

    • The External References area when B2B is used as a reference (outbound) to send messages from the SOA composite application to partners.

    B2B binding component in JDeveloper
    Description of the illustration bb_jdev.gif

  3. Follow the steps in the B2B Configuration Wizard of Oracle JDeveloper.

    Select a document definition that was previously created in Oracle B2B. Or, you can launch Oracle B2B from the wizard to create a document definition.


The JMS option on the B2B Integration Type page of the B2B Configuration Wizard is in preview mode. If you want to use this option to communicate with Oracle B2B through JMS queues, start Oracle JDeveloper in preview mode as follows:
ORACLE_JDEV_HOME\jdeveloper\jdeveloper -J"-DPREVIEW_MODE=true"

2.6 What You May Need To Know About Using Oracle B2B

This section contains topics to help with troubleshooting.

2.6.1 Enabling Debug Mode at Run Time

Use Oracle Enterprise Manager 11g Fusion Middleware Control to enable logging (SOA Infrastructure > Logs > Log Configuration). See Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite for more information.

An alternative is to edit the logging.xml file at


2.6.2 Logging Out: SSO Logout Configuration for Oracle Access Manager

In web.xml, the success_url parameter of must contain an SSO logout URL, such as ../access/oblix/lang/en-us/logout.html, to ensure that the URL is accessible and does not result in a 404 error.

See Oracle Fusion Middleware Security Guidefor information about Oracle Single Sign-On and Oracle Access Manager.