Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

Part I IDE Help for Oracle Service Bus

1 Introduction to Oracle Service Bus

2 Tasks

• 2.1 Working with Projects, Folders, Resources, and Configurations
  • 2.1.1 Resource Naming Restrictions
  • 2.1.2 Editing Resources
  • 2.1.3 Cloning Oracle Service Bus Projects and Folders
  • 2.1.4 Creating Oracle Service Bus Configuration Projects
  • 2.1.5 Creating Oracle Service Bus Projects
  • 2.1.6 Creating Servers
  • 2.1.7 Creating Custom Resources
  • 2.1.8 Creating and Editing JNDI Provider Resources
  • 2.1.9 Creating Proxy Server Resources
  • 2.1.10 Creating Message Format Files
  • 2.1.11 Exporting Resources
    • 2.1.11.1 Using the Export Wizard
    • 2.1.11.2 Using the Command Line or a Script to Export an Oracle Service Bus Configuration
  • 2.1.12 Generating an Effective WSDL
  • 2.1.13 Modifying JAR Dependencies
  • 2.1.14 Importing Resources
    • 2.1.14.1 Using the Import Wizard
    • 2.1.14.2 Using the Command Line or a Script to Import an Oracle Service Bus Configuration
  • 2.1.15 Creating Service Account Resources
  • 2.1.16 Creating Service Key Provider Resources
  • 2.1.17 Creating SMTP Server Resources
  • 2.1.18 Creating XQuery Transformations
  • 2.1.19 Creating XSL Transformations
• 2.2 Working with Business Services
  • 2.2.1 Creating Business Services
    • 2.2.1.1 Generating a Business Service from an Existing Service
  • 2.2.2 Generating a JCA Business Service from an Outbound JCA File
  • 2.2.3 Generating a Business Service from Oracle Enterprise Repository
    • 2.2.3.1 Re-generating an Existing Business Service from Oracle Enterprise Repository
  • 2.2.4 Editing Business Services
• 2.3 Working with Proxy Services
  • 2.3.1 Creating Proxy Services
    • 2.3.1.1 Generating a Proxy Service from an Existing Service
  • 2.3.2 Generating a JCA Proxy Service from an Inbound JCA File
  • 2.3.3 Consuming Oracle Service Bus Proxy Services in Oracle JDeveloper with WSIL
  • 2.3.4 Editing Proxy Services
• 2.4 Working with Proxy Service Message Flows
  • 2.4.1 Constructing Proxy Service Message Flows
  • 2.4.2 Adding and Configuring Alert Actions in Message Flows
  • 2.4.3 Adding and Configuring Assign Actions in Message Flows
  • 2.4.4 Adding and Configuring Conditional Branch Nodes in Message Flows
  • 2.4.5 Adding and Configuring Delete Actions in Message Flows
  • 2.4.6 Adding and Configuring Dynamic Publish Actions in Message Flows
  • 2.4.7 Adding and Configuring Dynamic Routing Actions in Message Flows
  • 2.4.8 Adding and Configuring Error Handlers in Message Flows
  • 2.4.9 Adding and Configuring For-Each Actions in Message Flows
  • 2.4.10 Adding and Configuring If-Then Actions in Message Flows
  • 2.4.11 Adding and Configuring Insert Actions in Message Flows
  • 2.4.12 Adding and Configuring Java Callout Actions in Message Flows
  • 2.4.13 Adding and Configuring Log Actions in Message Flows
  • 2.4.14 Adding and Configuring MFL Transform Actions in Message Flows
  • 2.4.15 Adding and Configuring Operational Branch Nodes in Message Flows
  • 2.4.16 Adding and Configuring Pipeline Pair Nodes in Message Flows
  • 2.4.17 Adding and Configuring Publish Actions in Message Flows
  • 2.4.18 Adding and Configuring Publish Table Actions in Message Flows
  • 2.4.19 Adding and Configuring Raise Error Actions in Message Flows
  • 2.4.20 Adding and Configuring Rename Actions in Message Flows
  • 2.4.21 Adding and Configuring Replace Actions in Message Flows
  • 2.4.22 Adding and Configuring Reply Actions in Message Flows
  • 2.4.23 Adding and Configuring Report Actions in Message Flows
  • 2.4.24 Adding and Configuring Resume Actions in Message Flows
  • 2.4.25 Adding and Configuring Route Nodes in Message Flows
  • 2.4.26 Adding and Configuring Routing Actions in Message Flows
  • 2.4.27 Adding and Configuring Routing Options Actions in Message Flows
  • 2.4.28 Adding and Configuring Routing Table Actions in Message Flows
  • 2.4.29 Adding and Configuring Service Callout Actions in Message Flows
  • 2.4.30 Adding and Configuring Skip Actions in Message Flows
  • 2.4.31 Adding and Configuring Stages in Message Flows
  • 2.4.32 Adding and Configuring Transport Headers Actions in Message Flows
  • 2.4.33 Adding and Configuring Validate Actions in Message Flows
• 2.5 Working with Alert Destinations
  • 2.5.1 Creating and Editing Alert Destinations
  • 2.5.2 Adding E-mail Recipients to Alert Destinations
  • 2.5.3 Adding JMS Destinations to Alert Destinations
• 2.6 Working with MQ Connections
  • 2.6.1 Adding and Editing MQ Connections
• 2.7 Working with Oracle Enterprise Repository and Harvester
  • 2.7.1 Generating Business Services from Oracle Enterprise Repository
  • 2.7.2 Using Harvester
    • 2.7.2.1 Using Harvester from Eclipse
    • 2.7.2.2 Using Harvester from the Command Line or a Script
  • 2.7.3 Performing Queries in Oracle Enterprise Repository from Eclipse
• 2.8 Working with UDDI Registries
  • 2.8.1 Adding and Configuring UDDI Registries
  • 2.8.2 Importing Business Services From a UDDI Registry
• 2.9 Working with Split-Join
  • 2.9.1 Introduction to Split-Join
    • 2.9.1.1 Using Split-Join with Content in SOAP Headers
    • 2.9.1.2 Transaction Support
    • 2.9.1.3 Security with Split-Joins
  • 2.9.2 Designing a Split-Join
    • 2.9.2.1 Initial Setup
  • 2.9.3 Designing a Static Split-Join
    • 2.9.3.1 1. Creating a New Split-Join
    • 2.9.3.2 2. Adding an Assign
    • 2.9.3.3 3. Adding a Parallel Node
    • 2.9.3.4 4. Adding an Assign for Each Branch
    • 2.9.3.5 5. Adding an Invoke Service
    • 2.9.3.6 6. Adding an Assign for Each Branch
    • 2.9.3.7 7. Exporting and Testing the Split-Join
  • 2.9.4 Designing a Dynamic Split-Join
    • 2.9.4.1 1. Creating a New Split-Join
    • 2.9.4.2 2. Adding an Assign
    • 2.9.4.3 3. Adding a For Each
    • 2.9.4.4 4. Adding an Assign
    • 2.9.4.5 5. Adding an Invoke Service
    • 2.9.4.6 6. Adding an Assign
    • 2.9.4.7 7. Adding an Error Handler
    • 2.9.4.8 8. Exporting and Testing the Split-Join
  • 2.9.5 Creating a New Split-Join
  • 2.9.6 Configuring the Start Node
    • 2.9.6.1 Adding General Information
    • 2.9.6.2 Defining Global Variables
    • 2.9.6.3 Viewing External Services
  • 2.9.7 Configuring a Receive
    • 2.9.7.1 Viewing the Operation
    • 2.9.7.2 Defining the Receive Variable
    • 2.9.7.3 Adding General Information
  • 2.9.8 Creating an Assign
    • 2.9.8.1 Adding and Configuring Assign Operations
    • 2.9.8.2 Adding General Information
  • 2.9.9 Invoking a Service
    • 2.9.9.1 Selecting an Operation
    • 2.9.9.2 Defining Input and Output Variables
    • 2.9.9.3 Adding General Information
  • 2.9.10 Creating a Parallel
    • 2.9.10.1 Adding Nodes
    • 2.9.10.2 Adding General Information
  • 2.9.11 Creating a For Each
    • 2.9.11.1 Defining the For Each Logic
    • 2.9.11.2 Adding General Information
  • 2.9.12 Creating an If Activity
    • 2.9.12.1 Configuring the If
    • 2.9.12.2 Adding and Configuring Else If
    • 2.9.12.3 Configuring the Else
    • 2.9.12.4 Adding General Information
  • 2.9.13 Creating an Error Handler
  • 2.9.14 Creating a Raise Error
  • 2.9.15 Configuring a Reply
    • 2.9.15.1 Viewing the Operation
    • 2.9.15.2 Defining the Reply Variable
    • 2.9.15.3 Adding General Information
  • 2.9.16 About Scope
    • 2.9.16.1 Scope and Variables
  • 2.9.17 Exporting and Testing a Split-Join
    • 2.9.17.1 Creating a Transport Typed Business Service
    • 2.9.17.2 Exporting the Split-Join Files
    • 2.9.17.3 Testing the Split-Join in the Test Console
