TaskFocusedNetBeansUISpec

(Difference between revisions)
m
 
(12 intermediate revisions not shown)
Line 4: Line 4:
=Task Management=
=Task Management=
-
Dashboard window - placed in IDE explorer area
+
'''Try the [[http://wiki.netbeans.org/wiki/images/8/84/Org-netbeans-modules-tasks-ui.nbm Task Dashboard mockup]], feedback is welcome.'''
 +
 
 +
==Task Dashboard Window==
 +
Main task management window placed in the explorer area of the IDE.
  ===========================================================================
  ===========================================================================
-
  | [AddC] [AddR]                                                           |    '''(Toolbar)'''
+
  | [AddC] [AddR] [Refresh]                                                |    '''(Toolbar)'''
  ===========================================================================
  ===========================================================================
  |                                                                        |
  |                                                                        |
Line 63: Line 66:
* [AddC] - toolbar item with add-category icon
* [AddC] - toolbar item with add-category icon
* [AddR] - toolbar item with add-repository icon
* [AddR] - toolbar item with add-repository icon
 +
* [Refresh] - toolbar item with refresh icon
   
   
-
'''Active Task panel''' - this panel displays currently activated task, ID and Summary of the task is presented and it behaves like a link which opens the active task in a task-editor window. Using '''[v]''' user can easily recall recently activated tasks and re-activate one of them. User can deactivate active task using '''[deactivate]'''.
+
'''Active Task panel''' - this panel displays the currently activated task, ID and Summary of the task are presented and it behaves like a link which opens the active task in a task-editor window. Using '''[v]''' user can easily recall recently activated tasks and re-activate one of them. User can deactivate active task using '''[deactivate]'''.
'''Search panel''' - Only search textfield is displayed.
'''Search panel''' - Only search textfield is displayed.
Line 78: Line 82:
</pre>  
</pre>  
-
After the user enter text into the search textfield, new panel with results is displayed.
+
After the user enters text into the search textfield, new panel with results is displayed.
<pre>
<pre>
Line 105: Line 109:
'''Category node''' - A category node can be expanded to see its tasks. This node consists of a category name a total tasks count and a count of (remotely) changed tasks in the category.
'''Category node''' - A category node can be expanded to see its tasks. This node consists of a category name a total tasks count and a count of (remotely) changed tasks in the category.
-
The context menu of a category node contains following action:
+
The context menu of a category node contains following actions:
* '''Open/Close''' - Open action is available when a category is closed. This action opens (activates) a closed category and moves it to the Categories and Repositories panel. Close action is the opposite, it is available for opened categories. Close action closes a category and moves it to the Closed Categories and Repositories panel. Closed category is not synchronized and it is not taken into account in searching.
* '''Open/Close''' - Open action is available when a category is closed. This action opens (activates) a closed category and moves it to the Categories and Repositories panel. Close action is the opposite, it is available for opened categories. Close action closes a category and moves it to the Closed Categories and Repositories panel. Closed category is not synchronized and it is not taken into account in searching.
-
* '''Delete''' - Removes all tasks from a category and delete it.
+
* '''Delete''' - Removes all tasks from the category and deletes it.
-
* '''Rename''' - Renames a category.
+
* '''Rename''' - Renames the category.
-
* '''Sort''' - Selects sorting mechanism for tasks of a category.
+
* '''Sort''' - Selects sorting mechanism for tasks of the category.
-
* '''Refresh''' - Refreshes all tasks in a category.
+
* '''Refresh''' - Refreshes all tasks in the category.
-
* '''Notification''' - Check-able menu item. A user specifies if he wants to be notified about remote changes within a category and its tasks.
+
* '''Notification''' - Check-able menu item. A user specifies if he wants to be notified about remote changes within the category and its tasks.
''TODO: toolbar - items, placement''
''TODO: toolbar - items, placement''
Line 119: Line 123:
The context menu of a task node contains following actions:
The context menu of a task node contains following actions:
-
* '''Open''' - Opens a new window in the editor which enables a user to review and edit attributes of a task.
+
* '''Open''' - Opens the task-edit window in the editor which enables the user to review and edit attributes of the task.
-
* '''Activate/Deactivate''' - Activate/Deactivate a task - ''TODO - context info''
+
* '''Activate/Deactivate''' - Activates/Deactivates the task - ''TODO - context info''
-
* '''Remove from Category''' - Removes a task from current category.
+
* '''Remove from Category''' - Removes the task from current category.
-
* '''Move to Category''' - A user selects a target category from the sub-menu (containing all categories) and a task is moved from the source category to the selected one.   
+
* '''Move to Category''' - A user selects the target category from the sub-menu (containing all categories) and the task is moved from the source category to the selected one.   
-
* '''Schedule''' - Sets a schedule date, a due date and an estimated time of a task
+
* '''Schedule''' - Sets the schedule date, the due date and the estimated time of the task
-
* '''Refresh''' - Refreshes a tasks.
+
* '''Refresh''' - Refreshes the tasks.
-
* '''Notification''' - Check-able menu item. A user specifies if he wants to be notified about remote changes a task.
+
* '''Notification''' - Check-able menu item. The user specifies if he wants to be notified on task changes.
-
* '''Repository specified actions''' - Actions specified by source repository of a task placed into a sub-menu.
+
* '''Repository-specific actions''' - Actions specific to the source repository of the task - placed into the sub-menu.
Line 133: Line 137:
The context menu of a repository node contains following actions:
The context menu of a repository node contains following actions:
* '''Open/Close''' - Open action is available when a repository is closed. This action opens (activates) a closed repository and moves it to the Categories and Repositories panel. Close action is the opposite, it is available for opened repositories . Close action closes a repository and moves it to the Closed Categories and Repositories panel. Closed repository is not synchronized and it is not taken into account in searching.
* '''Open/Close''' - Open action is available when a repository is closed. This action opens (activates) a closed repository and moves it to the Categories and Repositories panel. Close action is the opposite, it is available for opened repositories . Close action closes a repository and moves it to the Closed Categories and Repositories panel. Closed repository is not synchronized and it is not taken into account in searching.
-
* '''Edit''' - Allows a user to change attributes of a repository e.g. username, password.
+
* '''Edit''' - Allows the user to change attributes of a repository e.g. username, password.
-
* '''Remove Repository''' - Removes a repository from the dashboard.
+
* '''Remove Repository''' - Removes the repository from the dashboard and IDE.
-
* '''Create Task''' - Creates a new task in a repository.
+
* '''Create Task''' - Creates a new task in the repository. Opens a new-task window in the editor.
-
* '''Search in Repository''' - Opens new search window. Using this window a user can search a repository, create queries or find and open tasks.
+
* '''Search in Repository''' - Opens new search window. Using this window the user can search a repository, create queries or find and open tasks.
-
* '''Refresh''' - Refreshes all queries in a repository.
+
* '''Refresh''' - Refreshes all queries in the repository.
''TODO: toolbar - items, placement''
''TODO: toolbar - items, placement''
-
'''Query node''' - A query node consists of a query name, a total count tasks and count of new or changed tasks in the query (similar to a category node). Each count is presented as a link to a detailed list of tasks that the count represents.
+
'''Query node''' - A query node consists of a query name, a total count of tasks and count of new or changed tasks in the query (similar to a category node). Each count is presented as a link to a detailed list of tasks that the count represents in the editor window.
The context menu of a query node contains following actions:
The context menu of a query node contains following actions:
-
* '''Open''' - Shows list of all tasks contained in a query.
+
* '''Open''' - Shows detailed list of all tasks contained in the query.
-
* '''Edit''' - Allows a user to change parameters of a query.
+
* '''Edit''' - Allows the user to change parameters of the query.
-
* '''Delete''' - Deletes query.
+
* '''Delete''' - Deletes the query.
-
* '''Refresh''' - Refreshes a query.
+
* '''Refresh''' - Refreshes the query.
-
* '''Notification''' - Check-able menu item. A user specifies if he wants to be notified about remote changes of tasks in a query.
+
* '''Notification''' - Check-able menu item. The user specifies if he wants to be notified about remote changes of tasks in the query.
-
 
