Back Forward Property-Map-ValuePair method

Methods and instructions by function

The Property-Map-ValuePair method evaluates a two-dimensional map value rule identified in the parameters. It sets the value that results into a specified property.

In the Diagram tab of a flow rule, a decision shape (Decision shape) can reference a map value rule.

Parameters

This method has five parameters:

Parameter

Description

PropertyName

Identify a target property to receive the result of this method. (You can't use a local variable here.)

MapName

Enter the name — second key part — of a map value rule (Rule-Obj-MapValue rule type)

RowInput

Optional. Identify an input value for the row, as a literal or Single Value property reference. If you leave this blank, the system uses the value of the ROW PROPERTY Property, identified on the Input tab of the map value rule.

ColumnInput

Optional. Identify an input value for the column, as a literal constant or Single Value property reference. If you leave this blank, the system uses the value of the Column Property property, identified on the Input tab of the map value rule.

AllowMissingProperties

Check to cause map value processing to continue even if a referenced property is not present on the clipboard. For a Single Value property, the system uses the null string as the value of the missing property.

Clear to cause map value processing to halt if processing references a property that is not present on the clipboard. This causes the system to store an output parameter MapValueStatus with value "NotFound" on the parameter page of the activity.

Results

The system forms a map value rule key from the value in the second parameter and the class of the step page or primary page. It uses rule resolution to find the map value rule.

It evaluates this two-dimensional rule using as input the value you supply in the RowInput and ColumnInput parameters, or from the properties identified in the Input tab of the map value rule.

It evaluates the rule and stores the result in the property you identified in the PropertyName parameter.

Checking the method status

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

Definitions decision task, map value
Related topics About Map Value rules
Property-Map-Value method

zzzMethods and instructions by function