Oracle Fusion MiddlewareDevelopers Guide for Oracle Service Bus 11g Release 1 (11.1.1.5.0)E15866-03

April 2011

Oracle Fusion Middleware Developer's Guide for Oracle Service Bus, 11g Release 1 (11.1.1.5.0) E15866-03 Copyright 2008, 2011, Oracle and/or its affiliates. All rights reserved. Primary Authors: Floyd Jones, Legacy authors

Contributing Author: 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 software or related documentation 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 USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software 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 which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software 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.

ContentsPreface .............................................................................................................................................................. xliiiDocumentation Accessibility .................................................................................................................. Conventions .............................................................................................................................................. xliii xliii

Part I

IDE Help for Oracle Service Bus

1 Introduction to Oracle Service Bus 2 TasksWorking 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 Creating Service Key Provider Resources ................................................................................... 2-10 Creating SMTP Server Resources ................................................................................................. 2-11

iii

Creating XQuery Transformations ............................................................................................... Creating XSL Transformations...................................................................................................... Working with Business Services ........................................................................................................ Creating Business Services............................................................................................................. Generating a Business Service from an Existing Service.................................................... Generating a JCA Business Service from an Outbound JCA File ............................................ Generating a Business Service from Oracle Enterprise Repository ......................................... Re-generating an Existing Business Service from Oracle Enterprise Repository ........... Editing Business Services............................................................................................................... Working with Proxy Services .............................................................................................................. Creating Proxy Services ................................................................................................................. Generating a Proxy Service from an Existing Service ........................................................ Generating a JCA Proxy Service from an Inbound JCA File .................................................... Consuming Oracle Service Bus Proxy Services in Oracle JDeveloper with WSIL ................ Editing Proxy Services.................................................................................................................... Working with Proxy Service Message Flows ................................................................................... Constructing Proxy Service Message Flows................................................................................ Adding and Configuring Alert Actions in Message Flows ...................................................... Adding and Configuring Assign Actions in Message Flows ................................................... Adding and Configuring Conditional Branch Nodes in Message Flows ............................... Adding and Configuring Delete Actions in Message Flows .................................................... Adding and Configuring Dynamic Publish Actions in Message Flows ................................. Adding and Configuring Dynamic Routing Actions in Message Flows ................................ Adding and Configuring Error Handlers in Message Flows ................................................... Adding and Configuring For-Each Actions in Message Flows................................................ Adding and Configuring If-Then Actions in Message Flows .................................................. Adding and Configuring Insert Actions in Message Flows ..................................................... Adding and Configuring Java Callout Actions in Message Flows.......................................... Adding and Configuring Log Actions in Message Flows......................................................... Adding and Configuring MFL Transform Actions in Message Flows ................................... Adding and Configuring Operational Branch Nodes in Message Flows............................... Adding and Configuring Pipeline Pair Nodes in Message Flows ........................................... Adding and Configuring Publish Actions in Message Flows .................................................. Adding and Configuring Publish Table Actions in Message Flows ....................................... Adding and Configuring Raise Error Actions in Message Flows............................................ Adding and Configuring Rename Actions in Message Flows ................................................. Adding and Configuring Replace Actions in Message Flows.................................................. Adding and Configuring Reply Actions in Message Flows ..................................................... Adding and Configuring Report Actions in Message Flows ................................................... Adding and Configuring Resume Actions in Message Flows ................................................. Adding and Configuring Route Nodes in Message Flows ....................................................... Adding and Configuring Routing Actions in Message Flows ................................................. Adding and Configuring Routing Options Actions in Message Flows .................................. Adding and Configuring Routing Table Actions in Message Flows ...................................... Adding and Configuring Service Callout Actions in Message Flows..................................... Adding and Configuring Skip Actions in Message Flows........................................................ Adding and Configuring Stages in Message Flows...................................................................

