TaskFocusedNetBeansUISpec

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