• 2.10 Using the Oracle Service Bus Debugger
  • 2.10.1 Enabling Debugging
  • 2.10.2 Using Standard Debugging
    • 2.10.2.1 Debug Views
    • 2.10.2.2 Step Actions and Breakpoints
  • 2.10.3 Using the Oracle Service Bus Debugger Launch Configuration
    • 2.10.3.1 Remote Debugging
    • 2.10.3.2 Debugging Oracle Service Bus Running Stand-Alone on a Managed Server
    • 2.10.3.3 Server Sharing

3 Transport Configuration

• 3.1 Protocol-Specific Transport Configuration Pages
  • 3.1.1 BPEL-10g Transport Configuration Page (Business Services)
  • 3.1.2 DSP Transport Configuration Page (Business Services)
  • 3.1.3 EJB Transport Configuration Page (Business Services)
  • 3.1.4 E-Mail Transport Configuration Page (Business Services)
  • 3.1.5 E-Mail Transport Configuration Page (Proxy Services)
  • 3.1.6 File Transport Configuration Page (Business Services)
  • 3.1.7 File Transport Configuration Page (Proxy Services)
  • 3.1.8 FTP Transport Configuration Page (Business Services)
  • 3.1.9 FTP Transport Configuration Page (Proxy Services)
  • 3.1.10 HTTP Transport Configuration Page (Business Services)
  • 3.1.11 HTTP Transport Configuration Page (Proxy Services)
  • 3.1.12 JCA Transport Configuration Page (Proxy and Business Services)
  • 3.1.13 JEJB Transport Configuration Page (Business Services)
  • 3.1.14 JEJB Transport Configuration Page (Proxy Services)
  • 3.1.15 JMS Transport Configuration Page (Business Services)
  • 3.1.16 JMS Transport Configuration Page (Proxy Services)
  • 3.1.17 MQ Transport Configuration Page (Business Services)
  • 3.1.18 MQ Transport Configuration Page (Proxy Services)
  • 3.1.19 SB Transport Configuration Page (Business Services)
  • 3.1.20 SB Transport Configuration Page (Proxy Services)
  • 3.1.21 SFTP Transport Configuration Page (Business Services)
  • 3.1.22 SFTP Transport Configuration Page (Proxy Services)
  • 3.1.23 SOA-DIRECT Transport Configuration Page (Business Services)
  • 3.1.24 Tuxedo Transport Configuration Page (Business Services)
  • 3.1.25 Tuxedo Transport Configuration Page (Proxy Services)
  • 3.1.26 WS Transport Configuration Page (Business Services)
  • 3.1.27 WS Transport Configuration Page (Proxy Services)

4 User Interface Reference

• 4.1 Alerts
  • 4.1.1 Alert Destination Editor
  • 4.1.2 Edit E-mail Recipient Page
  • 4.1.3 Edit JMS Destination Page
• 4.2 Business Service Configuration
  • 4.2.1 Business Service General Configuration Page
    • 4.2.1.1 Business Service Editor Options
  • 4.2.2 Business Service Message Type Configuration Page
  • 4.2.3 Business Service SOAP Binding Configuration Page
  • 4.2.4 Business Service Transport Configuration Page
  • 4.2.5 Business Service Message Handling Configuration Page
  • 4.2.6 Business Service - Service Policy Configuration Page
  • 4.2.7 Business Service Security Configuration Page
• 4.3 Proxy Service Configuration
  • 4.3.1 Proxy Service General Configuration Page
    • 4.3.1.1 Proxy Service Editor Options
  • 4.3.2 Proxy Service Message Type Configuration Page
  • 4.3.3 Proxy Service Operation Selection Configuration Page
  • 4.3.4 Proxy Service Message Handling Configuration Page
  • 4.3.5 Proxy Service SOAP Binding Configuration Page
  • 4.3.6 Proxy Service Transport Configuration Page
  • 4.3.7 Proxy Service - Service Policy Configuration Page
  • 4.3.8 Proxy Service Security Configuration Page
• 4.4 Oracle Service Bus Configurations and Projects
  • 4.4.1 Oracle Service Bus Configurations View
  • 4.4.2 New Oracle Service Bus Configuration Project Wizard
  • 4.4.3 Oracle Service Bus Configuration Page
  • 4.4.4 New Oracle Service Bus Project
• 4.5 Custom Resources
  • 4.5.1 New Custom Resource Wizard
  • 4.5.2 New Custom Resource Editor
  • 4.5.3 New Custom Resource - Resource Type Page
  • 4.5.4 Custom MQ Resource Configuration Page
• 4.6 Export Wizard
  • 4.6.1 Export Wizard - Oracle Service Bus Configuration JAR Export Page
  • 4.6.2 Export Wizard - Export to Server - Select Resources Page
  • 4.6.3 Export Wizard - Export to Server - Review Resources Page
• 4.7 Import Wizard
  • 4.7.1 Import Wizard - Config JAR Import - Load Resources Page
  • 4.7.2 Import Wizard - Config JAR Import - Review Resources Page
  • 4.7.3 Import Wizard - Config ZIP Import - Load Resources Page
  • 4.7.4 Import Wizard - Config ZIP Import - Review Resources Page
  • 4.7.5 Import Wizard - URL Import - Load Resources Page
  • 4.7.6 Import Wizard - URL Import - Review Resources Page
• 4.8 JNDI Providers
  • 4.8.1 JNDI Provider Editor
  • 4.8.2 New JNDI Provider Resource Wizard
• 4.9 Proxy Servers
• 4.10 Message Flow Design Palette
  • 4.10.1 Message Flow Nodes
  • 4.10.2 Message Flow Route Actions - Communication Actions
  • 4.10.3 Message Flow Route Actions - Flow Control Actions
  • 4.10.4 Message Flow Stage Actions - Communication Actions
  • 4.10.5 Message Flow Stage Actions - Flow Control Actions
  • 4.10.6 Message Flow Stage Actions - Message Processing Actions
  • 4.10.7 Message Flow Stage Actions - Reporting Actions
• 4.11 Message Flow Editor
  • 4.11.1 Alert Action Properties
  • 4.11.2 Assign Action Properties
  • 4.11.3 Conditional Branch Node Properties
  • 4.11.4 Delete Action Properties
  • 4.11.5 Dynamic Publish Action Properties
  • 4.11.6 Dynamic Routing Action Properties
  • 4.11.7 Error Handler Node Properties
  • 4.11.8 For-Each Action Properties
  • 4.11.9 If-Then Action Properties
    • 4.11.9.1 If Action and Else-If Action Properties
    • 4.11.9.2 Else Action Properties
  • 4.11.10 Insert Action Properties
  • 4.11.11 Java Callout Action Properties
  • 4.11.12 Log Action Properties
  • 4.11.13 Message Flow Properties - Comment
  • 4.11.14 Message Flow Properties - Namespaces
  • 4.11.15 Message Flow Properties - Variables
  • 4.11.16 MFL Transform Action Properties
  • 4.11.17 Operational Branch Node Properties
  • 4.11.18 Pipeline Pair Node Properties
  • 4.11.19 Publish Action Properties
  • 4.11.20 Publish Table Action Properties
    • 4.11.20.1 Publish Table Properties
    • 4.11.20.2 Case Action Properties
    • 4.11.20.3 Publish Action Properties
  • 4.11.21 Raise Error Action Properties
    • 4.11.21.1 Transactions
  • 4.11.22 Rename Action Properties
  • 4.11.23 Replace Action Properties
  • 4.11.24 Reply Action Properties
  • 4.11.25 Report Action Properties
  • 4.11.26 Resume Action Properties
  • 4.11.27 Route Node Properties
  • 4.11.28 Routing Action Properties
  • 4.11.29 Routing Options Action Properties
  • 4.11.30 Routing Table Action Properties
    • 4.11.30.1 Routing Table Properties
    • 4.11.30.2 Case Action Properties
    • 4.11.30.3 Routing Action Properties
  • 4.11.31 Service Callout Action Properties
  • 4.11.32 Skip Action Properties
  • 4.11.33 Stage Node Properties
  • 4.11.34 Transport Headers Action Properties
  • 4.11.35 Validate Action Properties
