Property-Set-XML method

03-02 R-6018 VANDJ 11/15/02 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. B-15835 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. B-17775

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. SDAS/OLSOK 12/05/05 and SR-210 and B-15556 rejected

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. ERNSG 2/6/06

Cautions

• R-10043 B-20617 You can't use this method for a property that is also the target property of a Declare Expression rule. MARIK 1/31/04 You can't save the Activity form if such a conflict is detected. B-19396
• Don't 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 object status (pyStatusWork property).

Checking the method status

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

	property validation, stream processing
	About XML rules How stream processing works How to reference properties in expressions

Methods and instructions by function