Version: 22-SP0-25 and onwards
Please note this version now supports the following control types:
Earlier versions of the Specification PowerPack did not export the above control types.
If any of the above controls are in use and this version (or newer) of the PowerPack is installed the exported file will include this information.
This Specification Task will export Controls and Constants with values to an existing text file.
This Task will NOT create a file. You must specify an already existing text file with its extension.
This task will export the current value of the following control types:
All other control types will not be exported.
Control values that span multiple lines will span multiple rows in the exported text file.
If the structure of the exported text file requires each control on a separate row we recommend excluding any control where its value could span multiple lines.
This applies to the following control types:
| Property Name | Description |
|---|---|
| Title | Changes the Title (not the name) of the task. |
| Delimiter | Character to use between the name, value and type on each row (comma by default). |
| Export Path | Full path, including extension, of the file that the Controls and Constants will be exported to. |
| Constants to Exclude | A pipebar (|) delimited list of Constants to exclude. |
| Control Names to Exclude | A pipebar (|) delimited list of Control names to exclude. |
| Wrap Value in Quotes | True (checked) to wrap the value in quotes IF the value of the control includes the delimiter.
This is useful to ensure control values, that include the delimiter value, are not confused with the delimiter. When a value coming from a control includes quotes another quote will be added to each. For example: Control Value is: some text, "text in quotes", more text Delimiter is , (comma) the exported value will be: "some text, ""text in quotes"", more text" |
When this Task is added the properties are static. To be able to build rules on a static property see How To: Change A Static Property To A Dynamic Property.
| Property Name | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Delimiter | "#" | # | # will be used as the delimiter. This is the character which will be used to separate the name, value and the type. |
| Export Path | "C:\Exports\Export.txt" | C:\Exports\Export.txt | This is the full file path with extension. |
| Constants To Exclude | "B" | B | The Constant DWConstantB will not be included in the text file. |
| Control Name To Exclude | "TextBox2" | TextBox2 | The Control TextBox1 will not be included in the text file. |
| Type | Name | Value |
|---|---|---|
| Text Box Control | TextBox1 | ABC |
| Numeric Text Box Control | NumericTextBox1 | 123 |
| Slider Control | Slider1 | 43 |
| Text Box Control | TextBox2 | XYZ |
| Constant | A | 123 |
| Constant | B | 456 |
| Constant | C | DriveWorks |
| Created Text File |
|---|
Name#Value#Type TextBox1#ABC#Control NumericTextBox1#123#Control Slider1#43#Control A#123#Constant C#DriveWorks#Constant |
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)