Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

What's New in This Guide for Release 11.1.1.6.x

Part I Introduction to Oracle B2B

1 Introduction to Oracle B2B

• 1.1 Oracle B2B and Business-to-Business E-Commerce
• 1.2 Protocols Supported in Oracle B2B
• 1.3 Oracle B2B Metadata
• 1.4 Security Features of Oracle B2B
  • 1.4.1 Payload Obfuscation
  • 1.4.2 Restricting Access to Document Types
• 1.5 How Does Oracle B2B Fit into a SOA Implementation?
• 1.6 Sending a Purchase Order: An Example of a SOA Implementation
• 1.7 Oracle B2B Samples and Cookbooks
• 1.8 Administering Oracle B2B in the Oracle Fusion Middleware Environment

2 Getting Started with Oracle B2B

• 2.1 What You Need to Get Started with Oracle B2B
• 2.2 Logging in to Oracle B2B
  • 2.2.1 Finding Port Information
  • 2.2.2 Accessing Oracle B2B Through Single Sign-On (SSO)
  • 2.2.3 Enabling the weblogic User for Logging in to Oracle B2B
• 2.3 Using the Oracle B2B Interface
  • 2.3.1 Administration
  • 2.3.2 Partners
  • 2.3.3 Reports
  • 2.3.4 Metrics
• 2.4 Creating a B2B Transaction: An Overview of the Process Flow
• 2.5 Using Oracle B2B in the Oracle JDeveloper Environment
  • 2.5.1 How To Use B2B Binding Components in a SOA Composite Application
  • 2.5.2 About Using the JMS Integration Type in the B2B Configuration Wizard
  • 2.5.3 The B2BX12OrderGateway Composite in the Fusion Order Demo
• 2.6 What You May Need To Know About Using Oracle B2B
  • 2.6.1 Enabling Debug Mode at Run Time
  • 2.6.2 Logging Out: SSO Logout Configuration for Oracle Access Manager

Part II Oracle B2B Process Flow

3 Creating Guideline Files

• 3.1 Introduction to Oracle B2B Document Editor
• 3.2 Installing Oracle B2B Document Editor
• 3.3 Creating Guideline Files: EDIFACT D98 Example

4 Creating Document Definitions

• 4.1 Introduction to Document Protocols
  • 4.1.1 The Document Hierarchy
  • 4.1.2 Document Protocols with Acknowledgments
• 4.2 Creating Document Definitions
• 4.3 Deleting a Document Definition

5 Configuring Trading Partners

• 5.1 Introduction to Trading Partners
• 5.2 Creating Trading Partner Profiles
• 5.3 Adding Trading Partner Users
• 5.4 Adding Document Definitions
• 5.5 Configuring Channels
  • 5.5.1 About MLLP
    • 5.5.1.1 Overriding the Connection Mode
    • 5.5.1.2 Generic Support for TCP
    • 5.5.1.3 Dynamic Endpoints
    • 5.5.1.4 Using a Transport Callout to Extract Custom Headers
  • 5.5.2 Message Sequencing
    • 5.5.2.1 Outbound Message Sequencing
    • 5.5.2.2 Inbound Message Sequencing
    • 5.5.2.3 Sequencing Without Dispatching
    • 5.5.2.4 Troubleshooting Message Sequencing
  • 5.5.3 Using Transport Sync Callback
  • 5.5.4 Correlating Messages Using JMS Queues
  • 5.5.5 Configuring Delivery Retry Options
    • 5.5.5.1 Delivery Retry at the Channel Level
    • 5.5.5.2 Delivery Retry at the Document Level
• 5.6 Using the Auto Create Agreement Feature
• 5.7 Using Identifiers for Trading Partner Lookup
• 5.8 Scheduling Trading Partner Downtime
• 5.9 Broadcasting Messages to Multiple Trading Partners
• 5.10 Validating Certificate in Inbound Message Processing

6 Creating and Deploying Trading Partner Agreements

• 6.1 Introduction to Agreements
• 6.2 Creating an Agreement
• 6.3 Deploying an Agreement
  • 6.3.1 Redeploying an Agreement
• 6.4 Deleting and Exporting Agreements

Part III Oracle B2B Administration

7 Importing and Exporting Data

• 7.1 Importing and Exporting the Design-Time Repository
• 7.2 What Is Copied When You Import or Export from the Import/Export Tab
• 7.3 About the Exported File
  • 7.3.1 Exported ZIP Files Containing Agreement Names in Multibyte Character Languages

8 Using Document Protocols

• 8.1 Using the Custom Document Protocol
  • 8.1.1 How to Configure the XPath Expression for a Custom XML Document
    • 8.1.1.1 Option 1: Specify the XPath and the Matching Value
    • 8.1.1.2 Option 2: Check for the Existence of a Node
    • 8.1.1.3 Option 3: Check the Value of an Attribute
