Skip to main content


XML Stream rules

Suggest edit Updated on August 16, 2021

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.

Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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