2-11 2-11 2-11 2-11 2-12 2-12 2-13 2-13 2-13 2-13 2-13 2-14 2-14 2-15 2-16 2-16 2-17 2-18 2-18 2-19 2-19 2-20 2-20 2-20 2-21 2-21 2-22 2-22 2-22 2-23 2-23 2-24 2-24 2-24 2-25 2-26 2-26 2-27 2-27 2-27 2-28 2-28 2-28 2-29 2-29 2-30 2-30

iv

Adding and Configuring Transport Headers Actions in Message Flows .............................. Adding and Configuring Validate Actions in Message Flows................................................. Working with Alert Destinations....................................................................................................... Creating and Editing Alert Destinations ..................................................................................... Adding E-mail Recipients to Alert Destinations ........................................................................ Adding JMS Destinations to Alert Destinations......................................................................... Working with MQ Connections ......................................................................................................... Adding and Editing MQ Connections ......................................................................................... Working with Oracle Enterprise Repository and Harvester ......................................................... Generating Business Services from Oracle Enterprise Repository .......................................... Using Harvester............................................................................................................................... Using Harvester from Eclipse ................................................................................................ Using Harvester from the Command Line or a Script ....................................................... Performing Queries in Oracle Enterprise Repository from Eclipse......................................... Working with UDDI Registries .......................................................................................................... Adding and Configuring UDDI Registries ................................................................................. Importing Business Services From a UDDI Registry ................................................................. Working with Split-Join....................................................................................................................... Introduction to Split-Join ............................................................................................................... Using Split-Join with Content in SOAP Headers ................................................................ Transaction Support ................................................................................................................ Security with Split-Joins.......................................................................................................... Designing a Split-Join ..................................................................................................................... Initial Setup............................................................................................................................... Creating/Importing a WSDL Containing the Base Operation .................................. Creating/Importing a Business Service to Use the Split-Join .................................... Designing a Static Split-Join .......................................................................................................... 1. Creating a New Split-Join ................................................................................................... 2. Adding an Assign ................................................................................................................ 3. Adding a Parallel Node ...................................................................................................... 4. Adding an Assign for Each Branch ................................................................................... 5. Adding an Invoke Service .................................................................................................. 6. Adding an Assign for Each Branch ................................................................................... 7. Exporting and Testing the Split-Join................................................................................. Designing a Dynamic Split-Join .................................................................................................... 1. Creating a New Split-Join ................................................................................................... 2. Adding an Assign ................................................................................................................ 3. Adding a For Each ............................................................................................................... 4. Adding an Assign ................................................................................................................ 5. Adding an Invoke Service .................................................................................................. 6. Adding an Assign ................................................................................................................ 7. Adding an Error Handler ................................................................................................... 8. Exporting and Testing the Split-Join................................................................................. Creating a New Split-Join .............................................................................................................. Configuring the Start Node ........................................................................................................... Adding General Information.................................................................................................. Defining Global Variables.......................................................................................................

2-30 2-31 2-31 2-31 2-32 2-32 2-32 2-32 2-33 2-33 2-35 2-35 2-36 2-37 2-38 2-38 2-38 2-39 2-39 2-39 2-40 2-40 2-41 2-41 2-41 2-41 2-41 2-42 2-42 2-43 2-43 2-43 2-43 2-44 2-44 2-45 2-46 2-46 2-47 2-47 2-47 2-47 2-47 2-48 2-49 2-50 2-50

v

