Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

Part I Console Help for Oracle Service Bus

1 Introduction to Oracle Service Bus

• 1.1 Starting Oracle Service Bus Console
• 1.2 Customizing Table Views

2 Change Center

• 2.1 Using the Change Center
• 2.2 Activating Sessions
• 2.3 Exiting Sessions
• 2.4 Viewing Configuration Changes
• 2.5 Purging Session Activation History
• 2.6 Undoing Tasks
  • 2.6.1 Order of Undoing Tasks
  • 2.6.2 Undoing Into a Session
• 2.7 Viewing Task Details
• 2.8 Viewing All Sessions
• 2.9 Viewing and Resolving Conflicts

3 Working with Projects, Folders, and Resources

• 3.1 Naming Projects and Folders
  • 3.1.1 Qualifying Resource Names Using Projects and Folders
• 3.2 Projects View Page
• 3.3 Project/Folder View Page
• 3.4 Adding Projects
• 3.5 Renaming Projects
• 3.6 Moving Projects (Converting to a Folder)
• 3.7 Cloning Projects
• 3.8 Deleting Projects
• 3.9 Adding Folders
• 3.10 Renaming Folders
• 3.11 Moving or Upgrading Folders
• 3.12 Cloning Folders
• 3.13 Deleting Folders
• 3.14 Creating Resources
• 3.15 Loading Resources from a Zip File
• 3.16 Load Resources - Select Zip File and Review Type Extensions Page
• 3.17 Loading Resources from a URL
• 3.18 Load Resources - Load Resources from URL Page
• 3.19 Load Resources - Review Loaded Resources Page
• 3.20 Load Resources - Import Result Page
• 3.21 View References Page
• 3.22 Viewing References to Resources
• 3.23 View Change History Page
• 3.24 Using the Resource Browser
• 3.25 Renaming Resources
• 3.26 Moving Resources
• 3.27 Cloning Resources
• 3.28 Exporting a WSDL
• 3.29 Generating a WSDL
• 3.30 Viewing Resources in a Web Browser
• 3.31 Deleting Resources

4 XML Schemas

• 4.1 Locating XML Schemas
• 4.2 Adding XML Schemas
• 4.3 Editing XML Schemas
• 4.4 Deleting XML Schemas
• 4.5 Viewing Unresolved XML Schema References
• 4.6 Resolving Unresolved XML Schema References

5 Alert Destinations

• 5.1 Locating Alert Destinations
• 5.2 Adding Alert Destinations
• 5.3 Adding E-Mail and JMS Recipients
  • 5.3.1 Adding E-Mail Recipients
  • 5.3.2 Adding JMS Destinations
• 5.4 Editing Alert Destinations
• 5.5 Deleting Alert Destinations

6 WSDLs

• 6.1 Locating WSDLs
• 6.2 Adding WSDLs
• 6.3 Editing WSDLs
• 6.4 Deleting WSDLs
• 6.5 Viewing Unresolved WSDL References
• 6.6 Resolving Unresolved WSDL References

7 JARs

• 7.1 Locating JARs
• 7.2 Adding JARs
• 7.3 Editing JARs
• 7.4 Editing JAR Dependencies
• 7.5 Deleting JARs

8 MQ Connections

• 8.1 Locating MQ Connections
• 8.2 Adding MQ Connections
• 8.3 Editing MQ Connections
• 8.4 Deleting MQ Connections

9 Split-Joins

• 9.1 Locating Split-Joins
• 9.2 Adding Split-Joins
• 9.3 Editing Split-Joins
• 9.4 Deleting Split-Joins

10 XQuery Transformations

• 10.1 Locating XQuery Transformations
• 10.2 Adding XQuery Transformations
• 10.3 Editing XQuery Transformations
• 10.4 Deleting an XQuery Transformation

11 Custom WS-Policies

• 11.1 Using Oracle Service Bus WS-Policies
  • 11.1.1 Using Custom WS-Policies
• 11.2 Locating Custom WS-Policies
• 11.3 Adding Custom WS-Policies
• 11.4 Editing Custom WS-Policies
• 11.5 Deleting Custom WS-Policies

12 JCA Bindings

• 12.1 Locating JCA Bindings
• 12.2 Adding JCA Bindings
• 12.3 Editing JCA Bindings
• 12.4 Deleting JCA Bindings

13 XML Documents

• 13.1 Locating XML Documents
• 13.2 Adding XML Documents
• 13.3 Editing XML Documents
• 13.4 Deleting XML Documents

14 XSL Transformations

• 14.1 Locating XSL Transformations
• 14.2 Adding an XSL Transformation
• 14.3 Editing XSL Transformations
• 14.4 Deleting an XSL Transformation
• 14.5 Resolving Unresolved XSL Transformation References

15 MFLs

