Service SAP form - Completing the XML Page tab

Use this 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.

Important: Service SAP rules are no longer being actively developed, and are being considered for deprecation in upcoming releases. Using Service SAP rules does not follow Pega development best practices. Use Service SOAP rules instead. For more information, see Service SOAP rules.

When you use this tab to specify a data transform for mapping an argument, you are specifying that you want the WSDL file generated in the service package to include schema definitions for complex properties. In other words, the SOAP operation style for the services is document-literal rather than RPC-encoded.

In this situation, the data transform only specifies the properties to add to the page. The system does not use any values specified for those properties in the data transform. The system parses the request message, looking for the properties listed in the Target column of the data transform's Set actions. Properties that are listed in the data transform but not present in the message are ignored, and not added to the page.

Field Description
Schema Definitions  
Page Name Enter the name of a page of the class identified in the Class Name field. This may be an embedded page within the primary page identified on the Service tab, or a top-level page.

You use this page name in the Map To Key or Map From Key on the Request or Response tab.

Class Name Specify the class rule that holds the data model of the XML object being mapped.
Data Transform Select a data transform (instance of Rule-Obj-Model ) that specifies the properties that the system should parse to or from the message and the clipboard page.

This data transform only specifies the properties to add to the page. The property names are specified in the Target column of Set actions in the data transform. Any values specified in the corresponding Source columns of those Set actions are ignored in this situation. As a result, you can enter "" in the Source column for those Set action rows.