Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

XML Stream rules

Updated on April 6, 2022

Create an XML stream rule to define an XML template or skeleton message as part of an interface between the Pega Platform and an external system. You can use XML stream rules to assemble and send an XML document in an email message, a SOAP message, a file, or other types of messages.

The XML text in each XML stream rule can contain directives or JSP tags that reference clipboard properties. At run time, the system performs stream processing to evaluate these directives or JSP tags and form the final XML message.

Note: For the highest quality and security, minimize the use of XML rules you create in application rulesets. While XML rules are necessary for specific features, use auto-generated sections in flow actions and harnesses when possible. Auto-generated rules might often provide better performance, greater security, greater levels of browser independence, and more consistent branding and styles than hand-crafted rules. If your application rulesets contain XML rules, they can affect your compliance score. Use the Rule Security Analyzer to check for security vulnerabilities.

Where referenced

Connect SOAP, Service SOAP, and Service Email rules often use XML Stream rules to compose an XML document from clipboard property values. Most other service and connector rules can use XML Stream rules. In an activity, the Property-Set-XML method evaluates an XML Stream rule using stream processing.

In addition, XML Stream rules define the structure of menus in Dev Studio.


Use the Application Explorer to access XML Stream rules that apply to the work types in your application. Use the Records Explorer to list all XML Stream rules available to you.


If you have a Document Type Definition (DTD) or XML Schema (XSDL) file that defines the structure of XML documents to be produced by an XML Stream rule, you can create classes, properties, and XML stream rules corresponding to the XML definition automatically, using a wizard. See About the Connector and Metadata wizard .


XML Stream rules are part of the Integration Mapping category. An XML Stream rule is an instance of the Rule-Obj-XML rule type.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us