Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Interoperability Scenarios and Considerations

• 1.1 Supported Configurations
• 1.2 Supported Standards and Implementations
• 1.3 Platform Interoperability
• 1.4 Platform Interoperability Limitations
  • 1.4.1 .NET Interoperability Limitations
  • 1.4.2 Apache Axis Interoperability Limitations
  • 1.4.3 WebSphere Interoperability Limitations

Part I Console Help for Oracle Service Bus

2 Introduction to Oracle Service Bus

• 2.1 Starting the Oracle Service Bus Administration Console
• 2.2 Customizing Table Views
• 2.3 Resource Naming Restrictions

3 Change Center

• 3.1 Using the Change Center
• 3.2 Activating Sessions
• 3.3 Exiting Sessions
• 3.4 Viewing Configuration Changes
• 3.5 Purging Session Activation History
• 3.6 Undoing Tasks
  • 3.6.1 Order of Undoing Tasks
  • 3.6.2 Undoing Into a Session
• 3.7 Viewing Task Details
• 3.8 Viewing All Sessions
• 3.9 Viewing and Resolving Conflicts

4 Working with Projects, Folders, and Resources

• 4.1 Naming Projects and Folders
  • 4.1.1 Qualifying Resource Names Using Projects and Folders
• 4.2 Projects View Page
• 4.3 Project/Folder View Page
• 4.4 Adding Projects
• 4.5 Renaming Projects
• 4.6 Moving Projects (Converting to a Folder)
• 4.7 Cloning Projects
• 4.8 Deleting Projects
• 4.9 Adding Folders
• 4.10 Renaming Folders
• 4.11 Moving or Upgrading Folders
• 4.12 Cloning Folders
• 4.13 Deleting Folders
• 4.14 Creating Resources
• 4.15 Loading Resources from a Zip File
• 4.16 Load Resources - Select Zip File and Review Type Extensions Page
• 4.17 Loading Resources from a URL
• 4.18 Load Resources - Load Resources from URL Page
• 4.19 Load Resources - Review Loaded Resources Page
• 4.20 Load Resources - Import Result Page
• 4.21 View References Page
• 4.22 Viewing References to Resources
• 4.23 View Change History Page
• 4.24 Using the Resource Browser
• 4.25 Renaming Resources
• 4.26 Moving Resources
• 4.27 Cloning Resources
• 4.28 Exporting a WSDL
• 4.29 Generating a WSDL
• 4.30 Viewing Resources in a Web Browser
• 4.31 Deleting Resources

5 XML Schemas

• 5.1 Locating XML Schemas
• 5.2 Adding XML Schemas
• 5.3 Editing XML Schemas
• 5.4 Deleting XML Schemas
• 5.5 Viewing Unresolved XML Schema References
• 5.6 Resolving Unresolved XML Schema References

6 Alert Destinations

• 6.1 Locating Alert Destinations
• 6.2 Adding Alert Destinations
• 6.3 Adding E-Mail and JMS Recipients
  • 6.3.1 Adding E-Mail Recipients
  • 6.3.2 Adding JMS Destinations
• 6.4 Editing Alert Destinations
• 6.5 Deleting Alert Destinations

7 WSDLs

• 7.1 Locating WSDLs
• 7.2 Adding WSDLs
• 7.3 Editing WSDLs
• 7.4 Deleting WSDLs
• 7.5 Viewing Unresolved WSDL References
• 7.6 Resolving Unresolved WSDL References

8 JARs

• 8.1 Locating JARs
• 8.2 Adding JARs
• 8.3 Editing JARs
• 8.4 Editing JAR Dependencies
• 8.5 Deleting JARs

9 MQ Connections

• 9.1 Locating MQ Connections
• 9.2 Adding MQ Connections
• 9.3 Editing MQ Connections
• 9.4 Deleting MQ Connections

10 Split-Joins

• 10.1 Locating Split-Joins
• 10.2 Adding Split-Joins
• 10.3 Editing Split-Joins
• 10.4 Deleting Split-Joins

11 XQuery Transformations

• 11.1 Locating XQuery Transformations
• 11.2 Adding XQuery Transformations
• 11.3 Editing XQuery Transformations
• 11.4 Deleting an XQuery Transformation

12 Custom WS-Policies

• 12.1 Using Oracle Service Bus WS-Policies
  • 12.1.1 Using Custom WS-Policies
• 12.2 Locating Custom WS-Policies
• 12.3 Adding Custom WS-Policies
• 12.4 Editing Custom WS-Policies
• 12.5 Deleting Custom WS-Policies

13 JCA Bindings

• 13.1 Locating JCA Bindings
• 13.2 Adding JCA Bindings
• 13.3 Editing JCA Bindings
• 13.4 Deleting JCA Bindings

14 XML Documents

• 14.1 Locating XML Documents
• 14.2 Adding XML Documents
• 14.3 Editing XML Documents
• 14.4 Deleting XML Documents

15 XSL Transformations

• 15.1 Locating XSL Transformations
• 15.2 Adding an XSL Transformation
• 15.3 Editing XSL Transformations
• 15.4 Deleting an XSL Transformation
• 15.5 Resolving Unresolved XSL Transformation References

16 MFLs

• 16.1 Locating MFLs
• 16.2 Adding MFLs
• 16.3 Editing MFLs
• 16.4 Deleting MFLs

17 Service Accounts

