- Discussion Topics
- Online Resources
- Other Resources
To extend its functionality ToDoList lets you configure tools to perform action and operations that are outside the scope of ToDoList as a generalised task manager.
A User-Defined Tool (UDT) is a template which specifies a tool (application, script or batch file) together with additional command-line parameters and information on how to display the tool in ToDoList's user interface.
Note: For detailed information on configuring a UDT see (Menu Bar > Tools Menu > Preferences > User Defined Tools.
The goal is to create a command template that can be populated with data at run-time, and then executed from the DOS prompt. It would look something like this:
c:\path\to\program\name.exe -switch1 -switch2 "data1" -switch3 "data2"
The switches and data are whatever is required for the 'name.exe' program to work. These are the tool's 'Arguments'.
A set switches and/or data that will be passed to the tool via its command-line. The down-arrow button attached to this field will display a list of “placeholder” variables for data that ToDoList will substitute when you run the tool. For example an argument might be set as follows:
The $(selTID) is inserted by ToDoList after clicking the down-arrow button to show a list of available data. In that list is “Selected Task ID”. When clicked, the placeholder “$(selTID)” is inserted into the arguments field. So with the above argument set, at runtime, the value of the current selected task will be substituted, maybe #217, and the final command will look something like this.
Whatever happens in that command is outside the scope of ToDoList and this documentation. It's up to you to find or create scripts or programs which do things that you want, and then to get ToDoList to provide those programs with required data to provide the results you seek.
Placeholders prefixed by 'user' will result in the user (you) being prompted to enter information when the UDT is executed. This is useful where the information is not known in advance or it frequently changes. User placeholders typically take 3 additional arguments:
Example of a User Placeholder:
There are no quotes around the user data for the command-line. That could cause a problem with the program that processes the data. The next example adds quotes:
The following (rough) examples illustrate possible uses of the tools system and one possible way of solving each challenge.
"$(userfile, var_msxsl, "Path to Msxsl.exe")" "$(pathname)" "$(userfile, var_xslfile, "Path to Xsl file")" "$(folder) $(filetitle).html"
Note that there are two *userfile* placeholders, and that fields are surrounded by quotes as described above.