• 4.12 Modify JAR Dependencies Dialog
• 4.13 SMTP Servers
  • 4.13.1 Edit SMTP Server Page
  • 4.13.2 New SMTP Server Resource Wizard
• 4.14 UDDI Registry Configuration Page
• 4.15 Outline view - Oracle Service Bus
• 4.16 Resource Management
  • 4.16.1 Preferences dialog - Oracle Service Bus - Type Associations Page
  • 4.16.2 References View
  • 4.16.3 Select Clone Target Dialog
  • 4.16.4 Select a Resource Dialog
• 4.17 New Service Key Provider Resource
• 4.18 New WS-Policy
• 4.19 Service Accounts
  • 4.19.1 New Service Account Resource
  • 4.19.2 Service Account Editor - General Configuration Page
  • 4.19.3 Service Account Editor - Static User Configuration Page
  • 4.19.4 Service Account Editor - User Mappings Configuration Page
• 4.20 Expression Editors
  • 4.20.1 XQuery/XSLT Expression Editor
  • 4.20.2 XPath Expression Editor
  • 4.20.3 Condition Editor
  • 4.20.4 Condition Builder Page
  • 4.20.5 Expression Page
  • 4.20.6 XQuery Resource Page
  • 4.20.7 XSLT Resource Page
  • 4.20.8 Dynamic XQuery Page
  • 4.20.9 Variable Structures Page
  • 4.20.10 Namespace Definitions Page
  • 4.20.11 XQuery Functions Page
  • 4.20.12 Add Variable Structure Dialog
• 4.21 New XSL Transformation
• 4.22 Split-Join User Interface Reference
  • 4.22.1 Split-Join Design Palette
    • 4.22.1.1 Operations
  • 4.22.2 Global / Start Node Properties
  • 4.22.3 Variable Properties
  • 4.22.4 Error Handler Properties
  • 4.22.5 Invoke Service Properties
    • 4.22.5.1 Invoking Another Split-Join
  • 4.22.6 Reply Properties
  • 4.22.7 For Each Properties
  • 4.22.8 If Properties
  • 4.22.9 If and Else If Properties
  • 4.22.10 Parallel Properties
  • 4.22.11 Raise Error Properties
  • 4.22.12 Repeat Until Properties
  • 4.22.13 Re-Raise Error Properties
  • 4.22.14 Scope Properties
  • 4.22.15 While Properties
  • 4.22.16 Wait Properties
  • 4.22.17 Assign Properties
    • 4.22.17.1 Assign Operation Properties
  • 4.22.18 Copy Properties
  • 4.22.19 Delete Properties
  • 4.22.20 Insert Properties
  • 4.22.21 Java Callout Properties
  • 4.22.22 Log Properties
  • 4.22.23 Replace Properties
  • 4.22.24 Receive Properties
  • 4.22.25 Counter Variable Dialog
  • 4.22.26 Create/Edit Variable Dialog
    • 4.22.26.1 Scope and Variables
  • 4.22.27 Create Message Variable Dialog
  • 4.22.28 Service Browser
  • 4.22.29 SOAP Fault Variable Dialog
  • 4.22.30 WSDL Browser
  • 4.22.31 Split-Join Wizard - New Split-Join
  • 4.22.32 Split-Join Wizard - Specify Operations

Part II XQuery Mapper

5 Introduction

• 5.1 Overview of XQuery Mapper
• 5.2 Support for XQuery 2002 and 2004
  • 5.2.1 Restrictions Applicable to the XQuery Test View

6 Transforming Data Using XQuery Mapper

• 6.1 Launching XQuery Mapper
• 6.2 Importing the XQuery Mapper Sample Project
• 6.3 Creating an XQuery Mapper Project
• 6.4 Importing and Creating Schema Files
  • 6.4.1 Importing XML Schemas and MFL Files
  • 6.4.2 Creating XML Schemas
  • 6.4.3 Creating XML Files from XML Schemas
  • 6.4.4 Creating WSDL Files
  • 6.4.5 Creating MFL Files
• 6.5 Selecting Source and Target Data Types
• 6.6 Creating Data Transformations
  • 6.6.1 Creating Basic Element Transformations
    • 6.6.1.1 Prerequisite
    • 6.6.1.2 Creating Element-to-Element Links
  • 6.6.2 Creating Basic Attribute Transformations
    • 6.6.2.1 Prerequisite
    • 6.6.2.2 Creating an Attribute-to-Element Link
  • 6.6.3 Creating Complex Transformations
    • 6.6.3.1 Prerequisite
    • 6.6.3.2 Creating a Complex Transformation
• 6.7 Editing Data Transformations
  • 6.7.1 Viewing and Editing XQuery Files
  • 6.7.2 Creating Joins and Unions
  • 6.7.3 Creating If-Then-Else Expressions
  • 6.7.4 Creating For-Let-Where-Order By-Return (FLWOR) Expressions
  • 6.7.5 Creating Typeswitch Expressions
  • 6.7.6 Inserting XQuery Functions
  • 6.7.7 Inserting Expression Variables
  • 6.7.8 Viewing Schema Properties
• 6.8 Restricting Output of Optional Elements
• 6.9 Testing Data Transformations
  • 6.9.1 Features of the Test View
    • 6.9.1.1 Related Topics
• 6.10 Graphical Features in Design View
  • 6.10.1 Right-Click Menu Options
  • 6.10.2 Link Patterns
  • 6.10.3 Link Colors
• 6.11 XML Global Elements, Global Types, Local Elements, and Attributes

7 Examples: Data Transformation Using XQuery Mapper

• 7.1 Combining Data from Different Schemas
• 7.2 Mapping Repeating Elements and Creating Joins
  • 7.2.1 Step 1. Create an XQuery File
  • 7.2.2 Step 2. Add a Constraint
  • 7.2.3 Step 3. Add Data to Return Element
  • 7.2.4 Step 4. Add Function to Calculate Value of Quote
  • 7.2.5 Step 5. Add a Constraint with Multiple Conditions
  • 7.2.6 Test the XQuery
• 7.3 Creating Unions
• 7.4 Creating Repeating-Source to Nonrepeating-Target Transformations
• 7.5 Creating Nonrepeating-Source to Repeating-Target Transformation
• 7.6 Creating Nested If-Then-Else Expressions
  • 7.6.1 Step 1. Create the XQuery Transformation
  • 7.6.2 Step 2. Create the First "If" Condition
  • 7.6.3 Step 3. Create the First Nested If-Then-Else Condition
  • 7.6.4 Step 4. Create the Second Nested If-Then-Else Condition
• 7.7 Creating FLWOR Expressions
• 7.8 Using Recursive Schemas
• 7.9 Grouping Data by Key Fields

8 Upgrading XQuery Code

• 8.1 Upgrading Inline XQuery Code
• 8.2 Upgrading XQuery Files

Part III Format Builder

9 Introduction

• 9.1 Overview

10 Format Builder Main Window

• 10.1 Using the Menu Bar
• 10.2 Using the Toolbar
• 10.3 Using the Tree Pane
• 10.4 Using the Shortcut Menus
• 10.5 Using Drag and Drop
• 10.6 Valid Names

11 Message Format Detail Window

12 Field Detail Window

13 Group Detail Window

14 Reference Detail Window

15 Comment Detail Window

16 Format Builder Options

17 Importing Metadata

• 17.1 Importing a Guideline XML File
• 17.2 Importing an XML Schema
• 17.3 Importing a COBOL Copybook
• 17.4 Importing C Structures
• 17.5 Starting the C Structure Importer
• 17.6 Generating MFL Data
• 17.7 Generating C Code
• 17.8 Importing an FML Field Table Class
  • 17.8.1 FML Field Table Class Importer Prerequisites
  • 17.8.2 Sample FML Field Table Class Files
  • 17.8.3 Creating XML with the FML Field Table Class Importer

18 Format Tester

