Contents

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

What's New in Oracle Application Server Integration B2B?

Part I Introduction and Concepts

1 Introduction to Oracle Application Server Integration B2B

• What Does OracleAS Integration B2B Provide?
• Supported Protocols
• Design-Time Workflow
• • Business Protocols
  • Trading Partner Management—Creating Trading Partner Profiles
  • Trading Partner Management—Creating Trading Partner Agreements
  • Configuration and Deployment
• OracleAS Integration B2B Administration, Monitoring, and Security
• Chapter Summary

2 Getting Started with the User Interface Tool

• Accessing the User Interface Tool
• User Interface Tool Page Layouts
• • Main List Pages
  • Details Pages
  • Creating Incomplete Partner Data
  • Creating, Adding, Deleting, and Removing Data
  • Naming Conventions
  • Using the Browser Back and Forward Buttons
  • Using the Return to List Link
  • Searching for Data on the Main List Page
  • Exporting Partner Data to an XML File
  • Viewing the State of Partner Data on the Details Pages
  • • Draft State for Partner Data
    • Approved State for Partner Data
    • Deployed State for Partner Data
• Partners Tab Overview
• • Trading Partners List Page
  • Trading Partner Agreements List Page
  • Protocols List Page
  • Callouts List Page
• Deployment Tab Overview
• Reports Tab Overview
• Administration Tab Overview
• • Design List Page
  • Management List Page
• Chapter Summary

3 Supported Protocols

• Overview of Supported Protocols
• Document Protocols
• • RosettaNet
  • • RosettaNet Dictionaries
    • RosettaNet Validation
  • EDI X12
  • EDI EDIFACT
  • Custom Documents
  • HL7
• Exchange Protocols
• • RNIF
  • AS2
  • Generic
  • MLLP
  • ebMS
• Process Protocols
• • PIPs
• Business Protocols
• • Mix and Match Protocols
• Chapter Summary

4 Communicating with Host Trading Partner Applications

• Internal Delivery Channels in OracleAS Integration B2B
• Integrations with OracleAS Integration InterConnect
• Integrations with Oracle E-Business Suite
• Integrations with Oracle BPEL Process Manager
• • Messages
  • • Headers
    • The Payload
    • Internal Delivery Channels
  • Configuring OracleAS Integration B2B
  • The B2B WSIL Browser
  • Configuring Oracle BPEL Process Manager
  • • Oracle BPEL Process Manager Adapters
  • Message Correlation
• Integrations with Host Applications
• Overview of Callouts
• Chapter Summary

Part II Tutorials

5 Purchase Order Tutorials

• About the OracleAS Integration B2B Tutorials
• • Business Scenario
  • Business Scenario Workflow in the Tutorials
• Before You Begin the Tutorials
• • Setting Up the CLASSPATH Environment
  • Logging In to OracleAS Integration B2B
  • Changing the Host Trading Partner Name
  • Location of Run-Time and Configuration Files Used in the Tutorials
• Tutorial 1: Setting Up a RosettaNet over the Internet Transaction
• • Acme Server, Task 1: Creating the Collaboration
  • • Creating the 3A4 Collaboration
  • Acme Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (GlobalChips)
    • Setting Up the Host Trading Partner (Acme)
  • Acme Server, Task 3: Creating the Trading Partner Agreement
  • Acme Server, Task 4: Creating and Deploying the Configuration
  • Task 5: Verifying the Purchase Order Transaction
  • GlobalChips Server, Task 1: Creating the Collaboration
  • GlobalChips Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (Acme)
    • Setting Up the Host Trading Partner (GlobalChips)
  • GlobalChips Server, Task 3: Creating the Trading Partner Agreement
  • GlobalChips Server, Task 4: Creating and Deploying the Configuration
  • Both Servers, Task 5: Verifying the Purchase Order Transaction