• 17.1 Specifying Service Accounts
  • 17.1.1 Using Service Accounts Data and Sessions
• 17.2 Locating Service Accounts
• 17.3 Adding Service Accounts
• 17.4 Editing Service Accounts
• 17.5 Deleting Service Accounts

18 Service Key Providers

• 18.1 Locating Service Key Providers
• 18.2 Adding Service Key Providers
• 18.3 Editing Service Key Providers
• 18.4 Deleting Service Key Providers

19 Business Services: Creating and Managing

• 19.1 Creating and Configuring Business Services
  • 19.1.1 Generating a Business Service from a JCA Binding Resource
  • 19.1.2 Generating a Business Service from Oracle Enterprise Repository
• 19.2 Create/Edit a Business Service - Page Reference
  • 19.2.1 General Configuration Page
  • 19.2.2 Message Type Configuration Page
  • 19.2.3 Transport Configuration Page
  • 19.2.4 Protocol-Specific Transport Configuration Page
  • 19.2.5 BPEL-10g Transport Configuration Page
  • 19.2.6 DSP Transport Configuration Page
  • 19.2.7 EJB Transport Configuration Page
  • 19.2.8 E-Mail Transport Configuration Page
  • 19.2.9 File Transport Configuration Page
  • 19.2.10 Flow Transport Configuration Page
  • 19.2.11 FTP Transport Configuration Page
  • 19.2.12 HTTP Transport Configuration Page
  • 19.2.13 JCA Transport Configuration Page
  • 19.2.14 JEJB Transport Configuration Page
  • 19.2.15 JMS Transport Configuration Page
  • 19.2.16 MQ Transport Configuration Page
  • 19.2.17 SB Transport Configuration Page
  • 19.2.18 SFTP Transport Configuration Page
  • 19.2.19 SOA-DIRECT Transport Configuration Page
  • 19.2.20 Tuxedo Transport Configuration Page
  • 19.2.21 WS Transport Configuration Page
  • 19.2.22 SOAP Binding Configuration Page
  • 19.2.23 Message Handling Configuration Page
  • 19.2.24 Summary Page
• 19.3 Exporting a WSDL Associated with a Business Service
• 19.4 Locating Business Services
• 19.5 Editing Business Service Configurations
  • 19.5.1 View a Business Service - Configuration Details Page
  • 19.5.2 Business Service Policies Page
  • 19.5.3 Business Service Security Page
• 19.6 Deleting Business Services

20 Proxy Services: Creating and Managing

• 20.1 Creating and Configuring Proxy Services
  • 20.1.1 Generating a Proxy Service from a JCA Binding Resource
• 20.2 Create/Edit a Proxy Service - Page Reference
  • 20.2.1 General Configuration Page
  • 20.2.2 Message Type Configuration Page
  • 20.2.3 Transport Configuration Page
  • 20.2.4 Protocol-Specific Transport Configuration Pages
  • 20.2.5 E-Mail Transport Configuration Page
  • 20.2.6 File Transport Configuration Page
  • 20.2.7 FTP Transport Configuration Page
  • 20.2.8 HTTP Transport Configuration Page
  • 20.2.9 JCA Transport Configuration Page
  • 20.2.10 JEJB Transport Configuration Page
  • 20.2.11 JMS Transport Configuration Page
  • 20.2.12 MQ Transport Configuration Page
  • 20.2.13 SB Transport Configuration Page
  • 20.2.14 SFTP Transport Configuration Page
  • 20.2.15 Tuxedo Transport Configuration Page
  • 20.2.16 WS Transport Configuration Page
  • 20.2.17 Operation Selection Configuration Page
  • 20.2.18 Message Handling Page
  • 20.2.19 Summary Page
• 20.3 Exporting a WSDL Associated with a Proxy Service
• 20.4 Locating Proxy Services
• 20.5 Editing Proxy Service Configurations
  • 20.5.1 View a Proxy Service - Configuration Details Page
  • 20.5.2 Proxy Service Policy Page
  • 20.5.3 Proxy Service Security Page
• 20.6 Deleting Proxy Services

21 Proxy Services: Message Flow

• 21.1 Viewing and Editing Message Flows
• 21.2 Edit Message Flow Page
• 21.3 Edit Stage Configuration Page
• 21.4 Adding Pipeline Pair Nodes to Message Flows
• 21.5 Adding Conditional Branches to Message Flows
• 21.6 Adding Operational Branches to Message Flows
• 21.7 Adding Stages to Pipelines
• 21.8 Adding Route Nodes to Message Flows
• 21.9 Cutting, Copying, and Pasting Stages and Route Nodes

22 Proxy Services: Actions

• 22.1 Adding and Editing Actions in Message Flows
• 22.2 Adding Publish Actions
• 22.3 Adding Publish Table Actions
• 22.4 Adding Dynamic Publish Actions
• 22.5 Adding Routing Options Actions
• 22.6 Adding Service Callout Actions
• 22.7 Adding Transport Header Actions
  • 22.7.1 Setting Cookies in Outbound HTTP Transport Headers
    • 22.7.1.1 Setting a Cookie as a Complex XML Expression
    • 22.7.1.2 Setting a Cookie with a String Expression
• 22.8 Adding Dynamic Routing to Route Nodes
• 22.9 Adding Routing Actions to Route Nodes
• 22.10 Adding Routing Tables to Route Nodes
• 22.11 Adding For Each Actions
• 22.12 Adding If... Then... Actions
• 22.13 Adding Raise Error Actions
  • 22.13.1 Transactions