Viewing External Services ...................................................................................................... Configuring a Receive .................................................................................................................... Viewing the Operation............................................................................................................ Defining the Receive Variable................................................................................................ Adding General Information.................................................................................................. Creating an Assign.......................................................................................................................... Adding and Configuring Assign Operations ...................................................................... Adding an Operation to an Assign ................................................................................ Adding a Copy Operation............................................................................................... Adding General Information.................................................................................................. Invoking a Service ........................................................................................................................... Selecting an Operation ............................................................................................................ Defining Input and Output Variables................................................................................... Adding General Information.................................................................................................. Creating a Parallel ........................................................................................................................... Adding Nodes .......................................................................................................................... Adding General Information.................................................................................................. Creating a For Each......................................................................................................................... Defining the For Each Logic ................................................................................................... Adding General Information.................................................................................................. Creating an If Activity .................................................................................................................... Configuring the If ................................................................................................................... Writing the logic of the condition................................................................................... Adding resulting nodes ................................................................................................... Adding General Information .......................................................................................... Adding and Configuring Else If ........................................................................................... Writing the Logic of the Condition ................................................................................ Adding Resulting Nodes ................................................................................................. Adding General Information .......................................................................................... Configuring the Else ................................................................................................................ Adding Resulting Nodes ................................................................................................. Adding General Information.................................................................................................. Creating an Error Handler............................................................................................................. Creating a Raise Error..................................................................................................................... Configuring a Reply........................................................................................................................ Viewing the Operation............................................................................................................ Defining the Reply Variable ................................................................................................... Adding General Information.................................................................................................. About Scope ..................................................................................................................................... Scope and Variables................................................................................................................. Exporting and Testing a Split-Join................................................................................................ Creating a Transport Typed Business Service ..................................................................... Exporting the Split-Join Files.................................................................................................. Exporting from the Business Service Menu .................................................................. Auto-export ....................................................................................................................... Manual export ................................................................................................................... Testing the Split-Join in the Test Console.............................................................................

2-51 2-51 2-51 2-51 2-52 2-52 2-52 2-53 2-53 2-54 2-54 2-54 2-54 2-55 2-55 2-55 2-56 2-56 2-56 2-57 2-57 2-57 2-58 2-58 2-58 2-58 2-58 2-59 2-59 2-59 2-59 2-59 2-59 2-60 2-60 2-61 2-61 2-62 2-62 2-62 2-63 2-63 2-63 2-64 2-64 2-64 2-65

vi

Exporting from the Business Service Menu .................................................................. Using the Oracle Service Bus Debugger........................................................................................... Enabling Debugging ....................................................................................................................... Using Standard Debugging ........................................................................................................... Debug Views............................................................................................................................. Step Actions and Breakpoints ................................................................................................ Using the Oracle Service Bus Debugger Launch Configuration.............................................. Remote Debugging .................................................................................................................. Debugging Oracle Service Bus Running Stand-Alone on a Managed Server................. Server Sharing ..........................................................................................................................

2-65 2-65 2-66 2-66 2-67 2-68 2-68 2-69 2-69 2-69

3 Transport ConfigurationProtocol-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-23 MQ Transport Configuration Page (Business Services) ............................................................ 3-27 MQ Transport Configuration Page (Proxy Services) ................................................................. 3-29 SB Transport Configuration Page (Business Services)............................................................... 3-31 SB Transport Configuration Page (Proxy Services) ................................................................... 3-32 SFTP Transport Configuration Page (Business Services) .......................................................... 3-33 SFTP Transport Configuration Page (Proxy Services)............................................................... 3-33 SOA-DIRECT Transport Configuration Page (Business Services)........................................... 3-35 Tuxedo Transport Configuration Page (Business Services)...................................................... 3-37 Tuxedo Transport Configuration Page (Proxy Services)........................................................... 3-38 WS Transport Configuration Page (Business Services) ............................................................. 3-40 WS Transport Configuration Page (Proxy Services) .................................................................. 3-40

4 User Interface ReferenceAlerts........................................................................................................................................................... Alert Destination Editor .................................................................................................................... Edit E-mail Recipient Page ............................................................................................................... Edit JMS Destination Page ................................................................................................................ 4-1 4-2 4-2 4-3

vii

Business Service Configuration ............................................................................................................ 4-3 Business Service General Configuration Page ............................................................................... 4-3 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 Message Flow Nodes ...................................................................................................................... 4-40 Message Flow Route Actions - Communication Actions.......................................................... 4-41

viii

