Property-Set-XML method

Use this method to save the contents of an XML Stream rule after stream processing completes as the value of a Single Value property. The property value can then be mapped as output and conveyed to an external system.

The target property value is the XML text from an XML Stream rule ( Rule-Obj-XML rule type), after stream processing. Stream processing evaluates directives and clipboard references.

Parameters

This method has three parameters:

Parameter Description
PropertyName Identify a Single Value target property to receive the value produced by stream processing.

If the property is on the step page, precede the property name with a period.

If this property is on a different page, include the page name in the reference and ensure that this page appears on the Pages & Classes tab of the Activity form.

XMLStream Enter the Stream Name key part of an XML Stream rule to process.
XMLType Enter the third key part of an XML Stream rule to process.

Results

This method forms a key to an XML Stream rule instance from the value you supply for the second and third parameters and the class of the step page or of the activity. It uses rule resolution to find the XML Stream rule.

If the step page does not exist, a new page is created, of the class identified in the Pages & Classes tab.

It then uses stream processing to interpret and evaluate the JSP tags or directives in this rule. It stores the resulting XML text as the value of the property referenced in the first parameter. The property value is validated against the property rule.

Cautions

  • You cannot use this method for a property that is also the target property of a Declare Expression rule. You can't save the Activity form if such a conflict is detected.
  • Do not attempt to set the value of a property that has a name starting with pz; changes to such properties are reserved.
  • Use the standard activity Work-.UpdateStatus — not this method — to change the value of a work item status ( pyStatusWork property).

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

Methods and instructions by function