Skip to Content
avatar image
Former Member

How to handle soap faults from receiver webservice

The scenario is file to webservice. The file contains a record that I need to submit to the webservice. The issue I am having is rather than providing any error as a response message (or an error segment in the response) it returns a soap:fault for any issue, structural or data; or the response structure as defined in the WSDL on success.

I tried to use the Fault on the Synchronous service interface:

Created a XSD based on the soap:fault structure, linked the External Message to the Fault in the Service Interface.

Example of a fault:

<soap:Envelope xmlns:soap="">




         <faultstring>The specified Tag ID is already in use. Please specify a unique value.</faultstring>










When a fault is encountered, only the following shows in message monitoring:





I would like to be able to route the response message to a file so that it can be reviewed by support team, rather than cause error in Runtime Workbench. Going forward it is likely that I will add routing based on the <faultcode>. Certain faults can be handled, possibly by calling another webservice to obtain more data then include in transform.

Thank you for your assistance.

Add comment
10|10000 characters needed characters exceeded

  • Get RSS Feed

3 Answers

  • Jan 14, 2015 at 02:27 AM


    Please try Async-Sync bridge. Response mapping should be flexible to handle success and fault message. For initial testing, let the response be pass-through. After successful testing, develop mapping logic.

    Link1, Link2.

    Add comment
    10|10000 characters needed characters exceeded

    • Tadd,

      Sync-Async bridge fits this requirement.

      Target web-service (SOAP over HTTP), is synchronous. When a message is sent to target web-service, it will send back a success message or fault message. Use SOAPUI, to test target web-service.

      Lets try this, SOAP <-> PI <-> SOAP. There will be request mapping and response mapping. Please configure this scenario and test it with SOAPUI. Sender agreement will have the WSDL details. Send a Tag ID which is already in use. You can will see response (fault message) in SOAPUI.

      File can't be used for sync. So use Async-Sync bridge. Now configure a new scenario, File -> PI -> SOAP -> PI -> File. In response, use response mapping developed above.

  • avatar image
    Former Member
    Jan 14, 2015 at 07:26 AM

    Hi Tadd,

      You may want to use the RequestResponseBean and ResponseOneWayBean in your sender file channel to capture the response from the web service and save that as a file on a file server.



    Add comment
    10|10000 characters needed characters exceeded

  • Jan 14, 2015 at 08:35 AM

    HI Tadd,

    From my point of view Raghu suggestion is the best way to do it. However, you have more options like to generate the file in the response, in the mapping level, writing a file, you would need to it in an UDF or java mapping, like this example File Lookup in UDF - Process Integration - SCN Wiki

    (notice this example is to read not to write).


    Add comment
    10|10000 characters needed characters exceeded