Fault handling in Oracle SOA Suite 11g-Example

We have already seen the theory part of fault handling as how it works,now in this section we will create a simple scenario to throw and then take appropriate action as per fault policies.

Pre requisite for this exercise is

SOA Suite 11.1.1.2
JDeveloper 11.1.1.2


Example.
===========

Create a new project in Jdeveloper





give some logical name to BPEL process make it a synchronous bpel process and say finish.




So now your composite should look like this.Drag and drop a BPEL process in your composite



Now again make this as a synchronous BPEL process and deselect the exposed as web service option.




So now the process should look like this.




now double click on Throw fault bpel process and drag and drop a throw activity in between .NOw double click on throw activity and choose one of the system fault



Create a fault variable also.

Once you will create it you will find that a wsdl is automatically added to your project RuntimeFault.wsdl

Now drag and drop an assign activity in between the throw and Receive input

In the assign activity assign some values to the fault Variable you have created.

So i have assigned some values as



So you bpel process which throws a fault should look like this



NOw connect the throw block with Catch Block as shown



Now go to the Catch Bpel process and drag and drop an invoke activity ,now connect the invoke activity with the throw partnerlink as shown below




NOw add a catch block to catch the fault,this will catch the same remote fault for which you have defined it.

NOw drag and drop a assign activity and copy the fault code to the output variable.

Again drag and drop a reply activity and send this output variable to the client.

We are doing so because we have only one client application here and we want that he should get the error.So when we reply the output to client we are basically throwing the fault to the calling application.

So now your fault handling process is ready,now we will add our fault policy to this project.

copy your fault-binding.xml and fault-policies.xml file in the same folder where you have your composite.xml lies

my fault-binding.xml file look something like this


xmlns="http://schemas.oracle.com/bpel/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

CatchFault

and my fault-policies.xml file looks like



xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.oracle.com/bpel/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

name="bpelx:remoteFault">















There are two important things that you need to note down

1>if you can see in your falut-binding.xml you can see an entry like

component faultPolicy="bpelFaultHandling"

this is baiscally a reference id which is passed to the fault-policies.xml so correpsonding to that

we have an entry in fault-policies.xml

faultPolicy version="2.0.1" id="bpelFaultHandling"

So the important thing is that this refernce id should match in the two files.

In my case it is bpelFaultHandling in both the case.


2>You can again see in your fault-bindings.xml an entry like this


CatchFault

This CatchFault is the name of the BPELProcess which is catching the fault.In my case the name of process which is
catching fault is CatchFault.


Now again we need to make two more addition in to our composite to make him aware that fault policies are added

fault-policies.xml
fault-bindings.xml

This should be added just after the service tag finishes

I am just pasting my composite.xml for example.




mode="active" state="on" xmlns="http://xmlns.oracle.com/sca/1.0"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
xmlns:orawsp="http://schemas.oracle.com/ws/2006/01/policy"
xmlns:ui="http://xmlns.oracle.com/soa/designer/">
location="CatchFault.wsdl" importType="wsdl"/>
location="ThrowFault.wsdl" importType="wsdl"/>




fault-policies.xml
fault-bindings.xml







catchfault_client_ep
CatchFault/catchfault_client


CatchFault/ThrowFault.throwfault_client
ThrowFault/throwfault_client




NOw you are done with your BPEL process.

Compile and deploy this project to your application server.

ONce deployed invoke the process you will get an option like this in the em console



Here we are getting an option of manual recovery as we have defined in our fault policy for manual intervention.Let me know if you have issues in it.