This document provides a developer's guide for using the Oracle Service Bus (OSB) integrated development environment (IDE) to create and configure proxy services, business services, message flows, transformations, transports, and other OSB resources. It describes tasks like creating projects and folders, generating services from WSDLs, designing split-join message flows, debugging message flows, and more.

1. Oracle® Fusion Middleware
Developer’s Guide for Oracle Service Bus
11g Release 1 (11.1.1.6.3)
E15866-08
August 2012
Documentation for developers that describes how to use the
Oracle Service Bus (OSB) development environment (IDE) to
create and configure proxy and business services, Split-Joins,
create message flows, perform message transformation with
XQuery, XSLT, and MFL, configure transports, work with
JCA adapters, create custom transports, configure security
using WS-Security, use the OSB API, and create global JNDI
resources.

2. Oracle Fusion Middleware Developer's Guide for Oracle Service Bus, 11g Release 1 (11.1.1.6.3)
E15866-08
Copyright © 2008, 2012, Oracle and/or its affiliates. All rights reserved.
Primary Author: Carol Thom
Contributing Author: Floyd Jones
Contributor:
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"
pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and
license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of
the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software
License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications, including
applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other
measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages
caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of
their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,
Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced
Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle
Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your
access to or use of third-party content, products, or services.

3. Contents
Preface .............................................................................................................................................................. xliii
Documentation Accessibility .................................................................................................................. xliii
Conventions .............................................................................................................................................. xliii
What's New in This Guide for Release 11.1.1.6.x .................................................................... xlv
Part I IDE Help for Oracle Service Bus
1 Introduction to Oracle Service Bus
2 Tasks
Working with Projects, Folders, Resources, and Configurations ................................................... 2-1
Resource Naming Restrictions ......................................................................................................... 2-2
Editing Resources............................................................................................................................... 2-2
Cloning Oracle Service Bus Projects and Folders.......................................................................... 2-2
Creating Oracle Service Bus Configuration Projects..................................................................... 2-3
Creating Oracle Service Bus Projects............................................................................................... 2-3
Creating Servers ................................................................................................................................. 2-3
Creating Custom Resources.............................................................................................................. 2-4
Creating and Editing JNDI Provider Resources ............................................................................ 2-4
Creating Proxy Server Resources..................................................................................................... 2-5
Creating Message Format Files ........................................................................................................ 2-5
Exporting Resources .......................................................................................................................... 2-5
Using the Export Wizard ........................................................................................................... 2-6
Using the Command Line or a Script to Export an Oracle Service Bus Configuration .... 2-6
Before You Begin.................................................................................................................. 2-6
Exporting a Configuration Using the Command Line................................................... 2-6
Exporting a Configuration Using Ant .............................................................................. 2-8
Exporting a Configuration Using WLST .......................................................................... 2-9
Generating an Effective WSDL ........................................................................................................ 2-9
Modifying JAR Dependencies.......................................................................................................... 2-9
Importing Resources.......................................................................................................................... 2-9
Using the Import Wizard........................................................................................................ 2-10
Using the Command Line or a Script to Import an Oracle Service Bus Configuration. 2-10
Creating Service Account Resources............................................................................................ 2-10
iii