• 18.1 Format Tester Window
• 18.2 Format Tester Menus
• 18.3 File Menu
• 18.4 Edit Menu
• 18.5 Display Menu
• 18.6 Generate Menu
• 18.7 Transform Menu
• 18.8 Shortcut Menu
• 18.9 Using the Non-XML Window
• 18.10 Using the Data Offset Feature
• 18.11 Using the Text Feature
• 18.12 Using the XML Window
• 18.13 Using the Debug Window
• 18.14 Using the Resize Bars
• 18.15 Debugging Format Definitions
• 18.16 Searching for Values
• 18.17 Searching for Offsets
• 18.18 Using the Debug Log

19 Format Builder Menus

• 19.1 File Menu
• 19.2 Edit Menu
• 19.3 Insert Menu
• 19.4 View Menu
• 19.5 Tools Menu
• 19.6 Help Menu
• 19.7 Shortcut Menu

20 How Do I?

• 20.1 Create a Message Format
• 20.2 Create a Group
• 20.3 Create a Field
• 20.4 Create a Comment
• 20.5 Create a Reference
• 20.6 Save a Document
• 20.7 Use Format Tester
• 20.8 Debug Format Definitions
• 20.9 Search for Values
• 20.10 Search for Offsets
• 20.11 Use the Debug Log
• 20.12 Character Delimiters
• 20.13 Specify a Delimiter
  • 20.13.1 Specify by Reference
  • 20.13.2 Specify by Value
• 20.14 Delimiter Match Rule
  • 20.14.1 Data Delimiter
  • 20.14.2 Escape Character
  • 20.14.3 None

21 Using the Palette

• 21.1 Displaying the Palette Window
• 21.2 Adding Items to the Palette
• 21.3 Adding Palette Items to a Message Format
• 21.4 Using the File Menu
• 21.5 Using the Shortcut Menu

22 Format Builder Supported Data Types

• 22.1 MFL Data Types
• 22.2 COBOL Copybook Importer Data Types
• 22.3 Unsupported C Language Features

Part IV General Development Topics

23 Development Environment Setup

• 23.1 Running Multiple Development Servers with Derby
  • 23.1.1 Derby Best Practices and Troubleshooting
    • 23.1.1.1 Troubleshooting Derby Configuration with Multiple Domains
  • 23.1.2 Sharing a Single Derby Database Instance Between Multiple Domains
  • 23.1.3 Running Each Domain with a Unique Derby Instance
• 23.2 Disabling the JMS Reporting Provider

24 Creating and Using Custom XPath Functions

• 24.1 Registering Custom Functions with Oracle Service Bus
• 24.2 Creating and Packaging the Custom Function Java Classes
  • 24.2.1 Creating the Class and Method
    • 24.2.1.1 Using Single-Dimensional Arrays
  • 24.2.2 Packaging the Custom Function Class
• 24.3 Using Custom Functions
  • 24.3.1 Using Custom Functions in Inline XQuery Expressions and XQuery Resources
  • 24.3.2 Using Custom Functions in XSLT Resources
• 24.4 Testing Custom XPath Functions in Eclipse
• 24.5 Deploying Custom Functions in a Cluster

Part V Transports

25 Oracle SOA Suite Transport (SOA-DIRECT)

• 25.1 About the SOA-DIRECT Transport
  • 25.1.1 WS-Addressing
  • 25.1.2 Security
  • 25.1.3 Environment Values
  • 25.1.4 Error Handling
    • 25.1.4.1 Connection Errors
    • 25.1.4.2 Application Errors
    • 25.1.4.3 Generic Errors
• 25.2 Using SOA Suite Services with Oracle Service Bus
  • 25.2.1 Simple Use Cases – Synchronous
    • 25.2.1.1 Synchronous Invocation of a SOA Composite
    • 25.2.1.2 Synchronous Invocation from a SOA Composite
    • 25.2.1.3 Associating Messages with the Correct Conversation
  • 25.2.2 Advanced Use Cases – Asynchronous
    • 25.2.2.1 Asynchronous Invocation of a SOA Composite
    • 25.2.2.2 Asynchronous Invocation from a SOA Composite
• 25.3 Transport Configuration Reference
  • 25.3.1 SOA-DIRECT Endpoint URI
    • 25.3.1.1 Cluster URI
    • 25.3.1.2 URI Examples
  • 25.3.2 SOA-DIRECT Transport Configuration for Business Services
• 25.4 WS-Addressing Reference
  • 25.4.1 ReplyTo Header
    • 25.4.1.1 Calling a SOA Composite Asynchronously with a SOA-DIRECT Business Service
    • 25.4.1.2 Calling Back to a SOA Composite Asynchronously with a SOA-DIRECT Business Service
  • 25.4.2 MessageID / RelatesTo Headers
• 25.5 XML Examples
  • 25.5.1 Conversation ID Examples
    • 25.5.1.1 Port and Message Definitions
    • 25.5.1.2 WS-Addressing that Sets the Conversation ID
    • 25.5.1.3 Message Payload Data that Sets the Conversation ID
    • 25.5.1.4 Transformation Examples
  • 25.5.2 Asynchronous Composite to Composite Native Communication Through Oracle Service Bus Example
    • 25.5.2.1 Port and Message Definitions
    • 25.5.2.2 BP1 to P1 – Initiate operation
    • 25.5.2.3 P1/B1 to BP2
    • 25.5.2.4 BP2 to P2 – onResult operation
    • 25.5.2.5 P2/B2 to BP1 – onResult operation

26 JCA Transport

• 26.1 About the JCA Transport
  • 26.1.1 Messaging
    • 26.1.1.1 Transactions
  • 26.1.2 Transport Headers
    • 26.1.2.1 $inbound and $outbound Request Headers
    • 26.1.2.2 $inbound-Only Request Headers
    • 26.1.2.3 $outbound-Only Request Headers
  • 26.1.3 Endpoint Properties
    • 26.1.3.1 Proxy Service Endpoint Properties (Inbound)
    • 26.1.3.2 Business Service Endpoint Properties (Outbound)
  • 26.1.4 Security
    • 26.1.4.1 Proxy Services
    • 26.1.4.2 Business Services
  • 26.1.5 Logging
    • 26.1.5.1 Oracle BAM Adapter Logging
  • 26.1.6 Error Handling
    • 26.1.6.1 EIS Fault Details in JCA Business Services
    • 26.1.6.2 Business Service Retry Application Errors
  • 26.1.7 URI Rewriting
  • 26.1.8 Environment Variables
  • 26.1.9 Encoding
• 26.2 Working with Adapters
  • 26.2.1 Adapter Support
    • 26.2.1.1 Oracle JCA Adapter Limitations
  • 26.2.2 JCA Adapter Framework
  • 26.2.3 Configuring Adapters – General
  • 26.2.4 Configuring Adapters that Poll a Database
  • 26.2.5 Configuring the Oracle JCA Adapter for Database
  • 26.2.6 Configuring the Oracle JCA Adapter for AQ
  • 26.2.7 Rejected Messages
• 26.3 Invoking an EIS Service Through Oracle Service Bus
  • 26.3.1 Creating, Configuring, and Invoking the Services
• 26.4 Invoking an External Service from an EIS
  • 26.4.1 Creating, Configuring, and Invoking the Services
• 26.5 Transport Configuration Reference
  • 26.5.1 Endpoint URI
    • 26.5.1.1 Endpoint Redeployment
  • 26.5.2 JCA Transport Configuration for Proxy and Business Services
  • 26.5.3 Proxy Service Operation Configuration
  • 26.5.4 Proxy Service Message Handling
  • 26.5.5 Policies

27 HTTP and Poller Transports

• 27.1 HTTP Transport
  • 27.1.1 Configuring Proxy Services using the HTTP Transport
  • 27.1.2 Configuring Business Services using the HTTP Transport
  • 27.1.3 REST Support
    • 27.1.3.1 REST in Proxy Services
    • 27.1.3.2 REST in Business Services
• 27.2 E-mail Transport
  • 27.2.1 Configuring Proxy Services Using the E-mail Transport
  • 27.2.2 Configuring Business Services Using the E-mail Transport
• 27.3 File Transport
  • 27.3.1 Configuring Proxy Services using the File Transport
  • 27.3.2 Configuring Business Services using the File Transport
• 27.4 FTP Transport
  • 27.4.1 Configuring Proxy Services using the FTP Transport
  • 27.4.2 Configuring Business Services using the FTP Transport