• Tutorial 2: Setting Up an EDI EDIFACT over Generic (VAN) Transaction
• • Acme Server, Task 1: Creating the Business Actions
  • • Creating the Process_ORDERS Business Action—Acme Sends a Purchase Order
    • Creating the Process_CONTRL Business Action—Functional Acknowledgments
    • Creating the Process_ORDRSP Business Action—GlobalChips Sends a Purchase Order Confirmation
  • Acme Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (GlobalChips)
    • Setting Up the Host Trading Partner (Acme)
  • Acme Server, Task 3: Creating the Trading Partner Agreement
  • Acme Server, Task 4: Creating and Deploying the Configuration
  • Task 5: Verifying the Purchase Order Transaction
  • GlobalChips Server, Task 1: Creating the Business Actions
  • GlobalChips Server, Task 2: Setting Up the Trading Partners
  • • Changing the Host Trading Partner Name to GlobalChips
    • Setting Up the Remote Trading Partner (Acme)
    • Setting Up the Host Trading Partner (GlobalChips)
  • GlobalChips Server, Task 3: Creating the Trading Partner Agreement
  • GlobalChips Server, Task 4: Creating and Deploying the Configuration
  • Both Servers, Task 5: Verifying the Purchase Order Transaction
  • Variation: Using the Email Transport Protocol
• Tutorial 3: Setting Up an EDI X12 over Internet (AS2) Transaction
• • Acme Server, Task 1: Creating the Business Actions
  • • Creating the Process_850 Business Action—Acme Sends a Purchase Order
    • Creating the Process_997 Business Action—Acknowledgments
    • Creating the Process_855 Business Action—GlobalChips Sends a Purchase Order Confirmation
  • Acme Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (GlobalChips)
    • Setting Up the Host Trading Partner (Acme)
  • Acme Server, Task 3: Creating the Trading Partner Agreement
  • Acme Server, Task 4: Creating and Deploying the Configuration
  • Task 5: Verifying the Purchase Order Transaction
  • GlobalChips Server, Task 1: Creating the Business Actions
  • GlobalChips Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (Acme)
    • Setting Up the Host Trading Partner (GlobalChips)
  • GlobalChips Server, Task 3: Creating the Trading Partner Agreement
  • GlobalChips Server, Task 4: Creating and Deploying the Configuration
  • Both Servers, Task 5: Verifying the Purchase Order Transaction
• Using the EMail Transport Protocol
• Doing More Than One Tutorial
• • Starting and Stopping the B2B Server with OPMN
  • Importing Configuration Data
• Chapter Summary

6 Health Care Tutorial

• About the Health Care Tutorial
• Before You Begin the Tutorial
• Tutorial: Setting Up an HL7 over MLLP Transaction
• • Acme Server, Task 1: Creating the Business Actions
  • • Creating the Process_A01 Business Action—Acme Sends an ADT_A01 Message
    • Creating the Process_ACK Business Action—Acknowledgment
  • Acme Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (GlobalChips)
    • Setting Up the Host Trading Partner (Acme)
  • Acme Server, Task 3: Creating the Trading Partner Agreement
  • Acme Server, Task 4: Creating and Deploying the Configuration
  • Task 5: Verifying the Purchase Order Transaction
  • GlobalChips Server, Task 1: Creating the Business Actions
  • GlobalChips Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (Acme)
    • Setting Up the Host Trading Partner (GlobalChips)
  • GlobalChips Server, Task 3: Creating the Trading Partner Agreement
  • GlobalChips Server, Task 4: Creating and Deploying the Configuration
  • Both Servers, Task 5: Verifying the ADT_A01 Transaction
• Chapter Summary

7 Custom XML Document Tutorial