• 22.14 Adding Reply Actions
• 22.15 Adding Resume Actions
• 22.16 Adding Skip Actions
• 22.17 Adding Assign Actions
• 22.18 Adding Delete Actions
• 22.19 Adding Insert Actions
• 22.20 Adding Java Callout Actions
• 22.21 Adding MFL Transform Actions
• 22.22 Adding Rename Actions
• 22.23 Adding Replace Actions
• 22.24 Adding Validate Actions
• 22.25 Adding Alert Actions
• 22.26 Adding Log Actions
• 22.27 Adding Report Actions

23 Proxy Services: XQuery and XPath Editors

• 23.1 Creating and Editing Inline XQuery and XPath Expressions
• 23.2 Understanding XQuery Editor Layouts and Tasks
  • 23.2.1 Palettes
  • 23.2.2 Workspace
  • 23.2.3 Property Inspector
• 23.3 Building Expressions in the Editor Workspace Text Fields
• 23.4 Creating Namespaces to Use in Inline Expressions
• 23.5 Creating Variable Structures in the XQuery Editors
• 23.6 Creating Custom XPath Functions in the XQuery Editors
• 23.7 Binding External XQuery Resources to Inline XQueries
• 23.8 Binding External XSLT Resources to Inline XQueries
• 23.9 Binding Dynamic XQuery Expressions to Inline XQueries
• 23.10 Entering XQuery Comparison Expressions Using the Builder Option
• 23.11 Entering Unary Expressions Using the Builder Option

24 Proxy Services: Error Handlers

• 24.1 Edit Error Handler Page
• 24.2 Adding Proxy Service Error Handlers
• 24.3 Adding Pipeline Error Handlers
• 24.4 Adding Stage Error Handlers
• 24.5 Adding Route Node Error Handlers
• 24.6 Editing Error Handlers

25 Security Configuration

• 25.1 Understanding Users, Groups, Security Roles and Policies
  • 25.1.1 Users
  • 25.1.2 Groups
    • 25.1.2.1 Administrative Security Groups
  • 25.1.3 Roles
    • 25.1.3.1 Administrative Security Roles
  • 25.1.4 Access Control Policies
  • 25.1.5 Security Configuration Data and Sessions
• 25.2 Locating Users
• 25.3 Adding Users
• 25.4 Editing Users
• 25.5 Deleting Users
• 25.6 Locating Groups
• 25.7 Adding Groups
• 25.8 Editing Groups
• 25.9 Deleting Groups
• 25.10 Locating Roles
• 25.11 Adding Roles
  • 25.11.1 Defining Role Conditions
• 25.12 Editing Roles
• 25.13 Deleting Roles
• 25.14 Locating Access Control Policies
• 25.15 Editing Transport-Level Access Policies
• 25.16 Editing Message-Level Access Policies
• 25.17 Adding Policy Conditions

26 Monitoring

• 26.1 Viewing SLA Alerts
• 26.2 Viewing Pipeline Alerts
• 26.3 Locating Alerts
  • 26.3.1 WebLogic Diagnostics Framework Query Language
• 26.4 Purging Alerts
• 26.5 Viewing Alert Details
• 26.6 Viewing Service Monitoring Information
• 26.7 Resetting Statistics for Services
• 26.8 Configuring Operational Settings for Proxy Services
• 26.9 Configuring Operational Settings for Business Services
• 26.10 Setting the Aggregation Interval for a Service
• 26.11 Viewing Service Metrics
• 26.12 Viewing Operations Metrics for WSDL-Based Services
• 26.13 Viewing Pipeline Metrics
• 26.14 Viewing Action Metrics
• 26.15 Viewing Business Services Endpoint URIs Metrics
• 26.16 Viewing Server Information
• 26.17 Viewing Server Details
• 26.18 Viewing Domain Log Files
• 26.19 Customizing Your View of Domain Log File Entries
• 26.20 Viewing Details of Domain Log Files
• 26.21 Viewing Alert Rules
• 26.22 Locating Alert Rules
• 26.23 Creating and Editing Alert Rules
  • 26.23.1 Configuring General Information for Alert Rules
  • 26.23.2 Defining Alert Rule Conditions
  • 26.23.3 Reviewing the Alert Rule Configuration
• 26.24 Viewing Alert Rule Configurations
• 26.25 Editing Alert Rules
• 26.26 Deleting Alert Rules

27 Configuration

• 27.1 Finding and Updating Operational Settings
  • 27.1.1 Finding All Services (Proxy and Business Services)
  • 27.1.2 Finding Proxy Services
  • 27.1.3 Finding Business Services
  • 27.1.4 Finding Split-Joins
  • 27.1.5 Finding Alert Destinations
  • 27.1.6 Finding SLA Alert Rules
• 27.2 Enabling Global Settings
  • 27.2.1 Enabling Global Monitoring of Services
  • 27.2.2 Disabling Global Monitoring of Services
  • 27.2.3 Enabling SLA Alerts Globally
  • 27.2.4 Disabling SLA Alerts Globally
  • 27.2.5 Enabling Pipeline Alerts Globally
  • 27.2.6 Disabling Pipeline Alerts Globally
  • 27.2.7 Enabling Message Reporting Globally
  • 27.2.8 Disabling Message Reporting Globally
  • 27.2.9 Enabling Logging Globally
  • 27.2.10 Disabling Logging Globally
  • 27.2.11 Enabling Result Caching Globally
  • 27.2.12 Disabling Result Caching Globally
