Outlook Taskboard aka JanBan

Outlook Taskboard is a kanban board style view for Outlook Tasks.

I found the original Kanban board implemented by Evren Varol. I looked at the forks and liked the changes by BillyMcSkintos, using the task status instead of folders. But he lost the drag&drop feature.

So I decided to take my own fork and added a bunch of features, and added some options to the configuration file.

In the meantime I (and others) have done so many changes that I decided to rename the project to JanBan

My changes:

1. Added colours to task categories
2. Tasks folder is now the Backlog folder
3. Use new folder 'Kanban' for all the current work: Next, InProgress, Waiting and Done
4. Removed Add button at InProgress and Waiting lanes. Tasks can only be added to Backlog and Next
5. Drag and drop now sets the new status
6. Introduced date format in config file
7. Drag & Drop now also works properly when filter is active
8. Use another icon for archiving of completed icons, for better difference from the edit icon
9. Removed editing option for completed tasks
10. Display Completion Date for completed tasks instead of Due Date
11. Implemented filter on private / non-private tasks (button top right)
12. If one of the task folders in the config does not exist, then it is created
13. Optional saving of filter state via CONFIG file
14. Optional use of privacy filter via CONFIG file
15. Added configuration for what to do with completed tasks (Nothing, Archive, Hide, Delete)
16. Added "Filter on start date" configuration option to Backlog folder/column to hide tasks with start date in the future
17. Added configuration options to show/hide 'Owner' and '% complete' per column
18. Added configuration option to enable/disable auto refresh of the taskboard
19. Added configuration option to show/hide sections in the report
20. Added configuration option to make task lanes active or inactive
21. Added help screen
22. Added configuration screen (journal item)
23. Tested with recurring tasks. Works perfectly :-)
24. Added new config option: AUTO_TASK_START. When true, then tasks that have start date today or earlier will be moved to the NEXT lane automatically.
25. Added new config option: Display Total Work hours for task item

TODO:

• Add tooltips to the buttons
• Look into performance issues, because currently it re-reads the tasks from Outlook quite often
• Implement error logging by sending a mail to myself
• More configuration and customization options
• And finally a rewrite using React. Why? Firstly, because I want to get experience with it, and secondly, it is said to be faster

----- End -----

BillyMcSkintos' additions to the original Readme file:

----- 05/15/17 ------ Credit for this fork goes entirely to @evrenvarol. I have made a few simple changes to suit my needs:

1. Removed Focus Column
2. Added CSS to color columns
3. Added Owner
4. Added Task %
5. Columns are no-longer drag and drop. Tasks move from column to column with the Outlook task status. 5.a. Must add and use a category of !Next to move a task to the appropriate column. ----- End -----

The original Readme file of Evren Varol with all instructions:

It uses the main "Tasks" folder as Back Log and utilizes 5 individual subfolders (InProgress, Next, Focus, Waiting and Completed) as each task lane for personal kanban workflow.

There are 2 ways to use the taskboard.

1. Outlook Folder Home Page (recommended)
2. Directly from Internet Explorer

Moving Tasks between task lanes

Filtering Tasks

Platforms supported

Only tested with Outlook 2013 and 2016 running on Windows 8.1/10.

It may also work with earlier Outlook versions, and possibly work with Windows 7.

The taskboard can also be opened in Internet Explorer. Due to limitations with ActiveX controls, only Internet Explorer 9/10 and 11 are supported.

Basic Setup

1. Download the latest release zip file and extract it to a folder in your local hard drive.

2. In Outlook, create following folder structure under your Tasks folder (it is easier to use the Folders view to create these folders):

   

3. For Outlook Home page:

• Create another folder (of any type) and name it something like "Taskboard" or "Kanban", etc. (Alternatively you can use the main account folder as a home page as well)

• Right-click the folder, and then click Properties. Select the Home Page tab in the Properties dialog box.

• In the Address box, browse to the folder you have just extracted the Taskboard files and select the kanban.html file.

• Click to select the Show home page by default for this folder check box and then click OK.

  

  _{If you receive above warning, simply click X icon to close both warning prompt and the Properties window.}

4. For Internet Explorer:

• Open Internet Explorer and go to Tools > Internet Options > Security tab. Select the Local Intranet Zone and click on the Custom Level button. Ensure the "Initialize and script ActiveX controls not marked as safe for scripting" option is set to Enabled

• Double-click on the kanban-ie.html file to open the page in Internet Explorer.

  _{On Win10, you will need to right click on the file, select Open With -> Internet Explorer to open the page in IE11. Otherwise it tries to open in Edge which is not supported.}

Advanced Setup

The configuration file (config.js) under the js folder can be edited to customise task lane limits, titles and some other settings.

Task Lane Folder Names and Titles

    'FOCUS_FOLDER':     { Name: 'Objectives-2016', Title: 'OBJECTIVES', Limit: 0, Sort: "[Importance]", Restrict: "[Complete] = false", Owner: '' },

• Task lane folders names can be customised by changing the Name value. (Do NOT change the folder identifier - i.e. FOCUS_FOLDER)

• The `Title' value represents the title showing on the task lane.

Task Lane Limits

    'INPROGRESS_FOLDER':   { Name: 'InProgress', Title: 'IN PROGRESS', Limit: 5, Sort: "[Importance]", Restrict: "[Complete] = false", Owner: ''},
    'NEXT_FOLDER':       { Name: 'Next', Title: 'NEXT', Limit: 0, Sort: "[Importance]", Restrict: "[Complete] = false", Owner: ''},
    'FOCUS_FOLDER':     { Name: 'Focus', Title: 'FOCUS', Limit: 0, Sort: "[Importance]", Restrict: "[Complete] = false", Owner: '' },
    'WAITING_FOLDER':     { Name: 'Waiting', Title: 'WAITING', Limit: 0, Sort: "[Importance]", Restrict: "[Complete] = false", Owner: '' },

• The Limit value can be amended to set limits in each task lane.

• Only InProgress, Next, Focus and Waiting folders accept limit settings. BackLog and Completed lanes do not have limits apply.

• Setting the Limit to 0 removes the limit.

Task Lane Sort Order

By default, the tasks are sorted by priority.

    'NEXT_FOLDER':       { Name: 'Next', Title: 'NEXT', Limit: 0, Sort: "[DueDate]", Restrict: "[Complete] = false", Owner: ''},

• The Sort value can be updated to change the order.

• It is also possible to add multiple order criteria like Sort: "[DueDate][Importance]"

Task Template

When a task created using the Add button on task lanes, a new task created with a default template.

    // Default task template
    'TASK_TEMPLATE':        '\r\n\r\n### TODO:\r\n\r\n\r\n\r\n### STATUS:\r\n\r\n\r\n\r\n### ISSUES:\r\n\r\n\r\n\r\n### REFERENCE:\r\n\r\n\r\n\r\n'

This template can be customised by changing the TASK_TEMPLATE setting.

Task Note Excerpt

If there are some notes entered in the task, only first 200 chars are visible by default configuration.

// Task Note Excerpt Size
// number of chars for each task note
// 0 = makes no notes appear on the each task card
'TASKNOTE_EXCERPT':    200,

The TASKNOTE_EXCERPT value can be updated to change the number of characters shown in the task board view.

Note: If the default task template used to create the task, only the first part of the task notes are visible. (until first the '###'' section).