File Actions
Last Modified on 28 February 2023
The File actions give you control over creating, deleting, moving, and copying files that are used in the testing process.
File Copy
| Icon | Description |
|---|
 | The File Copy action copies a file from one location into another. If the selected file doesn't exist the test fails. |
File Copy Editor
| Function | Description |
|---|
| Overwrite | Determines if the element should overwrite an existing file at the target location. If this is not selected, and the file already exists at the target location, the test fails. |
| Source | Location of the file you want to copy. |
| Target | Location where you want to copy the file. |
File Create
| Icon | Description |
|---|
 | The File Create action creates a file based on a text file asset. This creates the file with the information contained in the text file asset. |
File Create Editor
| Function | Description |
|---|
| File Content Asset | The text to put into the file upon creation. |
| Overwrite | Determines if the element should overwrite an existing file at the target location. If this is not selected, and the file already exists at the target location, the test fails. |
| Target | Location where you want to create the file. |
File Delete
| Icon | Description |
|---|
 | The File Delete action deletes a file from the target location. If the file does not exist, the you can control if the test fails or continues using the strict option. |
File Delete Editor
| Function | Description |
|---|
| Strict | Determines whether the test fails or continues if the target file does not exist. If selected, and the file does not exist, the test fails. |
| Target | The location where you want to delete the file. |
File Load
| Description |
|---|
| Loads a file from a selected connection asset. |
| Function | Description |
|---|
| Encoding | The text file encoding that's used to read the file.
|
| Resource Key | Name of the resource key that stores the results.
|
| Source | The source of the loaded file. |
File Line / Match Count
| Icon | Description |
|---|
 | The File Line / Match Count action counts lines in a file, or matches according to a specified pattern. The result of the count is then stored in a resource key that's used for comparisons in the assert step. |
File Line / Match Count Editor
| Function | Description |
|---|
| Line By Line | Toggle on or off to determine if matches evaluate one line at a time. |
| Operation Type | Specifies if the element counts lines or matches. |
| Pattern | This is the regular expression that's used to count matches. |
| Target | The file you want to count. |
| Resource Key | The result of the count is stored in the resource key. |
File Move
| Icon | Description |
|---|
 | The File Move action moves the file from one location to another. You can specify if the element overwrites an existing file or not. |
File Move Editor
| Function | Description |
|---|
| Overwrite | Toggle on or off to specify if the element overwrites a file that already exists. If turned off, and the file exists at the target location, the test fails. |
| Source | The location of the file you want to move. |
| Target | The location where you want to move the file. |
