Back Forward About Service SOAP rules

Integration Services category
New Service Request Response
Faults XML Page History More...

Purpose

Using Simple Object Access Protocol (SOAP) over HTTP, the SOAP integration interface in Process commander supports interactions with external systems through Web services. Use SOAP service rules when your Process Commander applications need to act as a Web service.

A SOAP service means a SOAP service package that provides one or more service methods for an external application to use. Each method in the service package corresponds to a SOAP service rule that identifies an activity to run and maps the incoming and outgoing data.

To call a Process Commander SOAP service, an external application collects data values, wraps them in an XML document envelope (SOAP envelope) that contains the name of the requested service, and posts the envelope to the URL of the Process Commander PRSOAPServlet servlet. The PRSOAPServlet servlet routes the request to the appropriate SOAP service package and rule.

SOAP services generally process service requests synchronously. That is, they immediately perform their requested processing and return a configured response while the calling application waits. However, you can configure SOAP services to process service requests asynchronously, which means the service queues the request for asynchronous execution and the calling application calls back later for the results. Additionally, you can configure synchronous SOAP services to check for specific error conditions that you expect will be temporary — work object locks, for example — and then queue service requests for another attempt at a later time.

Access

Use the Integration slice (Integration) to list the Service SOAP rules in your application. Use the Rules by Type Explorer to list all the Service SOAP rules available to you.

Development

After all the Service SOAP rules in one package are created, access the Service Package data instance again to generate a WSDL file to support client-side development.

For a comprehensive description of the development process and a sample, see the Pega Developer Network document PDNBuilding SOAP Services. See also:

Category

Service SOAP rules belong to the Integration-Services category. A Service SOAP rule is an instance of the Rule-Service-SOAP class.

Related topics How to unit test a Service SOAP rule
Standard rules Atlas — Standard Service SOAP rules

zzz Integration-Services category
Help System home pageHome