• 27.3 Setting User Preferences

28 Reporting

• 28.1 Viewing Reporting Messages
• 28.2 Viewing Message Details
• 28.3 Purging Messages

29 Import/Export

• 29.1 Importing Resources
  • 29.1.1 Selecting Projects and Resources to Import
  • 29.1.2 Specifying the Importing Security Settings
  • 29.1.3 Importing Service Accounts or Service Key Providers
  • 29.1.4 Reviewing the Import Summary
• 29.2 Exporting Resources
  • 29.2.1 Specifying the Exporting Security Settings

30 UDDI

• 30.1 Viewing Configured UDDI Registries
• 30.2 Configuring UDDI Registries
  • 30.2.1 Adding UDDI Registries
  • 30.2.2 Editing UDDI Registries
• 30.3 Setting Up a Default UDDI Configuration
• 30.4 Importing Business Services From a UDDI Registry
• 30.5 Using Auto-Import Status
• 30.6 Detaching Services
• 30.7 Publishing Proxy Services to a UDDI Registry
• 30.8 Using Auto-Publish

31 Global Resources

• 31.1 Viewing JNDI Providers
• 31.2 Adding JNDI Providers
• 31.3 Editing JNDI Providers
• 31.4 Deleting JNDI Providers
• 31.5 Viewing SMTP Servers
• 31.6 Locating SMTP Servers
• 31.7 Adding SMTP Servers
• 31.8 Configuring a Default SMTP Server
• 31.9 Editing SMTP Servers
• 31.10 Deleting SMTP Servers
• 31.11 Viewing Proxy Servers
• 31.12 Locating Proxy Servers
• 31.13 Adding Proxy Servers
• 31.14 Editing Proxy Servers
• 31.15 Deleting Proxy Servers

32 Customization

• 32.1 Finding and Replacing Environment Values
• 32.2 Creating Customization Files
• 32.3 Executing Customization Files

33 Test Console

• 33.1 Testing Services
  • 33.1.1 Testing Proxy Services
  • 33.1.2 Configuring Proxy Services Test Data
  • 33.1.3 Viewing Proxy Services Test Results
  • 33.1.4 Tracing Proxy Services
  • 33.1.5 Testing Business Services
    • 33.1.5.1 Testing Attachments in Business Services
  • 33.1.6 Configuring Business Services Test Data
  • 33.1.7 Viewing Business Services Test Results
• 33.2 Testing Transformations
  • 33.2.1 Testing MFL Transformations
  • 33.2.2 Testing XSLT Transformations
  • 33.2.3 Testing XQuery Transformations
• 33.3 Performing XQuery Testing
  • 33.3.1 Using the XQuery Expression and XQuery Condition Editors
  • 33.3.2 Using the XPath Expression Editor
• 33.4 Understanding How the Run Time Uses the Transport Settings in the Test Console

Part II User Guide

34 Introduction to the User Guide

35 Starting Oracle Service Bus Servers

• 35.1 Starting Derby in Development Enviornments
• 35.2 Starting the Oracle Service Bus Admin Server
  • 35.2.1 Starting the Admin Server from the Command Line
  • 35.2.2 Starting the Admin Server on Windows
    • 35.2.2.1 Starting the Admin Server from the Windows Start Menu
    • 35.2.2.2 Starting the Admin Server as a Windows Service
  • 35.2.3 Starting Servers Using Node Manager
• 35.3 Starting Oracle Service Bus Managed Servers
• 35.4 Verifying Server Startup

36 Configuring Proxy Services and Business Services

• 36.1 Oracle Service Bus Proxy Services
• 36.2 Oracle Service Bus Business Services
• 36.3 How WSDL is Used in Oracle Service Bus
  • 36.3.1 About Effective WSDLs and Generated WSDLs
    • 36.3.1.1 Effective WSDLs
    • 36.3.1.2 Generated WSDLs
    • 36.3.1.3 Accessing Effective WSDLs
  • 36.3.2 WSDL Overview
    • 36.3.2.1 Types
    • 36.3.2.2 Message
    • 36.3.2.3 Port Type
    • 36.3.2.4 Binding
    • 36.3.2.5 Service and Port
• 36.4 Using a WSDL to Define a Service
  • 36.4.1 SOAP Document Wrapped Web Services
  • 36.4.2 SOAP Document Style Web Services
  • 36.4.3 SOAP RPC Web Services
• 36.5 Basing Services on WSDL Ports and on WSDL Bindings
  • 36.5.1 Characteristics of Effective WSDLs Generated for Proxy Services
    • 36.5.1.1 Characteristics of Effective WSDLs Generated for Non-Transport-Type Business Services
    • 36.5.1.2 Characteristics of Effective WSDLs Generated for Transport-Type Business Services
    • 36.5.1.3 Generating Effective WSDLs in Clustered Domains
    • 36.5.1.4 Examples of Proxy Services Based on a Port and on a Binding
  • 36.5.2 Using Any SOAP or Any XML Service Types
  • 36.5.3 Using the Messaging Service Type