+
===To-Do items===
-
=To-Do items=
+
* '''icons''' - use icons e.g. for priority of the task?
* '''icons''' - use icons e.g. for priority of the task?
Line 163: Line 166:
* '''Toolbar''' - how to design toolbar of nodes (category, repository, query...)
* '''Toolbar''' - how to design toolbar of nodes (category, repository, query...)
 +
 +
==Task Window==
 +
This window allows the user to review and edit task attributes along with setting schedule dates and adding private notes. '''Work in Progress'''
 +
 +
==================================================================================================================================================
 +
| 182540 - AIOOBE at TaskList.clear()                                                                                      [A/D icon]|[Ref icon]
 +
==================================================================================================================================================
 +
| [-] My Private Task Details
 +
+-------------------------------------------------------------------------------------------------------------------------------------------------
 +
|                  +-----------------+-+
 +
|    Category:      |(none)          |v|
 +
|                  +-----------------+-+
 +
|
 +
|                  +-----------------+-+              +-----------------+-+                      +---+
 +
|    Start date:    |Sun, 11/30/2012  |v|    Due date: |Wed, 23/30/2012  |v|    Estimate[hours]:  | 2 |
 +
|                  +-----------------+-+              +-----------------+-+                      +---+
 +
|
 +
|    Notes:
 +