• 15.1 Locating MFLs
• 15.2 Adding MFLs
• 15.3 Editing MFLs
• 15.4 Deleting MFLs

16 Service Accounts

• 16.1 Specifying Service Accounts
  • 16.1.1 Using Service Accounts Data and Sessions
• 16.2 Locating Service Accounts
• 16.3 Adding Service Accounts
• 16.4 Editing Service Accounts
• 16.5 Deleting Service Accounts

17 Service Key Providers

• 17.1 Locating Service Key Providers
• 17.2 Adding Service Key Providers
• 17.3 Editing Service Key Providers
• 17.4 Deleting Service Key Providers

18 Business Services: Creating and Managing

• 18.1 Creating and Configuring Business Services
  • 18.1.1 Generating a Business Service from a JCA Binding Resource
  • 18.1.2 Generating a Business Service from Oracle Enterprise Repository
• 18.2 Create/Edit a Business Service - Page Reference
  • 18.2.1 General Configuration Page
  • 18.2.2 Message Type Configuration Page
  • 18.2.3 Transport Configuration Page
  • 18.2.4 Protocol-Specific Transport Configuration Page
  • 18.2.5 BPEL-10g Transport Configuration Page
  • 18.2.6 DSP Transport Configuration Page
  • 18.2.7 EJB Transport Configuration Page
  • 18.2.8 E-Mail Transport Configuration Page
  • 18.2.9 File Transport Configuration Page
  • 18.2.10 Flow Transport Configuration Page
  • 18.2.11 FTP Transport Configuration Page
  • 18.2.12 HTTP Transport Configuration Page
  • 18.2.13 JCA Transport Configuration Page
  • 18.2.14 JEJB Transport Configuration Page
  • 18.2.15 JMS Transport Configuration Page
  • 18.2.16 MQ Transport Configuration Page
  • 18.2.17 SB Transport Configuration Page
  • 18.2.18 SFTP Transport Configuration Page
  • 18.2.19 SOA-DIRECT Transport Configuration Page
  • 18.2.20 Tuxedo Transport Configuration Page
  • 18.2.21 WS Transport Configuration Page
  • 18.2.22 SOAP Binding Configuration Page
  • 18.2.23 Message Handling Configuration Page
  • 18.2.24 Summary Page
• 18.3 Exporting a WSDL Associated with a Business Service
• 18.4 Locating Business Services
• 18.5 Editing Business Service Configurations
  • 18.5.1 View a Business Service - Configuration Details Page
  • 18.5.2 Business Service Policies Page
  • 18.5.3 Business Service Security Page
• 18.6 Deleting Business Services

19 Proxy Services: Creating and Managing

• 19.1 Creating and Configuring Proxy Services
  • 19.1.1 Generating a Proxy Service from a JCA Binding Resource
• 19.2 Create/Edit a Proxy 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 Pages
  • 19.2.5 E-Mail Transport Configuration Page
  • 19.2.6 File Transport Configuration Page
  • 19.2.7 FTP Transport Configuration Page
  • 19.2.8 HTTP Transport Configuration Page
  • 19.2.9 JCA Transport Configuration Page
  • 19.2.10 JEJB Transport Configuration Page
  • 19.2.11 JMS Transport Configuration Page
  • 19.2.12 MQ Transport Configuration Page
  • 19.2.13 SB Transport Configuration Page
  • 19.2.14 SFTP Transport Configuration Page
  • 19.2.15 Tuxedo Transport Configuration Page
  • 19.2.16 WS Transport Configuration Page
  • 19.2.17 Operation Selection Configuration Page
  • 19.2.18 Message Handling Page
  • 19.2.19 Summary Page
• 19.3 Exporting a WSDL Associated with a Proxy Service
• 19.4 Locating Proxy Services
• 19.5 Editing Proxy Service Configurations
  • 19.5.1 View a Proxy Service - Configuration Details Page
  • 19.5.2 Proxy Service Policy Page
  • 19.5.3 Proxy Service Security Page
• 19.6 Deleting Proxy Services

20 Proxy Services: Message Flow

• 20.1 Viewing and Editing Message Flows
• 20.2 Edit Message Flow Page
• 20.3 Edit Stage Configuration Page
• 20.4 Adding Pipeline Pair Nodes to Message Flows
• 20.5 Adding Conditional Branches to Message Flows
• 20.6 Adding Operational Branches to Message Flows
• 20.7 Adding Stages to Pipelines
• 20.8 Adding Route Nodes to Message Flows
• 20.9 Cutting, Copying, and Pasting Stages and Route Nodes

21 Proxy Services: Actions