• 27.5 SFTP Transport
  • 27.5.1 Environment Values
  • 27.5.2 General Principles of SFTP Authentication
  • 27.5.3 Run-Time Behavior
  • 27.5.4 Using the SFTP Transport
    • 27.5.4.1 Enabling SFTP Authentication
    • 27.5.4.2 Configuring Proxy Services
    • 27.5.4.3 Configuring Business Services
    • 27.5.4.4 Handling Communication Errors
    • 27.5.4.5 Troubleshooting
    • 27.5.4.6 Importing Resources
    • 27.5.4.7 Importing and Publishing Services: UDDI Registries

28 SB Transport

• 28.1 Environmental Values
• 28.2 Configuring Proxy Services to Use the SB Transport
• 28.3 Configuring Business Services to Use the SB Transport
  • 28.3.1 JNDI Provider
• 28.4 Handling Errors
• 28.5 UDDI
  • 28.5.1 Publishing a Service
  • 28.5.2 Importing a Service

29 EJB Transport

• 29.1 Introduction
• 29.2 Invoking EJBs from Oracle Service Bus
  • 29.2.1 Register a JNDI Provider Resource
    • 29.2.1.1 Adding a JNDI Provider
  • 29.2.2 Register an EJB Client JAR Resource
    • 29.2.2.1 Adding a Client or Converter JAR
    • 29.2.2.2 Create a Service Account (Optional)
    • 29.2.2.3 Locate an EJB in the JNDI Tree
  • 29.2.3 Transport Configuration Reference
    • 29.2.3.1 EJB Endpoint URI
    • 29.2.3.2 EJB Transport Configuration for Business Services
  • 29.2.4 Invoking EJB Business Services
• 29.3 Exposing EJBs as Web Services
• 29.4 Advanced Topics
  • 29.4.1 Transaction Processing, Retries, and Error Handling
    • 29.4.1.1 Transactions
    • 29.4.1.2 Retries and Failover
    • 29.4.1.3 Error Handling
  • 29.4.2 Supported Types and Converter Class
    • 29.4.2.1 Converter Classes
  • 29.4.3 Business Exception Classes
• 29.5 Troubleshooting
  • 29.5.1 Enabling Debug Mode
  • 29.5.2 Temp Directories
  • 29.5.3 Deployed Application
  • 29.5.4 Errors

30 JEJB Transport

• 30.1 About the JEJB Transport
  • 30.1.1 Difference Between the JEJB Transport and the EJB Transport
  • 30.1.2 Environment Values
  • 30.1.3 WSDL Generation
  • 30.1.4 Error Handling
    • 30.1.4.1 Exception Propagation in the Response
    • 30.1.4.2 Application and Connection Errors
• 30.2 Creating and Configuring JEJB Services
  • 30.2.1 Creating and Packaging Your Client EJB JAR
  • 30.2.2 Register a JNDI Provider Resource (Business Services)
    • 30.2.2.1 Adding a JNDI Provider
  • 30.2.3 Configuring a JEJB Proxy or Business Service
• 30.3 Use Cases
  • 30.3.1 EJB Invokes an External Service
  • 30.3.2 Non-EJB Client Invokes an EJB
  • 30.3.3 EJB Invokes EJB
• 30.4 Transport Configuration Reference
  • 30.4.1 JEJB Endpoint URI
    • 30.4.1.1 Proxy Service JEJB Endpoint URI
    • 30.4.1.2 Business Service JEJB Endpoint URI
  • 30.4.2 JEJB Transport Configuration for Proxy Services
  • 30.4.3 JEJB Transport Configuration for Business Services
• 30.5 Testing JEJB Services
• 30.6 UDDI Integration
  • 30.6.1 UDDI Publish
  • 30.6.2 UDDI Import

31 JMS Transport

• 31.1 Overview of JMS Interoperability
• 31.2 Asynchronous Request-Response Messaging
• 31.3 Using SOAP-JMS Transport
  • 31.3.1 Interoperating with Oracle WebLogic Server
    • 31.3.1.1 Configuring the Response Queues for Cross-Domain JMS Calls
• 31.4 Naming Guidelines for Domains, WebLogic, and JMS Servers
• 31.5 Specifying the JMS Type for Services
• 31.6 WSDL-Defined SOAP Fault Messages
• 31.7 Interoperability with WebSphere MQ
• 31.8 Interoperability with Tibco EMS
• 31.9 Message ID and Correlation ID Patterns for JMS Request/Response
  • 31.9.1 Overview of JMS Request-Response and Design Patterns
    • 31.9.1.1 Patterns for Messaging
  • 31.9.2 JMS Message ID Pattern
  • 31.9.3 JMS Correlation ID Pattern
  • 31.9.4 Comparison of Message ID and Correlation ID Patterns
  • 31.9.5 Interoperating with JAX-RPC Over JMS
    • 31.9.5.1 Invoking a JAX-RPC Web Service Using the JMS Message ID Pattern
    • 31.9.5.2 Invoking a JMS Request-Response Proxy Service from a JAX-RPC Client
  • 31.9.6 JMS Message ID Pattern Examples
    • 31.9.6.1 Example 1: An MQ Service Uses a JMS Message ID to Correlate the Request-Response Message
    • 31.9.6.2 Example 2: A JAX-RPC Client with Oracle Service Bus Proxy Service
    • 31.9.6.3 Example 3: Oracle Service Bus as a Client of an Oracle WebLogic Server JAX-RPC Request/Response Service
• 31.10 Using the JMS Transport
  • 31.10.1 Configuring Proxy Services using JMS Transport Protocol
  • 31.10.2 Transport Headers
    • 31.10.2.1 Configuring Transport Headers
  • 31.10.3 Sending and Receiving Java Objects in Messages
  • 31.10.4 Configuring Business Services using JMS Transport Protocol
  • 31.10.5 Error Handling

32 Local Transport

• 32.1 Introduction
• 32.2 Features and Characteristics of Local Transport Proxy Services
• 32.3 Message Handling for Local Transport Proxy Services
• 32.4 Usage of Local Transport Proxy Services
• 32.5 Limitations

33 WS Transport

• 33.1 Supported Functionality
  • 33.1.1 Messaging Patterns
  • 33.1.2 Policies
    • 33.1.2.1 WS-Policy Configurations
  • 33.1.3 Streaming Content for Large Messages
  • 33.1.4 Web Services Interoperability
• 33.2 Authentication and Authorization of Services
  • 33.2.1 Proxy Service Authentication
  • 33.2.2 Proxy Service Authorization
  • 33.2.3 Business Service Authentication
• 33.3 Using the WS Transport
  • 33.3.1 Adding Resources to an Oracle Service Bus Domain
    • 33.3.1.1 Configuring WS Policies
    • 33.3.1.2 Attaching WS Policies to a Service
  • 33.3.2 Configuring an Error Queue
  • 33.3.3 Configuring Proxy Services to Use the WS Transport
  • 33.3.4 Assigning Transport Access Control to Proxy Services
    • 33.3.4.1 Adding Policy Conditions
  • 33.3.5 Routing the WS Transport Through an HTTP Proxy Server
  • 33.3.6 Configuring Business Services to Use the WS Transport
• 33.4 Error Handling
• 33.5 Importing and Exporting Resources
• 33.6 Importing and Publishing Services Using UDDI Registries

34 MQ Transport

• 34.1 Key Features
• 34.2 Advantages of Using the MQ Transport
• 34.3 Supported Service Types
• 34.4 Messaging Patterns
• 34.5 Environment Values
• 34.6 Quality of Service
• 34.7 MQ Clusters and the MQ Transport
• 34.8 Using the MQ Transport
  • 34.8.1 Adding MQ Client Libraries to Your Environment
  • 34.8.2 MQ Connection Resources
    • 34.8.2.1 Creating an MQ Connection Resource
  • 34.8.3 Configuring Proxy Services to Use the MQ Transport
  • 34.8.4 Configuring Business Services to Use the MQ Transport
  • 34.8.5 Transport Headers
    • 34.8.5.1 Configuring Transport Headers
  • 34.8.6 Error Handling
  • 34.8.7 Limitations of the MQ Transport
• 34.9 Using the WebSphere JMS MQ Interface
  • 34.9.1 Using the WebSphere MQ JMS Interface
  • 34.9.2 Messaging Types
    • 34.9.2.1 Non-Persistent Messaging
    • 34.9.2.2 Non-XA Persistent Messaging
    • 34.9.2.3 XA Messaging
  • 34.9.3 Tuning WebSphere MQ

35 Oracle BPEL Process Manager Transport (for use with Oracle SOA Suite 10g only)

• 35.1 Overview
  • 35.1.1 SOAP Support
  • 35.1.2 Transaction Propagation
  • 35.1.3 SSL Support
  • 35.1.4 Environment Variables
