User Tools

Site Tools


task-attributes

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
task-attributes [2016/10/01 04:05]
admin
task-attributes [2017/05/30 05:02] (current)
admin
Line 1: Line 1:
 ====== Task Attributes ====== ====== Task Attributes ======
  
-This page describes ​all the attributes available on an individual ​task. +This page describes the various built-in ​attributes available on a given task and how they can be edited.
  
 {{images:​screenshots:​task-attributes.png}} {{images:​screenshots:​task-attributes.png}}
  
-====Common concepts relating to Attributes==== +Some attributes can only be edited via their associated fields, some attributes can only be edited by clicking directly on the associated column, some can also be edited/​modified via the [[edit-menu|Edit Menu]]and some can be edited in multiple ways. Finally, some attributes are read-only.
-  * [[#people|People]] +
-  * [[#​droplists|Droplists]] +
-  * [[#​default_field_values|Default Field Values]] +
-  * [[#​field_inheritance|Field Inheritance]] +
-  * [[#​dates_and_times|Dates ​and Times]] +
-  * [[#​time_units|Time Units]]+
  
-| **Name**           | **Column**     ​| **Description** |                                                                                              ​ +Note: All editable attributes can be considered entirely optional, meaning that they do not require you to enter any value. 
-| Allocated By       | By             | A single [[#​person|person]] who assigned the task. This could be the source of the task, a manager, or an individual responsible party. See [[#​droplists|Droplists]]. ​Note that the text By is used in the grid column for both Created By and Allocated By. + 
-| Allocated To       | To             | [[#​people|People]] assigned to process ​the task. This is multi-check field where the list of available people is specific to the tasklist. See [[#​droplists|Droplists]]. Multiple values in the grid are separated by a comma. ​+Name               ^ Column ​        ^ Description ​  ^ Edit       ​^ ​     
-| Category ​          | Cat.           | One or more groups ​or types associated with the task. This could be a departmentPersonal versus ​Work, an evaluation like Simple ​or Complex, ​a Location or Department, or any other term to allow for filtering and sorting of tasks. See [[#​droplists|Droplists]]. Multiple values ​in the grid are separated by a comma. See also Tags below. ​+| Allocated By       | By             | A single [[attribute-concepts#​person|person]] who assigned the task.\\ This could be the source of the task, a manager, or an individual responsible party.\\ See also: [[attribute-concepts#​droplists|Droplists]]. ​| Field 
-| Colour ​            ​| ​None           | A task can be set to any custom color. Select several tasks and then set the color to make them visually stand out. However, other settings of higher precedence may force the color of a task to be different from the task-level setting. ​See [[colours|Colours]] for in-depth information about how colors work. Note that while a task is selected the color of the row in the grid is based on the theme color settings only apply to unselected grid rows.   | +| Allocated To       | To             ​| ​One or more [[attribute-concepts#​people|People]] assigned to carry out the task.\\ Multiple values are separated by comma in the grid.\\ See also: [[attribute-concepts#​droplists|Droplists]] ​| Field 
-| Comments ​          ​None           | Free-form text can be added to any task. Comments can be added in Simple Text, with no formatting. They can also be entered in Rich Text with fonts, ​colors, styles, text sizing, images, tables, etc. See [[task-comments|Task Comments]] for in-depth information about this field. ​+| Category ​          | Cat.           | One or more groups ​into which the task fits.\\ eg. '​Personal'​'Work''Simple', 'Complex'etc. Multiple values are separated by a comma in the grid. See also: [[attribute-concepts#​droplists|Droplists]] | Field 
-| Completed Date     | Completed ​     | This field defaults to "​today"​ unless it is set to another ​date. When the date is set, the Completed Checkbox is checked. ​See [[completed-tasks|Completed Tasks]] ​for more information on this topic. ​+| Colour ​            ​| ​(none) ​          | The text colour ​to be used for the task\\ See also: [[user-interface-fonts-colours-prefs|Font & Colour Preferences.]] | Field | 
-| Completed Time     | (Follows ​Date) | For some purposes it's important to know the time when a task was completed. This field is available but can be removed if not desired for a specific tasklist. | +| [[task-comments|Comments]] (none) ​          | Free-form text as [[simple-text-comments|Simple Text]], with no formatting, or [[rich-text-comments|Rich Text]] with fonts, ​colours, styles, text sizing, images, tables, etc.| Field 
-| Completed Checkbox | {{images:​screenshots:​checkbox.png}} | A task is considered complete when the checkbox with the Completed Date is set in the edit area, or when the Completed Checkbox column in the grid is checked. These checkboxes are linked. Checking this box may affect he status: In Preferences >  Tasks >  Attribute Calculations is an option for "After completing ​a task, set its '​Status'​ to ...." and in the textbox enter a status like "​Complete"​. See [[completed-tasks|Completed Tasks]] ​for more information on this topic. | +| Completed Date     | Completed ​     | The date on which work on a task was completed.\\ See also [[completed-tasks|Completed Tasks]], Completed Check Box (below) | Field 
-| Cost               | Cost           ​| ​An integer or decimal ​value can be entered to represent ​the monetary cost for a task, where other fields are related to time. No currency types are associated with costlike euros or dollars. "Local currency" ​is assumed. | +| Completed Time     | (follows ​Date) | The associated ​time that a task was complete| Field 
-| Created By         | By             ​| ​The user ID used to login to the PC is also used to set the Created By field which identifies the person who created a taskNote that the text By is used in the grid column for both Created By and Allocated By. | +| Completed Checkbox | {{images:​screenshots:​checkbox.png}} | Provides ​the simplest way to mark a task as completed. See also: [[completed-tasks|Completed Tasks]], Completed Date (above)| Column-click ​
-| Creation Date      | Created ​       | A timestamp ​which is assigned by the software to alll new tasks. ​The value cannot be manually modified. ​+| Cost               | Cost           ​| ​value representing ​the monetary cost of undertaking ​a task. No explicit ​currency types are associated with this attribute'Local currency' ​is assumed. ​| Field 
-| Dependency ​        | {{images:​screenshots:​dependency.png}} | A task is dependent on another task when it has a Dependency set to another task ID. That is, if task 208 depends on task 54, it has Dependency set to 54, and task 54 must be completed in order for 208 to complete. The Completed Checkbox cannot be set on a task unless its dependency is completed first. In the edit field, manually enter the task ID of another task. Multiple IDs can be separated with a comma to indicated all of the other tasks must be completed before ​the current ​task. The "​eyeglasses"​ (look at) icon in the edit field allows the grid selection to jump from a dependent task to its first dependency (no others). In the grid, tasks with dependency have a small ToDoList icon in the  < < column. A task with other tasks dependent on it does not have a link to its dependent tasks. A Dependency can also be set graphically in the Gantt Chart View.  ​+| Created By         | By             ​| ​By default your computer login ID is used for this field. ​You can change this value in the [[task-defaults-prefs|Preferences]]| (read-only) ​
-| Due Date           | Due            | Some tasks have a date by which they should or must be completed. ​For some projects there is no due date, tasks simply need to be done. If the Due Date is set, then the color of the task line changes if the due date has passed. See [[colours|Colours]]. The Start Date and Due Date are used to show the span of a task in the Calendar ​View and the Gantt ViewBoth fields can also be set graphically in the Gantt Chart View. The default can be set in Preferences ​>  Tasks >  Defaults >  Task Attributes >  Default Attributeswhere either the Date of Creation will be used or the field will be empty for a new task. See the Time Estimated field, as changing the Due Date can affect that field. ​+| Creation Date      | Created ​       | A time-stamp ​which is assigned by the software to all new tasks. ​| Read-only ​
-| Due Time           ​| ​               ​| Some tasks must be completed by a specific time. If the Due Time is not set, the default is 11:59pm, meaning the task should be completed by the end of the day. ([[https://github.com/​abstractspoon/​todolist_resources/​issues/​12|Issue 12]] suggests an enhancement to set the default in [[preferences|Preferences]].) ​+| Dependency ​        | {{images:​screenshots:​dependency.png}} | Defines ​the ID of another task which must be completed before ​'​this' ​task can be marked as complete.\\ See also: [[dependencies|Task Dependencies]][[completed-tasks|Setting ​Task as Complete]]. ​ | Field, [[gantt-view|Gantt Chart View]] 
-| External ID        | Ext.ID ​        | An External ID can be set to refer to a bug tracking system, customer ID, customer service ticket, or any other application. ​The field is for reference only. An ideal use is with [[user-defined-tools|User-Defined Tools]] ​(UDT) to open the external app for the currently selected task. | +| Due Date           | Due            | Specifies ​a date by which a task should or must be completed. ​This date will also be used to show the span of a task in the [[calendar-view|Calendar]] and [[gantt-view|Gantt]] Views.\\ See also: [[user-interface-fonts-colours-prefs|Font & Colour ​Preferences]][[task-calcs-prefs|Attribute Calculation Preferences]]| Field 
-| File Link          | {{images:​screenshots:​file-link.png}} | Multiple files can be referenced from the local/networked file system. Examples of files might include screenshots image files or documentation files. You can also paste URL into this fieldWhile an entry is selected and highlighted,​ if you replace that entry it actually does an add of the new entryThe top file link is pushed down and the new link is pushed onto the top of the stackCaution: In the [[edit-menu#edit_menu|Edit Menu]] ​under Other Task Attributes, the Set Task File Link option displays the standard open file dialog for you to associate a single file with the selected task. While more than one file link can be associated with a task, this option currently only allows one link to be assigned to that field. ​+| Due Time           ​| ​(follows date) | Some tasks must be completed by a specific time of day. If this time is not set, it defaults to the end of the day ie11:59PM. | Field 
-| Flag               | {{images:​screenshots:​flag.png}} | An additional way to identify ​an important task | +| External ID        | Ext.ID ​        | An External ID can be set to refer to a bug tracking system, customer ID, customer service ticket, or any other application. ​This attribute ​is ideal for use is with [[user-defined-tools|User-Defined Tools]] to open the external app for the currently selected task. | Field 
-| Icon               | {{images:​screenshots:​icon.png}} | An icon to help identify a particular task | +| File Link          | {{images:​screenshots:​file-link.png}} | Allows you to associate one or more local files or URLs with taskegA specification document| Field, Drag-Drop, ​[[edit-menu|Edit Menu]] | 
-| ID                 | ID             | A unique ​sequential numeric identifier ​which is assigned by the software. ​The value cannot be manually modified. The ID counter is unique ​to each tasklist. | +| Flag               | {{images:​screenshots:​flag.png}} | An additional way to highlight ​an important task | Column-click,​ [[edit-menu|Edit Menu]]
-| Parent ID          | PID            | All sub-tasks (child tasks) include the ID of their immediate parent ​task.| +| Icon               | {{images:​screenshots:​icon.png}} | A single ​icon to help identify a particular task | Column-click,​ [[edit-menu|Edit Menu]]
-| Percent Complete ​  ​| ​             This is a calculated field in accordance with Preferences. Details are available on the specializes in [[calculated-fields|Calculated Fields]]. | +| ID                 | ID             | A unique ​number ​which is assigned by the software ​for identification purposesIDs are only unique ​within a specific ​tasklist. ​| (read-only) | 
-| Priority ​          | {{images:​screenshots:​priority.png}} | Task Prioritization is extremely important ​in any project management system. Tasks with a higher numeric priority are more important than those with a lower priority. These should be processed sooner than other tasks. A task can have No Priority ​to modify its importance. ​The value can be set from 0 (Lowest) ​to 10 (Highest). See [[priority-and-risk|Priority and Risk]] ​for more information on this concept. Priority is associated with Risk. +| Modified Date      | Last Mod.      | The date and time the task was last modified (by anyone). ​ | (read-only) ​
-| Recently Modified ​ | *      | Indicates whether a given task has been modified within a user-definable time period eg. 5 hours or 2 weeks | +| Parent ID          | PID            | The ID of a task'​s ​immediate parent. ​| (read-only) ​
-| Recurrence ​        | Recurs | The default is for every task to only be performed Once. But single ​task might be performed more than onceTo schedule a tasks to recur (occur again), a complex set of values are used. For example, a task might recur every year on March 3rd, or every other Tuesday, or on the 1st and 15th of every month. This might continue without end or there might only be a limited number of events. For example, a client's maintenance agreement might entitle them to four quarterly checkups for a period of 2 years. When the current task is completed, based on the Recurrence settings the same task might be used for future events, or a new task might be created automatically for each event. See [[[recurrence|[Recurrence]]] for more information on this complex concept. | +| Percent Complete ​  | %              The amount of the task effort that has been completed so far.\\ See also: [[task-calcs-prefs|Attribute Calculation Preferences]]. | Field, [[edit-menu|Edit Menu]]
-| Remaining Time     | {{images:​screenshots:​remaining-time.png}} ​ | The difference between ​the Time Estimate and Time Spent +| Priority ​          | {{images:​screenshots:​priority.png}} | A value in the range 0-10 to indicate the relative ​importance ​of completing this task ahead of othersWhere this is not appropriate the priority ​can be set to '<​None>'​.\\ See also: [[priority-and-risk|Priority and Risk]] ​| Field 
-| Reminder ​          | {{images:​screenshots:​reminder.png}} ​ | An indication of whether there is an active reminder for the task | +| Recently Modified ​ | *      | Indicates whether a given task has been modified within a user-definable time period eg. 5 hours or 2 weeks.\\ See also: [[task-calcs-prefs|Attribute Calculation Preferences]]. | Read-only ​
-| Risk               | {{images:​screenshots:​risk.png}} | The concept ​of Risk is often used to help determine Priority. For example, if a task has a higher risk of failure, a manager might increase or decrease the Priority. See [[priority-and-risk|Priority and Risk]] ​for more information on this concept. ​| +| Recurrence ​        | Recurs | How often and when a task repeats eg'Every second ​Tuesday ​in June'.\\ See also: [[recurrence|[Recurrence ​(Repeating) Tasks]]. | Field, Column-click,​ [[edit-menu|Edit Menu]] ​
-| Status ​            | Status ​        | The Status is the state of the current task. The value is selected from a dropdown and all values defined in Preferences are available to all tasklists. Examples include Assigned, In Progress, Need Info, Testing, Completed. See [[#​droplists|Droplists]]. This field is changed manually as the status of the task changes. Exactly how the field is used is subject to preference. Some people might set Status to "In Testing"​ when as a task enters the testing phase. When testing is completed, is there a "​Testing Complete"​ status? Or does the task remain in Testing until it moves to Deployment? It's easy to forget to change the status as work is performed. Some people might prefer a system where tasks are simply Not Started or Complete. There are no specific rules for when to set Status or what values to use. See the Completed Checkbox field above about how the Status field can be modified by other changes. ​+| Remaining Time     | {{images:​screenshots:​remaining-time.png}} ​ | This a read-only (calculated) value expressing ​ how much time there remains to complete ​the task. See also: [[task-calcs-prefs|Attribute Calculation Preferences]] | (read-only) ​
-| Start Date         | Start          | The Start Date can be the future ​anticipated date of when a task will start. If in the past it might be the date on which processing of the task actually startedFor some projects there is no start date, tasks simply need to be done. The Start Date and Due Date are used to show the span of a task in the Calendar ​View and the Gantt ViewBoth fields can also be set graphically in the Gantt Chart View. The default can be set in Preferences ​>  Tasks >  Defaults >  Task Attributes >  Default Attributeswhere either the Date of Creation will be used or the field will be empty for a new task. See the Time Estimated field, as changing the Start Date can affect that field. ​+| Reminder ​          | {{images:​screenshots:​reminder.png}} ​ | Indcates ​whether ​or not there is an active reminder for the task | Column-click,​ [[edit-menu|Edit Menu]] ​
-| Start Time         | (Follows Date) | Some tasks must be started at a specific time. If the Start Time is not set, the default ​is 12:00am, meaning ​the task can be started at any timeor that the time when the task was started is not important. | +| Risk               | {{images:​screenshots:​risk.png}} | A value in the range 0-10 to indicate the relative '​danger' ​of undertaking this task. Where this is not appropriate the risk can be set to '<​None>'​. See also: [[priority-and-risk|Priority and Risk]] | Field 
-| Tags               | Tags           ​| ​A Tag is similar ​to a Category (see above) in that the field helps to organize ​tasks into groupsOne significant difference ​is that the Category droplist is application-widewhile the scope of Tags are limited to single tasklist. The tag "​car"​ used in a list of home projects would not apply to client projects. The tag "​Robert"​ would only apply to a client tasklist where there is a person with that name - it may not make sense to +| Start Date         | Start          | The (futuredate you anticipate starting work on this task. This date will also be used to show the span of a task in the [[calendar-view|Calendar]] and [[gantt-view|Gantt]] Views.\\ See also [[user-interface-fonts-colours-prefs|Font & Colour ​Preferences]][[task-calcs-prefs|Attribute Calculation Preferences]]| Field 
 +| Start Time         | (follows date) | Some tasks must be started at a specific time of day. If this time is not set, it is assumed to be the start of the day ie. 12:00AM. | Field | 
 +| Status ​            | Status ​        | A single value indicating ​the current state of a task. eg. '​Assigned'​'In Progress',​ 'Need Info', '​Testing',​ '​Completed'​.\\ See also: [[attribute-concepts#​droplists|Droplists]]. | Field. | 
 +| Tags               | Tags           ​| ​One or more words used to describe aspects of task that can be used to organise or [[find-tasks-dialog|Find Tasks]].\\ See also: [[attribute-concepts#​droplists|Droplists]]. | Field | 
 +| Task Title         | Title          | The name of your task.\\ This is the only **mandatory editable** attribute. | Column-click[[edit-menu|Edit Menu]] | 
 +| Version ​           | Ver.           | A single value representing ​the version ​of a product the task relates ​to (mainly related ​to software). | Field |
task-attributes.1475294738.txt.gz · Last modified: 2016/10/01 04:05 by admin