4. Creating Service Key Provider Resources ................................................................................... 2-10
Creating SMTP Server Resources ................................................................................................. 2-11
Creating XQuery Transformations ............................................................................................... 2-11
Creating XSL Transformations...................................................................................................... 2-11
Working with Business Services ........................................................................................................ 2-11
Creating Business Services............................................................................................................. 2-12
Generating a Business Service from an Existing Service.................................................... 2-12
Generating a JCA Business Service from an Outbound JCA File ............................................ 2-12
Generating a Business Service from Oracle Enterprise Repository ......................................... 2-13
Re-generating an Existing Business Service from Oracle Enterprise Repository ........... 2-13
Editing Business Services............................................................................................................... 2-13
Working with Proxy Services .............................................................................................................. 2-13
Creating Proxy Services ................................................................................................................. 2-13
Generating a Proxy Service from an Existing Service ........................................................ 2-14
Generating a JCA Proxy Service from an Inbound JCA File .................................................... 2-14
Consuming Oracle Service Bus Proxy Services in Oracle JDeveloper with WSIL ................ 2-15
Editing Proxy Services.................................................................................................................... 2-16
Working with Proxy Service Message Flows ................................................................................... 2-16
Constructing Proxy Service Message Flows................................................................................ 2-17
Adding and Configuring Alert Actions in Message Flows ...................................................... 2-18
Adding and Configuring Assign Actions in Message Flows ................................................... 2-18
Adding and Configuring Conditional Branch Nodes in Message Flows ............................... 2-19
Adding and Configuring Delete Actions in Message Flows .................................................... 2-19
Adding and Configuring Dynamic Publish Actions in Message Flows ................................. 2-20
Adding and Configuring Dynamic Routing Actions in Message Flows ................................ 2-20
Adding and Configuring Error Handlers in Message Flows ................................................... 2-20
Adding and Configuring For-Each Actions in Message Flows................................................ 2-21
Adding and Configuring If-Then Actions in Message Flows .................................................. 2-21
Adding and Configuring Insert Actions in Message Flows ..................................................... 2-22
Adding and Configuring Java Callout Actions in Message Flows.......................................... 2-22
Adding and Configuring Log Actions in Message Flows......................................................... 2-23
Adding and Configuring MFL Transform Actions in Message Flows ................................... 2-23
Adding and Configuring Operational Branch Nodes in Message Flows............................... 2-23
Adding and Configuring Pipeline Pair Nodes in Message Flows ........................................... 2-24
Adding and Configuring Publish Actions in Message Flows .................................................. 2-24
Adding and Configuring Publish Table Actions in Message Flows ....................................... 2-25
Adding and Configuring Raise Error Actions in Message Flows............................................ 2-26
Adding and Configuring Rename Actions in Message Flows ................................................. 2-26
Adding and Configuring Replace Actions in Message Flows.................................................. 2-27
Adding and Configuring Reply Actions in Message Flows ..................................................... 2-27
Adding and Configuring Report Actions in Message Flows ................................................... 2-27
Adding and Configuring Resume Actions in Message Flows ................................................. 2-28
Adding and Configuring Route Nodes in Message Flows ....................................................... 2-28
Adding and Configuring Routing Actions in Message Flows ................................................. 2-28
Adding and Configuring Routing Options Actions in Message Flows .................................. 2-29
Adding and Configuring Routing Table Actions in Message Flows ...................................... 2-29
Adding and Configuring Service Callout Actions in Message Flows..................................... 2-30
iv

5. Adding and Configuring Skip Actions in Message Flows........................................................ 2-30
Adding and Configuring Stages in Message Flows................................................................... 2-31
Adding and Configuring Transport Headers Actions in Message Flows .............................. 2-31
Adding and Configuring Validate Actions in Message Flows................................................. 2-31
Working with Alert Destinations....................................................................................................... 2-32
Creating and Editing Alert Destinations ..................................................................................... 2-32
Adding E-mail Recipients to Alert Destinations ........................................................................ 2-32
Adding JMS Destinations to Alert Destinations......................................................................... 2-32
Working with MQ Connections ......................................................................................................... 2-33
Adding and Editing MQ Connections ......................................................................................... 2-33
Working with Oracle Enterprise Repository and Harvester ......................................................... 2-34
Generating Business Services from Oracle Enterprise Repository .......................................... 2-34
Using Harvester............................................................................................................................... 2-35
Using Harvester from Eclipse ................................................................................................ 2-36
Using Harvester from the Command Line or a Script ....................................................... 2-37
Performing Queries in Oracle Enterprise Repository from Eclipse......................................... 2-38
Working with UDDI Registries .......................................................................................................... 2-38
Adding and Configuring UDDI Registries ................................................................................. 2-39
Importing Business Services From a UDDI Registry ................................................................. 2-39
Working with Split-Join....................................................................................................................... 2-39
Introduction to Split-Join ............................................................................................................... 2-40
Using Split-Join with Content in SOAP Headers ................................................................ 2-40
Transaction Support ................................................................................................................ 2-41
Security with Split-Joins.......................................................................................................... 2-41
Designing a Split-Join ..................................................................................................................... 2-41
Initial Setup............................................................................................................................... 2-42
Creating/Importing a WSDL Containing the Base Operation .................................. 2-42
Creating/Importing a Business Service to Use the Split-Join .................................... 2-42
Designing a Static Split-Join .......................................................................................................... 2-42
1. Creating a New Split-Join ................................................................................................... 2-42
2. Adding an Assign ................................................................................................................ 2-43
3. Adding a Parallel Node ...................................................................................................... 2-43
4. Adding an Assign for Each Branch ................................................................................... 2-44
5. Adding an Invoke Service .................................................................................................. 2-44
6. Adding an Assign for Each Branch ................................................................................... 2-44
7. Exporting and Testing the Split-Join................................................................................. 2-44
Designing a Dynamic Split-Join .................................................................................................... 2-45
1. Creating a New Split-Join ................................................................................................... 2-46
2. Adding an Assign ................................................................................................................ 2-47
3. Adding a For Each ............................................................................................................... 2-47
4. Adding an Assign ................................................................................................................ 2-47
5. Adding an Invoke Service .................................................................................................. 2-47
6. Adding an Assign ................................................................................................................ 2-48
7. Adding an Error Handler ................................................................................................... 2-48
8. Exporting and Testing the Split-Join................................................................................. 2-48
Creating a New Split-Join .............................................................................................................. 2-49
Configuring the Start Node ........................................................................................................... 2-50
v

