About Service SOAP rules |
New | Service | Request | Response |
Faults | XML Page | History | More... |
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.
Use the Integration slice () 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.
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 Building SOAP Services. See also:
Service SOAP rules belong to the Integration-Services category. A Service SOAP rule is an instance of the Rule-Service-SOAP class.
How to unit test a Service SOAP rule | |
Atlas — Standard Service SOAP rules |