|    +-------------------------------------------------------------------------------------------------------------------------------+
 +
|    ||                                                                                                                              |
 +
|    |                                                                                                                              |
 +
|    |                                                                                                                              |
 +
|    |                                                                                                                              |
 +
|    +-------------------------------------------------------------------------------------------------------------------------------+
 +
==================================================================================================================================================
 +
|        (task specific actions toolbar)
 +
==================================================================================================================================================
 +
|
 +
|        (task specific attributes panel)
 +
|
 +
|
 +
|
 +
==================================================================================================================================================
 +
 +
'''Toolbar items:'''
 +
* [A/D icon] - IconButton - Activates/Deactivates the task
 +
* [Ref icon] - IconButton - Refreshes the task
 +
* (Task specific actions) - Actions specific to the task/repository type, e.g. Bugzilla, JIRA
 +
* ''TODO - do we want notification setting in this window?''
 +
 +
'''My Private Task Details'''
 +
* private panel contains private attributes of the task, these attributes are common for all types of tasks
 +
* Category - The user can add the task to the dashboard by setting the category using this combo-box. Setting the category as "(none)" removes the task from the dashboard.
 +
* Start date - The user sets the schedule date using date picker.
 +
* Due date - The user sets the due date using date picker.
 +
* Estimate - The user set estimate time (in hours) in the text field.
 +
* Notes - The user can add notes using this text area.
 +
 +
'''Task specific attributes panel'''
 +
* the content of this panel depends on a type of the task, in general it contains few (most likely collapsible) blocks of attributes
 +
 +
=== Update 4/2/2012 ===
 +
The following mockup shows a rendition of the Task Dashboard with the addition of grouping, sorting, and filtering controls:
 +
 +
* [[Media:Group_Sort_Filter.PNG]]

Current revision as of 13:19, 5 April 2012

User Interface specification for TaskList and related parts of the Task-Focused NetBeans project.

See also Use-Cases

Contents

Task Management

Try the [Task Dashboard mockup], feedback is welcome.

Task Dashboard Window

Main task management window placed in the explorer area of the IDE.

