About Service SOAP rules |
New | Service | Request | Response | |
Faults | XML Page | Test Cases | History | More... |
C-500 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 Application Explorer or the Integration Overview landing page to see Service SOAP rules in your application. Use the Rules Explorer to list all Service SOAP rules that are available to you. To access the Integration Overview landing page, select > Integration > Overview.
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 |