6. Adding General Information.................................................................................................. 2-51
Defining Global Variables....................................................................................................... 2-51
Viewing External Services ...................................................................................................... 2-52
Configuring a Receive .................................................................................................................... 2-52
Viewing the Operation............................................................................................................ 2-52
Defining the Receive Variable................................................................................................ 2-52
Adding General Information.................................................................................................. 2-53
Creating an Assign.......................................................................................................................... 2-53
Adding and Configuring Assign Operations ...................................................................... 2-53
Adding an Operation to an Assign ................................................................................ 2-54
Adding a Copy Operation............................................................................................... 2-54
Adding General Information.................................................................................................. 2-55
Invoking a Service ........................................................................................................................... 2-55
Selecting an Operation ............................................................................................................ 2-55
Defining Input and Output Variables................................................................................... 2-55
Adding General Information.................................................................................................. 2-56
Creating a Parallel ........................................................................................................................... 2-56
Adding Nodes .......................................................................................................................... 2-56
Adding General Information.................................................................................................. 2-57
Creating a For Each......................................................................................................................... 2-57
Defining the For Each Logic ................................................................................................... 2-57
Adding General Information.................................................................................................. 2-58
Creating an If Activity .................................................................................................................... 2-58
Configuring the If ................................................................................................................... 2-58
Writing the logic of the condition................................................................................... 2-59
Adding resulting nodes ................................................................................................... 2-59
Adding General Information .......................................................................................... 2-59
Adding and Configuring Else If ........................................................................................... 2-59
Writing the Logic of the Condition ................................................................................ 2-59
Adding Resulting Nodes ................................................................................................. 2-60
Adding General Information .......................................................................................... 2-60
Configuring the Else ................................................................................................................ 2-60
Adding Resulting Nodes ................................................................................................. 2-60
Adding General Information.................................................................................................. 2-60
Creating an Error Handler............................................................................................................. 2-60
Creating a Raise Error..................................................................................................................... 2-61
Configuring a Reply........................................................................................................................ 2-61
Viewing the Operation............................................................................................................ 2-62
Defining the Reply Variable ................................................................................................... 2-62
Adding General Information.................................................................................................. 2-63
About Scope ..................................................................................................................................... 2-63
Scope and Variables................................................................................................................. 2-63
Exporting and Testing a Split-Join................................................................................................ 2-64
Creating a Transport Typed Business Service ..................................................................... 2-64
Exporting the Split-Join Files.................................................................................................. 2-64
Exporting from the Business Service Menu .................................................................. 2-65
Auto-export ....................................................................................................................... 2-65
vi

7. Manual export ................................................................................................................... 2-65
Testing the Split-Join in the Test Console............................................................................. 2-66
Exporting from the Business Service Menu .................................................................. 2-66
Using the Oracle Service Bus Debugger........................................................................................... 2-66
Enabling Debugging ....................................................................................................................... 2-67
Using Standard Debugging ........................................................................................................... 2-67
Debug Views............................................................................................................................. 2-68
Step Actions and Breakpoints ................................................................................................ 2-69
Using the Oracle Service Bus Debugger Launch Configuration.............................................. 2-69
Remote Debugging .................................................................................................................. 2-70
Debugging Oracle Service Bus Running Stand-Alone on a Managed Server................. 2-70
Server Sharing .......................................................................................................................... 2-70
3 Transport Configuration
Protocol-Specific Transport Configuration Pages.............................................................................. 3-1
BPEL-10g Transport Configuration Page (Business Services)..................................................... 3-2
DSP Transport Configuration Page (Business Services)............................................................... 3-3
EJB Transport Configuration Page (Business Services) ................................................................ 3-4
E-Mail Transport Configuration Page (Business Services) .......................................................... 3-5
E-Mail Transport Configuration Page (Proxy Services) ............................................................... 3-6
File Transport Configuration Page (Business Services)................................................................ 3-7
File Transport Configuration Page (Proxy Services)..................................................................... 3-7
FTP Transport Configuration Page (Business Services) ............................................................... 3-8
FTP Transport Configuration Page (Proxy Services) .................................................................... 3-9
HTTP Transport Configuration Page (Business Services) ........................................................ 3-10
HTTP Transport Configuration Page (Proxy Services) ............................................................. 3-13
JCA Transport Configuration Page (Proxy and Business Services)......................................... 3-15
JEJB Transport Configuration Page (Business Services)............................................................ 3-17
JEJB Transport Configuration Page (Proxy Services) ................................................................ 3-19
JMS Transport Configuration Page (Business Services) ............................................................ 3-20
JMS Transport Configuration Page (Proxy Services)................................................................. 3-24
MQ Transport Configuration Page (Business Services) ............................................................ 3-28
MQ Transport Configuration Page (Proxy Services) ................................................................. 3-30
SB Transport Configuration Page (Business Services)............................................................... 3-32
SB Transport Configuration Page (Proxy Services) ................................................................... 3-33
SFTP Transport Configuration Page (Business Services) .......................................................... 3-34
SFTP Transport Configuration Page (Proxy Services)............................................................... 3-34
SOA-DIRECT Transport Configuration Page (Business Services)........................................... 3-36
Tuxedo Transport Configuration Page (Business Services)...................................................... 3-38
Tuxedo Transport Configuration Page (Proxy Services)........................................................... 3-40
WS Transport Configuration Page (Business Services) ............................................................. 3-41
WS Transport Configuration Page (Proxy Services) .................................................................. 3-42
4 User Interface Reference
Alerts........................................................................................................................................................... 4-1
Alert Destination Editor .................................................................................................................... 4-2
vii

