Create Service SAP rules in your Pega Platform application when you want to allow an SAP system to connect to the Pega Platform using SOAP web service protocols. SAP service rules are designed for both traditional SAP R/3 (ECC) application integration and SAP NetWeaver application integration.
A SAP service is a SOAP service package that provides one or more service methods for an external SAP application to use. Each method in the service package corresponds to an SAP service rule that identifies an activity to run and maps the incoming and outgoing data.
SAP 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 SAP 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 SAP services to check for specific error conditions that you expect will be temporary—work item locks, for example—and then queue service requests for another attempt at a later time.
Use the Application Explorer to see Service SAP rules in your application. Use the Records Explorer to list all Service SAP rules that are available to you.
After all the Service SAP 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 Community document Building SOAP Services. See also:
- Configure a service to process requests asynchronously
- How asynchronous service processing works
- Configure a service to queue a failed service request for another attempt
Service SAP rules use SOAP protocols and belong to the Integration-Services category. A Service SAP rule is an instance of the Rule-Service-SAP class.
- Service SAP form - Completing the Create, Save As, or Specialization form
- Service SAP form - Completing the Service tab
Complete the Service tab to identify the activity that this Service SAP rule calls. See More about Service Packages.
- Service SAP form - Completing the Request tab
Configure the data mapping of the incoming SOAP request from the external SAP application to the Pega Platform on the Request tab.
- Service SAP form - Completing the Response tab
Configure the data mapping for the reply message on the Response tab. Use the Response headers section to map data for the SOAP envelope header. Use the Response parameters section to map data for the body of the SOAP message.
- Service SAP form - Completing the Faults tab
Use the Faults tab to specify data returned to the client application when the service encounters a fatal processing error and must return a SOAP fault message. You can also use the Faults tab for other conditions that you want to cause SOAP fault messages to be returned.
- Service SAP form - Completing the XML Page tab
Use the XML Page tab to identify a data transform that defines the schema of an XML object. The service rule uses the data transform to map the XML object's arguments to and from the pages and properties.
- Service SAP form - Completing the Advanced tab
Use the Advanced tab to define security settings for the service and ensure content integrity and confidentiality of requests and responses.
- Service SAP form - Working with the Test Cases tab
This tab is visible only to operators who have the AutomatedTesting privilege through an access role.