Message Flow Route Actions - Flow Control Actions ............................................................... Message Flow Stage Actions - Communication Actions........................................................... Message Flow Stage Actions - Flow Control Actions ................................................................ Message Flow Stage Actions - Message Processing Actions .................................................... Message Flow Stage Actions - Reporting Actions...................................................................... Message Flow Editor............................................................................................................................. Alert Action Properties................................................................................................................... Assign Action Properties ............................................................................................................... Conditional Branch Node Properties ........................................................................................... Delete Action Properties ................................................................................................................ Dynamic Publish Action Properties ............................................................................................. Dynamic Routing Action Properties ............................................................................................ Error Handler Node Properties..................................................................................................... For-Each Action Properties............................................................................................................ If-Then Action Properties............................................................................................................... If Action and Else-If Action Properties................................................................................. Else Action Properties ............................................................................................................. Insert Action Properties ................................................................................................................. Java Callout Action Properties ...................................................................................................... Log Action Properties..................................................................................................................... Message Flow Properties - Comment .......................................................................................... Message Flow Properties - Namespaces ..................................................................................... Message Flow Properties - Variables .......................................................................................... MFL Transform Action Properties................................................................................................ Operational Branch Node Properties ........................................................................................... Pipeline Pair Node Properties ....................................................................................................... Publish Action Properties .............................................................................................................. Publish Table Action Properties.................................................................................................... Publish Table Properties ......................................................................................................... Case Action Properties ............................................................................................................ Publish Action Properties ....................................................................................................... Raise Error Action Properties........................................................................................................ Transactions .............................................................................................................................. Rename Action Properties ............................................................................................................. Replace Action Properties.............................................................................................................. Reply Action Properties ................................................................................................................. Report Action Properties................................................................................................................ Resume Action Properties ............................................................................................................. Route Node Properties ................................................................................................................... Routing Action Properties ............................................................................................................. Routing Options Action Properties .............................................................................................. Routing Table Action Properties................................................................................................... Routing Table Properties ........................................................................................................ Case Action Properties ............................................................................................................ Routing Action Properties ...................................................................................................... Service Callout Action Properties................................................................................................. Skip Action Properties....................................................................................................................

4-41 4-42 4-42 4-43 4-44 4-44 4-46 4-46 4-47 4-48 4-49 4-50 4-50 4-50 4-51 4-52 4-52 4-52 4-53 4-55 4-56 4-56 4-56 4-56 4-57 4-58 4-59 4-59 4-60 4-60 4-61 4-61 4-61 4-61 4-62 4-63 4-64 4-65 4-65 4-66 4-66 4-67 4-68 4-69 4-69 4-69 4-72

ix

Stage Node Properties .................................................................................................................... Transport Headers Action Properties .......................................................................................... Validate Action Properties............................................................................................................. Modify JAR Dependencies Dialog .................................................................................................... SMTP Servers......................................................................................................................................... Edit SMTP Server Page................................................................................................................... New SMTP Server Resource Wizard............................................................................................ UDDI Registry Configuration Page................................................................................................... Outline view - Oracle Service Bus ..................................................................................................... Resource Management ......................................................................................................................... Preferences dialog - Oracle Service Bus - Type Associations Page.......................................... References View .............................................................................................................................. Select Clone Target Dialog............................................................................................................. Select a Resource Dialog................................................................................................................. New Service Key Provider Resource ................................................................................................. New WS-Policy ...................................................................................................................................... Service Accounts.................................................................................................................................... New Service Account Resource .................................................................................................... Service Account Editor - General Configuration Page .............................................................. Service Account Editor - Static User Configuration Page ......................................................... Service Account Editor - User Mappings Configuration Page................................................. Expression Editors ................................................................................................................................ XQuery/XSLT Expression Editor ................................................................................................. XPath Expression Editor ................................................................................................................ Condition Editor.............................................................................................................................. Condition Builder Page .................................................................................................................. Expression Page............................................................................................................................... XQuery Resource Page ................................................................................................................... XSLT Resource Page ....................................................................................................................... Dynamic XQuery Page ................................................................................................................... Variable Structures Page ................................................................................................................ Namespace Definitions Page......................................................................................................... XQuery Functions Page.................................................................................................................. Add Variable Structure Dialog ..................................................................................................... New XSL Transformation .................................................................................................................... Split-Join User Interface Reference ................................................................................................... Split-Join Design Palette................................................................................................................. Operations................................................................................................................................. Global / Start Node Properties ..................................................................................................... Variable Properties.......................................................................................................................... Error Handler Properties ............................................................................................................... Invoke Service Properties............................................................................................................... Invoking Another Split-Join ................................................................................................... Reply Properties .............................................................................................................................. For Each Properties ......................................................................................................................... If Properties...................................................................................................................................... If and Else If Properties ..................................................................................................................