===========================================================================
| [AddC] [AddR] [Refresh]                                                 |    (Toolbar)
===========================================================================
|                                                                         |
| [182540 - AIOOBE at TaskList.clear()]   [v]   [deactivate]              |    (Active task panel)
|                                +-----------+                            |
+--------------------------------|(recently  |----------------------------+
|                                |activated  |                            |
|  (Search panel)                |tasks}     |                            |    (Search panel)
|                                +-----------+                            |
===========================================================================
| [-] [c] Fix (total 3|changed 1)                                     [x] |
|-------------------------------------------------------------------------|
|    [p] 182540 - AIOOBE at TaskList.clear()                              |
|                                                                         |
|    [p] 257931 - NPE at NavigatorComponent.resultChanged                 |
|                                                                         |
|    [p] 198540 - Code Navigator window (click and animation)             |
|                                                                         |
+-------------------------------------------------------------------------+
| [+] [c] Evaluate (total 23|changed 4)                               [x] |    (Categories and Repositories)
+-------------------------------------------------------------------------+     
| [+] [c] Performance (total 5|changed 0)                             [x] |
+-------------------------------------------------------------------------+
| [+] [c] This week (total 6|changed 0)                               [x] |
+-------------------------------------------------------------------------+
| [-] [r] NetBeans Bugzilla                                           [x] |
|-------------------------------------------------------------------------|
|    Progress API ([total 21]|[changed or new 4])                         |
|                                                                         |
|    Navigator SPI ([total 11]|[changed or new 6])                        |
|                                                                         |
===========================================================================
| Closed                                                                  |
===========================================================================
|  [c] Fix Ant                                                        [o] |
+-------------------------------------------------------------------------+
|  [c] 7.2 release                                                    [o] |    (Closed Categories and Repositories)
+-------------------------------------------------------------------------+     
|  [r] Ant Jira                                                       [o] |
+-------------------------------------------------------------------------+
|  [r] Test GitHUB                                                    [o] |
===========================================================================

[o] - open-icon button - open category/repository move it to the Categories and Repositories panel

[x] - close-icon button - close category/repository move it to the Closed Categories and Repositories panel

[p] - priority icon - represents priority of a task

[c] - category icon

[r] - repository icon

Toolbar items:

  • [AddC] - toolbar item with add-category icon
  • [AddR] - toolbar item with add-repository icon
  • [Refresh] - toolbar item with refresh icon

Active Task panel - this panel displays the currently activated task, ID and Summary of the task are presented and it behaves like a link which opens the active task in a task-editor window. Using [v] user can easily recall recently activated tasks and re-activate one of them. User can deactivate active task using [deactivate].

Search panel - Only search textfield is displayed.

+-------------------------------------------------------------------------+
|             +-------------------------------+                           |
|[+]  Search: |                               |                           |
|             +-------------------------------+                           |
===========================================================================
| [-] [c] Fix (total 3|changed 1)                                     [x] |
|-------------------------------------------------------------------------|
|                              ...                                        |

After the user enters text into the search textfield, new panel with results is displayed.

+-------------------------------------------------------------------------+
|              +-------------------------------+                          |
| [-]  Search: |Navigator                      |                          |
|              +-------------------------------+                          |
|   +-------------------------------------------------------------------+ |
|   |[p] 257931 - NPE at NavigatorComponent.resultChanged               | |
|   |                                                                   | |
|   |[p] 198540 - Code Navigator window (click and animation)           | |
|   |                                                                   | |
|   |                                                                   | |
|   |        (height up to X entries, then scrolling)                   | |
|   |                                                                   | |
|   +-------------------------------------------------------------------+ |
===========================================================================
| [-] [c] Fix (total 3|changed 1)                                     [x] |
|-------------------------------------------------------------------------|
|                                 ...                                     |

Categories and Repositories - a list of user-specified categories and repositories which the user is currently using.


Category node - A category node can be expanded to see its tasks. This node consists of a category name a total tasks count and a count of (remotely) changed tasks in the category.

The context menu of a category node contains following actions:

  • Open/Close - Open action is available when a category is closed. This action opens (activates) a closed category and moves it to the Categories and Repositories panel. Close action is the opposite, it is available for opened categories. Close action closes a category and moves it to the Closed Categories and Repositories panel. Closed category is not synchronized and it is not taken into account in searching.
  • Delete - Removes all tasks from the category and deletes it.
  • Rename - Renames the category.
  • Sort - Selects sorting mechanism for tasks of the category.
  • Refresh - Refreshes all tasks in the category.
  • Notification - Check-able menu item. A user specifies if he wants to be notified about remote changes within the category and its tasks.

TODO: toolbar - items, placement


Task node - A task node presents basic information about a task (most likely ID - summary of a task).

The context menu of a task node contains following actions:

  • Open - Opens the task-edit window in the editor which enables the user to review and edit attributes of the task.
  • Activate/Deactivate - Activates/Deactivates the task - TODO - context info
  • Remove from Category - Removes the task from current category.
  • Move to Category - A user selects the target category from the sub-menu (containing all categories) and the task is moved from the source category to the selected one.
  • Schedule - Sets the schedule date, the due date and the estimated time of the task
  • Refresh - Refreshes the tasks.
  • Notification - Check-able menu item. The user specifies if he wants to be notified on task changes.
  • Repository-specific actions - Actions specific to the source repository of the task - placed into the sub-menu.


