BPEL File Adapter Tutorial Overview: In this tutorial I will explain how to read a CSV file using ReadFileAdapter

and then to write a CSV file using WriteFileAdapter. We dont have two separate FileAdapters but based on the read and write operation we mention them as ReadFileAdapter or WriteFileAdapter. ReadFileAdapter will Receive the input data from file and translate the data based on the translation logic defined and post the XML messages. WriteFileAdapter will receive the XML messages and translate it into actual data and write to a file.

FileAdapter supports the following file formats. 1. XML 2. Delimited (Delimiter can be anything) 3. Fixed position 4. Binary Data You dont need to use both ReadFileAdapter and WriteFileAdapter in a single process, for example you can read the data from file using ReadFileAdapter and write data to a database using DBAdapter. In other way you can get the data from a database and write it to a file using WriteFileAdapter. This is purely based on the business requirement and up to us how we are going to use them. System Requirements: 1. jDeveloper 10.1.3 2. SOA Suite 10.1.3 Connections Required: 1. Start the SOA Suite 2. Create Application Server Connection

3. Create Integration Server Connection Start the SOA Suite: If you dont have SOA Suite already installed on your machine click here to download and install it. If you have SOA Suite installed on your machine navigate Start >> All Programs >> Oracle >>Start SOA Suite

Once your Application Server starts successfully you will see the screen below

Create Application Server Connection Navigate to Connection Navigator by clicking view >> Connections Navigator or by pressing Ctrl + Shift + o

Right click on Application Server and click New Application Server Connection

Wizard opens with welcome screen

Click Next

Connection Name: AppServerConnection1 (you can change it to anything) Connection Type: Oracle Application Server 10g 10.1.3

Click Next

Username: oc4jadmin Password: welcome1(this is the default password, if you have changed it use your own password) Click next

Leave everything as it is and click next And then press Test Connection

If you receive the Status as Success! You are good to proceed. If you get any errors make sure your application server is running and try again. Click Finish to close the wizard and return to Connection Navigator. Create Integration Server Connection Go to Connection Navigator by pressing Ctrl+Shift+o

Right click on Integration Server

By Clicking the New Integration Server Connection wizard opens up with welcome screen.

Click Next

You can leave the Name as it is or change it if needed Click Next

Application Server: Select the Application Server you created in first step. If you have only one application server it will be automatically selected.

Hostname: localhost Port Number: 8888 Click Next

Click Test Connection

If you receive the following message you connection is successful. Application Server: OK BPEL Process Manager Server: OK ESB Server: OK Click finish to close the wizard Create New Application Open Application Navigator by clicking Ctrl+Shift+A or go to view >> Application Navigator

If you have any Application exists you can create your BPEL process under that if not creation new application by right clicking the Applications and selecting New

Change the application name as you need and leave all the remaining things as default and click OK

Click Cancel to cancel the project. We will create new project manually by selecting the BPEL Process project in next step. Create New BPEL Process Right Click on the Application that we created and click New Project

Wizard opens as shown

Select BPEL Process Project and click OK

Change the Name(optional) and Template: Empty BPEL Process Click Finish. If you expand the BPEL Process you can see the files below which are created by default.

Middle panel of jdeveloper opens BPELProcess.bpel file automatically if not open it by double clicking on the file shown in the above figure.

In the .bpel file you can see 3 regions 1. Services(Left Side) 2. Main Activity Region 3. Services(Right Side) On the Right Side of your screen you can see the component palette.

From the dropdown select Services if it is not selected.

From services select File Adapter

Drag it to Services region on left and leave it. Automatically Adapter Configuration Wizard will pop up showing the welcome screen

Click Next

Enter Service Name as ReadFileAdapter since we are going to use this adapter for reading the file. Click Next

Select ReadFile and click Next

Select the Physical Path option and select the path where you CSV file is placed.

I have placed by .CSV file in the C:\readfile directory Deselect the option Delte files after successful retrieval Click Next

Enter the patten name in Include Files with Name Pattern I have entered erpschools*.txt which means that all the files starting with erpschools word prefix will be picked for processing. Ex: erpschools.txt will be picked erpschools1.txt will be picked erpschools2.txt will be picked 1erpschools.com will not be picked. Click Next

Leave the default values and Click Next

Click on Define Schema for Native Format button

Navtive Format Builder Wizard will pop up with welcome screen. Click Next

Select Delimited option and Click Next

Select your delimited file. My Delimited file looks like this

Click Next

Since our file contains only one record select first option and Click Next

Namespace: leave default value Enter a name for element that will represent record: readrecord Click Next

Click Next

