Back Forward Property-Map-DecisionTable method

Methods and instructions by function

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

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

Parameters

This method has three parameters:

Parameter

Description

PropertyName

SmartPromptOptional. 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 table rules do not return a result value.

DecisionTableName

SmartPromptEnter 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 rule 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 rule to evaluate.

The system then evaluates the decision table rule, 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 rule 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.

Definitions decision task, decision table
Related topics About Decision Table rules

zzzMethods and instructions by function