Property-Map-DecisionTable method

Use the Property-Map-DecisionTable method to evaluate a decision table and save the result as the value of a property.

In the Diagram tab of a flow rule, a decision shape can reference a decision table.

Parameters

This method has three parameters:

Parameter Description
PropertyName Optional. Select or enter a target property to contain the results of the decision table evaluation. Enter a property name or property reference to a single value. (You can't use a local variable.)

Leave blank when the Allowed to Return Values check box on the Decision Table form is not checked, because such decision tables do not return a result value.

DecisionTableName Enter the name of a decision table, the second key part of a Rule-Declare-DecisionTable instance.
AllowMissingProperties If selected, the system attempts to evaluate the rule even when one or more properties referenced in the rule are not present on the clipboard.

Results

The system forms a decision table key using the second parameter and the class of the step page or primary page. It uses rule resolution to locate the appropriate decision table to evaluate.

The system then evaluates the decision table, in the context of current property values, and stores the results in the property identified in the PropertyName parameter.

If you specify a PropertyName property but the decision table does not return any value, the property is set to an empty string value.

Trapping not-found conditions

If the AllowMissingProperties parameter is not selected and a needed property is not on the clipboard, the Property-Map-DecisionTable method places an output parameter DecisionTableInvalidProperty on the parameter page of the current activity. This output parameter identifies the name and class of the missing property.

This capability can be useful in situations where a user can be prompted for the missing property.

Checking the method status

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

Methods and instructions by function