User Tools

Site Tools


command-line

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
command-line [2016/10/03 00:26]
admin
command-line [2017/08/02 03:34] (current)
admin
Line 58: Line 58:
 |[[#​-bid|-bid]]| <id> |Specifies the sibling task after which to create the new task| |[[#​-bid|-bid]]| <id> |Specifies the sibling task after which to create the new task|
 |[[#​-c|-c]]| <​categories>​ |Modifies the '​Category(s)'​ for the currently selected task| |[[#​-c|-c]]| <​categories>​ |Modifies the '​Category(s)'​ for the currently selected task|
-|[[#​-cd|-cd]]| <​date ​[[time|time]]> |Modifies the '​Completion Date' (and optionally the time) for the currently selected task|+|[[#​-cd|-cd]]| <date [time]> |Modifies the '​Completion Date' (and optionally the time) for the currently selected task|
 |[[#​-cm|-cm]]| <​comments>​ |Sets the '​Comments'​ for the currently selected task| |[[#​-cm|-cm]]| <​comments>​ |Sets the '​Comments'​ for the currently selected task|
 |[[#​-cmd|-cmd]]| <id> |Sends the specified command to ToDoList'​s main window| |[[#​-cmd|-cmd]]| <id> |Sends the specified command to ToDoList'​s main window|
 +|[[#​-copy|-copy]]| <​attrib1>​ <​attrib2>​ |Copies the value for '​attrib1'​ to '​attrib2'​ for the currently selected task|
 |[[#​-cs|-cs]]| <​cost>​ |Modifies the '​Cost'​ for the currently selected task| |[[#​-cs|-cs]]| <​cost>​ |Modifies the '​Cost'​ for the currently selected task|
 |[[#​-ct|-ct]]| <​time>​ |Modifies the '​Completion Time' for the currently selected task| |[[#​-ct|-ct]]| <​time>​ |Modifies the '​Completion Time' for the currently selected task|
 |[[#​-d|-d]]| <id> |Sets the '​Dependency(s)'​ for the currently selected task| |[[#​-d|-d]]| <id> |Sets the '​Dependency(s)'​ for the currently selected task|
-|[[#​-dd|-dd]]| <​date ​[[time|time]]> |Modifies the 'Due Date' (and optionally the time) for the currently selected task|+|[[#​-dd|-dd]]| <date [time]> |Modifies the 'Due Date' (and optionally the time) for the currently selected task|
 |[[#​-dt|-dt]]| <​time>​ |Modifies the 'Due Time' for the currently selected task| |[[#​-dt|-dt]]| <​time>​ |Modifies the 'Due Time' for the currently selected task|
-|[[#​-f|-f]]| <filepath2[[| <filepath3> | <filepath4|| <​filepath3>​ | <​filepath4>​ ]]|Allows additional tasklists to be opened|+|[[#​-f|-f]]| ​%%<path2> [ | <p3> | <p4> ]%% |Allows additional tasklists to be opened|
 |[[#​-fr|-fr]]| <​path>​ |Sets the 'File Link' for the currently selected task| |[[#​-fr|-fr]]| <​path>​ |Sets the 'File Link' for the currently selected task|
 |[[#​-g|-g]]| |Save intermediate file| |[[#​-g|-g]]| |Save intermediate file|
Line 72: Line 73:
 |[[#​-i|-i]]| <​inipath>​ |Specifies an alternative settings file path| |[[#​-i|-i]]| <​inipath>​ |Specifies an alternative settings file path|
 |[[#​-m|-m]]| <​filepath>​ |Imports the specified file| |[[#​-m|-m]]| <​filepath>​ |Imports the specified file|
-|[[#​-md|-md]]| <​date ​[[time|time]]> |Sets the '​Creation Date' (and optionally the time) of the newly created task|+|[[#​-md|-md]]| <date [time]> |Sets the '​Creation Date' (and optionally the time) of the newly created task|
 |[[#​-nt|-nt]]| <​title>​ |Creates a new task in the active tasklist with the specified title| |[[#​-nt|-nt]]| <​title>​ |Creates a new task in the active tasklist with the specified title|
 |[[#​-p|-p]]| <​priority>​ |Modifies the '​Priority'​ for the currently selected task| |[[#​-p|-p]]| <​priority>​ |Modifies the '​Priority'​ for the currently selected task|
Line 79: Line 80:
 |[[#​-r|-r]]| <​risk>​ |Sets the '​Risk'​ for the currently selected task| |[[#​-r|-r]]| <​risk>​ |Sets the '​Risk'​ for the currently selected task|
 |[[#​-s|-s]]| <​status>​ |Sets the '​Status'​ for the currently selected task| |[[#​-s|-s]]| <​status>​ |Sets the '​Status'​ for the currently selected task|
-|[[#​-sd|-sd]]| <​date ​[[time|time]]> |Modifies the 'Start Date'​(and optionally the time) for the currently selected task|+|[[#​-sd|-sd]]| <date [time]> |Modifies the 'Start Date'​(and optionally the time) for the currently selected task|
 |[[#​-st|-st]]| <​time>​ |Modifies the 'Start Time' for the currently selected task| |[[#​-st|-st]]| <​time>​ |Modifies the 'Start Time' for the currently selected task|
 |[[#​-te|-te]]| <hrs> |Sets the 'Time Estimate'​ for the currently selected task| |[[#​-te|-te]]| <hrs> |Sets the 'Time Estimate'​ for the currently selected task|
Line 161: Line 162:
 ''​todolist -tid 6 -cd 2015-07-30T08:​19'' ​   \\ ''​todolist -tid 6 -cd 2015-07-30T08:​19'' ​   \\
  
-As of v7.0.8 a number of days can be added or subtracted to the date field by appending a + or - to the value:+number of days can be added or subtracted to the date field by appending a + or - to the value:
  
 ''​-cd +7'' ​    \\ ''​-cd +7'' ​    \\
Line 195: Line 196:
 At this time text and other selections cannot be forced to a dialog/​window once it opens. So with the Transform example, the window will open but a user must enter specs and click OK to continue. At this time text and other selections cannot be forced to a dialog/​window once it opens. So with the Transform example, the window will open but a user must enter specs and click OK to continue.
  
 +====-copy====
 +===Copies the value for '​attrib1'​ to '​attrib2'​ for the currently selected task===
  
 +This allows attribute values to be copied between different attributes, subject to the following conditions:
 +
 +  * '​attrib1'​ and/or '​attrib2'​ can reference:
 +    * Built-in attributes, using the corresponding command-line identifiers elsewhere on this page
 +    * Custom attributes, using their unique identifier name
 +  * Creation Date and Created By cannot be changed
 +  * The two attributes must have equivalent types ie. Text, Numbers, People
 +  * Some built-in attributes can only be copied to custom attributes and not to other built-in attributes: case Cost, Recurrence, Colour, Percent Completion, Comments, Dependencies,​ File Links.
 +
 +Examples:
 + 
 +|''​-copy md sd''​|Copies a task's creation date to its start date|
 +|''​-copy cd cust_mydate''​|Copies a task's completion date to a custom date attribute|
 +|''​-copy at cust_mylist''​|Copies a task's '​Allocated to' to a multi-list custom text attribute|
 +|''​-copy cs cust_mynumber''​|Copies a task's '​Cost'​ value to a custom number (whole or fractional) attribute|
 +|''​-copy cust_mytext1 cust_mytext2''​|Copies a task's value between two custom text attributes|
 + 
 ====-cs==== ====-cs====
 ===Modifies the '​Cost'​ for the currently selected task=== ===Modifies the '​Cost'​ for the currently selected task===
Line 207: Line 227:
 ''​-cs 0'' ​    \\ ''​-cs 0'' ​    \\
  
-As of v7.0.1 the Cost value can be set to "​0"​ with ""​ or any value resulting in zero including 0 or 0.00. +value can be added or subtracted to the cost field by appending a + or - to the value:
- +
-As of v7.0.8 a value can be added or subtracted to the cost field by appending a + or - to the value:+
  
 ''​-cs +250.25'' ​    \\ ''​-cs +250.25'' ​    \\
Line 218: Line 236:
 ===Modifies the '​Completion Time' for the currently selected task=== ===Modifies the '​Completion Time' for the currently selected task===
  
-New in v7. See the [[#​-cd|-cd]] switch for full information about the Completion Date and Time. This switch allows for setting the time value only.+See the [[#​-cd|-cd]] switch for full information about the Completion Date and Time. This switch allows for setting the time value only.
  
 This switch does not currently support a +/- prefix to add/​subtract to the time. This switch does not currently support a +/- prefix to add/​subtract to the time.
Line 226: Line 244:
 ===Sets the '​Dependency(s)'​ for the currently selected task=== ===Sets the '​Dependency(s)'​ for the currently selected task===
  
-The task ID which follows the -d switch must be complete before the current task can be flagged as completed. Stated another way, the specified task is a requirement/​pre-requisite ​for the current task. More than one such tasks can be specified by enclosing the task IDs in a single space-delimited,​ quoted value: ​   ​+The task ID which follows the -d switch must be complete before the current task can be flagged as completed. Stated another way, the specified task is a requirement/​prerequisite ​for the current task. More than one such tasks can be specified by enclosing the task IDs in a single space-delimited,​ quoted value: ​   ​
 ''​todolist -tid 10 -d "2 6 7"''​ \\ ''​todolist -tid 10 -d "2 6 7"''​ \\
- 
-// Work in Progress. // In v7.0.0-7.0.2 This feature does not appear to be working. 
  
  
Line 243: Line 259:
 ===Modifies the 'Due Time' for the currently selected task=== ===Modifies the 'Due Time' for the currently selected task===
  
-New in v7. See the [[#​-dd|-dd]] switch about the Due Date and Time. This switch allows for setting the time value only.+See the [[#​-dd|-dd]] switch about the Due Date and Time. This switch allows for setting the time value only.
  
 This switch does not currently support a +/- prefix to add/​subtract to the time. This switch does not currently support a +/- prefix to add/​subtract to the time.
Line 303: Line 319:
 ===Alternative INI File=== ===Alternative INI File===
  
-Multiple instances of ToDoList can be executed simultaneously,​ with each each using a different .ini [[[configuration|[Configuration]]] file. If not specified in the command-line,​ the default configuration file is ToDoList.ini,​ in the root folder along with the .exe and .dll files. ​   ​+Multiple instances of ToDoList can be executed simultaneously,​ with each using a different .ini [[configuration|Configuration]] file. If not specified in the command-line,​ the default configuration file is ToDoList.ini,​ in the root folder along with the .exe and .dll files. ​   ​
 ''​C:​\SpecialApps\ToDoList\ToDoList.exe -i "​C:​\Users\me\Documents\Tasks\ToDoListLive.ini"''​ \\ ''​C:​\SpecialApps\ToDoList\ToDoList.exe -i "​C:​\Users\me\Documents\Tasks\ToDoListLive.ini"''​ \\
  
Line 340: Line 356:
 Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero. Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero.
  
-As of v7.0.8 a value can be added or subtracted to the priority field by appending a + or - to the value:+value can be added or subtracted to the priority field by appending a + or - to the value:
  
 ''​-p +1'' ​    \\ ''​-p +1'' ​    \\
Line 375: Line 391:
 Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero. Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero.
  
-As of v7.0.8 a value can be added or subtracted to the risk field by appending a + or - to the value:+value can be added or subtracted to the risk field by appending a + or - to the value:
  
 ''​-r +1'' ​    \\ ''​-r +1'' ​    \\
Line 403: Line 419:
 Setting the time without the date using -sd currently results in an erroneous date of 12/30/1899. See the [[#​-st|-st]] switch to set the time without the date. Setting the time without the date using -sd currently results in an erroneous date of 12/30/1899. See the [[#​-st|-st]] switch to set the time without the date.
  
-As of v7.0.8 a number of days can be added or subtracted to the date field by appending a + or - to the value:+number of days can be added or subtracted to the date field by appending a + or - to the value:
  
 ''​-sd +7'' ​    \\ ''​-sd +7'' ​    \\
Line 461: Line 477:
 ''​-ts 0'' ​    \\ ''​-ts 0'' ​    \\
  
-As of v7.0.8 time can be added or subtracted to the time spent field by appending a + or - to the value:+Time can be added or subtracted to the time spent field by appending a + or - to the value:
  
 ''​-ts +2.5'' ​    \\ ''​-ts +2.5'' ​    \\
command-line.1475454417.txt.gz · Last modified: 2016/10/03 00:26 by admin