4-72 4-72 4-74 4-75 4-75 4-76 4-76 4-76 4-77 4-77 4-77 4-78 4-78 4-78 4-78 4-79 4-79 4-80 4-80 4-80 4-81 4-81 4-81 4-82 4-82 4-83 4-83 4-83 4-84 4-84 4-85 4-85 4-86 4-86 4-87 4-87 4-88 4-88 4-90 4-90 4-91 4-91 4-92 4-93 4-93 4-94 4-94

x

Parallel Properties ........................................................................................................................... Raise Error Properties..................................................................................................................... Repeat Until Properties .................................................................................................................. Re-Raise Error Properties............................................................................................................... Scope Properties .............................................................................................................................. While Properties .............................................................................................................................. Wait Properties ................................................................................................................................ Assign Properties ............................................................................................................................ Assign Operation Properties .................................................................................................. Copy Properties............................................................................................................................... Delete Properties ............................................................................................................................. Insert Properties .............................................................................................................................. Java Callout Properties................................................................................................................. Log Properties................................................................................................................................ Replace Properties......................................................................................................................... Receive Properties ......................................................................................................................... Counter Variable Dialog .............................................................................................................. Create/Edit Variable Dialog........................................................................................................ Scope and Variables............................................................................................................... Create Message Variable Dialog ................................................................................................. Service Browser ............................................................................................................................. SOAP Fault Variable Dialog ........................................................................................................ WSDL Browser .............................................................................................................................. Split-Join Wizard - New Split-Join.............................................................................................. Split-Join Wizard - Specify Operations ......................................................................................

4-95 4-95 4-95 4-95 4-96 4-96 4-96 4-97 4-97 4-98 4-98 4-99 4-100 4-101 4-101 4-102 4-102 4-102 4-103 4-103 4-103 4-103 4-104 4-104 4-104

Part II XQuery Mapper 5 IntroductionOverview 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 MapperLaunching XQuery Mapper.................................................................................................................... Importing the XQuery Mapper Sample Project ................................................................................. Creating an XQuery Mapper Project .................................................................................................... Importing and Creating Schema Files.................................................................................................. Importing XML Schemas and MFL Files ........................................................................................ Creating XML Schemas ..................................................................................................................... Creating XML Files from XML Schemas ........................................................................................ Creating WSDL Files.......................................................................................................................... Creating MFL Files............................................................................................................................. Selecting Source and Target Data Types .............................................................................................. Creating Data Transformations ............................................................................................................. Creating Basic Element Transformations ....................................................................................... 6-1 6-1 6-2 6-2 6-3 6-4 6-4 6-5 6-5 6-5 6-7 6-7

xi

Prerequisite .................................................................................................................................. 6-7 Creating Element-to-Element Links......................................................................................... 6-7 Creating Basic Attribute Transformations...................................................................................... 6-8 Prerequisite .................................................................................................................................. 6-8 Creating an Attribute-to-Element Link.................................................................................... 6-8 Creating Complex Transformations................................................................................................ 6-9 Prerequisite .................................................................................................................................. 6-9 Creating a Complex Transformation ....................................................................................... 6-9 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 MapperCombining 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 Using Recursive Schemas .................................................................................................................... 7-23 Grouping Data by Key Fields ............................................................................................................. 7-25

xii

8 Upgrading XQuery CodeUpgrading Inline XQuery Code ............................................................................................................ 8-1 Upgrading XQuery Files ......................................................................................................................... 8-2

Part III

Format Builder

9 IntroductionOverview.................................................................................................................................................... 9-1