• 36.6 Configuring Proxy Services
  • 36.6.1 Proxy Service Types and Transports
  • 36.6.2 Transport and Security Configuration for Proxy Services
  • 36.6.3 Configuration Settings For Each Proxy Service Type
  • 36.6.4 Configuring Message Flow
  • 36.6.5 Security-Related Validation for Proxy Services
• 36.7 Configuring Business Services
  • 36.7.1 Business Service Types and Transport
  • 36.7.2 Configuration Settings for All Business Service Types
  • 36.7.3 Configuration Settings For Each Business Service Type
  • 36.7.4 Using Proxy Servers
  • 36.7.5 Improving Performance by Caching Business Service Results
    • 36.7.5.1 How Result Caching Works
    • 36.7.5.2 Result Caching Best Practices
    • 36.7.5.3 Result Cache Metadata
    • 36.7.5.4 Testing Result Caching
    • 36.7.5.5 Result Caching Advanced Configuration
• 36.8 Viewing Resource Details

37 Modeling Message Flow in Oracle Service Bus

• 37.1 Message Flow Components
  • 37.1.1 Building a Message Flow
  • 37.1.2 Message Execution
• 37.2 Branching in Message Flows
  • 37.2.1 Operational Branching
  • 37.2.2 Conditional Branching
• 37.3 Configuring Actions in Stages and Route Nodes
  • 37.3.1 Communication Actions
  • 37.3.2 Flow Control Actions
  • 37.3.3 Message Processing Actions
  • 37.3.4 Reporting Actions
  • 37.3.5 Configuring Transport Headers in Message Flows
    • 37.3.5.1 Configuring Global Pass Through and Header-Specific Copy Options for Transport Headers
    • 37.3.5.2 Understanding How the Run Time Uses the Transport Headers Settings
• 37.4 Performing Transformations in Message Flows
  • 37.4.1 Transformations and Publish Actions
  • 37.4.2 Transformations and Route Nodes
• 37.5 Constructing Service Callout Messages
  • 37.5.1 SOAP Document Style Services
  • 37.5.2 SOAP RPC Style Services
  • 37.5.3 XML Services
  • 37.5.4 Messaging Services
• 37.6 Handling Errors as the Result of a Service Callout
  • 37.6.1 Transport Errors
  • 37.6.2 SOAP Faults
  • 37.6.3 Unexpected Responses
• 37.7 Handling Errors in Message Flows
  • 37.7.1 Generating the Error Message, Reporting, and Replying
  • 37.7.2 Example of Action Configuration in Error Handlers
• 37.8 Using Dynamic Routing
  • 37.8.1 Implementing Dynamic Routing
    • 37.8.1.1 Sample XML File
    • 37.8.1.2 Creating an XQuery Resource From the Sample XML
    • 37.8.1.3 Creating and Configuring the Proxy Service to Implement Dynamic Routing
• 37.9 Accessing Databases Using XQuery
• 37.10 Understanding Message Context
  • 37.10.1 Message Context Components
  • 37.10.2 Guidelines for Viewing and Altering Message Context
  • 37.10.3 Copying JMS Properties From Inbound to Outbound
• 37.11 Working with Variable Structures
  • 37.11.1 Using the Inline XQuery Expression Editor
    • 37.11.1.1 Inline XQueries
    • 37.11.1.2 Uses of the Inline XQuery Expression Editor
  • 37.11.2 Using Variable Structures
  • 37.11.3 Creating Variable Structure Mappings
    • 37.11.3.1 Sample WSDL
    • 37.11.3.2 Creating the Resources You Need for the Examples
    • 37.11.3.3 Example 1: Selecting a Predefined Variable Structure
    • 37.11.3.4 Example 2: Creating a Variable Structure That Maps a Variable to a Type
    • 37.11.3.5 Example 3: Creating a Variable Structure that Maps a Variable to an Element
    • 37.11.3.6 Example 4: Creating a Variable Structure That Maps a Variable to a Child Element
    • 37.11.3.7 Example 5: Creating a Variable Structure that Maps a Variable to a Business Service
    • 37.11.3.8 Example 6: Creating a Variable Structure That Maps a Child Element to Another Child Element
• 37.12 Quality of Service
  • 37.12.1 Delivery Guarantees
    • 37.12.1.1 Overriding the Default Element Attribute
    • 37.12.1.2 Delivery Guarantee Rules
    • 37.12.1.3 Threading Model
    • 37.12.1.4 Splitting Proxy Services
  • 37.12.2 Outbound Message Retries
• 37.13 Using Work Managers with Oracle Service Bus
• 37.14 Content Types, JMS Type, and Encoding
• 37.15 Throttling Pattern
• 37.16 WS-I Compliance
  • 37.16.1 WS-I Compliance Checks
• 37.17 Converting Between SOAP 1.1 and SOAP 1.2

38 Improving Service Performance with Split-Join

• 38.1 Introduction to Split-Join
  • 38.1.1 Static Split-Join
    • 38.1.1.1 Static Split-Join – Sample Scenario
  • 38.1.2 Dynamic Split-Join
    • 38.1.2.1 Dynamic Split-Join – Sample Scenario
  • 38.1.3 Split-Join Framework
• 38.2 Developing Split-Joins
  • 38.2.1 Split-Join Resource Type and Environment Variable

39 Message Context

