Edit History

TimingAndEstimationPluginUserManual

Version 2 (Timing and Estimation Plugin -, 05/28/2008 06:20 PM)

1 1 Timing and Estimation Plugin - 





    2
    1
    Timing and Estimation Plugin -
    
[[PageOutline]]





    3
    1
    Timing and Estimation Plugin -
    





    4
    2
    Timing and Estimation Plugin -
    
h1. Timing and Estimation Plugin User Manual





    5
    2
    Timing and Estimation Plugin -
    





    6
    2
    Timing and Estimation Plugin -
    
"TimingAndEstimationPlugin on [[TracHacks]]":http://trac-hacks.org/wiki/TimingAndEstimationPlugin | "Open Tickets":http://trac-hacks.org/report/9?COMPONENT=TimingAndEstimationPlugin | "New Ticket":http://trac-hacks.org/newticket?component=TimingAndEstimationPlugin&owner=bobbysmith007  | 





    7
    2
    Timing and Estimation Plugin -
    
"Web Browsable Source Code":http://trac-hacks.org/browser/timingandestimationplugin/trunk





    8
    2
    Timing and Estimation Plugin -
    





    9
    2
    Timing and Estimation Plugin -
    





    10
    2
    Timing and Estimation Plugin -
    
h2. Abstract Design Goal





    11
    2
    Timing and Estimation Plugin -
    





    12
    1
    Timing and Estimation Plugin -
    
My goal in writing this plugin was to use as much of the existing structure as possible (therefore not needing to add extra structure that might make maintainability difficult).  The largest downside I have found to this is that there is no way to attach more permissions to anything.





    13
    1
    Timing and Estimation Plugin -
    





    14
    2
    Timing and Estimation Plugin -
    





    15
    2
    Timing and Estimation Plugin -
    
h2. Custom Ticket Fields





    16
    2
    Timing and Estimation Plugin -
    





    17
    1
    Timing and Estimation Plugin -
    
In adhering to our design goal, rather than creating a new ticket interface, I create some custom fields and a small daemon to watch over them.  





    18
    1
    Timing and Estimation Plugin -
    





    19
    1
    Timing and Estimation Plugin -
    





    20
    2
    Timing and Estimation Plugin -
    
h3. Fields:





    21
    2
    Timing and Estimation Plugin -
    





    22
    2
    Timing and Estimation Plugin -
    
* *Hours to Add* This field functions as a time tracker.  When you add hours to it , those hours get added to the total hours field.  The person  who made the change is there fore credited with the hours spent on it.





    23
    2
    Timing and Estimation Plugin -
    
* *Total Hours* This field is the total number of hours that have been added to the project. This has been made uneditable by including javascript which replaces the input box with a span containing its value





    24
    2
    Timing and Estimation Plugin -
    
*** Reports might not agree with each other if this is manually edited (which is possible if you disable javascript).





    25
    2
    Timing and Estimation Plugin -
    
* *Is this billable?* An extra flag on tickets so that they can be marked as billable / not billable.





    26
    2
    Timing and Estimation Plugin -
    
* *Estimated Hours* a field that contains the estimated amount of work





    27
    2
    Timing and Estimation Plugin -
    





    28
    2
    Timing and Estimation Plugin -
    
h3. Future Fields





    29
    2
    Timing and Estimation Plugin -
    





    30
    2
    Timing and Estimation Plugin -
    
* *Ticket Rate* The ability to attach a cost per hour or total amount to an individual ticket





    31
    2
    Timing and Estimation Plugin -
    





    32
    2
    Timing and Estimation Plugin -
    





    33
    2
    Timing and Estimation Plugin -
    
h2. Management Page





    34
    2
    Timing and Estimation Plugin -
    





    35
    1
    Timing and Estimation Plugin -
    
This page provide a small interface for querying the tickets and adding a bill date at the current time.  





    36
    1
    Timing and Estimation Plugin -
    
This interface mostly just gives you links that match the interface to open any of the give reports,





    37
    1
    Timing and Estimation Plugin -
    
providing it the correct set of input parameters





    38
    1
    Timing and Estimation Plugin -
    





    39
    1
    Timing and Estimation Plugin -
    
The 'Management' button should be in the main title bar.  It is possible that if you are viewing at a low resolution, it was pushed off the edge of the screen.  Also if you are not logged in with report_view permissions, it will not show that button.





    40
    1
    Timing and Estimation Plugin -
    





    41
    1
    Timing and Estimation Plugin -
    
The direct url is '/Billing'.





    42
    1
    Timing and Estimation Plugin -
    





    43
    1
    Timing and Estimation Plugin -
    





    44
    1
    Timing and Estimation Plugin -
    





    45
    2
    Timing and Estimation Plugin -
    
h3. Set Bill Date





    46
    2
    Timing and Estimation Plugin -
    





    47
    2
    Timing and Estimation Plugin -
    





    48
    1
    Timing and Estimation Plugin -
    
This button will add now as a bill date.  This is mostly to make it





    49
    1
    Timing and Estimation Plugin -
    
easier to select the last time you billed.  This would allow you to





    50
    1
    Timing and Estimation Plugin -
    
set a ticket as having been billed at a given time while others have





    51
    1
    Timing and Estimation Plugin -
    