• 35.2 Simple Use Cases (Synchronous)
  • 35.2.1 Synchronous: Invoking Processes in Oracle BPEL Process Manager
    • 35.2.1.1 Creating and Configuring the Services
  • 35.2.2 Synchronous: Calling External Services from Oracle BPEL Process Manager
    • 35.2.2.1 Creating and Configuring the Services
  • 35.2.3 Associating Messages with the Correct Conversation
• 35.3 Advanced Use Cases (Asynchronous)
  • 35.3.1 Asynchronous: Invoking Processes in Oracle BPEL Process Manager
    • 35.3.1.1 Creating and Configuring the Services
  • 35.3.2 Asynchronous: Calling Service Providers from Oracle BPEL Process Manager
    • 35.3.2.1 Creating and Configuring the Services
• 35.4 Transport Configuration Reference
  • 35.4.1 Endpoint URI
  • 35.4.2 bpel-10g Transport Configuration
• 35.5 Security
  • 35.5.1 Using SSL from Oracle Service Bus to Oracle Servers
• 35.6 Error Handling
  • 35.6.1 Application Errors
  • 35.6.2 Connection Errors
  • 35.6.3 Other Errors
• 35.7 WS-Addressing Reference
  • 35.7.1 ReplyTo
    • 35.7.1.1 Calling a BPEL Process Asynchronously Through Oracle Service Bus
    • 35.7.1.2 BPEL Processes Calling External Services Through Oracle Service Bus
  • 35.7.2 MessageID / RelatesTo
• 35.8 XML Examples
  • 35.8.1 Conversation ID Examples
    • 35.8.1.1 Port and Message Definitions
    • 35.8.1.2 WS-Addressing that Sets the Conversation ID
    • 35.8.1.3 Message Payload Data that Sets the Conversation ID
    • 35.8.1.4 Transformation Examples
  • 35.8.2 Asynchronous BPEL to BPEL Through Oracle Service Bus Example
    • 35.8.2.1 Port and Message Definitions
    • 35.8.2.2 BP1 to P1 – Initiate operation
    • 35.8.2.3 P1/B1 to BP2
    • 35.8.2.4 BP2 to P2 – onResult operation
    • 35.8.2.5 P2/B2 to BP1 – onResult operation

36 Tuxedo Transport

• 36.1 Overview
  • 36.1.1 Capabilities of the Tuxedo transport
• 36.2 Configuring the Oracle Tuxedo Connector
  • 36.2.1 Before You Begin
  • 36.2.2 Configuring Oracle Tuxedo Connector
• 36.3 Using Tuxedo Services from Oracle Service Bus
  • 36.3.1 Configuring a New Business Service
    • 36.3.1.1 Add a New Project
    • 36.3.1.2 Add a Business Service
  • 36.3.2 Load Balancing and Failover
  • 36.3.3 Handling Errors
  • 36.3.4 Testing Your Configuration
• 36.4 Using Oracle Service Bus from Tuxedo
  • 36.4.1 Adding and Configuring a Proxy Service
    • 36.4.1.1 Add a New Project
    • 36.4.1.2 Add a Proxy Service
    • 36.4.1.3 Configure the Proxy Service
  • 36.4.2 Testing Your Configuration
• 36.5 Tuxedo Transport Buffer Transformation
  • 36.5.1 Any XML Service Type
  • 36.5.2 Messaging Service Type
• 36.6 Tuxedo Transport Transaction Processing
  • 36.6.1 Inbound Services
  • 36.6.2 Outbound Services

37 DSP and Oracle Data Service Integrator Transport

• 37.1 Enabling Data Services for Oracle Service Bus
• 37.2 Using the DSP Transport
  • 37.2.1 Actions Needed Within Oracle Data Service Integrator
    • 37.2.1.1 Step 1. Start Your Server
    • 37.2.1.2 Step 2. Generate a WSDL from the Data Service
    • 37.2.1.3 Step 3: Obtaining the Web Service Address
  • 37.2.2 Actions Needed Within Oracle Service Bus
    • 37.2.2.1 Step 4: Import the Data Service WSDL into Oracle Service Bus
    • 37.2.2.2 Step 5: Create the Business Service
    • 37.2.2.3 Step 6: Create the Proxy Service
    • 37.2.2.4 Step 7: Test Your Setup

Part VI Transport SDK

38 Introduction

39 Design Considerations

• 39.1 What is a Transport Provider?
• 39.2 What is the Transport SDK?
  • 39.2.1 Purpose of the SDK
  • 39.2.2 Transport SDK Features
    • 39.2.2.1 Handling Inbound and Outbound Messages
    • 39.2.2.2 Deploying Transport-Related Artifacts
    • 39.2.2.3 Processing Messages Asynchronously
  • 39.2.3 Transport Provider Modes
  • 39.2.4 Related Features
    • 39.2.4.1 Load Balancing
    • 39.2.4.2 Monitoring and Metrics
• 39.3 Do You Need to Develop a Custom Transport Provider?
  • 39.3.1 When to Use the Transport SDK
  • 39.3.2 When Alternative Approaches are Recommended
• 39.4 Transport Provider Components
  • 39.4.1 Overview
  • 39.4.2 Design-Time Component
  • 39.4.3 Runtime Component
• 39.5 The Transaction Model
  • 39.5.1 Overview of Transport Endpoint Properties
    • 39.5.1.1 Transactional vs. Non-Transactional Endpoints
    • 39.5.1.2 Supported Message Patterns
  • 39.5.2 Support for Synchronous Transactions
    • 39.5.2.1 Use Case 1 (Response Pipeline Processing)
    • 39.5.2.2 Use Case 2 (Service Callout Processing)
    • 39.5.2.3 Use Case 3 (Suspending Transactions)
    • 39.5.2.4 Use Case 4 (Multiple URIs)
• 39.6 The Security Model
  • 39.6.1 Inbound Request Authentication
  • 39.6.2 Outbound Request Authentication
    • 39.6.2.1 Outbound Username/Password Authentication
    • 39.6.2.2 Outbound SSL Client Authentication (Two-Way SSL)
    • 39.6.2.3 Outbound JAAS Subject Authentication
  • 39.6.3 Link-Level or Connection-Level Credentials
  • 39.6.4 Uniform Access Control to Proxy Services
  • 39.6.5 Identity Propagation and Credential Mapping
• 39.7 The Threading Model
  • 39.7.1 Overview
  • 39.7.2 Inbound Request Message Thread
  • 39.7.3 Outbound Response Message Thread
  • 39.7.4 Support for Asynchrony
  • 39.7.5 Publish and Service Callout Threading
• 39.8 Designing for Message Content
  • 39.8.1 Overview
  • 39.8.2 Sources and Transformers
  • 39.8.3 Sources and the MessageContext Object
  • 39.8.4 Built-In Transformations

40 Developing a Transport Provider

• 40.1 Development Road Map
  • 40.1.1 Planning
  • 40.1.2 Developing
  • 40.1.3 Packaging and Deploying
• 40.2 Before You Begin
• 40.3 Basic Development Steps
  • 40.3.1 1. Review the Transport Framework Components
  • 40.3.2 2. Create a Directory Structure for Your Transport Project
  • 40.3.3 3. Create an XML Schema File for Transport-Specific Artifacts
  • 40.3.4 4. Define Transport-Specific Artifacts
    • 40.3.4.1 EndPointConfiguration
    • 40.3.4.2 RequestMetaDataXML
    • 40.3.4.3 RequestHeadersXML
    • 40.3.4.4 ResponseMetaDataXML
    • 40.3.4.5 ResponseHeadersXML
  • 40.3.5 5. Define the XMLBean TransportProviderConfiguration
  • 40.3.6 6. Implement the Transport Provider User Interface
  • 40.3.7 7. Implement the Runtime Interfaces
  • 40.3.8 8. Deploy the Transport Provider
• 40.4 Important Development Topics
• 40.5 Handling Messages
  • 40.5.1 Overview
  • 40.5.2 Sending and Receiving Message Data
  • 40.5.3 Request and Response Metadata Handling
  • 40.5.4 Character Set Encoding
  • 40.5.5 Co-Located Calls
  • 40.5.6 Returning Outbound Responses to Oracle Service Bus Runtime
• 40.6 Transforming Messages
• 40.7 Working with TransportOptions
  • 40.7.1 Inbound Processing
  • 40.7.2 Outbound Processing
  • 40.7.3 Request Mode