• 21.1 Adding and Editing Actions in Message Flows
• 21.2 Adding Publish Actions
• 21.3 Adding Publish Table Actions
• 21.4 Adding Dynamic Publish Actions
• 21.5 Adding Routing Options Actions
• 21.6 Adding Service Callout Actions
• 21.7 Adding Transport Header Actions
• 21.8 Adding Dynamic Routing to Route Nodes
• 21.9 Adding Routing Actions to Route Nodes
• 21.10 Adding Routing Tables to Route Nodes
• 21.11 Adding For Each Actions
• 21.12 Adding If... Then... Actions
• 21.13 Adding Raise Error Actions
  • 21.13.1 Transactions
• 21.14 Adding Reply Actions
• 21.15 Adding Resume Actions
• 21.16 Adding Skip Actions
• 21.17 Adding Assign Actions
• 21.18 Adding Delete Actions
• 21.19 Adding Insert Actions
• 21.20 Adding Java Callout Actions
• 21.21 Adding MFL Transform Actions
• 21.22 Adding Rename Actions
• 21.23 Adding Replace Actions
• 21.24 Adding Validate Actions
• 21.25 Adding Alert Actions
• 21.26 Adding Log Actions
• 21.27 Adding Report Actions

22 Proxy Services: XQuery and XPath Editors

• 22.1 Creating and Editing Inline XQuery and XPath Expressions
• 22.2 Understanding XQuery Editor Layouts and Tasks
  • 22.2.1 Palettes
  • 22.2.2 Workspace
  • 22.2.3 Property Inspector
• 22.3 Building Expressions in the Editor Workspace Text Fields
• 22.4 Creating Namespaces to Use in Inline Expressions
• 22.5 Creating Variable Structures in the XQuery Editors
• 22.6 Creating Custom XPath Functions in the XQuery Editors
• 22.7 Binding External XQuery Resources to Inline XQueries
• 22.8 Binding External XSLT Resources to Inline XQueries
• 22.9 Binding Dynamic XQuery Expressions to Inline XQueries
• 22.10 Entering XQuery Comparison Expressions Using the Builder Option
• 22.11 Entering Unary Expressions Using the Builder Option

23 Proxy Services: Error Handlers

• 23.1 Edit Error Handler Page
• 23.2 Adding Proxy Service Error Handlers
• 23.3 Adding Pipeline Error Handlers
• 23.4 Adding Stage Error Handlers
• 23.5 Adding Route Node Error Handlers
• 23.6 Editing Error Handlers

24 Security Configuration

• 24.1 Understanding Users, Groups, Security Roles and Policies
  • 24.1.1 Users
  • 24.1.2 Groups
    • 24.1.2.1 Administrative Security Groups
  • 24.1.3 Roles
    • 24.1.3.1 Administrative Security Roles
  • 24.1.4 Access Control Policies
  • 24.1.5 Security Configuration Data and Sessions
• 24.2 Locating Users
• 24.3 Adding Users
• 24.4 Editing Users
• 24.5 Deleting Users
• 24.6 Locating Groups
• 24.7 Adding Groups
• 24.8 Editing Groups
• 24.9 Deleting Groups
• 24.10 Locating Roles
• 24.11 Adding Roles
  • 24.11.1 Defining Role Conditions
• 24.12 Editing Roles
• 24.13 Deleting Roles
• 24.14 Locating Access Control Policies
• 24.15 Editing Transport-Level Access Policies
• 24.16 Editing Message-Level Access Policies
• 24.17 Adding Policy Conditions

25 Monitoring

• 25.1 Viewing SLA Alerts
• 25.2 Viewing Pipeline Alerts
• 25.3 Locating Alerts
  • 25.3.1 WebLogic Diagnostics Framework Query Language
• 25.4 Purging Alerts
• 25.5 Viewing Alert Details
• 25.6 Viewing Service Monitoring Information
• 25.7 Resetting Statistics for Services
• 25.8 Configuring Operational Settings for Proxy Services
• 25.9 Configuring Operational Settings for Business Services
• 25.10 Setting the Aggregation Interval for a Service
• 25.11 Viewing Service Metrics
• 25.12 Viewing Operations Metrics for WSDL-Based Services
• 25.13 Viewing Pipeline Metrics
• 25.14 Viewing Action Metrics
• 25.15 Viewing Business Services Endpoint URIs Metrics
• 25.16 Viewing Server Information
• 25.17 Viewing Server Details
• 25.18 Viewing Domain Log Files
• 25.19 Customizing Your View of Domain Log File Entries
• 25.20 Viewing Details of Domain Log Files
• 25.21 Viewing Alert Rules
• 25.22 Locating Alert Rules
• 25.23 Creating and Editing Alert Rules
  • 25.23.1 Configuring General Information for Alert Rules
  • 25.23.2 Defining Alert Rule Conditions
  • 25.23.3 Reviewing the Alert Rule Configuration
• 25.24 Viewing Alert Rule Configurations
• 25.25 Editing Alert Rules
• 25.26 Deleting Alert Rules

26 Configuration