• 8.2 Using the EDI EDIFACT Document Protocol
• 8.3 Using the EDI X12 Document Protocol
• 8.4 Using the HL7 Document Protocol
• 8.5 Using the OAG Document Protocol
• 8.6 Using the Positional Flat File Document Protocol
• 8.7 Using the RosettaNet Document Protocol
  • 8.7.1 PIPs
  • 8.7.2 RosettaNet Validation
• 8.8 Using the UCCNet Document Protocol
  • 8.8.1 Creating a 1Sync Document
• 8.9 Changing Document Details
  • 8.9.1 Changing Document Definitions After Deploying an Agreement
  • 8.9.2 Changing Document Definitions After Importing Metadata
• 8.10 Using Document Routing IDs

9 Managing Deployments

• 9.1 Introduction to Agreement Deployment States
• 9.2 Managing Deployed Agreements
  • 9.2.1 Searching for Deployed Agreements
  • 9.2.2 Changing the Deployment State
  • 9.2.3 Exporting an Active Agreement

10 Creating Types

• 10.1 Creating Custom Identifier Types
• 10.2 Creating Custom Contact Information Types
• 10.3 Creating Custom Trading Partner Parameter Types

11 Batching EDI Messages

• 11.1 Setting Up a Batch
• 11.2 Managing Batched Messages

12 Scheduling Trading Partner Downtime

• 12.1 Introduction to Scheduling Trading Partner Downtime
• 12.2 Scheduling Trading Partner Downtime
• 12.3 Deleting Scheduled Downtime
• 12.4 Extending Trading Partner Downtime
  • 12.4.1 Overlapping Schedules
  • 12.4.2 Using the Extend Option

13 Managing Callouts

• 13.1 Introduction to Callouts
  • 13.1.1 Transport Callouts
  • 13.1.2 Creating a Callout Library JAR File
• 13.2 Creating a Callout
• 13.3 Including a Callout in an Agreement
• 13.4 Implementing a Callout

14 Using Maps

• 14.1 Introduction to Mapping
  • 14.1.1 About Mapsets
  • 14.1.2 Predefined and Custom Mapsets
• 14.2 Using Mapsets in the Oracle B2B Console
  • 14.2.1 Creating a Mapset in the Oracle B2B Console
  • 14.2.2 Associating a Mapset with a Trading Partner Agreement
  • 14.2.3 Deleting a Mapset in the Oracle B2B Console
• 14.3 Using Oracle MapBuilder to Create Prebuilt Maps

15 Purging Data

• 15.1 Purging Design Metadata and Instance Data

16 Configuring Listening Channels

• 16.1 Adding a Listening Channel and Protocol
• 16.2 Using Transport Protocols
• 16.3 Adding Listening Channel Details
  • 16.3.1 Transport Protocol Parameters
  • 16.3.2 Channel Attributes
  • 16.3.3 Exchange Protocol Parameters
  • 16.3.4 Security Parameters
• 16.4 Configuring a Listening Channel
• 16.5 Configuring Document Sequencing

17 Configuring B2B System Parameters

• 17.1 Setting Configuration Parameters

Part IV Reports and Metrics

18 Creating Reports

• 18.1 Introduction to Reports
  • 18.1.1 The Monitor User Role
  • 18.1.2 Purging Messages
  • 18.1.3 Resubmitting Messages from Oracle B2B
• 18.2 Creating Business Message Reports
• 18.3 Creating Wire Message Reports
• 18.4 Creating Application Message Reports
• 18.5 Creating Error Reports
• 18.6 Creating Conversation Reports

19 Using B2B Metrics

• 19.1 Introduction to B2B Metrics
• 19.2 B2B System Metrics
• 19.3 B2B Partner Metrics

Part V Scripts and Utilities

20 B2B Command-Line Tools

• 20.1 Prerequisites for Running the Command-line Tools
• 20.2 Archiving Data
• 20.3 Purging Data
• 20.4 Importing Data
• 20.5 Exporting Data
• 20.6 Batching Operations
• 20.7 Resetting Channel Passwords
• 20.8 Activating or Deactivating Listening Channels
• 20.9 Deploying Agreements
• 20.10 Validating B2B Metadata
• 20.11 Using the ebXML CPP/CPA Utilities
  • 20.11.1 Creating CPP/CPA Properties Templates
    • 20.11.1.1 Properties of cpp_cpa.properties
  • 20.11.2 CPP/CPA Import
  • 20.11.3 CPP/CPA Export
• 20.12 Verifying Agreement Availability
• 20.13 Creating Oracle B2B Metadata Based on selfservice.xsd
  • 20.13.1 Using Selfservice to Batch Create Document Protocols, Trading Partners, and Agreements
  • 20.13.2 Using Self Service Samples