• About the Custom XML Document Tutorial
• Before You Begin the Tutorial
• Tutorial: Setting Up a Custom Document over ebMS Transaction
• • Acme Server, Task 1: Creating the Business Action
  • • Creating the Process_ebMSRequest Business Action—Acme Sends an ebMS Document
  • Acme Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (GlobalChips)
    • Setting Up the Host Trading Partner (Acme)
  • Acme Server, Task 3: Creating the Trading Partner Agreement
  • Acme Server, Task 4: Creating and Deploying the Configuration
  • Task 5: Verifying the Purchase Order Transaction
  • GlobalChips Server, Task 1: Creating the Business Action
  • • Creating the Process_ebMSRequest Business Action—GlobalChips Sends an ebMS Document
  • GlobalChips Server, Task 2: Setting Up the Trading Partners
  • • Setting Up the Remote Trading Partner (Acme)
    • Setting Up the Host Trading Partner (GlobalChips)
  • GlobalChips Server, Task 3: Creating the Trading Partner Agreement
  • GlobalChips Server, Task 4: Creating and Deploying the Configuration
  • Both Servers, Task 5: Verifying the Transaction
• Chapter Summary

Part III Using the User Interface for Design-Time and Deployment Tasks

8 Managing Business Protocols

• Business Protocol Management Overview
• • Collaborations and Business Actions Overview
  • OracleAS Integration B2B - Document Editor Overview
• Viewing Business Protocols
• Managing Document Protocols
• • Creating a Document Protocol Revision
  • Viewing a Document Protocol Revision
  • Updating a Document Protocol Revision
  • Deleting a Document Protocol Revision
  • Creating a Document Type
  • Viewing a Document Type
  • Updating a Document Type
  • Deleting a Document Type
  • Viewing a Document Definition of a Document Type
  • Updating a Document Definition of a Document Type
  • Configuring the XPath Expression for a Custom XML Document
  • • Example: Creating a UCCNet Custom Document
• Viewing Exchange Protocols
• Managing Process Protocols
• • Creating a Business Action
  • • Page 1: General Page
    • Page 2: Document Protocol Revision
    • Page 3: Document Type
    • Page 4: Review
  • Viewing a Business Action
  • Updating a Business Action
  • Deleting a Business Action
  • Creating a Collaboration
  • • Page 1: General Page
    • Page 2: Business Transaction Page
    • Page 3: Requesting Business Action
    • Page 4: Responding Business Action (Optional)
    • Page 5: Review
  • Viewing a Collaboration
  • Updating a Collaboration
  • Deleting a Collaboration
• Common User Errors
• Chapter Summary

9 Creating Trading Partners

• Trading Partner Creation Overview
• • What Is a Trading Partner?
  • How Do You Create a Trading Partner?
  • Create Trading Partner Wizard Overview
  • Create Trading Partner Wizard and Protocol Standards
  • Prerequisites to Using the Create Trading Partner Wizard
  • Accessing the Create Trading Partner Wizard
• Creating and Assigning All Capabilities During a Single Wizard Session
• • Page 1: General Page
  • Page 2: Identification Page
  • Page 3: Operational Capability Page
  • Page 4: Delivery Channel Page
  • Page 5: Document Exchange Page
  • Page 6: Transport Page
  • Page 7: Review Page
• Creating and Defining All Capabilities During Separate Wizard Sessions
• • Creating a Remote Trading Partner
  • Assigning the Business Protocol to the Remote Trading Partner
  • Creating Business Protocol Operational Capabilities for the Remote Trading Partner
  • Creating Business Protocol Communication Capabilities for the Host and Remote Trading Partners
• Common User Errors
• Chapter Summary

10 Managing Trading Partners

• Trading Partner Management Overview
• • Trading Partner Details Page
  • Capabilities Page
  • Business Protocol Details Page
• Managing Trading Partners
• • Viewing a Host or Remote Trading Partner
  • Updating a Host or Remote Trading Partner
  • Deleting a Remote Trading Partner
• Managing Trading Partner Identification
• • Creating Trading Partner Identification
  • Viewing a Trading Partner Identification
  • Updating a Trading Partner Identification
  • Deleting a Trading Partner Identification
• Managing Trading Partner Agreements of Trading Partners
• Managing Remote Trading Partner Certificates
• • Creating a Remote Trading Partner Certificate
  • Viewing a Remote Trading Partner Certificate
  • Updating a Remote Trading Partner Certificate
  • Deleting a Remote Trading Partner Certificate
• Managing the Host Trading Partner Wallet Password
• • Creating a Host Trading Partner Wallet Password
  • Updating a Host Trading Partner Wallet Password
• Managing Trading Partner Contact Information for Persons and Organizations
• • Creating Contact Information for a Trading Partner Person or Organization
  • Viewing Contact Information for a Trading Partner Person or Organization
  • Updating Contact Information for a Trading Partner Person or Organization
  • Deleting Contact Information for a Trading Partner Person or Organization
• Managing Trading Partner Persons
• • Creating a Trading Partner Person
  • Viewing a Trading Partner Person and Updating the Person Password
  • Updating a Trading Partner Person
  • Deleting a Trading Partner Person
  • Assigning a User Role to a Host Trading Partner Person
  • Removing a User Role from a Host Trading Partner Person
  • Viewing User Roles and Use Case Group Details
• Managing Trading Partner Business Protocols
• • Assigning a Business Protocol
  • Viewing a Business Protocol
  • Viewing an Exchange Protocol
  • Viewing a Document Protocol
  • Viewing a Process Protocol
  • Removing a Business Protocol from a Remote Trading Partner
• Managing Internal Delivery Channels
• • Creating an Internal Delivery Channel
  • • Page 1: General Page
    • Page 2: Transport Page
    • Page 3: Review Page
  • Example: Creating an Internal Delivery Channel Using the JMS Transport Protocol
  • • Troubleshooting the JMS Internal Delivery Channel
  • Example: Creating File/FTP Internal Delivery Channels
  • • File Name Restrictions
  • Deleting an Internal Delivery Channel
• Managing Business Protocol Collaborations
• • Viewing a Business Protocol Collaboration
  • Updating a Business Protocol Collaboration
  • Deleting a Business Protocol Collaboration
• Managing Business Protocol Business Actions
• • Viewing a Business Protocol Business Action
  • Updating a Business Protocol Business Action
  • Deleting a Business Protocol Business Action
• Managing Business Protocol Delivery Channels
• • Viewing a Business Protocol Delivery Channel
  • Updating a Business Protocol Delivery Channel
  • Deleting a Business Protocol Delivery Channel
• Managing Business Protocol Document Exchanges
• • Viewing a Business Protocol Document Exchange
  • Updating a Business Protocol Document Exchange
  • Deleting a Business Protocol Document Exchange
• Managing Business Protocol Transports
• • Viewing a Business Protocol Transport
  • Updating a Business Protocol Transport
  • Deleting a Business Protocol Transport
• Managing Business Protocol Transport Servers
• • Viewing a Business Protocol Transport Server
  • Updating a Business Protocol Transport Server
  • Deleting a Business Protocol Transport Server
• Managing Business Protocol Endpoints
• • Viewing a Business Protocol Endpoint
  • Updating a Business Protocol Endpoint
  • Deleting a Business Protocol Endpoint
  • Viewing a Protocol Endpoint of a Business Protocol Endpoint
  • Updating a Protocol Endpoint of a Business Protocol Endpoint
  • Deleting a Protocol Endpoint of a Business Protocol Endpoint
• Common User Errors
• Chapter Summary

11 Managing Callouts

• Callouts Overview
• Managing Callouts
• • Creating a Callout
  • • Implementing a Callout: Code Example
  • Viewing a Callout
  • Updating a Callout
  • Deleting a Callout
• Managing Callout Properties
• • Creating Callout Properties
  • Viewing Callout Properties
  • Updating Callout Properties
  • Deleting Callout Properties
• Managing Callout Usages
• • Creating a Callout Usage
  • Viewing a Callout Usage
  • Updating a Callout Usage
  • Deleting a Callout Usage
  • Creating a Callout Metadata Parameter Value for a Callout Usage
  • Viewing a Callout Metadata Parameter Value for a Callout Usage
  • Updating a Callout Metadata Parameter Value for a Callout Usage
  • Deleting a Callout Metadata Parameter Value of a Callout Usage
• Tutorial: Adding Callout Usages to the RosettaNet over the Internet Transaction
• • Acme Server, Task 1: Performing the RosettaNet over RNIF Tutorial
  • Acme Server, Task 2: Setting Up Callout Usages
  • • Create an OAG Custom Document Type
    • Modify XML Gateway Settings
    • Modify the XSLTCallout Settings
    • Create a Trading Partner Agreement
    • Create and Deploy a Configuration
  • GlobalChips Server, Task 1: Performing the RosettaNet over RNIF Tutorial
  • GlobalChips Server, Task 2: Setting Up Callout Usages
  • • Create an OAG Custom Document Type
    • Modify XML Gateway Settings
    • Modify the XSLTCallout Settings
    • Create a Trading Partner Agreement
    • Create and Deploy a Configuration
• Common User Errors
• Chapter Summary

12 Creating and Managing Trading Partner Agreements

• Trading Partner Agreement Overview
• • What is A Trading Partner Agreement?
  • How Do You Create a Trading Partner Agreement?
  • Prerequisites to Creating a Trading Partner Agreement
• Managing Trading Partner Agreements
• • Creating a Trading Partner Agreement
  • Viewing a Trading Partner Agreement
  • Updating a Trading Partner Agreement
  • Deleting a Trading Partner Agreement
• Managing Trading Partner Agreement Participants
• • Adding Additional Identifications and Operational and Communication Capabilities to Trading Partner Agreement Participants
  • Viewing a Trading Partner Agreement Participant
  • Updating a Trading Partner Agreement Participant
  • Removing a Trading Partner Agreement Participant
• Managing Delivery Channels of Trading Partner Agreement Participants
• • Adding a Delivery Channel to a Trading Partner Agreement Participant
  • Viewing a Delivery Channel of a Trading Partner Agreement Participant
  • Updating a Delivery Channel of a Trading Partner Agreement Participant
  • Removing a Delivery Channel from a Trading Partner Agreement Participant
• Common User Errors
• Chapter Summary

13 Creating and Deploying a Configuration

• When Must I Read This Chapter?
• Configuration Overview
• • What is a Configuration?
  • Configuration Creation Overview
• Creating a Configuration
• • Successful Configuration Creation and Validation
  • Unsuccessful Configuration Creation and Validation
• Deploying a Configuration
• • Configuration Deployment Overview
  • Deploying a Validated Configuration
• Viewing a Configuration
• Quiescing a Configuration
• Discarding a Configuration
• Exporting a Configuration
• Common User Errors
• Chapter Summary

Part IV Using Scripts and Utilities

14 API for Creating Trading Partners and Agreements

• The Trading Partner Descriptor XML
• The Agreement Descriptor XML
• Using the Self-service API
• Example Files

15 Utilities for Enqueuing and Dequeuing

• Java Enqueue and Dequeue
• • IPEnqueue
  • IPDequeue
• PL/SQL Enqueue and Dequeue
• • msgid_b2b.sql
  • enq_b2b.sql
  • deq_b2b.sql

16 Batching and Debatching EDI Transaction Sets

• EDI Batching
• EDI Batching Examples

Part V Administration, Monitoring, and Security Tasks

17 Administering Oracle Application Server Integration B2B

• Administering OracleAS Integration B2B
• Managing Contact Types
• • Viewing a Contact Type
• Managing Trading Partner Identification Types
• • Creating a Trading Partner Identification Type
  • Viewing a Trading Partner Identification Type
• Exporting and Importing the Design-Time Repository
• • Exporting the Design-Time Repository Contents
  • Importing the Design-Time Repository Contents
  • Importing an Exported Configuration
  • Importing Support for Collaborations, Transaction Sets, and UCCnet Standards