8. Edit E-mail Recipient Page ............................................................................................................... 4-2
Edit JMS Destination Page ................................................................................................................ 4-3
Business Service Configuration ............................................................................................................ 4-3
Business Service General Configuration Page ............................................................................... 4-4
Business Service Editor Options ............................................................................................... 4-4
Business Service Message Type Configuration Page.................................................................... 4-4
Business Service SOAP Binding Configuration Page ................................................................... 4-6
Business Service Transport Configuration Page ........................................................................... 4-6
Business Service Message Handling Configuration Page......................................................... 4-10
Business Service - Service Policy Configuration Page ............................................................... 4-13
Business Service Security Configuration Page............................................................................ 4-14
Proxy Service Configuration ............................................................................................................... 4-15
Proxy Service General Configuration Page ................................................................................. 4-15
Proxy Service Editor Options ................................................................................................. 4-15
Proxy Service Message Type Configuration Page...................................................................... 4-16
Proxy Service Operation Selection Configuration Page ............................................................ 4-18
Proxy Service Message Handling Configuration Page.............................................................. 4-21
Proxy Service SOAP Binding Configuration Page .................................................................... 4-24
Proxy Service Transport Configuration Page ............................................................................. 4-25
Proxy Service - Service Policy Configuration Page ................................................................... 4-27
Proxy Service Security Configuration Page ................................................................................ 4-28
Oracle Service Bus Configurations and Projects............................................................................. 4-30
Oracle Service Bus Configurations View..................................................................................... 4-30
New Oracle Service Bus Configuration Project Wizard ............................................................ 4-31
Oracle Service Bus Configuration Page ....................................................................................... 4-31
New Oracle Service Bus Project .................................................................................................... 4-32
Custom Resources ................................................................................................................................. 4-32
New Custom Resource Wizard..................................................................................................... 4-33
New Custom Resource Editor....................................................................................................... 4-33
New Custom Resource - Resource Type Page ........................................................................... 4-33
Custom MQ Resource Configuration Page ................................................................................ 4-33
Export Wizard......................................................................................................................................... 4-34
Export Wizard - Oracle Service Bus Configuration JAR Export Page..................................... 4-34
Export Wizard - Export to Server - Select Resources Page ....................................................... 4-35
Export Wizard - Export to Server - Review Resources Page .................................................... 4-36
Import Wizard ........................................................................................................................................ 4-36
Import Wizard - Config JAR Import - Load Resources Page ................................................... 4-36
Import Wizard - Config JAR Import - Review Resources Page ............................................... 4-37
Import Wizard - Config ZIP Import - Load Resources Page .................................................... 4-37
Import Wizard - Config ZIP Import - Review Resources Page ................................................ 4-37
Import Wizard - URL Import - Load Resources Page ............................................................... 4-38
Import Wizard - URL Import - Review Resources Page ........................................................... 4-38
JNDI Providers....................................................................................................................................... 4-38
JNDI Provider Editor ...................................................................................................................... 4-38
New JNDI Provider Resource Wizard ......................................................................................... 4-39
Proxy Servers ......................................................................................................................................... 4-39
Message Flow Design Palette ............................................................................................................. 4-40
viii

