Creating a conditional action expression - simple example

This sample scenario shows how you can use WinStudio to generate conditional action expressions. Conditional action expressions have three parts: the action, the condition, and the value.

In this scenario, you want to make the [Credit Hold Date] a required field when users select the [Credit Hold] check box.

Open the form whose collection includes the [CreditHoldEdit] component and the [CreditHoldDateEdit] component.
Go into Design Mode and select the field (CreditHoldDateEdit component) for which you want to set the conditional requirement.
In the [Component] property sheet for [CreditHoldDateEdit], select the [Required When] property and click the ellipsis ([...]) button that displays.

This automatically sets [Action Type] to [Required] and [Action Value] to [#C(CreditHoldDateEdit)].

This is the "Action" part of the expression: "The Credit Hold Date component is required..."
In the [Edit Condition] dialog box:
- Click [Edit Left Value]. Set [Value Type] to [ComponentValue] and [Value] to [CreditHoldGridCol].
- Set [Operator] to [=].
- Click [Edit Right Value] and set [Value Type] to [Literal] and [Value] to [1].
  A value of 1 indicates that the component check box is selected.
This translates to [#C(CreditHoldGridCol) = "1"]

This is the "Condition" part of the expression: "...when the Credit Hold component is selected."
Click [OK] and see the full expression in the [Edit Set of Conditional Actions] dialog box:

Required:#C(CreditHoldDateEdit), #C(CreditHoldGridCol) = "1", "True"

The "Value" part of the expression is automatically generated in this case and is set to [True] to indicate that the component's value is required if the condition is true.
To return to the [Component] property sheet and store the conditional expression in the [Required When] property of the [CreditHoldDateEdit] component, click [OK].
Save the form and test it to make sure that selecting [Credit Hold] makes [Credit Hold Date] a required field.