Change the column names and types as needed and Click Next

.xsd(XML Schema Definition) file will created by default Click next

Click Finish to go back to Adapter Wizard

Schema Location and Schema Element will be populated with the values that we created just now. Click next

Click Finish

Create Partner Link window will show up as above

Click OK

Now you should be able to see the ReadFileAdapter in the services region as shown above Now in the component Palette select Process Activities

Select Receive component and drag it to main region When you move the component to main region it will change the color to yellow then you can drop it.

Double click on Receive_1 component to edit

Click on Flash light right to to the Partner Link Field

Select ReadFileAdapter and click OK

Now Partner Link and operation fields will be populated as shown Click on Auto Create button right to Variable to create new variable. If you dont understand which icon to click place your cursor on the icons and you can see the hint text

Click OK

Check Create Instance box and click apply Click OK Now the figure looks like this

There is a link created from ReadFileAdapter to Receive_1 component Create WriteFileAdapter Go to component palette and select services from drop down Select the drag FileAdapter to Services region on the right side FileAdapter Wizard will open with welcome screen as shown below

Click Next

ServiceName: WriteFileAdapter

Click Next

Select Write File option Click Next

Enter Directory path and file naming convention as shown above. %SEQ% will increase the numbers from 1 onwards which means if you have 10 files to write then your file names will be erp_1.txt, erp_2.txt, erp_3.txt ..erp_10.txt Click Next

Click Browse to select the schema file that we already created before

Select readrecord Click OK

Click Next

Click Finish to close the wizard

Click Apply and OK

WriteFileAdapter will showup in the right Services region as show above Now go to Component palette and select Process Activites Select Invoke Component from component palette and drop it below the Receive_1 component Double click on Invoke_1 component to edit it

Click Flash light to select the partner link

Click ok

Click Automatically create input variable icon to create new variable

Click ok

Click Apply and OK

Now drag and drop the Transform component below the Receive_1 component and above Invoke_1 component

Double click on Transform_1 component to edit the settings

Select as follows Source variable: Receive_1_Read_InputVariable Target variable: Invoke_1_Write_InputVariable

Click Apply and OK

Transformation_1.xsl file will open as show above select tns:readrecord in source and drag it to tns:readrecord on target to map the fields.

Auto Map Preferences will pop up as shown above

Click OK to auto map

All fields will be mapped automatically as shown above Now select BPELProcess.bpel file on top and click validate icon to validate the process

Once it is validated with out errors we are ready to deploy the process Deploy BPEL Process Right click on BPEL Process and select Deploy option as shown below

If you have this process already on server it will pop up with version number if not it will start deploying the process

If your deployment is successful you will see the message BUILD SUCCESSFUL. Initiate BPEL Process Open your browser and type the following URL http://localhost:8888/BPELConsole If your hostname is different change it in the URL

Username: oc4jadmin Password: welcome1(default) Login You can see the list of deployed BPEL Process on the left panel as shown below

Click on the process we deployed right now

You will be taken to Initiate screen where you have option to post XML Message Now your process has initiated Go to your writefile directory to see your file

admin

Posted by admin at 12:36 pm

2 Responses to BPEL File Adapter Tutorial

1. Shirish says:

August 23, 2011 at 10:00 pm Hi Prudhvi, When theres some issue with data, entire message is discarded, do you have an example of how exception handling like, rejectedMessageHandlers Thanks Shirish Reply

2. hari krishna says: September 15, 2011 at 5:32 pm thank u sir for giving this blog, iam easily understand the file adapters how to create in soa thank u very much sir,plz give more examples sir Reply

Leave a Reply
Name E-mail URI * *

CAPTCHA Code *

Your Comment You may use these HTML tags and attributes: <a href="" title=""> <abbr
title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

About Me

My short bio

Categories

Alerts Articles Data Loader Discoverer Financials Forms Fusion Middleware General HRMS iexpenses Interview Questions Manufacturing Oracle Reports Order Management Payables Personalization Purchasing Receivables Scripts Shell Script SQL Loader Sysadmin and AOL Tools Workflow

XML Publisher

Connect

Register Log in Entries RSS Comments RSS

Beginner Articles

FNDLOAD to transfer AOL Objects from one instance to other Technical Terms in Oracle Apps explained through real time example SQL Loader Part 2 SQL Loader Part 1 Concurrent Program Registration and add it to request group

Recent Posts

Concurrent Requests and Programs Related Scripts Menu and Functions Related Scripts Send e mail through PL SQL code UTL_FILE example Get On Hand Quantities through API

Follow Me

2011 erpSchools Suffusion theme by Sayontan Sinha