10 Format Builder Main WindowUsing the Menu Bar .............................................................................................................................. Using the Toolbar .................................................................................................................................. Using the Tree Pane............................................................................................................................... Using the Shortcut Menus ................................................................................................................... Using Drag and Drop ........................................................................................................................... Valid Names ........................................................................................................................................... 10-1 10-1 10-2 10-3 10-3 10-4

11 Message Format Detail Window 12 Field Detail Window 13 Group Detail Window 14 Reference Detail Window 15 Comment Detail Window 16 Format Builder Options 17 Importing MetadataImporting a Guideline XML File........................................................................................................ Importing an XML Schema ................................................................................................................. Importing a COBOL Copybook ......................................................................................................... Importing C Structures......................................................................................................................... Starting the C Structure Importer ...................................................................................................... Generating MFL Data........................................................................................................................... Generating C Code................................................................................................................................ Importing an FML Field Table Class ................................................................................................ FML Field Table Class Importer Prerequisites .......................................................................... Sample FML Field Table Class Files ............................................................................................ Creating XML with the FML Field Table Class Importer ........................................................ 17-1 17-1 17-2 17-3 17-3 17-4 17-4 17-5 17-5 17-6 17-6

18 Format TesterFormat Tester Window ......................................................................................................................... 18-1

xiii

Format Tester Menus ............................................................................................................................ File Menu ................................................................................................................................................ Edit Menu ............................................................................................................................................... Display Menu......................................................................................................................................... Generate Menu ...................................................................................................................................... Transform Menu .................................................................................................................................... Shortcut Menu ....................................................................................................................................... Using the Non-XML Window ............................................................................................................. Using the Data Offset Feature............................................................................................................. Using the Text Feature .......................................................................................................................... Using the XML Window ...................................................................................................................... Using the Debug Window ................................................................................................................... Using the Resize Bars ........................................................................................................................... Debugging Format Definitions .......................................................................................................... Searching for Values ............................................................................................................................. Searching for Offsets ............................................................................................................................ Using the Debug Log ............................................................................................................................

18-1 18-1 18-2 18-2 18-3 18-3 18-3 18-3 18-4 18-4 18-4 18-4 18-5 18-5 18-5 18-5 18-6

19 Format Builder MenusFile Menu ................................................................................................................................................ Edit Menu ............................................................................................................................................... Insert Menu ............................................................................................................................................ View Menu ............................................................................................................................................. Tools Menu ............................................................................................................................................. Help Menu.............................................................................................................................................. Shortcut Menu ....................................................................................................................................... 19-1 19-1 19-2 19-3 19-3 19-3 19-3

20 How Do I?Create a Message Format ..................................................................................................................... Create a Group ....................................................................................................................................... Create a Field.......................................................................................................................................... Create a Comment ................................................................................................................................. Create a Reference ................................................................................................................................. Save a Document ................................................................................................................................... Use Format Tester .................................................................................................................................. Debug Format Definitions .................................................................................................................. Search for Values ................................................................................................................................... Search for Offsets .................................................................................................................................. Use the Debug Log................................................................................................................................ Character Delimiters............................................................................................................................. Specify a Delimiter ............................................................................................................................... Specify by Reference ....................................................................................................................... Specify by Value ............................................................................................................................. Delimiter Match Rule........................................................................................................................... Data Delimiter ................................................................................................................................. Escape Character ............................................................................................................................. None ..................................................................................................................................................xiv

20-1 20-1 20-2 20-2 20-3 20-3 20-4 20-4 20-4 20-5 20-5 20-5 20-6 20-6 20-7 20-7 20-7 20-7 20-8

21 Using the PaletteDisplaying the Palette Window.......................................................................................................... Adding Items to the Palette ................................................................................................................. Adding Palette Items to a Message Format ...................................................................................... Using the File Menu ............................................................................................................................. Using the Shortcut Menu..................................................................................................................... 21-1 21-1 21-2 21-2 21-2

22 Format Builder Supported Data TypesMFL Data Types..................................................................................................................................... 22-1 COBOL Copybook Importer Data Types ......................................................................................... 22-5 Unsupported C Language Features.................................................................................................... 22-6