• 20.14 Resubmitting a Message
• 20.15 Resubmitting Messages Based on the Protocol Message ID
• 20.16 Scheduling Trading Partner Downtime
• 20.17 Managing the Keystore
• 20.18 Updating the Keystore
• 20.19 Errors During Import

21 Using the Oracle B2B Web Services

• 21.1 Introduction to Oracle B2B Web Services
• 21.2 Using the Outbound Web Service
• 21.3 Using the Translation Web Service
  • 21.3.1 XMLToNativeService
    • 21.3.1.1 Complete Envelope
    • 21.3.1.2 Transaction Set Alone
  • 21.3.2 NativeToXMLService
    • 21.3.2.1 Complete Envelope
    • 21.3.2.2 Transaction Set Alone
• 21.4 Using the Query API
  • 21.4.1 Is Trading Partner Agreement Setup Parameters
  • 21.4.2 Get Trading Partner Agreement Information Parameters
• 21.5 Securing Oracle B2B Web Services

22 Scripts for Archiving and Restoring Data

• 22.1 Introduction to Archiving and Restoring B2B Business Messages
• 22.2 Archiving B2B Business Messages
• 22.3 Restoring B2B Business Messages

23 Utilities for Enqueuing and Dequeuing

• 23.1 AQ Enqueue and Dequeue Utilities
  • 23.1.1 AQ Enqueue
  • 23.1.2 AQ Dequeue
• 23.2 JMS Enqueue and Dequeue Utilities
  • 23.2.1 JMS Enqueue
  • 23.2.2 Enqueue—Using a JMS JCA Adapter or Custom Utilities
  • 23.2.3 JMS Dequeue
• 23.3 Using the attachmentsDescriptor.xsd

24 Monitoring Instance Message Data With Oracle BAM

• 24.1 Introduction to Monitoring Oracle B2B with Oracle BAM
• 24.2 Creating a Data Source in Oracle WebLogic Server
• 24.3 Creating a Foreign JMS Server
• 24.4 Create a B2B Data Object using Oracle BAM Architect
• 24.5 Define a JMS Message Source Using an Oracle BAM Enterprise Message Source
• 24.6 Mapping Oracle B2B Instance Messages to Oracle BAM Data Objects
• 24.7 Creating a Dashboard to Monitor Oracle B2B
• 24.8 Enabling the Oracle BAM Integration in Oracle B2B

25 Programmatically Accessing Instance Message Data

• 25.1 Programmatically Accessing Instance Message Data
• 25.2 Instance Message Java API Examples
• 25.3 Troubleshooting Instance Message Java API
  • 25.3.1 Handling a Large Number of Messages
  • 25.3.2 Handing Large Payloads
  • 25.3.3 Executing Queries Remotely Using Weblogic.jar

Part VI Appendixes

A Handling Large Payloads

• A.1 Handling Large Payloads
  • A.1.1 Introduction to Large Payload Support
  • A.1.2 Large Payloads and 32-Bit Windows PCs
  • A.1.3 Settings for a Large Dataset Scenario

B Synchronous Request/Reply Support

• B.1 Introduction
• B.2 Configuring Sender
  • B.2.1 Configuring Oracle JDeveloper
  • B.2.2 Configuring Oracle B2B
• B.3 Configuring Receiver
  • B.3.1 Configuring Oracle JDeveloper
  • B.3.2 Configuring Oracle B2B
• B.4 Resubmitting Messages

C Setting B2B Configuration Properties in Fusion Middleware Control

• C.1 Properties To Set in Fusion Middleware Control
• C.2 Using the configmbeanutil Utility

D Back-End Applications Interface

• D.1 Mapping B2B IP_MESSAGE_TYPE to SCA Normalized Message Properties
• D.2 Normalized Message Properties

E Sequence Message Management

• E.1 Why Do You Need to Manage Sequenced Messages
• E.2 ANT Commands and Public APIs

F Setting Up B2B Communication By Using Remote JNDI Queue

• F.1 Configuring B2B Communication By Using Foreign JNDI
  • F.1.1 Creating a Target JMS Server, Module, and Queue
  • F.1.2 Setting Up an Environment to Connect to the JMS queue

G Exception Handling

• G.1 Inbound Messages
  • G.1.1 Request or Response Messages
    • G.1.1.1 Inbound ebMS, AS1, and AS2 Messages
  • G.1.2 Acknowledgment Messages
  • G.1.3 Exception Messages
• G.2 Outbound Messages
• G.3 Using a JMS Queue for Error Message Delivery
• G.4 Using a Custom Exception Queue for Error Message Delivery
• G.5 Inbound Exception Handling Scenarios
• G.6 Exception Payload Definition

H Self Service Utility Protocols, Identifications, Security Specifications, and Parameters

• H.1 Protocols
• H.2 Identifications
• H.3 Security Specifications
• H.4 Exchange Protocols Parameter Values
• H.5 Transport Protocols Parameter Values
• H.6 Document Protocol Parameter Values

Index