Back Forward Property-Map-DecisionTable method

Methods and instructions by function

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 (Decision shape) can reference a decision table.

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 checkbox on the Decision Table form is not checked, because such decision tables 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 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.

Definitions decision shape, decision table
Related topics About Decision Tables

UpMethods and instructions by function