• 26.1 Finding and Updating Operational Settings
  • 26.1.1 Finding All Services (Proxy and Business Services)
  • 26.1.2 Finding Proxy Services
  • 26.1.3 Finding Business Services
  • 26.1.4 Finding Split-Joins
  • 26.1.5 Finding Alert Destinations
  • 26.1.6 Finding SLA Alert Rules
• 26.2 Enabling Global Settings
  • 26.2.1 Enabling Global Monitoring of Services
  • 26.2.2 Disabling Global Monitoring of Services
  • 26.2.3 Enabling SLA Alerts Globally
  • 26.2.4 Disabling SLA Alerts Globally
  • 26.2.5 Enabling Pipeline Alerts Globally
  • 26.2.6 Disabling Pipeline Alerts Globally
  • 26.2.7 Enabling Message Reporting Globally
  • 26.2.8 Disabling Message Reporting Globally
  • 26.2.9 Enabling Logging Globally
  • 26.2.10 Disabling Logging Globally
  • 26.2.11 Enabling Result Caching Globally
  • 26.2.12 Disabling Result Caching Globally
• 26.3 Setting User Preferences

27 Reporting

• 27.1 Viewing Reporting Messages
• 27.2 Viewing Message Details
• 27.3 Purging Messages

28 Import/Export

• 28.1 Importing Resources
  • 28.1.1 Selecting Projects and Resources to Import
  • 28.1.2 Specifying the Importing Security Settings
  • 28.1.3 Importing Service Accounts or Service Key Providers
  • 28.1.4 Reviewing the Import Summary
• 28.2 Exporting Resources
  • 28.2.1 Specifying the Exporting Security Settings

29 UDDI

• 29.1 Viewing Configured UDDI Registries
• 29.2 Configuring UDDI Registries
  • 29.2.1 Adding UDDI Registries
  • 29.2.2 Editing UDDI Registries
• 29.3 Setting Up a Default UDDI Configuration
• 29.4 Importing Business Services From a UDDI Registry
• 29.5 Using Auto-Import Status
• 29.6 Detaching Services
• 29.7 Publishing Proxy Services to a UDDI Registry
• 29.8 Using Auto-Publish

30 Global Resources

• 30.1 Viewing JNDI Providers
• 30.2 Adding JNDI Providers
• 30.3 Editing JNDI Providers
• 30.4 Deleting JNDI Providers
• 30.5 Viewing SMTP Servers
• 30.6 Locating SMTP Servers
• 30.7 Adding SMTP Servers
• 30.8 Configuring a Default SMTP Server
• 30.9 Editing SMTP Servers
• 30.10 Deleting SMTP Servers
• 30.11 Viewing Proxy Servers
• 30.12 Locating Proxy Servers
• 30.13 Adding Proxy Servers
• 30.14 Editing Proxy Servers
• 30.15 Deleting Proxy Servers

31 Customization

• 31.1 Finding and Replacing Environment Values
• 31.2 Creating Customization Files
• 31.3 Executing Customization Files

32 Test Console

• 32.1 Testing Services
  • 32.1.1 Testing Proxy Services
  • 32.1.2 Configuring Proxy Services Test Data
  • 32.1.3 Viewing Proxy Services Test Results
  • 32.1.4 Tracing Proxy Services
  • 32.1.5 Testing Business Services
  • 32.1.6 Configuring Business Services Test Data
  • 32.1.7 Viewing Business Services Test Results
• 32.2 Testing Transformations
  • 32.2.1 Testing MFL Transformations
  • 32.2.2 Testing XSLT Transformations
  • 32.2.3 Testing XQuery Transformations
• 32.3 Performing XQuery Testing
  • 32.3.1 Using the XQuery Expression and XQuery Condition Editors
  • 32.3.2 Using the XPath Expression Editor
• 32.4 Understanding How the Run Time Uses the Transport Settings in the Test Console

Part II User Guide

33 Introduction to Oracle Service Bus

• 33.1 Document Scope and Audience

34 Configuring Proxy Services and Business Services

• 34.1 Oracle Service Bus Proxy Services
• 34.2 Oracle Service Bus Business Services
• 34.3 How WSDL is Used in Oracle Service Bus
  • 34.3.1 About Effective WSDLs and Generated WSDLs
    • 34.3.1.1 Effective WSDLs
    • 34.3.1.2 Generated WSDLs
    • 34.3.1.3 Accessing Effective WSDLs
  • 34.3.2 WSDL Overview
    • 34.3.2.1 Types
    • 34.3.2.2 Message
    • 34.3.2.3 Port Type
    • 34.3.2.4 Binding
    • 34.3.2.5 Service and Port
• 34.4 Using a WSDL to Define a Service
  • 34.4.1 SOAP Document Wrapped Web Services
  • 34.4.2 SOAP Document Style Web Services
  • 34.4.3 SOAP RPC Web Services
