Filing Variables
This feature allows you to output the value of a variable to a local file on your system. You can then use this file in other tasks, or in your own programs. You can also insert the variable into various locations of a file, depending on the criteria you select. This feature can be useful in many situations.
Examples:
1) appending one file to another.
Variable name
Select the variable you need to monitor from the list. For some variables like DATE, you need to manually enter the format. In version 7.x, you need to enter the variable name surrounded by $%…%$. In Version 5.x, the surrounding $%…%$ was not required. By adding the $%…%$ into the format, it is possible to set the Variable Name field as an entire line of text which includes the variable.
Examples of Variable Name Field entries:
Today's date is $%DATE::qqq-dd_hh:mm%$
My username is $%USERNAME%$
This ip address = $%IPADDRESS%$
Filepath
Enter the full filepath of the file, which you want to save the variable to. This field supports dynamic variables.
Filing Options
Choose your filing criteria. You can insert the value of the variable into various locations. If you choose the 'Line Number' or one of the 'String containing' options, you should enter the correct 'Option Value' also.
Option Value
This Option Value depends on the Filing Option above.
Examples:
Variable Name = $%DATE::qqq-dd_hh:mm%$
Filing Option = Insert at Line Number
Option Value = 10
This will insert the date/time at line 10 in the file
or
Variable Name = $%DATE::qqq-dd_hh:mm%$
Filing Option = Insert before first line containing
Option Value = error
This will insert the date/time in the file, before the first line that contains the word 'error'
Types of variables listed:
Task Variables: Task variables values are generated / updated when the tasks run. Example: Tasks exit codes are stored as the following variable: TaskTitle::ExitCode
System Variables: System variables which are resolved when the current task runs, examples are DATE, USERNAME etc..
Java Variables: Java variables that are available to the Java Virtual Machine that the program runs in. You can get the value of Java variables from the Utilities menu / Java Variables
User Variables: Users can add their own variables via batch files, scripts or programs. Users can link output from their own programs to this program.