• 39.1 The Message Context Model
• 39.2 Predefined Context Variables
• 39.3 Message-Related Variables
  • 39.3.1 Header Variable
  • 39.3.2 Body Variable
  • 39.3.3 Attachments Variable
  • 39.3.4 Binary Content in the body and attachments Variables
  • 39.3.5 Java Content in the body Variable
  • 39.3.6 Streaming body Content
    • 39.3.6.1 Best Practices for Using Content Streaming
  • 39.3.7 Streaming Attachments
    • 39.3.7.1 Inbound Message Handling
    • 39.3.7.2 Outbound Message Handling
  • 39.3.8 Understanding MTOM/XOP Support
    • 39.3.8.1 Configuring Proxy Services
    • 39.3.8.2 Configuring Business Services
• 39.4 Inbound and Outbound Variables
  • 39.4.1 Sub-Elements of the inbound and outbound Variables
    • 39.4.1.1 service
    • 39.4.1.2 transport
    • 39.4.1.3 security
  • 39.4.2 Related Topics
• 39.5 Operation Variable
• 39.6 Fault Variable
• 39.7 Initializing Context Variables
  • 39.7.1 Initializing the attachments Context Variable
  • 39.7.2 Initializing the header and body Context Variables
    • 39.7.2.1 SOAP Services
    • 39.7.2.2 XML Services (Non SOAP)
    • 39.7.2.3 Messaging Services
• 39.8 Performing Operations on Context Variables
  • 39.8.1 $body
  • 39.8.2 $header
  • 39.8.3 Related Topics
• 39.9 Constructing Messages to Dispatch
  • 39.9.1 SOAP Services
  • 39.9.2 XML Services (Non SOAP)
  • 39.9.3 Messaging Services
    • 39.9.3.1 About Sending Binary Content in Email Messages
  • 39.9.4 Related Topics
• 39.10 Message Context Schema
  • 39.10.1 Related Topics

40 Using the Test Console

• 40.1 Prerequisites
• 40.2 Testing Proxy Services
  • 40.2.1 Direct Calls
  • 40.2.2 Indirect Calls
  • 40.2.3 HTTP Requests
• 40.3 Testing Business Services
• 40.4 Recommended Approaches to Testing Proxy and Business Services
• 40.5 Tracing Proxy Services Using the Test Console
  • 40.5.1 Example: Testing and Tracing a Proxy Service
• 40.6 Testing Resources
  • 40.6.1 MFL
    • 40.6.1.1 Example
  • 40.6.2 XSLT
  • 40.6.3 XQuery
• 40.7 Performing XQuery Testing
• 40.8 Testing Services With Web Service Security
  • 40.8.1 Limitations for Services and Policies
• 40.9 Test Console Transport Settings
• 40.10 About Security and Transports

41 UDDI

• 41.1 UDDI, UDDI Registries, and Web Services
  • 41.1.1 Basic Concepts of the UDDI Specification
  • 41.1.2 Benefits of Using a UDDI Registry with Oracle Service Bus
  • 41.1.3 Introduction to UDDI Entities
• 41.2 Sample Business Scenarios for Oracle Service Bus and UDDI
  • 41.2.1 Basic Proxy Service Communication with a UDDI Registry
  • 41.2.2 Cross-Domain Deployment in Oracle Service Bus
• 41.3 Using Oracle Service Bus and UDDI
  • 41.3.1 A UDDI Workflow
• 41.4 Configuring a Registry
• 41.5 Publishing a Proxy Service to a UDDI Registry
  • 41.5.1 Publishing Local Proxy Services to UDDI
• 41.6 Using Auto-Publish
• 41.7 Importing a Service from a Registry
  • 41.7.1 Related References
• 41.8 Using Auto-Import
  • 41.8.1 Synchronize
  • 41.8.2 Detach
• 41.9 Auto-Synchronization of Services With UDDI
• 41.10 Mapping Oracle Service Bus Proxy Services to UDDI Entities
  • 41.10.1 UDDI Mapping Details for an Oracle Service Bus Proxy Service
  • 41.10.2 Transport Attributes
  • 41.10.3 Service Type Attributes
• 41.11 Canonical tModels Supporting Oracle Service Bus Services
• 41.12 Example

42 Extensibility Using Java Callouts and POJOs

• 42.1 Usage Guidelines
• 42.2 Working with Streaming Content
  • 42.2.1 Passing Streaming Content to a Java Callout
  • 42.2.2 Streaming Content Results from a Java Callout
• 42.3 Best Practices

43 XQuery Implementation

• 43.1 Supported Function Extensions from Oracle
• 43.2 Function Extensions from Oracle Service Bus
  • 43.2.1 fn-bea:lookupBasicCredentials
  • 43.2.2 fn-bea:isUserInGroup
  • 43.2.3 fn-bea:isUserInRole
  • 43.2.4 fn-bea: uuid
  • 43.2.5 fn-bea:execute-sql()
    • 43.2.5.1 Example 1: Retrieving the URI from a Database for Dynamic Routing
    • 43.2.5.2 Example 2: Getting XMLType Data from a Database
  • 43.2.6 fn-bea:serialize()
• 43.3 Creating and Using Custom XPath Functions

Part III Operations Guide

44 Introduction to the Operations Guide

45 Roles in Oracle Service Bus

• 45.1 Default Roles in Oracle Service Bus
  • 45.1.1 IntegrationAdmin
  • 45.1.2 IntegrationDeployer
  • 45.1.3 IntegrationMonitor
  • 45.1.4 IntegrationOperator