• 34.5 Basing Services on WSDL Ports and on WSDL Bindings
  • 34.5.1 Characteristics of Effective WSDLs Generated for Proxy Services
    • 34.5.1.1 Characteristics of Effective WSDLs Generated for Non-Transport-Type Business Services
    • 34.5.1.2 Characteristics of Effective WSDLs Generated for Transport-Type Business Services
    • 34.5.1.3 Generating Effective WSDLs in Clustered Domains
    • 34.5.1.4 Examples of Proxy Services Based on a Port and on a Binding
  • 34.5.2 Using Any SOAP or Any XML Service Types
  • 34.5.3 Using the Messaging Service Type
• 34.6 Configuring Proxy Services
  • 34.6.1 Proxy Service Types and Transports
  • 34.6.2 Transport and Security Configuration for Proxy Services
  • 34.6.3 Configuration Settings For Each Proxy Service Type
  • 34.6.4 Configuring Message Flow
  • 34.6.5 Security-Related Validation for Proxy Services
• 34.7 Configuring Business Services
  • 34.7.1 Business Service Types and Transport
  • 34.7.2 Configuration Settings for All Business Service Types
  • 34.7.3 Configuration Settings For Each Business Service Type
  • 34.7.4 Using Proxy Servers
  • 34.7.5 Improving Performance by Caching Business Service Results
    • 34.7.5.1 How Result Caching Works
    • 34.7.5.2 Result Caching Best Practices
    • 34.7.5.3 Result Cache Metadata
    • 34.7.5.4 Testing Result Caching
    • 34.7.5.5 Result Caching Advanced Configuration
• 34.8 Viewing Resource Details

35 Modeling Message Flow in Oracle Service Bus

• 35.1 Message Flow Components
  • 35.1.1 Building a Message Flow
  • 35.1.2 Message Execution
• 35.2 Branching in Message Flows
  • 35.2.1 Operational Branching
  • 35.2.2 Conditional Branching
• 35.3 Configuring Actions in Stages and Route Nodes
  • 35.3.1 Communication Actions
  • 35.3.2 Flow Control Actions
  • 35.3.3 Message Processing Actions
  • 35.3.4 Reporting Actions
  • 35.3.5 Configuring Transport Headers in Message Flows
    • 35.3.5.1 Configuring Global Pass Through and Header-Specific Copy Options for Transport Headers
    • 35.3.5.2 Understanding How the Run Time Uses the Transport Headers Settings
• 35.4 Performing Transformations in Message Flows
  • 35.4.1 Transformations and Publish Actions
  • 35.4.2 Transformations and Route Nodes
• 35.5 Constructing Service Callout Messages
  • 35.5.1 SOAP Document Style Services
  • 35.5.2 SOAP RPC Style Services
  • 35.5.3 XML Services
  • 35.5.4 Messaging Services
• 35.6 Handling Errors as the Result of a Service Callout
  • 35.6.1 Transport Errors
  • 35.6.2 SOAP Faults
  • 35.6.3 Unexpected Responses
• 35.7 Handling Errors in Message Flows
  • 35.7.1 Generating the Error Message, Reporting, and Replying
  • 35.7.2 Example of Action Configuration in Error Handlers
• 35.8 Using Dynamic Routing
  • 35.8.1 Implementing Dynamic Routing
    • 35.8.1.1 Sample XML File
    • 35.8.1.2 Creating an XQuery Resource From the Sample XML
    • 35.8.1.3 Creating and Configuring the Proxy Service to Implement Dynamic Routing
• 35.9 Accessing Databases Using XQuery
• 35.10 Understanding Message Context
  • 35.10.1 Message Context Components
  • 35.10.2 Guidelines for Viewing and Altering Message Context
  • 35.10.3 Copying JMS Properties From Inbound to Outbound
• 35.11 Working with Variable Structures
  • 35.11.1 Using the Inline XQuery Expression Editor
    • 35.11.1.1 Inline XQueries
    • 35.11.1.2 Uses of the Inline XQuery Expression Editor
  • 35.11.2 Using Variable Structures
  • 35.11.3 Creating Variable Structure Mappings
    • 35.11.3.1 Sample WSDL
    • 35.11.3.2 Creating the Resources You Need for the Examples
    • 35.11.3.3 Example 1: Selecting a Predefined Variable Structure
    • 35.11.3.4 Example 2: Creating a Variable Structure That Maps a Variable to a Type
    • 35.11.3.5 Example 3: Creating a Variable Structure that Maps a Variable to an Element
    • 35.11.3.6 Example 4: Creating a Variable Structure That Maps a Variable to a Child Element
    • 35.11.3.7 Example 5: Creating a Variable Structure that Maps a Variable to a Business Service
    • 35.11.3.8 Example 6: Creating a Variable Structure That Maps a Child Element to Another Child Element
