Use the Map-Structured method to invoke a map structured rule ( Rule-Map-Structured rule type) to assemble a text property value from property values on a clipboard page, or disassemble a single text property value into other property values.
This method has three parameters:
Select the direction of processing:
|Map||Identify the second key part (Purpose) of a map structured rule. At runtime, rule resolution uses the class of the step page (or the class of the primary page of the activity) as the Applies To key part to retrieve this rule.|
Enter a scalar property reference that is the source of the input data
structure (when the
Enter only properties that have a character-oriented
type, such as
The Map-Structured method works as follows:
- Locates the map structured rule using rule resolution.
- Uses information in the Mapping tab of the rule to parse the value of the property identified in the Property parameter into other clipboard values, or to assemble the value of that property from other clipboard values, depending on the Direction parameter.
If the direction is
Map From Clipboard, the value of properties listed on the Mapping tab are copied to the character offset position, truncated (if necessary) to the length specified in the Length field, padded and justified according to information on the Mapping tab.
If the direction is
Map To Clipboard, the mapping is executed in the reverse direction. The value of the property in the Property parameter is disassembled into the multiple properties listed on the Mapping tab. No padding or justification occurs. If the mapping defines a character length longer than the Max Length size of the property, the value is truncated to the Max Length size.
Property validation does not occur.
Checking the method status
This method updates the pxMethodStatus property. See How to test method results using a transition.
Previous topic Log-Message method Next topic Obj-Browse method