Repository node - A repository node can be expanded to see user-specified queries. This node consists of a repository name.

The context menu of a repository node contains following actions:

  • Open/Close - Open action is available when a repository is closed. This action opens (activates) a closed repository and moves it to the Categories and Repositories panel. Close action is the opposite, it is available for opened repositories . Close action closes a repository and moves it to the Closed Categories and Repositories panel. Closed repository is not synchronized and it is not taken into account in searching.
  • Edit - Allows the user to change attributes of a repository e.g. username, password.
  • Remove Repository - Removes the repository from the dashboard and IDE.
  • Create Task - Creates a new task in the repository. Opens a new-task window in the editor.
  • Search in Repository - Opens new search window. Using this window the user can search a repository, create queries or find and open tasks.
  • Refresh - Refreshes all queries in the repository.

TODO: toolbar - items, placement


Query node - A query node consists of a query name, a total count of tasks and count of new or changed tasks in the query (similar to a category node). Each count is presented as a link to a detailed list of tasks that the count represents in the editor window.

The context menu of a query node contains following actions:

  • Open - Shows detailed list of all tasks contained in the query.
  • Edit - Allows the user to change parameters of the query.
  • Delete - Deletes the query.
  • Refresh - Refreshes the query.
  • Notification - Check-able menu item. The user specifies if he wants to be notified about remote changes of tasks in the query.

To-Do items

  • icons - use icons e.g. for priority of the task?
  • annotations - how to annotate new/changed/active/... tasks in the dashboard
  • show in dashboard - navigate from the task-editor window to the same task in the dashboard
  • sorting - set sorting for whole dashboard or every category can have its own sorting
  • Toolbar - how to design toolbar of nodes (category, repository, query...)

Task Window

This window allows the user to review and edit task attributes along with setting schedule dates and adding private notes. Work in Progress

==================================================================================================================================================
| 182540 - AIOOBE at TaskList.clear()                                                                                       [A/D icon]|[Ref icon]
==================================================================================================================================================
| [-] My Private Task Details
+-------------------------------------------------------------------------------------------------------------------------------------------------
|                   +-----------------+-+
|    Category:      |(none)           |v|
|                   +-----------------+-+
|
|                   +-----------------+-+               +-----------------+-+                       +---+
|    Start date:    |Sun, 11/30/2012  |v|     Due date: |Wed, 23/30/2012  |v|     Estimate[hours]:  | 2 |
|                   +-----------------+-+               +-----------------+-+                       +---+
|
|    Notes:
|    +-------------------------------------------------------------------------------------------------------------------------------+
|    ||                                                                                                                              |
|    |                                                                                                                               |
|    |                                                                                                                               |
|    |                                                                                                                               |
|    +-------------------------------------------------------------------------------------------------------------------------------+
==================================================================================================================================================
|        (task specific actions toolbar)
==================================================================================================================================================
|
|        (task specific attributes panel)
|
|
|
==================================================================================================================================================

Toolbar items:

  • [A/D icon] - IconButton - Activates/Deactivates the task
  • [Ref icon] - IconButton - Refreshes the task
  • (Task specific actions) - Actions specific to the task/repository type, e.g. Bugzilla, JIRA
  • TODO - do we want notification setting in this window?

My Private Task Details

  • private panel contains private attributes of the task, these attributes are common for all types of tasks
  • Category - The user can add the task to the dashboard by setting the category using this combo-box. Setting the category as "(none)" removes the task from the dashboard.
  • Start date - The user sets the schedule date using date picker.
  • Due date - The user sets the due date using date picker.
  • Estimate - The user set estimate time (in hours) in the text field.
  • Notes - The user can add notes using this text area.

Task specific attributes panel

  • the content of this panel depends on a type of the task, in general it contains few (most likely collapsible) blocks of attributes

Update 4/2/2012

The following mockup shows a rendition of the Task Dashboard with the addition of grouping, sorting, and filtering controls:

Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo