Table of Contents

Getting Started with Oracle SOA B2B Integration: A Hands-On Tutorial

Credits

About the Authors

About the Reviewers

www.PacktPub.com

Support files, eBooks, discount offers and more

Why Subscribe?

Free Access for Packt account holders

Instant Updates on New Packt Books

Preface

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Downloading the example code

Errata

Piracy

Questions

1. B2B Overview

A brief history of B2B electronic document exchange

B2B market and technical trends

B2B architecture and implementation patterns

B2B message processing patterns

B2B connection models

Point-To-Point

One-To-Many (Peer-To-Peer)

Hub and Spoke

Many-To-Many

B2B Gateway

B2B Gateway and Open System Interconnection (OSI) model

B2B standards

B2B standards overview

EDI standards

EDI X12

XML-based standards

ebXML (electronic business XML)

Summary

2. Oracle B2B Overview

B2B environment setup

JDeveloper installation tips

System requirements

Oracle B2B installation and post-installation configuration notes

Oracle B2B web components

Introduction to the Oracle B2B e-commerce gateway

Business protocol

Document standard

Messaging protocol

Transport protocol

Process Control protocol

Packaging protocol

Putting it all together

Oracle B2B architecture

Oracle B2B and Service Component Architecture (SCA)

How B2B leverages Oracle Fusion Middleware Metadata Service

Oracle B2B interface quick tour

Summary

3. Creating Document Definitions

Oracle Document Editor

Installing the Document Editor 7.0.5

Creating documents

Creating document guidelines

Sample data generation and validation

Creating document definitions

Deleting document definitions

Updating document definitions after metadata import

Document definition parameters

Document routing tab

XML/Flat tab

XPath tab

Correlation tab

Apps tab

Summary

4. Trading Partner Management

B2B configuration process flow

Creating a trading partner

Legal precautions

Setting up the host trading partner

Renaming the host trading partner

Adding host profile transport and document identifiers

Setting up host trading partner contact information

Setting up host trading partner users

Setting up host trading partner documents

Setting up host trading partner delivery channels

Message sequencing

Inbound sequencing

Inbound sequencing and dispatching

Setting up the listening channels

Setting up a remote trading partner

Adding remote partner profile transport and document identifiers

Setting up remote trading partner contact information

Setting up remote trading partner users

Setting up remote trading partner documents

Setting up remote trading partner delivery channels

Setting up a Value Added Network (VAN) delivery channel

Outbound message sequencing

Setting up a trading partner agreement

Adding an agreement to a remote trading partner

Adding identifiers to the agreement

Deploying the agreement

Grouping trading partners

Summary

5. Setting up B2B Transactions

The B2B lifecycle

Creating documents

Creating trading partners

Creating trading partner agreements

Integrating with SOA Suite

Reporting and monitoring

Oracle Enterprise Manager

Runtime message flow

Inbound processing

Outbound processing

Exception handling

Message persistence and resubmission

Large payload handling

Large payload exchange with SOA

Inbound configuration

Outbound configuration

Best practices for handling large payloads

EDI batching

Creating an EDI batch

Managing an EDI batch

Summary

6. SOA Suite Integration

How B2B and SOA Suite team up

How B2B and SOA Suite communicate

Creating an SOA composite

Creating an application

Creating a project

Adding a Mediator component

Creating a document in the B2B console

Adding a B2B Binding exposed service

Adding a File Adapter external reference

Wire the components

Configuring the Mediator

B2B and SOA Design concepts

B2B Design best practices

Routing/mediation best practices

Data enrichment/lookup/cross-reference best practices

Understand the SLA requirements upfront

Consider using a Canonical/Common Object

Using a services-oriented approach

Using SOA Governance principles and tools

Deploying your project to the SOA server

Testing your project

Drop the file into the input directory for B2B

Following the document through the EM console

Outbound B2B Service

Adding a B2B Binding External Reference

Adding a File Adapter Exposed Service

Wire the components together

Configuring the Mediator

Deploying the Outbound composite

Testing the composite

Summary

7. Reporting and Monitoring

Creating B2B reports

Business message reports

Wire message reports

Application message reports

Error message reports

Conversation reports

Using B2B metrics

System metrics

Partner metrics

B2B monitoring in Enterprise Manager

Instance data monitoring using Oracle BAM

How Oracle B2B integrates with Oracle BAM

Steps to integrate Oracle B2B with Oracle BAM

Enable BAM integration in Oracle B2B

Create datasources in Oracle WebLogic Server

Create a BAM EMS and a data object

Create BAM dashboards

Summary

8. Exception Handling

B2B exception handling

B2B error queue

Inbound exception handling

Outbound exception handling

Creating a sample exception handler

Creating the SOA Composite application

Creating the ipException.xsd schema file

Creating the JMS consumer adapter

Creating a BPEL process for handling exceptions

Creating a Receive activity

Creating an If activity

Creating a Human Workflow task

Calling the Human Task from the BPEL process

Deploying and testing the exception handler

BPM Worklist

General troubleshooting tips

Summary

9. Oracle B2B Security Management

Security terminologies

Oracle B2B security architecture

Oracle B2B security features

B2B design-time security

WebLogic security realm

B2B User Provisioning

Creating a new WebLogic user

Creating a new B2B admin user

Granting the administrator role

Granting the monitor role

Allowing access to remote trading partner users

Protecting the payload data

Oracle B2B runtime security

Transport-level security

Phase 1 – enabling an SSL configuration

Task 1 – generating a private key and keystore

Task 2 – generating the Certificate Signing Request

Task 3 – creating the certificate chain

Task 4 – generating the public key

Task 5 – importing the trading partner's certificates

Phase 2 – enabling the SOA Suite SSL

Task 1 – enabling the WLS Secure Socket Layer

Task 2 – define the keystore location

Task 3 – testing the keystore configuration

Testing with a command line

Testing with the browser

Testing the Oracle B2B default HTTP delivery channel

Phase 3 – how to SSL-enable the host trading partner

Message-level security

Summary

10. Preparing to Go-Live

Oracle B2B production topology

Migrating Oracle B2B from Test to Production (T2P)

Moving Oracle B2B to a new target environment

Task 1 – creating the target environment B2B directory structures

Task 2 – prerequisites for the target environment

Task 3 – moving the database

Task 4 – creating a copy of source Middleware home and binary files

Task 5 – deploying binaries to the target

Task 6 – preparing Java components to move to the target system

Task 7 – extracting the move plan

Task 8 – deploying the configuration to the target system

Oracle B2B post-migration steps

Task 1 – migrating JKS certificates for B2B endpoints

Task 2 – deploying Oracle B2B agreements

Task 3 – enabling Oracle B2B listening channels

Task 4 – updating the EDI X12 data definition

Task 5 – verifying and updating the listening channel information

Task 6 – verifying and updating delivery channels

Moving B2B changes to an existing target environment

Customizing and deploying B2B composite applications

Upgrading an existing environment to a new release

B2B collaboration changes

B2B Production environment administration

Administration using the B2B Interface

Exporting and importing design-time data

Managing deployments

Archiving instance data

Purging data

Automating B2B administration with command-line tools

Preparing your environment

Purging instance data

EDI batching operations

Performance tuning

Things to do before you begin tweaking B2B configuration parameters

Tuning Oracle B2B

Changing the number of threads

MDS cache size

Summary

11. Advanced Topics

Java callouts

Transport callouts

Agreement callouts

Defining callouts

Configuring the callout

Defining the callout directory

Using the callout

Using the callout at the Agreement level

Using the callout at the Transport level

Implementing callouts

Testing callouts

B2B Self-Service utility

Setting up the environment

Creating the Self-Service configuration file

Example of a B2B Self-Service configuration file

Converting Self-Service XML to B2B Metadata

Troubleshooting

B2B Instance Message APIs

Example of using B2B Instance Message APIs

Troubleshooting Instance Message APIs

B2B Instance Message view

B2B utilities for initiating and receiving messages

Sending and receiving messages on AQ

IPEnqueue

IPDequeue

Sending and receiving messages on JMS

JMSEnqueue

JMSDequeue

Sending attachments

Summary

Index

Getting Started with Oracle SOA B2B Integration: A Hands-On Tutorial

Getting Started with Oracle SOA B2B Integration: A Hands-On Tutorial

Copyright © 2013 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the authors, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: July 2013

Production Reference: 1030713

Published by Packt Publishing Ltd.

Livery Place

35 Livery Street

Birmingham B3 2PB, UK.

ISBN 978-1-84968-886-4

www.packtpub.com

Cover Image by Artie Ng (<artherng@yahoo.com.au>)

Credits

Authors

Krishnaprem Bhatia

Scott Haaland

Alan Perlovsky

Reviewers

Prasanna Chandrashekhara

Ankit Pradhan

Acquisition Editor

Martin Bell

Lead Technical Editor

Susmita Panda

Technical Editors

Dipika Gaonkar

Dennis John

Mrunmayee Patil

Priya Singh

Project Coordinator

Leena Purkait

Proofreaders

Ting Baker

Lindsey Thomas

Indexer

Monica Ajmera Mehta

Graphics

Ronak Dhruv

Abhinash Sahu

Production Coordinator

Nitesh Thakur

Cover Work

Nitesh Thakur

About the Authors

Krishnaprem Bhatia has over twelve years of experience in the Software Development, Product Management, and IT industry. He started working with Oracle in 2001 and since then he has been working in various aspects of enterprise software integration including application, business process, and B2B integration. He has extensive software development experience, building world class integration solutions using Oracle technologies. As a Product Manager for Oracle B2B, he has worked extensively with customers and partners worldwide to develop unique B2B solutions, for solving integration challenges in nearly all industry verticals. Through dozens of workshops, he has interacted with and trained hundreds of integration experts on Oracle B2B across North America, Europe, and Asia. He loves to read, workout at the gym, and also has a passion for traveling as he has been to more than 26 countries. He holds a B.S. (with Highest Honors) in Computer Science and Engineering from UC Davis and an MBA from UC Berkeley Haas School of Business.

I would like to thank God for his help in every endeavor of my life. I want to thank my family who have been very positive and have supported me unconditionally. I would also like to thank all my customers, partners, and colleagues who have provided me with valuable knowledge, opportunities, and support.

Scott Haaland has over 20 years experience in the Software Development and IT industry. He started working in 1992 for Hewlett Packard, and then for the spinoff company from HP called Agilent Technologies. After branching out on his own with two different businesses, including a Software Consulting business, he also picked up many business management skills along the way as well. Most recently, Scott has joined Oracle in 2012 as a Principal Product Manager for the SOA Suite team, with a special emphasis on Oracle B2B. While working for Hewlett Packard as a Developer for their EDI Services team, Scott gained expertise in many different B2B standards, such as EDI X.12, TRADACOMMS, EDIFACT, and EIAJ. With the advent of Message Oriented Middleware and then the transition into Service Oriented Architecture, Scott continued to gain important Integration Architecture skills while at Agilent Technologies, where he helped to develop a Canonical model based on the OAGIS 8.0 specification for internal application to application integration using TIBCO technologies. Scott learned SOA Suite while providing consulting services, and helped his clients with a transition to a Service Oriented Architecture approach for integration using Oracle SOA Suite 11g. As a Product Manager for Oracle SOA Suite, his expertise in EDI, A2A, SOA, and B2B have proven invaluable towards the writing of this book. Scott enjoys spending time with his family, working on home improvement projects, working on cars, and volunteering at his church and in his community.

I would like to first thank Jesus Christ for being the source for everything good in my life. I would like to thank my family who have been positive and unconditionally supportive. I could not have achieved this nor anything else in my career without my beautiful wife Michele and her constant and untiring support for me. I would also like to thank my sons, Phillip and Andrew, who have sacrificed many weekends and evenings of daddy-time so that I could work on my writing. I would also like to thank my Mom and Dad, who provided an environment where my curiosity could develop as I was allowed try things and learn from my mistakes, and for always supporting me through the good and the bad times.

I would also like to thank my customers and colleagues who constantly challenge me to go to the next level of knowledge and service. A special thanks to my manager, Vikas Anand, for his constant coaching, mentoring, leadership by example, and for his support in my taking on this project.

Alan Perlovsky is a Senior Principal Consultant with Oracle's SOA/Fusion Middleware Practice and has been with Oracle for last five years where he is helping the Oracle Clients with the adoption of technologies such as Service-Oriented Architecture (SOA), B2B, and security. After starting his career as an Enterprise Application Development in the early nineties, and until now, he has been lucky to be involved in many exciting projects such as 24x7 EDI and XML transaction Clearinghouse, the world's biggest HIPAA implementation to date, and Global Combat Support Systems that introduces cutting edge enabling technology in support of the US Marines logistics operations, among others.

No book can be written without taking help from someone. I would like to thank Janna, my beautiful wife, for her support and patience, my sons, Mike and Daniel, for inspiration. In addition, I would like to thank Boris Lublinsky for introduction to book writing, Steve Verba for providing valuable comments, and Teresa Short and Markus Reschberger for their help.

About the Reviewers

Prasanna Chandrashekhara is working as a Senior Development Manager in product development SOA—B2B Integration. He has worked as one of the core Developers for Oracle B2B and Oracle SOA for healthcare and he has been with the product since Oracle B2B 10g.

He has around 13 years of Industry experience specializing around 9 years in trading partner integration and product development.

Ankit Pradhan is a Solution Architect with more than 10 years of experience in the design and implementation of large scale Enterprise Application Integration (EAI) and SOA-based solutions for major financial and telecom companies in USA and EMEA region.

He is currently part of an architecture consulting group of one of World's leading consulting companies in the Enterprise Business Integration and Cloud Computing space.

He holds a Bachelor of Engineering Degree in Computer Science and Post Graduate Diploma in Business Administration with Finance as major.

www.PacktPub.com

Support files, eBooks, discount offers and more

You might want to visit www.PacktPub.com for support files and downloads related to your book.

Did you know that Packt offers eBook versions of every book published, with PDF and ePub files available? You can upgrade to the eBook version at www.PacktPub.com and as a print book customer, you are entitled to a discount on the eBook copy. Get in touch with us at for more details.

At www.PacktPub.com, you can also read a collection of free technical articles, sign up for a range of free newsletters and receive exclusive discounts and offers on Packt books and eBooks.

http://PacktLib.PacktPub.com

Do you need instant solutions to your IT questions? PacktLib is Packt's online digital book library. Here, you can access, read and search across Packt's entire library of books. 

Why Subscribe?

Fully searchable across every book published by Packt

Copy and paste, print and bookmark content

On demand and accessible via web browser

Free Access for Packt account holders

If you have an account with Packt at www.PacktPub.com, you can use this to access PacktLib today and view nine entirely free books. Simply use your login credentials for immediate access.

Instant Updates on New Packt Books

Get notified! Find out when new books are published by following @PacktEnterprise on Twitter, or the Packt Enterprise Facebook page.

Preface

Enterprises engaging in B2B communications with their trading partners are facing increased pressure to increase automation and reduce costs. Increased compliance requirements and globalization of economies are fuelling B2B adoption in every vertical. B2B Gateway solutions enable enterprises to connect with external trading partners using B2B protocols to meet these new requirements.

This book, written by the most knowledgeable Oracle B2B author team, is a step-by-step practical guide that provides you with the essential information required to implement Oracle B2B solutions, including multiple hands-on tutorials that will help you get up and run quickly.

Packed with practical examples, illustrations, and product screenshots explained with clear, step-by-step instructions, the book starts with a discussion on the B2B industry and the most relevant B2B standards. It goes on to provide Oracle B2B architecture internals. This includes an introduction to SCA and Oracle B2B integration with Oracle Fusion middleware. Based on Oracle's suggested best practices and methodologies, the book provides a wide coverage and detailed discussion of Oracle B2B functionality and features for new and advanced users. The book features helpful tips and information on Oracle B2B not available elsewhere coming from experts with real-world experience with hundreds of B2B customers.

What this book covers

Chapter 1, B2B Overview, introduces the reader to the concept of B2B, provide an overview of B2B architecture, message processing patterns and the B2B Gateway, and describe the most relevant B2B standards.

Chapter 2, Oracle B2B Overview, builds the groundwork for the reader's further journey into Oracle B2B. It will provide the reader with Oracle B2B installation tips, SCA concepts, and Oracle B2B architecture highlights.

Chapter 3, Creating Document Definitions, describes how to create different document guidelines in Oracle B2B Document Editor and import these guidelines as document definitions in Oracle B2B.

Chapter 4, Trading Partner Management, describes how to configure host and remote trading partners, and how to create trading partner agreements and deploy them.

Chapter 5, Setting up B2B Transactions, explains how to create the sequence of steps needed to set up different documents, partners, and agreements.

Chapter 6, SOA Suite Integration, explains how to connect Oracle B2B with Oracle SOA Suite using different mechanisms, and you will learn how to choose the right mechanism for your situation.

Chapter 7, Reporting and Monitoring, explains how to monitor the runtime transactions using the reports and monitoring capabilities.

Chapter 8, Exception Handling, explains about the specific types of inbound and outbound exceptions that can occur and will be introduced to a custom exception handling process that incorporates human workflow into the error resolution process.

Chapter 9, Oracle B2B Security Management, explains Oracle B2B security features and how they are integrated into the overall Oracle Fusion Middleware (OFM) security paradigm.

Chapter 10, Preparing to Go-Live, explains how to build your production B2B topology, how to migrate your B2B installation from test to production, what tools are available to perform B2B administration, and how to tune your environment for optimal performance.

Chapter 11, Advanced Topics, explains how B2B Callouts can be used to invoke custom Java code, how the B2B Self-Service APIs can be used to create metadata in bulk, and how B2B utilities can be used to enqueue and dequeue messages based on AQ and JMS based queues.

What you need for this book

The virtual image of the Oracle SOA Suite patch release PS5 (11.1.1.6) installed on a LINUX platform has been used by the authors throughout the book. The deployment uses Oracle Database EE 11g as a common repository. This also applies to the version of JDeveloper. The Document Editor version used is 7.0.5

Who this book is for

This tutorial is intended for a wide range of audiences which includes SOA developers, SOA Suite and B2B administrators, and SOA architects. However some prior experience with SOA Suite 11g is necessary. This experience should include basic knowledge of WebLogic Server, BPEL Process Manager, and Oracle Mediator.

Conventions

In this book, you will find a number of styles of text that distinguish between different kinds of information. Here are some examples of these styles, and an explanation of their meaning.

Code words in text, database table names, folder names, filenames, file extensions, pathnames, dummy URLs, user input, and Twitter handles are shown as follows.

Both CPA and CPP are XML documents that have the same root element CollaborationProtocolProfile with PartyInfo, Packaging, Signature, and Comment elements.

A block of code is set as follows:

      850

      0001

When we wish to draw your attention to a particular part of a code block, the relevant lines or items are set in bold:

>

      00

      AB

B1234567

      1

      20120929

Any command-line input or output is written as follows:

cd /ProgramData/Propeople rm -r Drush git clone --branch master http://git.drupal.org/project/drush.git

New terms and important words are shown in bold. Words that you see on the screen, in menus or dialog boxes for example, appear in the text like this: On the Select Destination Location screen, click on Next to accept the default destination.

Note

Warnings or important notes appear in a box like this.

Tip

Tips and tricks appear like this.

Reader feedback

Feedback from our readers is always welcome. Let us know what you think about this book—what you liked or may have disliked. Reader feedback is important for us to develop titles that you really get the most out of.

To send us general feedback, simply send an e-mail to <feedback@packtpub.com>, and mention the book title via the subject of your message.

If there is a topic that you have expertise in and you are interested in either writing or contributing to a book, see our author guide on www.packtpub.com/authors.

Customer support

Now that you are the proud owner of a Packt book, we have a number of things to help you to get the most from your purchase.

Downloading the example code

You can download the example code files for all Packt books you have purchased as well as the high resolution graphics of this book from your account at http://www.packtpub.com. If you purchased this book elsewhere, you can visit http://www.packtpub.com/support and register to have the files e-mailed directly to you.

Errata

Although we have taken every care to ensure the accuracy of our content, mistakes do happen. If you find a mistake in one of our books—maybe a mistake in the text or the code—we would be grateful if you would report this to us. By doing so, you can save other readers from frustration and help us improve subsequent versions of this book. If you find any errata, please report them by visiting http://www.packtpub.com/submit-errata, selecting your book, clicking on the errata submission form link, and entering the details of your errata. Once your errata are verified, your submission will be accepted and the errata will be uploaded on our website, or added to any list of existing errata, under the Errata section of that title. Any existing errata can be viewed by selecting your title from http://www.packtpub.com/support.

Piracy

Piracy of copyright material on the Internet is an ongoing problem across all media. At Packt, we take the protection