Rules Builder (DriveWorks Documentation)

What's New Rules Builder

DriveWorks 8

Rules Insight - New intelligent feedback when constructing rules in the rules builder. See Rules Insight for more information. (DriveWorks projects only)
New Functions - Many new functions added to the functions list, all functions now have wizards where appropriate. See New Functions for more information.
In-line AND OR - Easy to read arguments for AND OR situations
Alternatives Pane - Select models captured as replacement models from the Alternatives tab of the rules builder.

In-line And Or

Using in-line AND OR makes reading of arguments with possible outcomes much more straightforward.

Example

Rule	Meaning
ItemsReturn="Type A" AND Items2Return="Type B" OR Items3Return="Type C"	Will return TRUE when Items = Type A and Items2 = Type B or Items 3 = Type C
ItemsReturn="Type A" AND Items2Return="Type B" OR Items3Return="Type C"	Will return FALSE when Items = Type A and Items2 is not Type B or Items 3 is not Type C
IF( ItemsReturn="Type A" AND Items2Return="Type B" OR Items3Return="Type C",100,150)	Will return 100 when Items = Type A and Items2 = Type B or Items 3 = Type C Will return 150 when Items = Type A and Items2 is not Type B or Items 3 is not Type C

Rule

Meaning

ItemsReturn="Type A" AND Items2Return="Type B" OR Items3Return="Type C"

Will return TRUE when Items = Type A and Items2 = Type B or Items 3 = Type C

ItemsReturn="Type A" AND Items2Return="Type B" OR Items3Return="Type C"

Will return FALSE when Items = Type A and Items2 is not Type B or Items 3 is not Type C

IF( ItemsReturn="Type A" AND Items2Return="Type B" OR Items3Return="Type C",100,150)

Will return 100 when Items = Type A and Items2 = Type B or Items 3 = Type C

Will return 150 when Items = Type A and Items2 is not Type B or Items 3 is not Type C

Alternatives Pane

Components that have been captured as Replacement Models are now listed in the Alternatives tab of the Rules Builder.

The Alternatives tab is only available when building a rule for the File Name parameter of a model. The Alternatives tab is only populated with the replacement models that have been captured to the model the rule is being built on.

Selecting Alternatives

To select alternatives to use in the rule:

Open the project in DriveWorks Administrator
Select Model Rules from the task explorer
Check the box next to the component the alternative file rule is to be built on, so the parameters display in the main window.
Select the File Name parameter for the model to be replaced with the alternative. Click Build.
Enter the rule in the rule editor or by using one of the function wizards.
At the point where the rule requires the name of the replacement model to be used switch to the Alternatives tab and double click the required replacement model.

Circular References

A rule that references itself (circular reference) will not be calculated, the result will be displayed as #CIRCULAR.

The rule will be saved allowing further diagnosing to correct the issue.

Invalid IF Function

An IF Function that contains too many arguments will not be calculated, the result will be displayed as #VALUE.