wiki:EstimationToolsPlugin

Version 6 (modified by Joachim Hoessler, 9 years ago) (diff)

--

Tools for visualizing and quick editing of effort estimations

Description

EstimationTools includes macros that visualize remaining effort estimations, e.g., as Burndown Chart, as well as an extension that allows inline editing of estimations in the query view.

Requirements

The charts use Google's Chart API, hence no additional python modules are required. The HoursInPlaceEditor requires the XmlRpcPlugin.

Bugs/Feature Requests

Existing bugs and feature requests for EstimationToolsPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from [download:estimationtoolsplugin here].

Source

You can check out EstimationToolsPlugin from here using Subversion, or browse the source with Trac.

Install

  • The latest version for Trac 0.10 can be checked out here.
  • Deploy the egg:
    # python setup.py bdist_egg 
    # cp dist/*.egg /path/to/trac/env/plugins 
    
    Please see Trac's plug-in installation instructions for more details.
  • You need to add a custom field in your trac.ini to store the estimations for the current remaining effort:
    [ticket-custom]
    estimatedhours = text
    estimatedhours.label = Remaining Hours
    estimatedhours.value = 0
    
  • if you want to use another field than estimatedhours, (e.g, hours_remaining), specify it here:
    [estimation-tools]
    estimation_field = hours_remaining
    
  • and, finally, enable the plugin
    [components]
    estimationtools.* = enabled
    

Features

BurndownChart

Creates burn down chart for given milestone.

This macro creates a chart that can be used to visualize the progress in a milestone (aka sprint or product backlog). For a given milestone and time frame, the remaining, estimated effort is calculated. The macro has the following parameters:

  • milestone: mandatory parameter that specifies the milestone.
  • startdate: mandatory parameter that specifies the start date of the period (ISO8601 format)
  • enddate: end date of the period. If omitted, it defaults to either the milestones `completed' date, or duedate, or today (in that order) (ISO8601 format)
  • sprints: list of comma-separated name of sprints to be included in calculation. Must be surrounded by brackets.
  • width: width of resulting diagram (defaults to 800)
  • height: height of resulting diagram (defaults to 200)
  • color: color specified as 6-letter string of hexadecimal values in the format RRGGBB. Defaults to ff9900, a nice orange.

Examples:

[[BurndownChart(milestone = Sprint 1, startdate = 2008-01-01)]]
[[BurndownChart(milestone = Release 3.0, startdate = 2008-01-01, enddate = 2008-01-15,
width = 600, height = 100, color = 0000ff, sprints = (Sprint 1, Sprint 2))]]
Burndown Chart

HoursRemaining

Calculates remaining estimated hours for given milestone.

milestone is a mandatory parameter. Example:

[[HoursRemaining(milestone=Sprint 1)]]

WorkloadChart

Creates workload chart for given milestone.

This macro creates a pie chart that shows the remaining estimated workload per ticket owner, and the remaining work days. It has the following parameters:

  • milestone: mandatory parameter that specifies the milestone.
  • width: width of resulting diagram (defaults to 400)
  • height: height of resulting diagram (defaults to 100)
  • color: color specified as 6-letter string of hexadecimal values in the format RRGGBB. Defaults to ff9900, a nice orange.

Examples:

[[WorkloadChart(milestone = Sprint 1)]]
[[WorkloadChart(milestone = Sprint 1, width = 600, height = 100, color = 00ff00)]]
Workload Chart

HoursInPlaceEditor

This component allows to edit the remaining hours field directly in the query view.

Screenshot of HoursInPlaceEditor

Recent Changes

16592 by rjollos on 2017-05-16 04:02:05
0.5.0dev: Make compatible with Trac 1.2

Fixes #13173.

16591 by rjollos on 2017-05-16 03:52:35
0.5.0dev: Tidy up codebase and drop support for Trac < 1.0

Refs #13173.

15265 by rjollos on 2016-02-11 04:29:08
Remove unnecessary svn:mime-type on js and html files

svn:mime-type was set to "plain" for many files.

(more)

Author/Contributors

Author: hoessler
Contributors:

Attachments (1)

Download all attachments as: .zip