not, and accurately get the correct billing information for all





    52
    1
    Timing and Estimation Plugin -
    
tickets.





    53
    1
    Timing and Estimation Plugin -
    





    54
    2
    Timing and Estimation Plugin -
    





    55
    2
    Timing and Estimation Plugin -
    
h2. Reports ==





    56
    2
    Timing and Estimation Plugin -
    
 Report Types ===





    57
    1
    Timing and Estimation Plugin -
    
We provide a few different reports for querying different types of data:





    58
    2
    Timing and Estimation Plugin -
    
**** *Billing Reports* Currently the billing reports are the only time based reports, and are therefore useful for getting an estimate what tickets had times (and totals), and which developers spent their time where.





    59
    2
    Timing and Estimation Plugin -
    
******* Ticket Work Summary





    60
    2
    Timing and Estimation Plugin -
    
******* Milestone Work Summary





    61
    2
    Timing and Estimation Plugin -
    
******* Developer Work Summary





    62
    2
    Timing and Estimation Plugin -
    
**** *Ticket/Hour Reports* These reports are useful for reviewing estimates on a large scale or getting an idea of the project at large.  These reports currently ignore the time.





    63
    2
    Timing and Estimation Plugin -
    
******* Ticket Hours





    64
    2
    Timing and Estimation Plugin -
    
******* Ticket Hours with Description 





    65
    2
    Timing and Estimation Plugin -
    
******* Ticket Hours Grouped By Component





    66
    2
    Timing and Estimation Plugin -
    
******* Ticket Hours Grouped By Component with Description





    67
    2
    Timing and Estimation Plugin -
    
******* Ticket Hours Grouped By Milestone





    68
    2
    Timing and Estimation Plugin -
    
******* Ticket Hours Grouped By Milestone with Description





    69
    2
    Timing and Estimation Plugin -
    





    70
    2
    Timing and Estimation Plugin -
    
h3. Adding More Reports





    71
    2
    Timing and Estimation Plugin -
    





    72
    1
    Timing and Estimation Plugin -
    
To add reports to the Management screen sections, you must run the following sql against your trac database





    73
    1
    Timing and Estimation Plugin -
    
Remember to fill in the @reportID of the report you want to insert, and to select the insert statement for the section of your choice.





    74
    2
    Timing and Estimation Plugin -
    
<pre>





    75
    2
    Timing and Estimation Plugin -
    
<pre>





    76
    1
    Timing and Estimation Plugin -
    





    77
    2
    Timing and Estimation Plugin -
    
<pre>





    78
    1
    Timing and Estimation Plugin -
    





    79
    2
    Timing and Estimation Plugin -
    





    80
    2
    Timing and Estimation Plugin -
    
h3. Removing a Report





    81
    2
    Timing and Estimation Plugin -
    





    82
    1
    Timing and Estimation Plugin -
    
To remove reports from the Management page, run the following query. 





    83
    1
    Timing and Estimation Plugin -
    
Remember to fill in the @reportID of the report you want to modify.





    84
    2
    Timing and Estimation Plugin -
    
* To remove for this version of the plugin (will be over written in future plugin upgrades)





    85
    2
    Timing and Estimation Plugin -
    
<pre>





    86
    2
    Timing and Estimation Plugin -
    
* To remove permanently (wont be over written in future plugin upgrades)





    87
    2
    Timing and Estimation Plugin -
    
<pre>





    88
    2
    Timing and Estimation Plugin -
    
_NB: The 'x' part is not important - you just need to make the column read something other than 'Timing and Estimation Plugin'._





    89
    1
    Timing and Estimation Plugin -
    





    90
    1
    Timing and Estimation Plugin -
    





    91
    2
    Timing and Estimation Plugin -
    
h3. TAKE NOTE





    92
    2
    Timing and Estimation Plugin -
    





    93
    2
    Timing and Estimation Plugin -
    
 *The reports can only be called from the Management Page. They will not work from the Trac View Tickets page. (Due to the custom variables that need values).*





    94
    2
    Timing and Estimation Plugin -
    





    95
    2
    Timing and Estimation Plugin -
    





    96
    2
    Timing and Estimation Plugin -
    
h2. Future Improvements





    97
    2
    Timing and Estimation Plugin -
    





    98
    2
    Timing and Estimation Plugin -
    
* "See tickets":http://trac-hacks.org/wiki/TimingAndEstimationPlugin at the "project trac":http://trac-hacks.org/wiki/TimingAndEstimationPlugin





    99
    2
    Timing and Estimation Plugin -
    
* Would like to suggest a couple of interfaces to Trac project, and perhaps write an implementation for them.





    100
    2
    Timing and Estimation Plugin -
    
*** * ICustomTicketFieldProvider * This should allow a plugin to provide a custom field with the ability to add html attributes and specify at least the tag name. (hopefully with a full template) This should hopefully also allow these provided custom controls to set permissions causing them to not render or to not editable.





    101
    2
    Timing and Estimation Plugin -
    
*** * ICustomReportProvider * This allows custom reports to be provided in a way that permissions can be enforced on them. 





    102
    2
    Timing and Estimation Plugin -
    
* work with advise and feedback from the user community to make this Plugin do this job adequately








        
        

    
















 
 Redmine Appliance - Powered by TurnKey Linux