• 45.2 Relation Between Roles in WLS and Roles in Oracle Service Bus
• 45.3 How to Create Roles in Oracle Service Bus

46 Monitoring Oracle Service Bus at Run Time

• 46.1 What is Service Monitoring?
  • 46.1.1 About the Oracle Service Bus Monitoring Framework
• 46.2 Aggregation Intervals
  • 46.2.1 The Refresh Rate of Monitoring Data
  • 46.2.2 Sample Intervals Within Aggregation Intervals
  • 46.2.3 How to Set the Aggregation Interval for Monitoring Data
  • 46.2.4 What are the Consequences Of Changing Aggregation Interval Of A Service?
• 46.3 What are the Consequences of Renaming or Moving a Service?
• 46.4 What Statistics Are Available for Oracle Service Bus Services?
• 46.5 Accessing Statistical Information for Services
  • 46.5.1 How to Access Service Statistics from the Oracle Service Bus Administration Console
  • 46.5.2 How to Access Statistical Information Using the JMX Monitoring APIs
  • 46.5.3 How to Access Statistics in a Cluster
  • 46.5.4 How to Reset Statistics
    • 46.5.4.1 What are the Consequences of Resetting the Statistics?
• 46.6 The Role of Alerts in Service Monitoring
  • 46.6.1 Assigning Severity for Alerts
  • 46.6.2 What are SLA Alerts?
    • 46.6.2.1 A Sample Use Case for SLA Alerts
  • 46.6.3 What are Pipeline Alerts?
    • 46.6.3.1 A Sample Use Case for Pipeline Alerts
  • 46.6.4 How to View or Delete SLA Alerts
  • 46.6.5 How to View or Delete Pipeline Alerts
  • 46.6.6 How to Filter a Search for Specific Alerts
    • 46.6.6.1 How to Filter a Search for SLA Alerts
    • 46.6.6.2 How to Filter a Search for Pipeline Alerts
  • 46.6.7 What are Alert Destinations?
    • 46.6.7.1 E-mail
    • 46.6.7.2 SNMP Traps
    • 46.6.7.3 Reporting
    • 46.6.7.4 Alert Logging
    • 46.6.7.5 JMS
• 46.7 What are Operational Settings for a Service?
  • 46.7.1 How to Configure the Operational Settings for a Service
  • 46.7.2 How to Configure the Operational Settings at the Global Level
  • 46.7.3 Updates to Operational Settings During Import of Oracle Service Bus Configurations
  • 46.7.4 Updates to Global Settings During the Import of Oracle Service Bus Configurations
  • 46.7.5 How to Preserve Operational Settings During the Import of Oracle Service Bus Configuration Through APIs
• 46.8 SLA Alerting Functionality in Oracle Service Bus
  • 46.8.1 How to Configure SLA Alert Rules
  • 46.8.2 How to Lookup or Edit Existing Alert Rules
  • 46.8.3 How to Rename Alert Rules
    • 46.8.3.1 What are the Consequences of Renaming an Alert Rule?
  • 46.8.4 What Happens to Alert Rules When You Import Oracle Service Bus Configurations?
• 46.9 The Oracle Service Bus Dashboard
  • 46.9.1 How to Access Service Statistics for the Current Aggregation Interval
  • 46.9.2 How to Access Running Count Statistics for Services
    • 46.9.2.1 Service Metrics
    • 46.9.2.2 Operations
    • 46.9.2.3 Pipeline Metrics
    • 46.9.2.4 Action Metrics
    • 46.9.2.5 Endpoint URIs
  • 46.9.3 Viewing SLA Alerts in the Dashboard
    • 46.9.3.1 Viewing the Alert History for SLA Alerts
  • 46.9.4 Viewing Pipeline Alerts in the Dashboard
    • 46.9.4.1 Viewing the Alert History for Pipeline Alerts
  • 46.9.5 Viewing Server Health in the Dashboard
    • 46.9.5.1 Viewing Log Summary
    • 46.9.5.2 Viewing Server Summary
    • 46.9.5.3 Viewing Server Details

47 Reporting

• 47.1 About the Oracle Service Bus Reporting Framework
• 47.2 About the JMS Reporting Provider
  • 47.2.1 Reporting Actions in Global Transactions
• 47.3 How to Configure a Database for the JMS Reporting Provider Store
  • 47.3.1 Configure the Reporting Data Source for Transactions
  • 47.3.2 How to Configure a Database in a Development Environment
  • 47.3.3 How to Configure a Database for Production
• 47.4 How to Enable Message Reporting
• 47.5 How to Stop a Reporting Provider
• 47.6 How to Untarget a JMS Reporting Provider
  • 47.6.1 How to Untarget the Default JMS Reporting Provider Before Domain Creation
  • 47.6.2 How to Untarget the JMS Reporting Provider when the Server is Running
  • 47.6.3 How to Untarget the JMS Reporting Provider When Server Not Running
• 47.7 Using the Reporting Module in the Oracle Service Bus Administration Console
  • 47.7.1 Viewing the Summary of Message Reports
  • 47.7.2 Viewing Message Details
  • 47.7.3 How to Purge Messages from the Reporting Data Store

48 Managing Endpoint URIs for Business Services

• 48.1 How to Configure a Business Service to Perform Retries
  • 48.1.1 How to Suppress Retries in Case of Application Errors
• 48.2 How to Mark a Non-Responsive URI Offline
  • 48.2.1 How to Mark an Endpoint URI Offline Temporarily
  • 48.2.2 How to Mark an Endpoint URI Offline Permanently