9. Message Flow Nodes ...................................................................................................................... 4-40
Message Flow Route Actions - Communication Actions.......................................................... 4-41
Message Flow Route Actions - Flow Control Actions ............................................................... 4-41
Message Flow Stage Actions - Communication Actions........................................................... 4-42
Message Flow Stage Actions - Flow Control Actions ................................................................ 4-42
Message Flow Stage Actions - Message Processing Actions .................................................... 4-43
Message Flow Stage Actions - Reporting Actions...................................................................... 4-44
Message Flow Editor............................................................................................................................. 4-44
Alert Action Properties................................................................................................................... 4-46
Assign Action Properties ............................................................................................................... 4-46
Conditional Branch Node Properties ........................................................................................... 4-47
Delete Action Properties ................................................................................................................ 4-48
Dynamic Publish Action Properties ............................................................................................. 4-49
Dynamic Routing Action Properties ............................................................................................ 4-50
Error Handler Node Properties..................................................................................................... 4-50
For-Each Action Properties............................................................................................................ 4-50
If-Then Action Properties............................................................................................................... 4-51
If Action and Else-If Action Properties................................................................................. 4-52
Else Action Properties ............................................................................................................. 4-52
Insert Action Properties ................................................................................................................. 4-52
Java Callout Action Properties ...................................................................................................... 4-53
Log Action Properties..................................................................................................................... 4-55
Message Flow Properties - Comment .......................................................................................... 4-56
Message Flow Properties - Namespaces ..................................................................................... 4-56
Message Flow Properties - Variables .......................................................................................... 4-56
MFL Transform Action Properties................................................................................................ 4-56
Operational Branch Node Properties ........................................................................................... 4-57
Pipeline Pair Node Properties ....................................................................................................... 4-58
Publish Action Properties .............................................................................................................. 4-59
Publish Table Action Properties.................................................................................................... 4-59
Publish Table Properties ......................................................................................................... 4-60
Case Action Properties ............................................................................................................ 4-60
Publish Action Properties ....................................................................................................... 4-61
Raise Error Action Properties........................................................................................................ 4-61
Transactions .............................................................................................................................. 4-61
Rename Action Properties ............................................................................................................. 4-61
Replace Action Properties.............................................................................................................. 4-62
Reply Action Properties ................................................................................................................. 4-63
Report Action Properties................................................................................................................ 4-64
Resume Action Properties ............................................................................................................. 4-65
Route Node Properties ................................................................................................................... 4-65
Routing Action Properties ............................................................................................................. 4-66
Routing Options Action Properties .............................................................................................. 4-66
Routing Table Action Properties................................................................................................... 4-67
Routing Table Properties ........................................................................................................ 4-68
Case Action Properties ............................................................................................................ 4-69
Routing Action Properties ...................................................................................................... 4-69
ix

10. Service Callout Action Properties................................................................................................. 4-69
Skip Action Properties.................................................................................................................... 4-72
Stage Node Properties .................................................................................................................... 4-72
Transport Headers Action Properties .......................................................................................... 4-72
Validate Action Properties............................................................................................................. 4-74
Modify JAR Dependencies Dialog .................................................................................................... 4-75
SMTP Servers......................................................................................................................................... 4-75
Edit SMTP Server Page................................................................................................................... 4-76
New SMTP Server Resource Wizard............................................................................................ 4-76
UDDI Registry Configuration Page................................................................................................... 4-76
Outline view - Oracle Service Bus ..................................................................................................... 4-77
Resource Management ......................................................................................................................... 4-77
Preferences dialog - Oracle Service Bus - Type Associations Page.......................................... 4-77
References View .............................................................................................................................. 4-78
Select Clone Target Dialog............................................................................................................. 4-78
Select a Resource Dialog................................................................................................................. 4-78
New Service Key Provider Resource ................................................................................................. 4-78
New WS-Policy ...................................................................................................................................... 4-79
Service Accounts.................................................................................................................................... 4-79
New Service Account Resource .................................................................................................... 4-80
Service Account Editor - General Configuration Page .............................................................. 4-80
Service Account Editor - Static User Configuration Page ......................................................... 4-80
Service Account Editor - User Mappings Configuration Page................................................. 4-81
Expression Editors ................................................................................................................................ 4-81
XQuery/XSLT Expression Editor ................................................................................................. 4-81
XPath Expression Editor ................................................................................................................ 4-82
Condition Editor.............................................................................................................................. 4-82
Condition Builder Page .................................................................................................................. 4-83
Expression Page............................................................................................................................... 4-83
XQuery Resource Page ................................................................................................................... 4-83
XSLT Resource Page ....................................................................................................................... 4-84
Dynamic XQuery Page ................................................................................................................... 4-84
Variable Structures Page ................................................................................................................ 4-85
Namespace Definitions Page......................................................................................................... 4-85
XQuery Functions Page.................................................................................................................. 4-86
Add Variable Structure Dialog ..................................................................................................... 4-86
New XSL Transformation .................................................................................................................... 4-87
Split-Join User Interface Reference ................................................................................................... 4-87
Split-Join Design Palette................................................................................................................. 4-88
Operations................................................................................................................................. 4-88
Global / Start Node Properties ..................................................................................................... 4-90
Variable Properties.......................................................................................................................... 4-90
Error Handler Properties ............................................................................................................... 4-91
Invoke Service Properties............................................................................................................... 4-91
Invoking Another Split-Join ................................................................................................... 4-92
Reply Properties .............................................................................................................................. 4-93
For Each Properties ......................................................................................................................... 4-93
x

