Back Forward Property-Set-Corr method

Methods and instructions by function

03-02 R-6018 VANDJ 11/15/02 Use this method to save the contents of a correspondence stream (generally HTML text) as the value of a Single Value property. The property value can then be mapped as output for transmission to an external system.

The target property value is the contents of a correspondence rule (Rule-Obj-Corr rule type), after stream processing. Stream processing evaluates directives and clipboard references.

CautionMARIK 1/31/04 Don't attempt to set the value of a property that has a name starting with pz; these properties are reserved. Don't use this method for a property that is the target property of a Declare Expression rule.

Parameters

This method has three parameters:

Parameter

Description

PropertyName Enter a Single Value target property reference. Identify the property that receives its value from stream processing. Typically, choose a property that has a Text type.
corr stream Enter the second key part — the Correspondence Name — of a correspondence rule.
CorrType Enter a correspondence type that is the final key part of a correspondence rule.

Results

This method forms a key to a correspondence rule 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 correspondence 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 applies stream processing to interpret and evaluate the JSP tags or directives (including property references) in this rule. It stores the resulting text as the value of the property referenced in the PropertyName parameter.

If the Type of the expression doesn't match the Type of the destination, the value is converted following the same scheme as within expressions. See Data type conversions (casting) in expressions and property assignments.

Any property messages previously associated with the property are cleared.GAJNJ 11/2/05 The property value is validated against the property. ERNSG 2/6/06

Cautions

Checking the method status

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

Definitions directives, property validation, stream processing
Related topics About Correspondence rules
How stream processing works

Property references in expressions

UpMethods and instructions by function