CDE 44 TranslatorOracleBpel

8/6/2019 CDE 44 TranslatorOracleBpel

1/26

Complex Data ExchangeTranslator for Oracle BPEL

Informatica Complex Data Exchange(Version 4.4)


2/26

Complex Data Exchange Translator for Oracle BPELVersion 4.4August 2007

Copyright 20012007 Informatica Corporation. All rights reserved.

This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing

restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may bereproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. ThisSoftware is protected by U.S. Patent Numbers and other Patents Pending.

Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and asprovided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR52.227-14 (ALT III), as applicable.The information in this software and documentation is subject to change without notice. Informatica Corporation does not warrant that this software ordocumentation is error free.

Informatica, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica

Data Quality, Informatica Data Explorer, Informatica Complex Data Exchange and Informatica On Demand Data Replicator are trademarks or registeredtrademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be tradenames or trademarks of their respective owners.

Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright Sun Microsystems. Allrights reserved. Copyright 1985-2003 Adobe Systems Inc. All rights reserved. Copyright 1996-2004 Glyph & Cog, LLC. All rights reserved.

This product includes software developed by Boost (http://www.boost.org/). Permissions and limitations regarding this software are subject to terms available athttp://www.boost.org/LICENSE_1_0.txt.

This product includes software developed by Mozilla (http://www.mozilla.org/). Your right to use such materials is set forth in the GNU Lesser General PublicLicense Agreement, which may be found at http://www.gnu.org/licenses/lgpl.html. The Mozilla materials are provided free of charge by Informatica, as-is,

without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particularpurpose.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/) which is licensed under the Apache License, Version 2.0(the License). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing,software distributed under the License is distributed on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express orimplied. See the License for the specific language governing permissions and limitations under the License.

This product includes software developed by SourceForge (http://sourceforge.net/projects/mpxj/). Your right to use such materials is set forth in the GNU LesserGeneral Public License Agreement, which may be found at http://www.gnu.org/licenses/lgpl.html. The SourceForge materials are provided free of charge byInformatica, as-is, without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitnessfor a particular purpose.

This product includes Curl software which is Copyright 1996-2007, Daniel Stenberg, . All Rights Reserved. Permissions and limitationsregarding this software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software forany purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

This product includes ICU software which is Copyright (c) 1995-2003 International Business Machines Corporation and others. All rights reserved. Permissionsand limitations regarding this software are subject to terms available at http://www-306.ibm.com/software/globalization/icu/license.jsp

This product includes OSSP UUID software which is Copyright (c) 2002 Ralf S. Engelschall, Copyright (c) 2002 The OSSP Project Copyright (c) 2002 Cable& Wireless Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.

This product includes Eclipse software which is Copyright (c) 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding thissoftware are subject to terms available at http://www.eclipse.org/org/documents/epl-v10.php

libstdc++ is distributed with this product subject to the terms related to the code set forth at http://gcc.gnu.org/onlinedocs/libstdc++/17_intro/license.html.

DISCLAIMER: Informatica Corporation provides this documentation as is without warranty of any kind, either express or implied, including, but not limitedto, the implied warranties of non-infringement, merchantability, or use for a particular purpose. The information provided in this documentation may includetechnical inaccuracies or typographical errors. Informatica could make improvements and/or changes in the products described in this documentation at anytime without notice.

Part Number: CDE-TOR-44000-0001


3/26

ii i

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Other Informatica Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Visiting Informatica Customer Portal . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Visiting the Informatica Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Visiting the Informatica Knowledge Base . . . . . . . . . . . . . . . . . . . . . . . . vii

Obtaining Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiOnline Conversion Agent Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Chapter 1: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Complex Data Exchange Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installing on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Uninstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 2: Using Complex Data Exchange in BPEL . . . . . . . . . . . . . . .7

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Configuring Data Transformations in Complex Data Exchange . . . . . . . . . . . . 9

Creating Wrapper Schemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Wrapper Schemas for a Parser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Wrapper Schemas for a Seriali zer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Wrapper Schemas for a Parser and a Serializer . . . . . . . . . . . . . . . . . . . . 12

Configuring a BPEL Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
http://-/?-http://-/?-


4/26

iv Table of Contents


5/26

v

Preface

Welcome to Informatica Complex Data Exchange, the leading software for automatingcomplex data transformations in high-performance, transaction-intensive applications and

service oriented architectures. Complex Data Exchange enables organizations to define,deploy, and reuse data transformations without writing code. You can use Complex DataExchange to transform any data format to any data format, whether the data is structured orunstructured, and whether it exists in an XML, text, or binary representation.

Complex Data Exchange Studio is a visual design environment for data transformations.Complex Data Exchange Engine is the runtime environment for transformation services. TheComplex Data Exchange libraries provide predefined transformations supporting industrystandard data formats.

Complex Data Exchange is fully integrated with Informatica PowerCenter and withnumerous external systems. PowerCenter applications use the Complex Data Transformationto activate Complex Data Exchange services and perform data transformations.


6/26

vi Preface

About This Book

Complex Data Exchange Translator for Oracle BPEL is written for developers who want totransform structured or unstructured data in the Oracle BPEL environment. The book

explains how to install, configure, and use the Complex Data Exchange integration featuresthat operate within BPEL.

Document Conventions

This guide uses the following formatting conventions:

If you see It means

italicized text The word or set of words are especially emphasized.

boldfaced text Emphasized subjects.

italicized monospaced text This is the variable name for a value you enter as part of an

operating system command. This is generic text that should be

replaced with user-supplied values.

Note: The following paragraph provides additional facts.

Tip: The following paragraph provides suggested uses.

Warning: The following paragraph notes situations where you can overwriteor corrupt data, unless you follow the specified procedure.

monospaced text This is a code example.

bold monospaced text This is an operating system command you enter from a prompt to

run a task.


7/26

Preface vii

Other Informatica Resources

In addition to the product manuals, Informatica provides these other resources:

Informatica Customer Portal Informatica web site

Informatica Knowledge Base

Informatica Global Customer Support

Visiting Informatica Customer Portal

As an Informatica customer, you can access the Informatica Customer Portal site athttp://my.informatica.com. The site contains product information, user group information,newsletters, access to the Informatica customer support case management system (ATLAS),the Informatica Knowledge Base, Informatica Documentation Center, and access to theInformatica user community.

Visiting the Informatica Web Site

You can access the Informatica corporate web site at http://www.informatica.com. The sitecontains information about Informatica, its background, upcoming events, and sales offices.

You will also find product and partner information. The services area of the site includesimportant information about technical support, training and education, and implementationservices.

Visiting the Informatica Knowledge Base

As an Informatica customer, you can access the Informatica Knowledge Base athttp://my.informatica.com. Use the Knowledge Base to search for documented solutions toknown technical issues about Informatica products. You can also find answers to frequentlyasked questions, technical white papers, and technical tips.

Obtaining Customer Support

There are many ways to access Informatica Global Customer Support. You can contact a

Customer Support Center by using the telephone numbers listed the following table, you cansend email, or you can use the WebSupport Service.

Use the following email addresses to contact Informatica Global Customer Support:

[email protected] for technical inquiries

[email protected] for general customer service requests


8/26

viii Preface

WebSupport requires a user name and password. You can request a user name and password athttp://my.informatica.com.

No r th A mer i ca / S ou t h A m er i ca Eu r op e / M id dl e Eas t / A f ri c a A s ia / A us t ral i a

Informatica Corporation

Headquarters

100 Cardinal Way

Redwood City, California

94063

United States

Toll Free

877 463 2435

Standard Rate

United States: 650 385 5800

Informatica Software Ltd.

6 Waltham Park

Waltham Road, White Waltham

Maidenhead, Berkshire

SL6 3TN

United Kingdom

Toll Free

00 800 4632 4357

Standard Rate

Belgium: +32 15 281 702

France: +33 1 41 38 92 26

Germany: +49 1805 702 702

Netherlands: +31 306 022 797

United Kingdom: +44 1628 511 445

Informatica Business Solutions

Pvt. Ltd.

Diamond District

Tower B, 3rd Floor

150 Airport Road

Bangalore 560 008

India

Toll Free

Australia: 00 11 800 4632 4357

Singapore: 001 800 4632 4357

Standard Rate

India: +91 80 4112 5738


9/26

1

Chapter 1

Overview

This chapter includes the following topics:

Scope, 2

Installation, 3


10/26

2 Chapter 1: Overview

Scope

Informatica Complex Data Exchange integrates into Oracle BPEL Process Manager Server,adding powerful data transformation capabilities to BPEL processes.

This integration is implemented as a BPEL translator. You can use the translator in the OracleJDeveloper BPEL Designer. The translator enables a BPEL process to accept input andgenerate output in non-XML formats.

This document explains how to install the Complex Data Exchange Translator for OracleBPEL, and it illustrates how to use the integration capabilities in BPEL processes.

For more information about BPEL, see the Oracle web site, http://www.oracle.com.

Complex Data Exchange Services

The integration features described in this document let you run Complex Data Exchangeservices in BPEL. A Complex Data Exchange service is a data transformation having one ofthe following types:

Parser. Converts any data format to XML.

Serializer. Converts XML to any format. Mapper. Converts XML to XML.

Transformer. Modifies the data in any format.

In BPEL, the most important applications are for parser and serializer services. For example, aBPEL process can activate a Complex Data Exchange parser service, which transforms binaryor text inputs to XML. The inputs can contain structured, semi-structured, or unstructureddata.

Similarly, a BPEL process can activate a Complex Data Exchange serializer service, whichtransforms XML to other data formats. By chaining a parser and a serializer in a singleprocess, you can use the software to transform any data format to any other data format, via

XML.

For more information about creating and deploying services, see Getting Started with ComplexData Exchangeand the Complex Data Exchange Studio User Guide.
http://www.oracle.com/http://www.oracle.com/


11/26

Installation 3

Installation

This section explains how to install the Complex Data Exchange Translator for Oracle BPELon your computer.

System Requirements

You can install the Complex Data Exchange Translator on a Microsoft Windows or Linuxplatform where the following software is installed:

Complex Data Exchange

BPEL 10.1.2

Before you proceed, install the Complex Data Exchange and BPEL software on the computer.For more information, see the Complex Data Exchange Administrator Guide.

Installing on Windows

To ins ta l l the Complex Data Exchange Trans la tor :

1. Confirm that Complex Data Exchange and BPEL are installed and operate properly.2. If the Oracle BPEL Process Manager Server is currently running, stop it.

3. The download package contains an executable file called CMXlator.jar. Store this file inthe Complex Data Exchange installation directory, by default:

c:\Program Files\Informatica\ComplexDataExchange

4. Find the file application.xml, which is located under the BPEL installation directory.The file location is:

ORACLE_BPEL_INSTALLATION_DIRECTORY\integration\orabpel\system\appserver\oc4j\j2ee\home\config\application.xml

5. Edit application.xml in a text editor such as Notepad. To the list oflibrary elements,add the following two elements, substituting the correct path to the Complex DataExchange installation directory:

6. Start the Oracle BPEL Process Manager Server.


12/26


Installing on Linux

To ins ta l l the Complex Data Exchange Trans la tor :

1 . Confirm that Complex Data Exchange and BPEL are installed and operate properly.

2. If the Oracle BPEL Process Manager Server is currently running, stop it.

3. The download package contains an executable file called CMXlator.jar. Store this file inthe Complex Data Exchange installation directory, by default:

/opt/Informatica/ComplexDataExchange

In the following steps, we symbolize the installation directory as INSTALL_DIR.

4. Copy the CMXlator.jar file from INSTALL_DIRto the BPEL library directory. The

typical location of the library directory is:

ORACLE_INSTALL_DIR/integration/orabpel/lib

ORACLE_INSTALL_DIR is the Oracle installation path, for example, /opt/oracle/OraHome-1. It is the value of the $ORACLE_HOME environment variable.

5. Copy the file CM_JavaAPI.jar, which is located in INSTALL_DIR/api/lib, to the BPELlibrary directory.

6. Find the file application.xml, which is located under the BPEL installation directory.The file location is:

ORACLE_INSTALL_DIR/j2ee/OC4J_BPEL/config/application.xml

7. Edit the file in a text editor. To the list oflibrary elements, add the following twoelements. In the paths, substitute the correct value ofORACLE_INSTALL_DIR.

8. Find the opmn.xml file, which is located at:

ORACLE_INSTALL_DIR/opmn/conf/opmn.xml

9. Edit the file in a text editor.

Find the element. Nested withinthis element, add the following environment element, substituting your value of

INSTALL_DIR.


13/26

Installation 5

value="INSTALL_DIR/jre1.4/lib/i386/server" append="true"/>

...

10. Run the following command, which causes the newopmn.xml file to take effect:

ORACLE_INSTALL_DIR/dcm/bin/dcmctl updateConfig -ct opmn

11. Start the Oracle BPEL Process Manager Server.

Uninstalling

To uninstall the Complex Data Exchange Translator, delete the file CMXlator.jar, andremove the library elements that you added to application.xml.

On Linux, remove the environment element that you added to opmn.xml.


14/26



15/26

7

Chapter 2

Using Complex Data

Exchange in BPEL

This chapter includes the following topics:

Overview, 8

Configuring Data Transformations in Complex Data Exchange, 9

Creating Wrapper Schemas, 10

Configuring a BPEL Process, 13


16/26

8 Chapter 2: Us ing Complex Da ta Exchange in BPEL

Overview

The Complex Data Exchange Translator enables you to run Complex Data Exchange servicesin BPEL. To do this, perform the following steps:

1. In Complex Data Exchange Studio, configure one or more data transformations anddeploy them as services.

2. Create XSD wrapper schemas that reference the schemas used in the services.

3. In the Oracle JDeveloper BPEL Designer, configure and run processes that activate theservices.

The following sections provide instructions for each step.


17/26

Configuring Data Transformations in Complex Data Exchange 9

Configuring Data Transformations in Complex DataExchange

To conf igur e and dep loy a data t r ansform at ion:

1. In Complex Data Exchange Studio, configure a project containing the datatransformation that you want to run.

2. Use the Project > Deploy command to deploy the transformation as a service. This allowsComplex Data Exchange Engine to run the transformation.

For more information about configuring and deploying data transformations, see GettingStarted with Complex Data Exchangeand the Complex Data Exchange Studio User Guide.


18/26

10 Chapter 2 : Using Complex Data Exchange in BPEL

Creating Wrapper Schemas

Every parser or serializer service requires at least one XSD schema. In a parser, the schemadefines the structure of the output XML. In a serializer, the schema defines the structure of

the input XML.Before you can run the service in BPEL, you must create a set of wrapper schemas that allowBPEL to access the schemas of your service. The following paragraphs explain how to createthe required wrapper schemas.

Throughout the examples, you should substitute your values for the italic text, as follows:

If the main schema file includes other schema files, create a wrapper only for the main file.

Wrapper Schemas for a Parser

Read-Partner Link

A parser service requires the following wrapper schema. Assign it to the read-partner link ofthe BPEL process.

Write-Partner Link

A parser requires the following wrapper schema. Assign it to the write-partner link of theBPEL process:

Ital ic Text Substi tute

MyCMSchema.xsd The filename of the schema that is used in the Complex Data Exchange service.

MyTargetNamespace The target namespace that is defined in MyCMSchema.xsd. If there is no target

namespace, omit the targetNamespace attribute from the wrapper schema.

MyCMServiceName The name of the Complex Data Exchange parser service that BPEL runs.


19/26

Creating Wrapper Schemas 11

Wrapper Schemas for a Serializer

Read-Partner Link

A serializer requires the following wrapper schema. Assign it to the read-partner link of theBPEL process.

Write-Partner Link

A serializer requires the following wrapper schema. Assign it to the read-partner link of theBPEL process:


20/26


Wrapper Schemas for a Parser and a Serializer

If you intend to use both a parser and a serializer in the same BPEL process, create thewrapper schemas as follows:

For the read-partner link, use the read-partner syntax of the parser. For more information,

see Wrapper Schemas for a Parser on page 10.

For the write-partner link, use the write-partner syntax of the serializer. For moreinformation, see Wrapper Schemas for a Serializer on page 11.


21/26

Configuring a BPEL Process 13

Configuring a BPEL Process

To conf igur e a BPEL proc ess that ru ns Complex Data Exchange ser v ices:

1. In the Oracle JDeveloper BPEL Designer, create or edit a process.

2. Copy all schema (*.xsd) files from the Complex Data Exchange service directories to theBPEL project directory.

The service directories are located in the Complex Data Exchange repository. You mustcopy both the main schema files and any included schema files.

3. Add the schema files to the BPEL project.

4. Copy the wrapper files that you created above to the BPEL project directory.

5. Add the wrapper schema files to the BPEL project.

6. In the Adapter Configuration Wizard, assign the appropriate wrapper schemas to theread-partner and write-partner links.


22/26


7. Run the process, supplying the appropriate input. Confirm that the output is asexpected.

Example

The following example illustrates how to configure a BPEL process that runs a Complex DataExchange parser and serializer.

PartnerLink_1 is a file adapter that reads non-XML data and activates a parser. The XMLoutput of the parser is transferred to receiveInput.

Assign_1 transfers the XML message from a variable in receiveInput to a variable inwriteOutput.

PartnerLink_2 is a file adapter that activates a serializer. The serializer converts the XMLmessage to a new non-XML format, which is written to a file.

Sample Input

In the above example, the input to the PartnerLink_1 adapter might be the following HL7message, containing the results of a clinical laboratory test:

MSH|^~\&|LAB||CDB||||ORU^R01|K172|P

PID|||PATID1234^5^M11||Jones^William||19610613|M

OBR||||80004^ElectrolytesOBX|1|ST|84295^Na||150|mmol/l|136-148|Above high normal|||Final results


23/26

Configuring a BPEL Process 15

OBX|2|ST|84132^K+||4.5|mmol/l|3.5-5|Normal|||Final results

OBX|3|ST|82435^Cl||102|mmol/l|94-105|Normal|||Final results

Sample XML

The Complex Data Exchange parser converts the content of the HL7 message to thefollowing XML:

William

Jones

19610613

Electrolytes

Na

150

136-148

Above high normal

Final results

...

Sample Output

The PartnerLink_2 adapter might use a Complex Data Exchange serializer to convert theXML to a patient report:

Dear William Jones,

The following is the result of your Electrolytes test:

Test Value Normal Range

---- ----- ------------

Na 150 136-148

K+ 4.5 3.5-5

Cl 102 94-105

All results are final.

Bring this test report to your physician for evaluation.


24/26



25/26

17

Index

BBPELOracle 2

BPEL processconfiguring 13

Iinstallation

Oracle BPEL integration 3

LLinux

installing Oracle BPEL integration 4

OOracle BPEL

translator for 2

Sschemas

wrapper 10

services

defined 2system requirements


Ttranslator

in BPEL process 13

Oracle BPEL 2

Uuninstalling


WWindows

installing Oracle BPEL integration 3wrapper schemas

Oracle BPEL 10


26/26

18 Index

CDE 44 TranslatorOracleBpel

Documents