11. If Properties...................................................................................................................................... 4-94
If and Else If Properties .................................................................................................................. 4-94
Parallel Properties ........................................................................................................................... 4-95
Raise Error Properties..................................................................................................................... 4-95
Repeat Until Properties .................................................................................................................. 4-95
Re-Raise Error Properties............................................................................................................... 4-95
Scope Properties .............................................................................................................................. 4-96
While Properties .............................................................................................................................. 4-96
Wait Properties ................................................................................................................................ 4-96
Assign Properties ............................................................................................................................ 4-97
Assign Operation Properties .................................................................................................. 4-97
Copy Properties............................................................................................................................... 4-98
Delete Properties ............................................................................................................................. 4-98
Insert Properties .............................................................................................................................. 4-99
Java Callout Properties................................................................................................................. 4-100
Log Properties................................................................................................................................ 4-101
Replace Properties......................................................................................................................... 4-101
Receive Properties ......................................................................................................................... 4-102
Counter Variable Dialog .............................................................................................................. 4-102
Create/Edit Variable Dialog........................................................................................................ 4-102
Scope and Variables............................................................................................................... 4-103
Create Message Variable Dialog ................................................................................................. 4-103
Service Browser ............................................................................................................................. 4-103
SOAP Fault Variable Dialog ........................................................................................................ 4-103
WSDL Browser .............................................................................................................................. 4-104
Split-Join Wizard - New Split-Join.............................................................................................. 4-104
Split-Join Wizard - Specify Operations ...................................................................................... 4-104
Part II XQuery Mapper
5 Introduction
Overview of XQuery Mapper ................................................................................................................ 5-1
Support for XQuery 2002 and 2004........................................................................................................ 5-2
Restrictions Applicable to the XQuery Test View ......................................................................... 5-2
6 Transforming Data Using XQuery Mapper
Launching XQuery Mapper.................................................................................................................... 6-1
Importing the XQuery Mapper Sample Project ................................................................................. 6-1
Creating an XQuery Mapper Project .................................................................................................... 6-2
Importing and Creating Schema Files.................................................................................................. 6-2
Importing XML Schemas and MFL Files ........................................................................................ 6-3
Creating XML Schemas ..................................................................................................................... 6-4
Creating XML Files from XML Schemas ........................................................................................ 6-4
Creating WSDL Files.......................................................................................................................... 6-5
Creating MFL Files............................................................................................................................. 6-5
Selecting Source and Target Data Types .............................................................................................. 6-6
xi

12. Creating Data Transformations ............................................................................................................. 6-7
Creating Basic Element Transformations ....................................................................................... 6-8
Prerequisite .................................................................................................................................. 6-8
Creating Element-to-Element Links......................................................................................... 6-8
Creating Basic Attribute Transformations...................................................................................... 6-8
Prerequisite .................................................................................................................................. 6-9
Creating an Attribute-to-Element Link.................................................................................... 6-9
Creating Complex Transformations................................................................................................ 6-9
Prerequisite ............................................................................................................................... 6-10
Creating a Complex Transformation .................................................................................... 6-10
Editing Data Transformations............................................................................................................. 6-10
Viewing and Editing XQuery Files............................................................................................... 6-10
Creating Joins and Unions ............................................................................................................. 6-11
Creating If-Then-Else Expressions................................................................................................ 6-11
Creating For-Let-Where-Order By-Return (FLWOR) Expressions.......................................... 6-13
Creating Typeswitch Expressions................................................................................................. 6-14
Inserting XQuery Functions .......................................................................................................... 6-15
Inserting Expression Variables...................................................................................................... 6-16
Viewing Schema Properties........................................................................................................... 6-17
Restricting Output of Optional Elements ........................................................................................ 6-17
Testing Data Transformations............................................................................................................. 6-18
Features of the Test View............................................................................................................... 6-18
Related Topics .......................................................................................................................... 6-21
Graphical Features in Design View ................................................................................................... 6-21
Right-Click Menu Options............................................................................................................. 6-21
Link Patterns .................................................................................................................................... 6-22
Link Colors....................................................................................................................................... 6-23
XML Global Elements, Global Types, Local Elements, and Attributes...................................... 6-24
7 Examples: Data Transformation Using XQuery Mapper
Combining Data from Different Schemas .......................................................................................... 7-1
Mapping Repeating Elements and Creating Joins ............................................................................ 7-4
Step 1. Create an XQuery File........................................................................................................... 7-4
Step 2. Add a Constraint ................................................................................................................... 7-6
Step 3. Add Data to Return Element ............................................................................................... 7-7
Step 4. Add Function to Calculate Value of Quote ....................................................................... 7-7
Step 5. Add a Constraint with Multiple Conditions ..................................................................... 7-9
Test the XQuery............................................................................................................................... 7-10
Creating Unions..................................................................................................................................... 7-10
Creating Repeating-Source to Nonrepeating-Target Transformations ....................................... 7-12
Creating Nonrepeating-Source to Repeating-Target Transformation......................................... 7-14
Creating Nested If-Then-Else Expressions....................................................................................... 7-17
Step 1. Create the XQuery Transformation ................................................................................. 7-18
Step 2. Create the First "If" Condition .......................................................................................... 7-19
Step 3. Create the First Nested If-Then-Else Condition............................................................. 7-20
Step 4. Create the Second Nested If-Then-Else Condition ........................................................ 7-20
Creating FLWOR Expressions............................................................................................................. 7-21
xii