• 40.8 Handling Errors
  • 40.8.1 Case 1
  • 40.8.2 Case 2
  • 40.8.3 Case 3
  • 40.8.4 Catching Application Errors
    • 40.8.4.1 Identifying Application Errors
    • 40.8.4.2 Configuring Application Error Retries
  • 40.8.5 Catching Connection Errors
    • 40.8.5.1 Identifying Connection Errors
• 40.9 Defining Custom Environment Value Types
• 40.10 Publishing Proxy Services to a UDDI Registry
• 40.11 When to Implement TransportWLSArtifactDeployer
• 40.12 Creating Help for Custom Transports
  • 40.12.1 Custom Transport Help Overview
    • 40.12.1.1 Eclipse Help
    • 40.12.1.2 Oracle Service Bus Administration Console Help
  • 40.12.2 Providing Custom Transport Help in Eclipse
    • 40.12.2.1 Providing Context-Sensitive Help in Eclipse
    • 40.12.2.2 Providing Help in the Eclipse Help System
    • 40.12.2.3 Help Implementation Reference
    • 40.12.2.4 Packaging Help for the Transport Plug-in
    • 40.12.2.5 Related Topics
  • 40.12.3 Providing Custom Transport Help in the Oracle Service Bus Administration Console
    • 40.12.3.1 Implementing the CustomHelpProvider Interface
    • 40.12.3.2 Creating an HTML File to Launch
    • 40.12.3.3 Creating a Simple Web Application to Display Expanded Help (Optional)
    • 40.12.3.4 Packaging Transport Help for the Oracle Service Bus Administration Console

41 Developing Oracle Service Bus Transports for Eclipse

• 41.1 Introduction
• 41.2 Services Runtime and Services Configuration
  • 41.2.1 Offline Methods
  • 41.2.2 Restrictions when Working Offline
  • 41.2.3 Working Offline with a Remote Server
  • 41.2.4 Bootstrapping Transports in Offline Mode
  • 41.2.5 Packaging Transports in Offline Mode
• 41.3 Packaging Transports as Eclipse Plug-Ins
  • 41.3.1 Transport Plug-in Resources
  • 41.3.2 Transport Plug-in Packaging
• 41.4 Reference
  • 41.4.1 Working in Different Modes
  • 41.4.2 TransportProviderFactory
  • 41.4.3 Extension Point Schema
  • 41.4.4 plugin.xml
  • 41.4.5 MANIFEST.MF
  • 41.4.6 Build.xml
  • 41.4.7 TransportManagerHelper Methods

42 Transport SDK Interfaces and Classes

• 42.1 Introduction
• 42.2 Schema-Generated Interfaces
• 42.3 General Classes and Interfaces
  • 42.3.1 Summary of General Classes
  • 42.3.2 Summary of General Interfaces
• 42.4 Source and Transformer Classes and Interfaces
  • 42.4.1 Summary of Source and Transformer Interfaces
  • 42.4.2 Summary of Source and Transformer Classes
• 42.5 Metadata and Header Representation for Request and Response Messages
  • 42.5.1 Runtime Representation of Message Contents
  • 42.5.2 Interfaces
• 42.6 User Interface Configuration
  • 42.6.1 Overview
  • 42.6.2 Summary of UI Interfaces
  • 42.6.3 Summary of UI Classes

43 Sample Socket Transport Provider

• 43.1 Sample Socket Transport Provider Design
  • 43.1.1 Concepts Illustrated by the Sample
  • 43.1.2 Basic Architecture of the Sample
  • 43.1.3 Configuration Properties
• 43.2 Sample Location and Directory Structure
• 43.3 Building and Deploying the Sample
  • 43.3.1 Setting Up the Environment
  • 43.3.2 Building the Transport
  • 43.3.3 Deploying the Sample Transport Provider
• 43.4 Start and Test the Socket Server
  • 43.4.1 Start the Socket Server
  • 43.4.2 Test the Socket Transport
• 43.5 Configuring the Socket Transport Sample
  • 43.5.1 Create a New Project
  • 43.5.2 Create a Business Service
  • 43.5.3 Create a Proxy Service
  • 43.5.4 Edit the Pipeline
• 43.6 Testing the Socket Transport Provider

44 Deploying a Transport Provider

• 44.1 Packaging the Transport Provider
• 44.2 Deploying the Transport Provider
  • 44.2.1 Transport Registration
• 44.3 Undeploying a Transport Provider
• 44.4 Deploying to a Cluster

Part VII Security

45 Introduction

• 45.1 Document Audience
• 45.2 Related Information

46 Understanding Oracle Service Bus Security

• 46.1 Inbound Security
• 46.2 Outbound Security
• 46.3 Options for Identity Propagation
  • 46.3.1 Example: Authentication with a User Name Token
• 46.4 Administrative Security
• 46.5 Access Control Policies
  • 46.5.1 Configuring Proxy Service Access Control
  • 46.5.2 Access Control Policy Management
    • 46.5.2.1 Deleting a Proxy Service
    • 46.5.2.2 Deleting the Access Control Policy Assigned to a Proxy Service
    • 46.5.2.3 Moving or Renaming a Proxy Service
    • 46.5.2.4 Renaming a Proxy Service Operation
• 46.6 Preserving Security Configuration During Import
  • 46.6.1 Preserve Security and Policy Configuration Check Box
  • 46.6.2 Preserve Credentials Check Box
  • 46.6.3 Preserve Access Control Check Box
• 46.7 Configuring the Oracle WebLogic Security Framework: Main Steps
• 46.8 Context Properties Are Passed to Security Providers
  • 46.8.1 Context Properties for HTTP Transport-Level Authentication
  • 46.8.2 ContextHandler Properties for Access Control and Message-Level Custom Authentication
  • 46.8.3 Additional Transport-Specific Context Properties
  • 46.8.4 Administrator-Supplied Context Properties for Message-Level Authentication
  • 46.8.5 Security Provider Must Have Knowledge of the Property Name
  • 46.8.6 Oracle WebLogic Server Administrative Channel is Supported
• 46.9 Using Security Providers
  • 46.9.1 Configuring Authentication Providers
  • 46.9.2 Using a Custom Authorization Provider to Protect Oracle Service Bus Resources
    • 46.9.2.1 WebLogic Authorization Provider Usage Information
    • 46.9.2.2 Oracle Service BusProxyServiceResource Object
    • 46.9.2.3 ProjectResourceV2 Object
    • 46.9.2.4 ConsoleResource Object
  • 46.9.3 About Errors When Using Security Provider Policies

47 Oracle Service Bus Security FAQ

• 47.1 How are Oracle Service Bus and Oracle WebLogic Server Security related?
• 47.2 What is Transport-Level Security?
• 47.3 What is Web Services Security?
• 47.4 What is Web Service Policy?
• 47.5 What are Web Service Policy assertions?
• 47.6 Are Access Control Policy and Web Service Policy the same?
• 47.7 What is Web Services Security Pass-Through?
• 47.8 What is a Web Services Security Active Intermediary?
• 47.9 What is outbound Web Services Security?
• 47.10 What is SAML?
• 47.11 Is it possible to customize the format of the subject identity in a SAML assertion?
• 47.12 What is the Certificate Lookup And Validation Framework?
• 47.13 Does Oracle Service Bus support identity propagation in a proxy service?
• 47.14 If both transport-level authentication and message-level authentication exist on inbound messages to the proxy service, which identity is propagated?
• 47.15 Is single sign-on supported in Oracle Service Bus?
• 47.16 Are security errors monitored?
• 47.17 Can I configure security for MBeans?

48 Configuring Administrative Security

• 48.1 Administrative Security Roles and Privileges
  • 48.1.1 Role-Based Access in the Oracle Service Bus Administration Console
• 48.2 Administrative Security Groups
• 48.3 Configuring Administrative Security: Main Steps

49 Securing Oracle Service Bus in a Production Environment

• 49.1 Undeploying the Service Bus (SB) Resource
• 49.2 Protection of Temporary Files With Streaming body Content
• 49.3 Protecting Against Denial of Service Attacks on the Oracle Service Bus Administration Console

50 Configuring Transport-Level Security

• 50.1 Configuring Transport-Level Security for HTTPS
  • 50.1.1 HTTPS Authentication Levels
  • 50.1.2 Configuring Inbound HTTPS Security: Main Steps
  • 50.1.3 Configuring Outbound HTTPS Security: Main Steps
