kanbanworkflowstimelinescrumrubyroadmapproject-planningproject-managementopenprojectangularissue-trackerifcgantt-chartganttbug-trackerboardsbcf
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
123 lines
6.2 KiB
123 lines
6.2 KiB
---
|
|
sidebar_navigation:
|
|
title: Time tracking
|
|
priority: 799
|
|
description: Time tracking in OpenProject
|
|
robots: index, follow
|
|
keywords: time tracking, logging time, define rate, labor costs
|
|
---
|
|
|
|
# Time tracking
|
|
|
|
Users can book their time or units spent on an activity within a project directly on work packages, which gives a clear indication of how much effort the project activities require. You can either log time in the work package view or via a commit message.
|
|
|
|
<div class="alert alert-info" role="alert">
|
|
**Note**: To use the time tracking functionality, the **Time and costs module** needs to be activated in the [project settings](../../projects/project-settings/modules/).
|
|
</div>
|
|
|
|
|
|
| Topic | Content |
|
|
| ------------------------------------------------------------ | ------------------------------------------------------------ |
|
|
| [Logging time](#logging-time-in-the-work-package-view) | How to log time to work packages? |
|
|
| [Track time with Toggl](./toggl-integration) | How to stop spent time with Toggl integration? |
|
|
| [Logging time via commit message](#logging-time-via-commit-message) | How to log time via a commit message to a work package? |
|
|
| [Edit logged time](#edit-logged-time) | How to edit logged time on a work package? |
|
|
| [Delete time entries](#delete-time-entires) | How to delete time entries logged to a work package? |
|
|
| [Spent time widget on the My Page](#spent-time-widget-on-the-my-page) | How to easily track and display spent time in the spent time widget on the MyPage? |
|
|
| [Define hourly rate for labor costs](#define-hourly-rate-for-labor-costs) | How to set the hourly rate to track labor costs? |
|
|
|
|
## Logging time in the work package view
|
|
|
|
In order to log spent hours for a certain activity, open the details of the corresponding work package. Select **Log time** from the **More functions** drop down menu, the icon with the three dots in the top right of the work packages details. Or use the **Log time** icon next to **Spent time**.
|
|
|
|
|
|
|
|
You will be directed to the detailed view to log time where you can edit the following:
|
|
|
|
2. The date, for which the time will be logged.
|
|
3. The actually logged time (in hours).
|
|
4. The **Activity** drop down menu offers a choice of activity categories, such as coordination or development. The range of categories can vary from project to project and can be edited by a project administrator or a role with respective permissions.
|
|
4. The comment field, where you can note a more detailed description of the activities that you log time for.
|
|
5. Don’t forget to **Save** your logged time.
|
|
|
|
|
|
|
|
The aggregated time spent on a work package is shown in the work package details view.
|
|
|
|
|
|
|
|
## Logging time via commit message
|
|
|
|
Note: the “enable time logging” option must be activated under system settings in order to log time via a commit message.
|
|
|
|
To log time to a work package via a commit message you need to use the following syntax: Refs #Work package number @amount of hours. For example refs #123 @2h will log 2 hours for the work package number 123.
|
|
|
|
## Edit logged time
|
|
|
|
To edit logged time, click in the amount of the **Spent time** in the work packages details view.
|
|
|
|
|
|
|
|
This will bring you to the time tracking report where you will see all time entries to this work package.
|
|
|
|
Click on the **Edit** icon next to a time entry in the list.
|
|
|
|
|
|
|
|
The same detailed view to log your time entries will appear where you are now able to apply your changes.
|
|
|
|
## Delete time entries
|
|
|
|
To delete a time entry, also click on the **Spent time** in the details of a work package (just as to edit a work package).
|
|
|
|
In the list of time entries, click on the **Delete** icon next to a time entry to drop the logged time.
|
|
|
|
|
|
|
|
|
|
|
|
## Track labor costs
|
|
|
|
In order to track labor costs, you need to [define an hourly rate](../cost-tracking/#hourly-rate) in your user profile first. The labor costs will then be calculated automatically based on your hours booked and your hourly rate.
|
|
|
|
## Spent time widget on the My Page
|
|
|
|
You can easily track spent time in the **spent time widget on the MyPage** and get an overview about all your activities during a week. It is like a weekly timesheet for yourself.
|
|
|
|
See more information about the My spent time widget on the [MyPage](../../../getting-started/my-page/#my-spent-time-widget).
|
|
|
|
|
|
|
|
## Define hourly rate for labor costs
|
|
|
|
You can define an hourly rate to **track labor costs per user**. Please navigate to the user profile, e.g. by clicking on a hyper link of the user name on a work package.
|
|
|
|
|
|
|
|
You will be directed to the user's profile page.
|
|
|
|
Here, you can click the **Edit button** on the top right corner of the user profile page.
|
|
|
|
|
|
|
|
Alternatively, you can navigate to *Administration ->Users & Permissions ->Users*.
|
|
|
|
Click on the **Rate history** tab.
|
|
|
|
You will see a default hourly rate valid for all projects.
|
|
|
|
If you want to set a different hourly rate for the user on different projects, you can overwrite the default rate with a different rate below in the respective projects.
|
|
|
|
|
|
|
|
To enter a new hourly rate, click on the **Update** icon next to the rate history. You can either set a **default hourly rate** or define a rate for a certain project.
|
|
|
|
|
|
|
|
1. Enter a date from which the rate is **Valid from**.
|
|
2. Enter the (hourly) **Rate**. The currency can only be changed in the system's Administration settings.
|
|
3. You can delete an hourly rate.
|
|
4. You can **add a rate** for a different time period.
|
|
5. **Save** your changes.
|
|
|
|
 |