13. Using Recursive Schemas .................................................................................................................... 7-23
Grouping Data by Key Fields ............................................................................................................. 7-25
Part III Format Builder
8 Introduction
Overview.................................................................................................................................................... 8-1
9 Format Builder Main Window
Using the Menu Bar ................................................................................................................................. 9-1
Using the Toolbar ..................................................................................................................................... 9-1
Using the Tree Pane.................................................................................................................................. 9-2
Using the Shortcut Menus ...................................................................................................................... 9-3
Using Drag and Drop .............................................................................................................................. 9-4
Valid Names .............................................................................................................................................. 9-4
10 Message Format Detail Window
11 Field Detail Window
12 Group Detail Window
13 Reference Detail Window
14 Comment Detail Window
15 Format Builder Options
16 Importing Metadata
Importing a Guideline XML File........................................................................................................ 16-1
Importing an XML Schema ................................................................................................................. 16-2
Importing a COBOL Copybook ......................................................................................................... 16-2
Importing C Structures......................................................................................................................... 16-3
Starting the C Structure Importer ...................................................................................................... 16-3
Generating MFL Data........................................................................................................................... 16-4
Generating C Code................................................................................................................................ 16-5
Importing an FML Field Table Class ................................................................................................ 16-5
FML Field Table Class Importer Prerequisites .......................................................................... 16-5
Sample FML Field Table Class Files ............................................................................................ 16-6
Creating XML with the FML Field Table Class Importer ........................................................ 16-6
17 Format Tester
Format Tester Window ......................................................................................................................... 17-1
Format Tester Menus ............................................................................................................................ 17-1
xiii

14. File Menu ................................................................................................................................................ 17-1
Edit Menu ............................................................................................................................................... 17-2
Display Menu......................................................................................................................................... 17-2
Generate Menu ...................................................................................................................................... 17-3
Transform Menu .................................................................................................................................... 17-3
Shortcut Menu ....................................................................................................................................... 17-3
Using the Non-XML Window ............................................................................................................. 17-3
Using the Data Offset Feature............................................................................................................. 17-4
Using the Text Feature .......................................................................................................................... 17-4
Using the XML Window ...................................................................................................................... 17-4
Using the Debug Window ................................................................................................................... 17-4
Using the Resize Bars ........................................................................................................................... 17-5
Debugging Format Definitions .......................................................................................................... 17-5
Searching for Values ............................................................................................................................. 17-5
Searching for Offsets ............................................................................................................................ 17-5
Using the Debug Log ............................................................................................................................ 17-6
18 Format Builder Menus
File Menu ................................................................................................................................................ 18-1
Edit Menu ............................................................................................................................................... 18-1
Insert Menu ............................................................................................................................................ 18-2
View Menu ............................................................................................................................................. 18-3
Tools Menu ............................................................................................................................................. 18-3
Help Menu.............................................................................................................................................. 18-3
Shortcut Menu ....................................................................................................................................... 18-3
19 How Do I?
Create a Message Format ..................................................................................................................... 19-1
Create a Group ....................................................................................................................................... 19-1
Create a Field.......................................................................................................................................... 19-2
Create a Comment ................................................................................................................................. 19-2
Create a Reference ................................................................................................................................. 19-3
Save a Document ................................................................................................................................... 19-3
Use Format Tester .................................................................................................................................. 19-4
Debug Format Definitions .................................................................................................................. 19-4
Search for Values ................................................................................................................................... 19-4
Search for Offsets .................................................................................................................................. 19-5
Use the Debug Log................................................................................................................................ 19-5
Character Delimiters............................................................................................................................. 19-5
Specify a Delimiter ............................................................................................................................... 19-6
Specify by Reference ....................................................................................................................... 19-6
Specify by Value ............................................................................................................................. 19-7
Delimiter Match Rule........................................................................................................................... 19-7
Data Delimiter ................................................................................................................................. 19-7
Escape Character ............................................................................................................................. 19-8
None .................................................................................................................................................. 19-8
xiv