• 35.12 Quality of Service
  • 35.12.1 Delivery Guarantees
    • 35.12.1.1 Overriding the Default Element Attribute
    • 35.12.1.2 Delivery Guarantee Rules
    • 35.12.1.3 Threading Model
    • 35.12.1.4 Splitting Proxy Services
  • 35.12.2 Outbound Message Retries
• 35.13 Content Types, JMS Type, and Encoding
• 35.14 Throttling Pattern
• 35.15 WS-I Compliance
  • 35.15.1 WS-I Compliance Checks
• 35.16 Converting Between SOAP 1.1 and SOAP 1.2

36 Improving Service Performance with Split-Join

• 36.1 Introduction to Split-Join
  • 36.1.1 Static Split-Join
    • 36.1.1.1 Static Split-Join – Sample Scenario
  • 36.1.2 Dynamic Split-Join
    • 36.1.2.1 Dynamic Split-Join – Sample Scenario
  • 36.1.3 Split-Join Framework
• 36.2 Developing Split-Joins
  • 36.2.1 Split-Join Resource Type and Environment Variable

37 Message Context

• 37.1 The Message Context Model
• 37.2 Predefined Context Variables
• 37.3 Message-Related Variables
  • 37.3.1 Header Variable
  • 37.3.2 Body Variable
  • 37.3.3 Attachments Variable
  • 37.3.4 Binary Content in the body and attachments Variables
  • 37.3.5 Java Content in the body Variable
  • 37.3.6 Streaming body Content
    • 37.3.6.1 Best Practices for Using Content Streaming
  • 37.3.7 Streaming Attachments
    • 37.3.7.1 Inbound Message Handling
    • 37.3.7.2 Outbound Message Handling
  • 37.3.8 Understanding MTOM/XOP Support
    • 37.3.8.1 Configuring Proxy Services
    • 37.3.8.2 Configuring Business Services
• 37.4 Inbound and Outbound Variables
  • 37.4.1 Sub-Elements of the inbound and outbound Variables
    • 37.4.1.1 service
    • 37.4.1.2 transport
    • 37.4.1.3 security
  • 37.4.2 Related Topics
• 37.5 Operation Variable
• 37.6 Fault Variable
• 37.7 Initializing Context Variables
  • 37.7.1 Initializing the attachments Context Variable
  • 37.7.2 Initializing the header and body Context Variables
    • 37.7.2.1 SOAP Services
    • 37.7.2.2 XML Services (Non SOAP)
    • 37.7.2.3 Messaging Services
• 37.8 Performing Operations on Context Variables
  • 37.8.1 $body
  • 37.8.2 $header
  • 37.8.3 Related Topics
• 37.9 Constructing Messages to Dispatch
  • 37.9.1 SOAP Services
  • 37.9.2 XML Services (Non SOAP)
  • 37.9.3 Messaging Services
    • 37.9.3.1 About Sending Binary Content in Email Messages
  • 37.9.4 Related Topics
• 37.10 Message Context Schema
  • 37.10.1 Related Topics

38 Using the Test Console

• 38.1 Features
• 38.2 Prerequisites
• 38.3 Testing Proxy Services
  • 38.3.1 Direct Calls
  • 38.3.2 Indirect Calls
  • 38.3.3 HTTP Requests
• 38.4 Testing Business Services
• 38.5 Recommended Approaches to Testing Proxy and Business Services
• 38.6 Tracing Proxy Services Using the Test Console
  • 38.6.1 Example: Testing and Tracing a Proxy Service
• 38.7 Testing Resources
  • 38.7.1 MFL
    • 38.7.1.1 Example
  • 38.7.2 XSLT
  • 38.7.3 XQuery
• 38.8 Performing XQuery Testing
• 38.9 Testing Services With Web Service Security
  • 38.9.1 Limitations for Services and Policies
• 38.10 Test Console Transport Settings
• 38.11 About Security and Transports

39 UDDI

• 39.1 UDDI, UDDI Registries, and Web Services
  • 39.1.1 Basic Concepts of the UDDI Specification
  • 39.1.2 Benefits of Using a UDDI Registry with Oracle Service Bus
  • 39.1.3 Introduction to UDDI Entities
• 39.2 Sample Business Scenarios for Oracle Service Bus and UDDI
  • 39.2.1 Basic Proxy Service Communication with a UDDI Registry
  • 39.2.2 Cross-Domain Deployment in Oracle Service Bus
• 39.3 Using Oracle Service Bus and UDDI
  • 39.3.1 A UDDI Workflow
• 39.4 Configuring a Registry
• 39.5 Publishing a Proxy Service to a UDDI Registry
  • 39.5.1 Publishing Local Proxy Services to UDDI
• 39.6 Using Auto-Publish
• 39.7 Importing a Service from a Registry
  • 39.7.1 Related References
• 39.8 Using Auto-Import
  • 39.8.1 Synchronize
  • 39.8.2 Detach