• The Run-Time Repository
• Purging the Entire Repository
• Purging Business Messages and Wire Messages Using the Purge Utility
• Common User Errors
• Chapter Summary

18 System Management with Oracle Enterprise Manager 10g

• Oracle Enterprise Manager 10g Monitoring and Administration Overview
• • OracleAS Integration B2B Management Concepts and Components
  • • Oracle Application Server Metadata Repository
    • OracleAS Integration B2B Instance
    • B2B Server of OracleAS Integration B2B
    • OC4J Instance of OracleAS Integration B2B
  • Oracle Enterprise Manager 10g Application Server Control Console Tasks
• Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager 10g Application Server Control Console
• • OracleAS Integration B2B Monitoring and Administration Tasks
  • • OracleAS Integration B2B Log Files
    • OracleAS Integration B2B Middle-Tier Instance Performance
    • OracleAS Integration B2B Middle-Tier Instance Server Properties
  • OracleAS Integration B2B Port Management
• Starting and Stopping OracleAS Integration B2B Components with OPMN
• Additional Oracle Application Server and OracleAS Integration B2B Management Tasks
• Changing Port Numbers
• • Port Changing Error Message
  • Modifying Ports
• Chapter Summary

19 Creating Reports

• Reports Overview
• • Reports User Role
• Creating Business Message Status Reports
• Creating Wire Message Status Reports
• Creating Collaboration Status Reports
• Creating Error Status Reports
• Saving Reports
• Saving Report Definitions
• Importing Reports
• Chapter Summary

20 Oracle Application Server Integration B2B Security

• About OracleAS Integration B2B Security
• • Classes of Users and Their Privileges
  • Resources Protected
  • Authorization and Access Enforcement
  • Use of Oracle Application Server Security Services
  • Use of Oracle Identity Management Infrastructure
• Configuring Oracle Application Server Security Framework for OracleAS Integration B2B
• • OracleAS Integration B2B Security Framework Configuration Issues
  • Identity Management Configuration Issues Specific to OracleAS Integration B2B
• Configuring OracleAS Integration B2B Security
• • OracleAS Integration B2B Installation
  • • Required Information for Successfully Installing Oracle Application Server Integration B2B
  • OracleAS Integration B2B Security Configuration
  • • Digital Envelopes and Certificates for Host and Remote Trading Partners
    • Digital Signatures for Host and Remote Trading Partners
    • Secure HTTP and Client Authentication
    • Encrypted Wallet Passwords for Host Trading Partners
  • Host Trading Partner Password Encryption in High Availability Environments
  • Configuration Issues and Options to Use for Oracle Application Server Security Framework
  • Oracle HTTP Server Transport Servlet and OracleAS Integration B2B
• Chapter Summary

A Troubleshooting and Workarounds

• Retrieving the B2B Database Password
• OracleAS Integration B2B Processing Is Very Slow
• User Interface Pages Time Out Too Fast
• Run-Time Error When Enqueuing a Message to IP_OUT_ENQUEUE
• Checking the IP_IN_QUEUE and IP_OUT_QUEUE Queues
• Running Reports
• Checking Log Files
• • Setting Log Levels
• Correcting Out-of-Memory Errors
• Resolving Connection Errors
• • Connection Errors While Posting Messages to the Trading Partner URL
• Generic Exchange Protocol Workarounds
• • Transport Protocol Parameter Settings for the FTP or File Transport Protocol
  • • Timestamp Formats
  • FTP Server on Windows Operating Systems
  • Generic Exchange Protocols and Functional Acknowledgments
  • Generic Exchange Protocols and Oracle Application Server Web Cache

B Exception Handling

• Inbound Messages
• • Request or Response Messages
  • Acknowledgment Messages
  • Exception Messages
• Outbound Messages
• Inbound Exception Handling Scenarios
• Exception Payload Definition

C Identifying a Trading Partner Using ISA/GS

Glossary

Index