Part IV General Development Topics 23 Development Environment SetupRunning Multiple Development Servers with Derby ................................................................... Derby Best Practices and Troubleshooting.................................................................................. Troubleshooting Derby Configuration with Multiple Domains....................................... Sharing a Single Derby Database Instance Between Multiple Domains................................. Running Each Domain with a Unique Derby Instance ............................................................. Disabling the JMS Reporting Provider............................................................................................. 23-1 23-1 23-2 23-3 23-4 23-5

24 Creating and Using Custom XPath FunctionsRegistering Custom Functions with Oracle Service Bus ............................................................... Creating and Packaging the Custom Function Java Classes......................................................... Creating the Class and Method..................................................................................................... Using Single-Dimensional Arrays ......................................................................................... Packaging the Custom Function Class......................................................................................... Using Custom Functions...................................................................................................................... Using Custom Functions in Inline XQuery Expressions and XQuery Resources ................. Using Custom Functions in XSLT Resources.............................................................................. Testing Custom XPath Functions in Eclipse..................................................................................... Deploying Custom Functions in a Cluster ....................................................................................... 24-1 24-2 24-3 24-3 24-4 24-4 24-4 24-4 24-5 24-5

Part V Transports 25 Oracle SOA Suite Transport (SOA-DIRECT)About the SOA-DIRECT Transport ................................................................................................... WS-Addressing................................................................................................................................ Security ............................................................................................................................................. Environment Values ....................................................................................................................... Error Handling ................................................................................................................................ Connection Errors .................................................................................................................... Application Errors ................................................................................................................... Generic Errors........................................................................................................................... 25-1 25-2 25-3 25-3 25-3 25-3 25-3 25-4

xv

Using SOA Suite Services with Oracle Service Bus....................................................................... Simple Use Cases Synchronous ................................................................................................. Synchronous Invocation of a SOA Composite .................................................................... Creating and Configuring the Services ......................................................................... Synchronous Invocation from a SOA Composite ............................................................... Creating and Configuring the Services ......................................................................... Associating Messages with the Correct Conversation ....................................................... Advanced Use Cases Asynchronous......................................................................................... Asynchronous Invocation of a SOA Composite.................................................................. Creating and Configuring the Services ......................................................................... Asynchronous Invocation from a SOA Composite............................................................. Creating and Configuring the Services ......................................................................... Transport Configuration Reference ................................................................................................. SOA-DIRECT Endpoint URI ....................................................................................................... Cluster URI ............................................................................................................................. URI Examples ......................................................................................................................... SOA-DIRECT Transport Configuration for Business Services............................................... WS-Addressing Reference................................................................................................................. ReplyTo Header ............................................................................................................................ Calling a SOA Composite Asynchronously with a SOA-DIRECT Business Service ... Calling Back to a SOA Composite Asynchronously with a SOA-DIRECT Business Service ..................................................................................................................... MessageID / RelatesTo Headers ................................................................................................ XML Examples ..................................................................................................................................... Conversation ID Examples .......................................................................................................... Port and Message Definitions .............................................................................................. WS-Addressing that Sets the Conversation ID.................................................................. Message Payload Data that Sets the Conversation ID...................................................... Transformation Examples..................................................................................................... Asynchronous Composite to Composite Native Communication Through Oracle Service Bus Example ........................................................................................................ Port and Message Definitions .............................................................................................. BP1 to P1 Initiate operation ............................................................................................... P1/B1 to BP2........................................................................................................................... BP2 to P2 onResult operation ............................................................................................ P2/B2 to BP1 onResult operation .....................................................................................

25-4 25-4 25-4 25-4 25-5 25-5 25-6 25-6 25-6 25-7 25-8 25-9 25-10 25-11 25-11 25-11 25-12 25-14 25-14 25-14 25-14 25-14 25-15 25-15 25-15 25-16 25-17 25-18 25-20 25-20 25-20 25-21 25-21 25-22