• 39.9 Auto-Synchronization of Services With UDDI
• 39.10 Mapping Oracle Service Bus Proxy Services to UDDI Entities
  • 39.10.1 UDDI Mapping Details for an Oracle Service Bus Proxy Service
  • 39.10.2 Transport Attributes
  • 39.10.3 Service Type Attributes
• 39.11 Canonical tModels Supporting Oracle Service Bus Services
• 39.12 Example

40 Extensibility Using Java Callouts and POJOs

• 40.1 Usage Guidelines
• 40.2 Working with Streaming Content
  • 40.2.1 Passing Streaming Content to a Java Callout
  • 40.2.2 Streaming Content Results from a Java Callout
• 40.3 Best Practices

41 XQuery Implementation

• 41.1 Supported Function Extensions from Oracle Data Service Integrator
• 41.2 Function Extensions from Oracle Service Bus
  • 41.2.1 fn-bea:lookupBasicCredentials
  • 41.2.2 fn-bea:isUserInGroup
  • 41.2.3 fn-bea:isUserInRole
  • 41.2.4 fn-bea: uuid
  • 41.2.5 fn-bea:execute-sql()
    • 41.2.5.1 Example 1: Retrieving the URI from a Database for Dynamic Routing
    • 41.2.5.2 Example 2: Getting XMLType Data from a Database
  • 41.2.6 fn-bea:serialize()
• 41.3 Creating and Using Custom XPath Functions

Part III Operations

42 Introduction

43 Roles in Oracle Service Bus

• 43.1 Default Roles in Oracle Service Bus
  • 43.1.1 IntegrationAdmin
  • 43.1.2 IntegrationDeployer
  • 43.1.3 IntegrationMonitor
  • 43.1.4 IntegrationOperator
• 43.2 Relation Between Roles in WLS and Roles in Oracle Service Bus
• 43.3 How to Create Roles in Oracle Service Bus

44 Monitoring Oracle Service Bus at Run Time

• 44.1 What is Service Monitoring?
  • 44.1.1 About the Oracle Service Bus Monitoring Framework
• 44.2 Aggregation Intervals
  • 44.2.1 The Refresh Rate of Monitoring Data
  • 44.2.2 Sample Intervals Within Aggregation Intervals
  • 44.2.3 How to Set the Aggregation Interval for Monitoring Data
  • 44.2.4 What are the Consequences Of Changing Aggregation Interval Of A Service?
• 44.3 What are the Consequences of Renaming or Moving a Service?
• 44.4 What Statistics Are Available for Oracle Service Bus Services?
• 44.5 Accessing Statistical Information for Services
  • 44.5.1 How to Access Service Statistics from the Oracle Service Bus Console
  • 44.5.2 How to Access Statistical Information Using the JMX Monitoring APIs
  • 44.5.3 How to Access Statistics in a Cluster
  • 44.5.4 How to Reset Statistics
    • 44.5.4.1 What are the Consequences of Resetting the Statistics?
• 44.6 The Role of Alerts in Service Monitoring
  • 44.6.1 Assigning Severity for Alerts
  • 44.6.2 What are SLA Alerts?
    • 44.6.2.1 A Sample Use Case for SLA Alerts
  • 44.6.3 What are Pipeline Alerts?
    • 44.6.3.1 A Sample Use Case for Pipeline Alerts
  • 44.6.4 How to View or Delete SLA Alerts
  • 44.6.5 How to View or Delete Pipeline Alerts
  • 44.6.6 How to Filter a Search for Specific Alerts
    • 44.6.6.1 How to Filter a Search for SLA Alerts
    • 44.6.6.2 How to Filter a Search for Pipeline Alerts
  • 44.6.7 What are Alert Destinations?
    • 44.6.7.1 E-mail
    • 44.6.7.2 SNMP Traps
    • 44.6.7.3 Reporting
    • 44.6.7.4 Alert Logging
    • 44.6.7.5 JMS
• 44.7 What are Operational Settings for a Service?
  • 44.7.1 How to Configure the Operational Settings for a Service
  • 44.7.2 How to Configure the Operational Settings at the Global Level
  • 44.7.3 Updates to Operational Settings During Import of Oracle Service Bus Configurations
  • 44.7.4 Updates to Global Settings During the Import of Oracle Service Bus Configurations
  • 44.7.5 How to Preserve Operational Settings During the Import of Oracle Service Bus Configuration Through APIs
• 44.8 SLA Alerting Functionality in Oracle Service Bus
  • 44.8.1 How to Configure SLA Alert Rules
  • 44.8.2 How to Lookup or Edit Existing Alert Rules
  • 44.8.3 How to Rename Alert Rules
    • 44.8.3.1 What are the Consequences of Renaming an Alert Rule?
  • 44.8.4 What Happens to Alert Rules When You Import Oracle Service Bus Configurations?
