Go to main content
1/56
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
What's New in This Guide for Release 12.2.1.1.0
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 Oracle B2B Fits 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
1.9
Accessibility Options
1.9.1
Enabling Accessibility Features in Oracle B2B
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.1.1
Create a SOA Application and Project
2.5.1.2
Add Service Components
2.5.1.3
Add a B2B Binding Component
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 runtime
2.6.2
Logging Out: SSO Logout Configuration for Oracle Access Manager
2.6.3
Clusters and B2B
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
3.3.1
Create the ECS File
3.3.2
Create the XSD File
3.3.3
Generate Data Using the ECS File
3.3.4
Analyze the Data
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.2.1
Update the Default Host Trading Partner Name
5.2.2
Add a Remote Trading Partner
5.2.3
Add Identifier Types and Values
5.2.4
Add Contact Information
5.2.5
Add a Trading Partner Parameter and Value
5.2.6
Provide Key Store Information for the Host Trading Partner
5.3
Adding Trading Partner Users
5.3.1
Create a New User in the Identity Store
5.3.2
Add a User in the Oracle B2B Interface
5.3.3
Add Document Types That the User Has Permission to Access
5.4
Adding Document Definitions
5.4.1
Add Document Definitions
5.5
Configuring Channels
5.5.1
Add a Channel
5.5.2
Provide Transport Protocol Parameters
5.5.3
Provide Channel Attributes
5.5.4
Provide Exchange Protocol Parameters
5.5.5
Configure Security
5.5.6
Binary Transfer
5.5.6.1
Outbound Transfer
5.5.6.2
Inbound Transfer
5.5.7
About MLLP
5.5.7.1
Overriding the Connection Mode
5.5.7.2
Generic Support for TCP
5.5.7.3
Dynamic Endpoints
5.5.7.4
Using a Transport Callout to Extract Custom Headers
5.5.8
Multiple Channel Support for ebMS
5.5.9
Message Sequencing
5.5.9.1
Outbound Message Sequencing
5.5.9.2
Inbound Message Sequencing
5.5.9.3
Sequencing Without Dispatching
5.5.9.4
Troubleshooting Message Sequencing
5.5.10
Using Transport Sync Callback
5.5.11
Correlating Messages Using JMS Queues
5.5.12
Configuring Delivery Retry Options
5.5.12.1
Delivery Retry at the Channel Level
5.5.12.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.3.1
Generating acknowledgment for EDI X12 Documents
8.3.1.1
Handling Duplicate Functional Acknowledgments in X12
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
Using the partnerDefinedPIPPayloadBindingId and LocationId Service Header Parameters
8.7.3
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.1.1
Search for Agreements to Batch
11.1.2
Create the Batch
11.1.3
Schedule the Batch
11.1.4
Creating a Batch Based on Max Count and Max Size
11.1.5
Understanding Batching Based on Batch Setup
11.2
Managing Batched Messages
11.3
Support for Sequencing Inbound 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
Securing Messages with PGP
13.4
Including a Callout in an Agreement
13.5
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
15.2
Purging Data Based on Database Partitions
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.3.5
FIPS 140 Compliance
16.3.5.1
Enabling FIPS Mode
16.4
Configuring a Listening Channel
16.5
Configuring Document Sequencing
16.6
Working with Default Channels
16.7
Message Flow Throttling
17
Configuring B2B System Parameters
17.1
Setting Configuration Parameters
Part IV Reports and Metrics
18
Securing Oracle B2B
18.1
Introduction to OPSS
18.2
Securing Oracle B2B
18.2.1
Managing Users and Groups
18.2.2
Managing Credentials
18.2.3
Managing Identity, Authentication, and Authorization
18.2.4
Managing Policies
18.2.5
Managing Keystore
18.2.5.1
Using Another Stripe
18.2.5.2
Features of FKS
18.2.5.3
Naming Convention for Keystores
18.2.5.4
Setting Up Keystore for Oracle B2B
18.2.6
Managing Auditing
19
Creating Reports
19.1
Introduction to Reports
19.1.1
The Monitor User Role
19.1.2
Purging Messages
19.1.3
Resubmitting Messages from Oracle B2B
19.1.3.1
Correlation Flow Id Response in B2B During Resubmission
19.2
Creating Business Message Reports
19.2.1
Message State Definition
19.3
Creating Wire Message Reports
19.4
Creating Application Message Reports
19.5
Creating Error Reports
19.6
Creating Conversation Reports
20
Using B2B Metrics
20.1
Introduction to B2B Metrics
20.2
B2B System Metrics
20.3
B2B Partner Metrics
Part V Scripts and Utilities
21
B2B Command-Line Tools
21.1
Prerequisites for Running the Command-line Tools
21.2
Archiving Data
21.3
Purging Data
21.4
Importing Data
21.5
Exporting Data
21.6
Batching Operations
21.7
Resetting Channel Passwords
21.8
Activating or Deactivating Listening Channels
21.9
Deploying Agreements
21.10
Validating B2B Metadata
21.11
Using the ebXML CPP/CPA Utilities
21.11.1
Creating CPP/CPA Properties Templates
21.11.1.1
Properties of cpp_cpa.properties
21.11.1.1.1
CPA Import Properties
21.11.1.1.2
CPA Export Properties
21.11.1.1.3
Common Properties
21.11.2
CPP/CPA Import
21.11.3
CPP/CPA Export
21.12
Verifying Agreement Availability
21.13
Creating Oracle B2B Metadata Based on selfservice.xsd
21.13.1
Using Selfservice to Batch Create Document Protocols, Trading Partners, and Agreements
21.13.2
Using Self Service Samples
21.13.3
How to Create Selfservice XML Templates from selfservice.xsd
21.14
Resubmitting a Message
21.14.1
Resubmitting Messages Based on the Protocol Message ID
21.15
Scheduling Trading Partner Downtime
21.16
Managing the Keystore
21.17
Updating the Keystore
21.18
Errors During Import
21.19
Moving B2B Agreement from a Test to a Production Environment
21.19.1
Export a Single Agreement as a ZIP File
21.19.2
Generate a Config Plan in XML Format Using the Command Line
21.19.3
Edit the Config Plan for the Production Environment
21.19.4
Update the Export Metadata with the Config Plan Changes
21.19.5
Import the Changes into the Production Environment
22
Using the Oracle B2B Web Services
22.1
Introduction to Oracle B2B Web Services
22.2
Using the Outbound Web Service
22.3
Using the Translation Web Service
22.3.1
XMLToNativeService
22.3.1.1
Complete Envelope
22.3.1.2
Transaction Set Alone
22.3.2
NativeToXMLService
22.3.2.1
Complete Envelope
22.3.2.2
Transaction Set Alone
22.3.3
Translation Web Service Parameters
22.4
Using the Query API
22.4.1
Is Trading Partner Agreement Setup Parameters
22.4.2
Get Trading Partner Agreement Information Parameters
22.5
Securing Oracle B2B Web Services
23
Enabling Web-Service-Based Message Exchange
23.1
Introduction to Web-Service-Based Message Exchange
23.2
Exchanging SOAP-Based Service Messages with Custom WSDL File
23.2.1
Exchanging Outbound SOAP-Based Messages
23.2.1.1
Uploading the WSDL
23.2.1.2
Creating a document
23.2.1.3
Adding the document to as a part of partner documents
23.2.1.4
Creating a Trading Partner Delivery Channel
23.2.1.5
Creating and deploying an agreement
23.2.2
Exchanging Inbound SOAP-Based Messages
23.2.3
Uploading the WSDL
23.2.4
Creating a document for the inbound flow
23.2.5
Adding the document to as a part of partner documents
23.2.6
Creating a listening channel
23.3
Configuring wsa.action
23.4
Sending Custom SOAP Headers
23.5
Attaching Policies to Web Services Using Enterprise Management
23.5.1
Creating Default Credentials Map and Key
23.5.2
Creating and attaching outbound policy sets
23.5.3
Creating and attaching inbound policy sets
23.6
Identifying Trading Partner at runtime
23.7
Sample Request-Reply Scenarios
23.7.1
Outbound Synchronization: Composite
23.7.2
Inbound Synchronization: Composite
23.7.3
Outbound Synchronization: JMS Queues
23.7.4
Inbound Synchronization: JMS Queues
24
Enabling AS4-Based Message Exchange
24.1
Introduction to AS4–Based Message Exchange
24.2
Exchanging AS4-Based Service Messages with Custom WSDL File
24.2.1
Exchanging Outbound Messages
24.2.2
Exchanging Inbound Messages
24.3
Setting up Trading Partners and Hosts
24.4
Message Partition Channels
24.5
Duplicate Message Detection
24.6
P-Mode Parameters
24.7
Local Policy Attachment
24.8
Use-Case Scenarios
24.8.1
Inbound Messaging
24.8.1.1
Setting Up the Responder
25
Scripts for Archiving and Restoring Data
25.1
Introduction to Archiving and Restoring B2B Business Messages
25.2
Archiving B2B Business Messages
25.3
Restoring B2B Business Messages
26
Utilities for Enqueuing and Dequeuing
26.1
AQ Enqueue and Dequeue Utilities
26.1.1
AQ Enqueue
26.1.2
AQ Dequeue
26.2
JMS Enqueue and Dequeue Utilities
26.2.1
JMS Enqueue
26.2.2
Enqueue—Using a JMS JCA Adapter or Custom Utilities
26.2.3
JMS Dequeue
26.3
Using the attachmentsDescriptor.xsd
27
Monitoring Instance Message Data With Oracle BAM
27.1
Introduction to Monitoring Oracle B2B with Oracle BAM
27.2
Creating a Data Source in Oracle WebLogic Server
27.3
Creating a Foreign JMS Server
27.4
Create a B2B Data Object using Oracle BAM Composer
27.5
Define a JMS Message Source Using an Oracle BAM Enterprise Message Source
27.6
Mapping Oracle B2B Instance Messages to Oracle BAM Data Objects
27.7
Creating a Dashboard to Monitor Oracle B2B
27.8
Enabling the Oracle BAM Integration in Oracle B2B
28
Programmatically Accessing Instance Message Data
28.1
Programmatically Accessing Instance Message Data
28.2
Instance Message Java API Examples
28.3
Troubleshooting Instance Message Java API
28.3.1
Handling a Large Number of Messages
28.3.2
Handing Large Payloads
28.3.3
Executing Queries Remotely Using Weblogic.jar
Appendices
A
Handling Large Payloads
A.1
Handling Large Payloads
A.1.1
Introduction to Large Payload Support
A.2
Using Document Streams to Handle Large Payloads
A.2.1
How Streaming Works
A.2.1.1
When Does Streaming Not Occur
A.2.1.2
Using Document Streams from the Back End
A.2.1.3
Settings for a Large Dataset Scenario
A.2.2
Limitations
B
Handling E-Mail Attachments
B.1
Sending and Receiving Payload as an E-Mail Attachment
B.2
Sending and Receiving Payload as E-Mail Body
B.3
Sending and Receiving Payload as E-Mail Body Along with an Attachment
B.4
Sending and Receiving Payload as E-Mail Body Along with Multiple Attachments
C
High Availability Architecture and Failover Considerations
C.1
Overview
C.2
Protection from Failures and Expected Behavior
C.3
Cluster-Wide Configuration Changes
D
Diagnosing Generic Issues
D.1
Generic Diagnostics
D.1.1
Identifying the Error in Oracle B2B Console
D.1.1.1
Identifying the Error Type
D.1.1.2
Identifying the Location of the Error
D.1.1.3
Checking the Message Flow
D.1.1.4
Sample Diagnosis
D.1.2
Examining the Log Files and Composites in Fusion Middleware Enterprise Manager Control Console
D.1.3
Displaying the Actual Thread ID in the Log File
D.2
Troubleshooting Message Delivery Failure - A Case Study
D.2.1
Problem
D.2.2
Troubleshooting the Issue
D.2.2.1
Tracing Inbound Message
D.2.2.1.1
Checking for the inbound message errors in the Oracle B2B console
D.2.2.1.2
Checking for inbound message errors in Fusion Middleware Enterprise Management Control console
D.2.2.2
Tracing Outbound Message
D.2.2.2.1
Checking for Outbound message errors in Fusion Middleware Enterprise Management Control console
D.2.2.2.2
Checking for the Outbound message errors in the Oracle B2B console
E
Synchronous Request/Reply Support
E.1
Introduction
E.2
Configuring Sender
E.2.1
Configuring Oracle JDeveloper
E.2.2
Configuring Oracle B2B
E.3
Configuring Receiver
E.3.1
Configuring Oracle JDeveloper
E.3.2
Configuring Oracle B2B
E.4
Resubmitting Messages
F
Setting B2B Configuration Properties in Fusion Middleware Control
F.1
Properties To Set in Fusion Middleware Control
F.2
Using the configmbeanutil Utility
G
Back-End Applications Interface
G.1
Mapping B2B IP_MESSAGE_TYPE to SCA Normalized Message Properties
G.2
Normalized Message Properties
H
Sequence Message Management
H.1
Why Do You Need to Manage Sequenced Messages
H.2
Ant Commands and Public APIs
I
Tracking Business Message Flow
I.1
Introduction to Business Flow Events
I.1.1
What You Need to Know About Flow Events?
I.2
Tracking Oracle B2B Message Events
I.3
Tracing Flow By Using Oracle B2B Console
I.4
Instance Tracking and Error Hospital Integration
I.4.1
Tracking Messages Between the Oracle Enterprise Manager Fusion Middleware Control Flow Trace and the B2B/Healthcare Console
I.4.2
Tracking the State of a Message from the Oracle Enterprise Manager Fusion Middleware Control Flow Trace XML
I.4.2.1
Inbound Messages
I.4.2.2
Outbound Non-Batch Messages
I.4.2.3
Outbound Batch Messages
J
Setting Up B2B Communication By Using Remote JNDI Queue
J.1
Configuring B2B Communication By Using Foreign JNDI
J.1.1
Creating a Target JMS Server, Module, and Queue
J.1.2
Setting Up an Environment to Connect to the JMS queue
K
Exception Handling
K.1
Inbound Messages
K.1.1
Request or Response Messages
K.1.1.1
Inbound ebMS, AS1, and AS2 Messages
K.1.1.2
Inbound Message Content-Type Handling for AS1 Messages
K.1.2
Acknowledgment Messages
K.1.3
Exception Messages
K.2
Outbound Messages
K.3
Using a JMS Queue for Error Message Delivery
K.4
Using a Custom Exception Queue for Error Message Delivery
K.5
Inbound Exception Handling Scenarios
K.6
Exception Payload Definition
K.7
AS4-Based Message Errors
L
Database Partitioning
L.1
Introduction
L.2
Partitioning Requirements
L.2.1
Setting Up Partitioning
L.2.2
Migrating Data
L.2.2.1
Purge Process
M
Self Service Utility Protocols, Identifications, Security Specifications, and Parameters
M.1
Protocols
M.2
Identifications
M.3
Security Specifications
M.4
Exchange Protocols Parameter Values
M.5
Transport Protocols Parameter Values
M.6
Document Protocol Parameter Values
N
TA1 acknowledgment
N.1
Introduction
N.2
Configuring TA1
N.2.1
TA1 for Inbound Direction
N.2.2
TA1 for Outbound Direction
O
Exchanging Messages By Using IBM Websphere MQ
O.1
Overview
O.2
Prerequisites
O.3
Connecting to IBM MQ
O.3.1
Configuring Credential-based Connectivity
O.3.2
Configuring Bindings-based Connectivity
P
Running Oracle B2B as a Hub
P.1
Introduction
P.2
Configuring Oracle B2B as a Hub
P.3
Testing the Configuration
Q
Overriding Non-Traditional Characters
Q.1
Introduction
Q.2
Using XEngine to Override Characters
Q.3
Overriding: An Example
Index
Scripting on this page enhances content navigation, but does not change the content in any way.