• 50.2 Configuring Transport-Level Security for HTTP
  • 50.2.1 Configuring Inbound HTTP Security: Main Steps
  • 50.2.2 Configuring Outbound HTTP Security: Main Steps
• 50.3 Configuring Transport-Level Security for JMS
  • 50.3.1 Configuring Inbound JMS Transport-Level Security: Main Steps
  • 50.3.2 Configuring Outbound JMS Transport-Level Security: Main Steps
• 50.4 Configuring Transport-Level Security for SFTP Transport
  • 50.4.1 How Two-Way Authentication is Performed
  • 50.4.2 Use of the known_hosts File
  • 50.4.3 SFTP Transport Authentication Process
  • 50.4.4 Configuring Inbound SFTP Transport-Level Security: Main Steps
  • 50.4.5 Configuring Outbound SFTP Transport-Level Security: Main Steps
  • 50.4.6 SFTP Security Attributes Preserved During Import
  • 50.4.7 SFTP Credential Life Cycle
• 50.5 Email, FTP, and File Transport-Level Security
  • 50.5.1 Email and FTP Transport-Level Security
  • 50.5.2 File Transport Security
• 50.6 Configuring Transport-Level Security for SB Transport
  • 50.6.1 Configuring SAML Authentication With Service Bus (SB) Transport
• 50.7 Configuring Transport-Level Security for WS Transport
  • 50.7.1 Reliable Web Services Messaging Defined
  • 50.7.2 WS Transport Resources Visible in WLS Console
  • 50.7.3 Use of WS-Policy Files for Web Service Reliable Messaging Configuration
    • 50.7.3.1 Preconfigured WS-RM Policy Files
  • 50.7.4 RM WS-Policy Required Prior to Activation
  • 50.7.5 Async Responses
  • 50.7.6 Proxy Service Authentication
  • 50.7.7 Preserving Security Configuration on Import
  • 50.7.8 Configuring Inbound and Outbound WS Transport-Level Security
• 50.8 Configuring Transport-Level Security for WebSphere Message Queue Transport
  • 50.8.1 Configuring Inbound MQ Transport-Level Security: Main Steps
  • 50.8.2 Configuring Outbound MQ Transport-Level Security: Main Steps
• 50.9 Transport-Level Security Elements in the Message Context

51 Securing Oracle Service Bus with Oracle Web Services Manager

• 51.1 About Oracle Web Services Manager Integration with Oracle Service Bus
  • 51.1.1 Security Providers
    • 51.1.1.1 JPS Providers
    • 51.1.1.2 CSS Providers
• 51.2 Setting Up and Using Oracle Web Services Manager with Oracle Service Bus
  • 51.2.1 Adding Oracle Web Services Manager and Oracle Enterprise Manager to an Oracle Service Bus Domain
  • 51.2.2 Attaching Oracle Web Services Manager Policies to Oracle Service Bus Services
    • 51.2.2.1 Policy Overrides
  • 51.2.3 Configuring SAML
  • 51.2.4 Advertising WSDLs to Support WS Standards
    • 51.2.4.1 WSDL Query Parameter Reference for WS Policies
  • 51.2.5 Deployment Considerations
  • 51.2.6 Auditing
  • 51.2.7 Monitoring Statistics
  • 51.2.8 Supported Assertions and Seed Policies
    • 51.2.8.1 Unsupported Assertions
    • 51.2.8.2 Supported Seed Policies
• 51.3 Use Cases: Oracle Service Bus and WLS 9.2 Policies with Oracle Web Services Manager
  • 51.3.1 Message Protection
    • 51.3.1.1 Message Protection with Client Agent
    • 51.3.1.2 Message Protection with Server Agent
    • 51.3.1.3 Message Protection with Client and Server Agents
    • 51.3.1.4 Message Protection with Gateway
  • 51.3.2 Authentication
  • 51.3.3 Perimeter Security
  • 51.3.4 Identity Propagation

52 Using WS-Policy in Oracle Service Bus Proxy and Business Services

• 52.1 About Web Services Policy
  • 52.1.1 Relationship Between WS-Security and WS-Policy
  • 52.1.2 WS-Policies Can be Bound Directly to Service
  • 52.1.3 Abstract and Concrete WS-Policy Statements
• 52.2 Oracle Service Bus WS-Policy Files
  • 52.2.1 Predefined Oracle Proprietary Policy Files
  • 52.2.2 Predefined Reliable Messaging Policy Files
  • 52.2.3 When to use the Predefined Policy Files
• 52.3 Creating and Using Custom WS-Policy Statements
• 52.4 Attaching WS-Policy Statements to WSDL Documents
  • 52.4.1 Determining the URI of a WS-Policy Statement
  • 52.4.2 Specifying the URI of a WS-Policy Statement in a WSDL Document
  • 52.4.3 Best Practices: Attaching WS-Policy Statements
  • 52.4.4 Example: Requiring X.509 Credentials for Identity and Confidentiality
  • 52.4.5 Example: Attaching Custom Inline WS-Policy Statements to a WSDL Document
• 52.5 Oracle-Proprietary Security Policy Best Practices
• 52.6 Policy Subjects and Effective Policy

53 Configuring Message-Level Security for Web Services

• 53.1 About Message-Level Security
  • 53.1.1 Sample Sequence of Actions in Message-Level Security
• 53.2 Message-Level Access Control Policies for Proxy Services
• 53.3 Configuring Proxy Service Message-Level Security
  • 53.3.1 Creating an Active Intermediary Proxy Service: Main Steps
  • 53.3.2 Creating a Pass-Through Proxy Service: Main Steps
• 53.4 Configuring Business Service Message-Level Security: Main Steps
• 53.5 Examples of Custom WS-Policy Statements
  • 53.5.1 Example: Encrypting Part of the SOAP Body and Header
  • 53.5.2 Example: Encryption Policy for a Business Service
  • 53.5.3 Example: Encrypting a Custom SOAP Header
  • 53.5.4 Example: Signing the Message Body and Headers
  • 53.5.5 Example: Signing a SOAP Body with SAML Holder-of-Key
  • 53.5.6 Example: Authenticating, Signing, and Encrypting a SOAP Body and Headers with SAML Sender Vouches
• 53.6 Disabling Business Service Message-Level Security

54 Using SAML with Oracle Service Bus

• 54.1 Mapping Identity to a SAML Token
• 54.2 Configuring SAML Pass-Through Identity Propagation
• 54.3 Authenticating SAML Tokens in Proxy Service Requests
• 54.4 Configuring SAML Authentication with Service Bus (SB) Transport
• 54.5 Using SAML Identity Switching
  • 54.5.1 Protecting the Identity-Switching Resource
• 54.6 Troubleshooting SAML with Oracle Service Bus

55 Configuring Custom Authentication

• 55.1 What Are Custom Authentication Tokens?
  • 55.1.1 Custom Authentication Token Use and Deployment
• 55.2 Understanding Transport-Level Custom Authentication
  • 55.2.1 Importing and Exporting and Transport-Level Custom Token Authentication
• 55.3 Understanding Message-Level Custom Authentication
• 55.4 Format of XPath Expressions
• 55.5 Configuring Identity Assertion Providers for Custom Tokens
  • 55.5.1 Object Type of Custom Tokens
  • 55.5.2 Configuring a Custom Token Type in an Identity Assertion Provider
    • 55.5.2.1 Steps for Configuring a Custom Token Type in an Identity Assertion Provider
    • 55.5.2.2 Setting the Supported and Active Types in the MBean
• 55.6 Configuring Custom Authentication Transport-Level Security
  • 55.6.1 Steps for Configuring Custom Authentication Transport-Level Security
• 55.7 Configuring Custom Authentication Message-Level Security
  • 55.7.1 Steps for Configuring Custom Authentication Message-Level Security
• 55.8 Propagating the Identity Obtained From Custom Authentication Tokens
• 55.9 Combining WS-Security with Custom Username/Password and Tokens

56 Message-Level Security with .Net 2.0

• 56.1 Message-Level Security Between .NET 2.0 and Oracle Service Bus
• 56.2 What is .NET?
• 56.3 Message-Level Security Configuration in .NET For Oracle Service Bus Interoperability
• 56.4 Oracle Service Bus Configuration for Message-Level Security with .NET
  • 56.4.1 Sample WSDL File

Part VIII Appendix

A Transport SDK UML Sequence Diagrams

• A.1 Oracle Service Bus Runtime Inbound Messages
• A.2 Oracle Service Bus Runtime Outbound Messages
• A.3 Design Time Service Registration