• 48.3 Metrics for Monitoring Endpoint URIs
  • 48.3.1 Endpoint URI Status
  • 48.3.2 Endpoint URI Performance Metrics
• 48.4 How to Mark an Offline URI as Online
• 48.5 How to Generate Alerts Based on Endpoint URI Status
  • 48.5.1 How to Configure an Alert Rule Based on Endpoint URI Status

49 Execution Tracing

• 49.1 How to Enable or Disable Execution Tracing
• 49.2 How to Access Tracing Information

50 Throttling

• 50.1 How to Enable Throttling
• 50.2 What are the Operational Settings for Throttling?
• 50.3 What Metrics are Available for Throttling?
• 50.4 How to Access Throttling Metrics
• 50.5 How to use Throttling Metrics for Alerting
• 50.6 How to use Throttling for Business Services with Multiple Endpoint URIs
  • 50.6.1 What Happens to Retried Messages During Throttling?

51 Managing Operational Settings Using Smart Search

• 51.1 Using Basic Search
• 51.2 Using Advanced Search
• 51.3 Managing Operational Settings for All Services
  • 51.3.1 Finding Services Using Search Filters
  • 51.3.2 Viewing and Editing Operational Settings
• 51.4 Managing Operational Settings for Proxy Services
  • 51.4.1 Finding Proxy Services Using Search Filters
  • 51.4.2 Viewing and Editing Operational Settings
• 51.5 Managing Operational Settings for Business Services
  • 51.5.1 Finding Business Services Using Search Filters
  • 51.5.2 Viewing and Editing Operational Settings
• 51.6 Managing Operational Settings for Split-Joins
  • 51.6.1 Finding Split-Joins Using Search Filters
  • 51.6.2 Viewing and Editing Operational Settings
• 51.7 Managing Operational Settings for Alert Destinations
  • 51.7.1 Finding Alert Destinations using Search Filters
  • 51.7.2 Viewing and Deleting Alert Destinations
• 51.8 Managing Operational Settings for SLA Alert Rules
  • 51.8.1 Finding SLA Alert Rules Using Search Filters
  • 51.8.2 Viewing and Configuring SLA Alert Rules

52 User Preferences

Part IV Appendix

A Error Codes

• A.1 Error Details Schemas

B Debugging Oracle Service Bus

• B.1 Debugging Oracle Service Bus
• B.2 Debugging Proxy Services and Split-Joins in Eclipse

C Oracle Service Bus APIs

• C.1 Resource Update and Customization
• C.2 Management and Monitoring
• C.3 Deployment

D JMX Monitoring API

• D.1 Description
• D.2 Concepts
  • D.2.1 Public POJO Objects
    • D.2.1.1 ResourceType
    • D.2.1.2 ServiceResourceStatistic
    • D.2.1.3 ResourceStatistic
    • D.2.1.4 StatisticValue
    • D.2.1.5 StatisticType
  • D.2.2 ServiceDomainMBean
  • D.2.3 Statistics Details
    • D.2.3.1 Statistics details for Resource Type - SERVICE
    • D.2.3.2 Statistics details for Resource Type–FLOW_COMPONENT
    • D.2.3.3 Statistics details for Resource Type – WEBSERVICE_OPERATION
    • D.2.3.4 Statistics details for Resource Type – URI
  • D.2.4 Caveats
  • D.2.5 Performance
• D.3 API Usage Example
  • D.3.1 Sample Program

E SNMP Components

• E.1 Creating and Using SNMP Agents
  • E.1.1 Guidelines for Creating and Targeting SNMP Agents for Oracle Service Bus

F Monitoring Statistics in Oracle Service Bus

G Auditing your Oracle Service Bus System

• G.1 Auditing the Configuration Changes
• G.2 Creating an Audit Trail for a Message Flow
• G.3 Auditing Security Violations

H XQuery-SQL Mapping Reference

• H.1 IBM DB2/NT 8
• H.2 Microsoft SQL Server
• H.3 Oracle8i, 8.1.x
• H.4 Oracle 9i, Oracle Database 10g
• H.5 Sybase 12.5.2 (and higher)
• H.6 Base (Generic) RDBMS Data Type Mapping

I Interoperability with WSRP

• I.1 WSRP Producers and Consumers
• I.2 WSRP Architecture
  • I.2.1 Enhanced Architecture with Oracle Service Bus
• I.3 WSRP Design Concepts
  • I.3.1 WSRP WSDLs
  • I.3.2 WSRP Messages
• I.4 Configuring Oracle Service Bus for WSRP
  • I.4.1 Getting the Producer WSDL
  • I.4.2 Routing Messages Between Consumer and Producer
  • I.4.3 Monitoring WSRP Applications
  • I.4.4 Load Balancing and Failover
• I.5 WSRP Interoperability Example
  • I.5.1 Example Prerequisites
  • I.5.2 Example Projects and Folders
  • I.5.3 Monitoring Example
    • I.5.3.1 Step 1: Define WSDL Resources
    • I.5.3.2 Step 2: Create Business Services
    • I.5.3.3 Step 3: Create Proxy Services
    • I.5.3.4 Alternative Methods to Create Proxy Services
    • I.5.3.5 Step 4: Retrieve the WSDL from the Producer
    • I.5.3.6 Step 5: Verify the Configuration