• 44.9 The Oracle Service Bus Dashboard
  • 44.9.1 How to Access Service Statistics for the Current Aggregation Interval
  • 44.9.2 How to Access Running Count Statistics for Services
    • 44.9.2.1 Service Metrics
    • 44.9.2.2 Operations
    • 44.9.2.3 Pipeline Metrics
    • 44.9.2.4 Action Metrics
    • 44.9.2.5 Endpoint URIs
  • 44.9.3 Viewing SLA Alerts in the Dashboard
    • 44.9.3.1 Viewing the Alert History for SLA Alerts
  • 44.9.4 Viewing Pipeline Alerts in the Dashboard
    • 44.9.4.1 Viewing the Alert History for Pipeline Alerts
  • 44.9.5 Viewing Server Health in the Dashboard
    • 44.9.5.1 Viewing Log Summary
    • 44.9.5.2 Viewing Server Summary
    • 44.9.5.3 Viewing Server Details

45 Reporting

• 45.1 About the Oracle Service Bus Reporting Framework
• 45.2 About the JMS Reporting Provider
• 45.3 How to Enable Message Reporting
• 45.4 How to Stop a Reporting Provider
• 45.5 How to Untarget a JMS Reporting Provider
  • 45.5.1 How to Untarget the Default JMS Reporting Provider Before Domain Creation
  • 45.5.2 How to Untarget the JMS Reporting Provider when the Server is Running
  • 45.5.3 How to Untarget the JMS Reporting Provider When Server Not Running
• 45.6 Using the Reporting Module in the Oracle Service Bus Console
  • 45.6.1 Viewing the Summary of Message Reports
  • 45.6.2 Viewing Message Details
  • 45.6.3 How to Purge Messages from the Reporting Data Store
  • 45.6.4 How to Configure a Database for the JMS Reporting Provider Store
    • 45.6.4.1 Configure the Reporting Data Source for Transactions
    • 45.6.4.2 How to Configure a Database in a Development Environment
    • 45.6.4.3 How to Configure a Database for Production

46 Managing Endpoint URIs for Business Services

• 46.1 How to Configure a Business Service to Perform Retries
  • 46.1.1 How to Suppress Retries in Case of Application Errors
• 46.2 How to Mark a Non-Responsive URI Offline
  • 46.2.1 How to Mark an Endpoint URI Offline Temporarily
  • 46.2.2 How to Mark an Endpoint URI Offline Permanently
• 46.3 Metrics for Monitoring Endpoint URIs
  • 46.3.1 Endpoint URI Status
  • 46.3.2 Endpoint URI Performance Metrics
• 46.4 How to Mark an Offline URI as Online
• 46.5 How to Generate Alerts Based on Endpoint URI Status
  • 46.5.1 How to Configure an Alert Rule Based on Endpoint URI Status

47 Tracing

• 47.1 How to Enable or Disable Tracing
• 47.2 How to Access Tracing Information

48 Throttling

• 48.1 How to Enable Throttling
• 48.2 What are the Operational Settings for Throttling?
• 48.3 What Metrics are Available for Throttling?
• 48.4 How to Access Throttling Metrics
• 48.5 How to use Throttling Metrics for Alerting
• 48.6 How to use Throttling for Business Services with Multiple Endpoint URIs
  • 48.6.1 What Happens to Retried Messages During Throttling?

49 Managing Operational Settings Using Smart Search

• 49.1 Using Basic Search
• 49.2 Using Advanced Search
• 49.3 Managing Operational Settings for All Services
  • 49.3.1 Finding Services Using Search Filters
  • 49.3.2 Viewing and Editing Operational Settings
• 49.4 Managing Operational Settings for Proxy Services
  • 49.4.1 Finding Proxy Services Using Search Filters
  • 49.4.2 Viewing and Editing Operational Settings
• 49.5 Managing Operational Settings for Business Services
  • 49.5.1 Finding Business Services Using Search Filters
  • 49.5.2 Viewing and Editing Operational Settings
• 49.6 Managing Operational Settings for Split-Joins
  • 49.6.1 Finding Split-Joins Using Search Filters
  • 49.6.2 Viewing and Editing Operational Settings
• 49.7 Managing Operational Settings for Alert Destinations
  • 49.7.1 Finding Alert Destinations using Search Filters
  • 49.7.2 Viewing and Deleting Alert Destinations
• 49.8 Managing Operational Settings for SLA Alert Rules
  • 49.8.1 Finding SLA Alert Rules Using Search Filters
  • 49.8.2 Viewing and Configuring SLA Alert Rules

50 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 Managed Resource
• E.2 Management Information Base
  • E.2.1 SNMP Agent
  • E.2.2 SNMP Manager
  • E.2.3 Network Management System (NMS)
• E.3 Creating and Using SNMP Trap Destinations

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