Skip to main content


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

Configuring XML tree node properties for a Parse XML rule

Updated on April 6, 2022

Configure nodes for element or attribute node types to be included in the tree structure. The tree structure allows you to define how the parsed XML data will be mapped to the clipboard values referenced in the individual tree nodes.

  1. In the navigation pane of Dev Studio, click Records.
  2. Expand the Integration-Mapping category, and then click Parse XML.
  3. Click the row of a Parse XML rule to open it.
  4. On the Mapping tab, double-click a tree node to display the User Data window for the node.
  5. On the Node tab of the User Data window, in the Node Namespace field, enter a namespace.
    This option is typically set when the parse rule is auto-generated from an XML Schema Definition (XSD). If the option is set, the attribute or element name must be prefix-qualified with the specified namespace value for its value to be parsed and mapped to the clipboard.
  6. If the node type is Element, and the same element can appear multiple times in a sequence, select Repeating to map the list of elements to a list property.
    Note: The Optional and Nillable options are typically set when the parse rule is auto-generated from an XSD, and has no effect on parsing.
  7. In the Substitution field, to indicate whether this element or its content can be substituted at run time using a different element or complex type definition.
    This option, as well as the content of the Type Substitution and Element Substitution tables on the XML tab of the parse rule, is typically set when the parse rule is auto-generated from an XSD.

    By using the Apply Rule mapping mode, the actual component parse rule instance that is applied to parse the element content can be determined dynamically at run time by matching the type or element name from the inbound XML document with an entry in either the Type Substitution or Element Substitution table. If found, the Class name specified in the third column of the table will be used to select the most appropriate Parse XML rule to process the element content.

    Note: If you configure Type Substitution on the root node of the Parse XML rule, you must specify a Context Page on the Mapping tab of the User Data panel.
  8. Click OK to close the User Data window, or click the Type tab to continue configuring the XSD type.
  • Previous topic Mapping XML elements to properties
  • Next topic Parsing date, dateTime, and time values in a Parse XML rule

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us