Work Hours Element Widget

Description

The Work Hours Widget provides an interface to record the number of work hours spent for each task. The break down of the work hours by task allows the analysis to be broken down at the lowest level of detail. An option allows for the input of overtime hours.

Info

Name

Work Hours Element Widget

Class

tactic.ui.table.WorkHoursElementWdg

TACTIC Version Support

2.5.0 +

Required database columns

none
Implementation

The Work Hours Element Widget is a common column that can be added to any task view using the Column Manager.

Options

Show Over Time

true or false(default). Toggles the on the display of a second row for inputting hours marked as over time.

Totals Summary

total. Toggles the on the display of a second row for inputting hours marked as over time. note: only total is supported, not average nor count.

Note

When toggling on the Totals Summary, turn off Grouping by column in the view, otherwise, displaying 2 totals summary rows may be confusing to the user.

Example 1

We can record 4 hours of work on Wednesday and 3 hours on Thursday for a task. The total for that week will be displayed as a convenience.

Example 2

If we set the Total Summary option to total in the Edit Column Definition, we can see the total straight time hours for each day and the total straight time hours for each week displayed as a convenience.

Example 3

If we toggle on the Show Overtime option in the Edit Column Definition, an additional row with the prefix 'OT' appears which allows us to input overtime hours.. In that new row, we can record an additional 2 hours of over time work on Friday and 1 hour of over time work on Saturday for a task. The total over time hours for that week will be displayed as a convenience.

Example 4

If we toggle on *both* the Show Over Time option and set the Total Summary to total in the Edit Column Definition, we can see all the totals displayed as a convenience for each day of straight time and over time hours as well as the totals for the straight time and the over time hours for the week.

Advanced

The values input for the hours are stored in work_hours table under the straight_time column, regardless if it is straight time or overtime. The column named category is used to indicate if the value in the straight_time column is for overtime or straight time. With further low level modifications, this widget can be extended to support further categories, for example, if a new "double time" category is needed.

Note

The colors for the background of the input fields for this widget are calculated based on an offset to the TACTIC theme for the project for the background2 color.