15. 20 Using the Palette
Displaying the Palette Window.......................................................................................................... 20-1
Adding Items to the Palette ................................................................................................................. 20-1
Adding Palette Items to a Message Format ...................................................................................... 20-2
Using the File Menu ............................................................................................................................. 20-2
Using the Shortcut Menu..................................................................................................................... 20-2
21 Format Builder Supported Data Types
MFL Data Types..................................................................................................................................... 21-1
COBOL Copybook Importer Data Types ......................................................................................... 21-5
Unsupported C Language Features.................................................................................................... 21-6
Part IV General Development Topics
22 Development Environment Setup
Running Multiple Development Servers with Derby ................................................................... 22-1
Derby Best Practices and Troubleshooting.................................................................................. 22-1
Sharing a Single Derby Database Instance Between Multiple Domains................................. 22-2
Running Each Domain with a Unique Derby Instance ............................................................. 22-3
Disabling the JMS Reporting Provider............................................................................................. 22-4
23 Creating and Using Custom XPath Functions
Registering Custom Functions with Oracle Service Bus ............................................................... 23-1
Creating and Packaging the Custom Function Java Classes......................................................... 23-3
Creating the Class and Method..................................................................................................... 23-3
Using Single-Dimensional Arrays ......................................................................................... 23-3
Packaging the Custom Function Class......................................................................................... 23-4
Using Custom Functions...................................................................................................................... 23-4
Using Custom Functions in Inline XQuery Expressions and XQuery Resources ................. 23-4
Using Custom Functions in XSLT Resources.............................................................................. 23-4
Testing Custom XPath Functions in Eclipse..................................................................................... 23-5
Deploying Custom Functions in a Cluster ....................................................................................... 23-5
Part V Transports
24 Oracle SOA Suite Transport (SOA-DIRECT)
About the SOA-DIRECT Transport ................................................................................................... 24-1
WS-Addressing................................................................................................................................ 24-2
Security ............................................................................................................................................. 24-3
Environment Values ....................................................................................................................... 24-3
Error Handling ................................................................................................................................ 24-3
Connection Errors .................................................................................................................... 24-3
Application Errors ................................................................................................................... 24-3
Generic Errors........................................................................................................................... 24-4
Using SOA Suite Services with Oracle Service Bus....................................................................... 24-4
xv

16. Simple Use Cases – Synchronous ................................................................................................. 24-4
Synchronous Invocation of a SOA Composite .................................................................... 24-4
Creating and Configuring the Services ......................................................................... 24-4
Synchronous Invocation from a SOA Composite ............................................................... 24-5
Creating and Configuring the Services ......................................................................... 24-5
Associating Messages with the Correct Conversation ....................................................... 24-6
Advanced Use Cases – Asynchronous......................................................................................... 24-6
Asynchronous Invocation of a SOA Composite.................................................................. 24-6
Creating and Configuring the Services ......................................................................... 24-7
Asynchronous Invocation from a SOA Composite............................................................. 24-8
Creating and Configuring the Services ......................................................................... 24-9
Transport Configuration Reference ................................................................................................. 24-10
SOA-DIRECT Endpoint URI ....................................................................................................... 24-11
Cluster URI ............................................................................................................................. 24-11
URI Examples ......................................................................................................................... 24-11
SOA-DIRECT Transport Configuration for Business Services............................................... 24-12
WS-Addressing Reference................................................................................................................. 24-14
ReplyTo Header ............................................................................................................................ 24-14
Calling a SOA Composite Asynchronously with a SOA-DIRECT Business Service ... 24-14
Calling Back to a SOA Composite Asynchronously with a SOA-DIRECT
Business Service ..................................................................................................................... 24-14
MessageID / RelatesTo Headers ................................................................................................ 24-14
XML Examples ..................................................................................................................................... 24-15
Conversation ID Examples .......................................................................................................... 24-15
Port and Message Definitions .............................................................................................. 24-15
WS-Addressing that Sets the Conversation ID.................................................................. 24-16
Message Payload Data that Sets the Conversation ID...................................................... 24-17
Transformation Examples..................................................................................................... 24-18
Asynchronous Composite to Composite Native Communication Through Oracle
Service Bus Example..................................................................................................................... 24-20
Port and Message Definitions .............................................................................................. 24-20
BP1 to P1 – Initiate operation ............................................................................................... 24-20
P1/B1 to BP2........................................................................................................................... 24-21
BP2 to P2 – onResult operation ............................................................................................ 24-21
P2/B2 to BP1 – onResult operation ..................................................................................... 24-22
25 JCA Transport
About the JCA Transport ..................................................................................................................... 25-1
Messaging......................................................................................................................................... 25-2
Transactions .............................................................................................................................. 25-2
Transport Headers and Normalized Message Properties......................................................... 25-2
$inbound and $outbound Request Headers ........................................................................ 25-2
$inbound-Only Request Headers .......................................................................................... 25-3
$outbound-Only Request Headers........................................................................................ 25-3
Endpoint Properties ........................................................................................................................ 25-4
Proxy Service Endpoint Properties (Inbound)..................................................................... 25-4
Business Service Endpoint Properties (Outbound)............................................................. 25-6
xvi