Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Property-Map-Value method

Updated on August 16, 2022

The Property-Map-Value method evaluates a one-dimensional map value ( Rule-Obj-MapValue rule type) defined in the parameter. The method sets the result as a value for a Single Value property.

The related method Property-Map-ValuePair works similarly for two-dimensional map values.

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


This method has three parameters:

PropertyNameIdentify a target property to hold the result of this method. (You can't use a local variable here.)
MapNameEnter the name — second key part — of a map value (Rule-Obj-MapValue rule type).
RowInput Optional. Identify an input value for the row, as a literal constant or Single Value property reference. If you leave this blank, the system uses the value of the ROW PROPERTY property, defined on the Input tab of the map value.
AllowMissingProperties Select 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 when 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.


The system forms a map value 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.

It evaluates this one-dimensional) rule using as input the value you supply in the RowInput parameter (or the property identified the Input tab of the map value).

It 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.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us