The Drive Control Value will drive a value into a Form Control in the Specification.
This task is often used to set values in Controls or clear values in Controls. This task is useful when re-using Form Controls multiple times.
| Property Name | Description |
|---|---|
| Control Name | The name of the Form Control to drive the Control Value into. |
| Control Value | The value to drive into the Control Name. |
| Use local value format | TRUE to drive the control value to the control using the local value format. For example, dates will be converted to the local format. |
| Title | Changes the Title (not the name) of the task. |
The following Controls can be driven with this task:
When this task is added the properties are static by default.
See How To: Change A
Static Property To A Dynamic Property to enable rules to be built on these properties.
For Control Type: Numeric Text Box
| Property | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Control Name | "Volume" | Volume | The name of the control must be within quotes or result as a string. No spaces in Control names. |
| Control Value | LengthReturn*WidthReturn*DepthReturn (100*100*100) | 1,000,000 | Use the rule builder to build the rule that will result in the value to drive into the control |
For Control Type: Check Box
| Property | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Control Name | "DocumentsRequired" | DocumentsRequired | The name of the control must be within quotes or result as a string. No spaces in Control names. |
| Control Value | DWVariableDocumentsCheck | FALSE | For a Check Box the Control Value must be either TRUE or FALSE. |
For Control Type: Date Picker
| Property | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Control Name | "ShippingDate" | ShippingDate | The name of the control must be within quotes or result as a string. No spaces in Control names. |
| Control Value | "06/26/2000" | 26/06/2000 | 26/06/2000 will be driven into the Date Picker Control. |
| Use local value format | =TRUE | TRUE | Date will be converted into the local format. This means that the value will drive into the Control. |
This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.
Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.
This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.
The status output navigation is as follows:
Success
Success with Warnings
Failed (one of the following occurred)