26 JCA TransportAbout the JCA Transport ..................................................................................................................... Messaging......................................................................................................................................... Transactions .............................................................................................................................. Transport Headers .......................................................................................................................... $inbound and $outbound Request Headers ........................................................................ $inbound-Only Request Headers .......................................................................................... $outbound-Only Request Headers........................................................................................ Endpoint Properties ........................................................................................................................ Proxy Service Endpoint Properties (Inbound)..................................................................... 26-1 26-2 26-2 26-2 26-2 26-3 26-3 26-4 26-4

xvi

Business Service Endpoint Properties (Outbound)............................................................. Security ............................................................................................................................................. Proxy Services........................................................................................................................... Business Services...................................................................................................................... Logging ............................................................................................................................................. Oracle BAM Adapter Logging ............................................................................................... Error Handling ................................................................................................................................ EIS Fault Details in JCA Business Services........................................................................... Business Service Retry Application Errors........................................................................... URI Rewriting.................................................................................................................................. Environment Variables................................................................................................................... Encoding........................................................................................................................................... Working with Adapters........................................................................................................................ Adapter Support.............................................................................................................................. Oracle JCA Adapter Limitations............................................................................................ JCA Adapter Framework ............................................................................................................. Configuring Adapters General ................................................................................................ Configuring Adapters that Poll a Database .............................................................................. Configuring the Oracle JCA Adapter for Database ................................................................. Configuring the Oracle JCA Adapter for AQ ........................................................................... Rejected Messages......................................................................................................................... Invoking an EIS Service Through Oracle Service Bus................................................................. Creating, Configuring, and Invoking the Services................................................................... Invoking an External Service from an EIS ..................................................................................... Creating, Configuring, and Invoking the Services................................................................... Transport Configuration Reference ................................................................................................. Endpoint URI ................................................................................................................................. Endpoint Redeployment....................................................................................................... JCA Transport Configuration for Proxy and Business Services............................................. Proxy Service Operation Configuration .................................................................................... Proxy Service Message Handling ............................................................................................... Policies ............................................................................................................................................

26-5 26-6 26-6 26-6 26-7 26-7 26-7 26-7 26-8 26-8 26-8 26-8 26-8 26-9 26-9 26-10 26-10 26-11 26-11 26-11 26-12 26-12 26-12 26-12 26-13 26-13 26-14 26-14 26-14 26-16 26-16 26-16

27 HTTP and Poller TransportsHTTP Transport ..................................................................................................................................... Configuring Proxy Services using the HTTP Transport ........................................................... Configuring Business Services using the HTTP Transport....................................................... REST Support................................................................................................................................... REST in Proxy Services ........................................................................................................... XQuery Examples ............................................................................................................. Headers .............................................................................................................................. REST in Business Services....................................................................................................... Response Codes for HTTP Business Services............................................................... E-mail Transport .................................................................................................................................... Configuring Proxy Services Using the E-mail Transport ......................................................... Configuring Business Services Using the E-mail Transport................................................... File Transport ....................................................................................................................................... 27-1 27-1 27-3 27-6 27-7 27-7 27-8 27-8 27-8 27-9 27-9 27-10 27-11

xvii

Configuring Proxy Services using the File Transport.............................................................. Configuring Business Services using the File Transport ........................................................ FTP Transport ....................................................................................................................................... Configuring Proxy Services using the FTP Transport ............................................................. Configuring Business Services using the FTP Transport ........................................................ SFTP Transport..................................................................................................................................... Environment Values ..................................................................................................................... General Principles of SFTP Authentication............................................................................... Run-Time Behavior ....................................................................................................................... Using the SFTP Transport............................................................................................................ Enabling SFTP Authentication............................................................................................. Creating the Known Hosts File..................................................................................... Enabling Username-Password Authentication .......................................................... Enabling Host-Based Authentication .......................................................................... Enabling Public Key Authentication............................................................................ Configuring Proxy Services.................................................................................................. Configuring Transport Headers and Metadata.......................................................... Configuring Business Services ............................................................................................. Handling Communication Errors........................................................................................ Troubleshooting .....................................................................