Skip to content
This repository has been archived by the owner on Jan 30, 2023. It is now read-only.
Kevin Papst edited this page Jan 30, 2023 · 3 revisions

Timesheet

That's where you track your time. We hope the interface is easy to understand and use.

Tracking your time

Just select a customer and all corresponding projects will be highlighted. Next step is to choose the project you are working on and last but not least the task you are doing. Now you are ready to track your time. Just hit the big green button in the top right corner to start tracking. To stop your current record hit the red stop-button either on the left of your current record or the top right corner. Afterwards you can choose another customer, project and/or task and continue to record.

Editing your time

If you have forgotten to quit tracking or selected a wrong task: don’t panic! There is a little pencil next to your recorded events. By clicking on it, you will be able to rearrange a mistake that might have happened.

Attention: The start and end-time of events that have been recorded after that mistake will not be modified automatically. Have a look if there are overlapping entries.

If you are in need of some extra info to your current task use the comments bubble displayed beneath the running time. Here you can add whatever info you think can help you with explained what you did.

Invoices

Create invoices for your clients. Use can choose between several templates. One invoice is always created for one client, where you decide which projects will be included. You can also select a timeframe (limiting the timesheet entries) which will be used for generating the invoice.

In most cases you do not want to use an existing template. But you can modify existing or create new templates for you and your company.

There are also existing templates to download that are shared with the community.

Export

With this extension you can export tracked time per User into an Excel-file, csv-file or a pdf-file. As a regular user you can only see your time. If you are at least a group leader you can select members of your group and export their data for reporting.

Rates

Here is the order in which is checked if a rate exists. The first one found is then used:

  • my rate of the activity
  • my rate of the project
  • my rate set via preferences
  • rate of the activity
  • rate set for the project

Database

See function get_best_fitting_rate in Database class.

If you have a look into the table kimai_rates you may see something like this:

User Project Event Rate
1 2 5 10.00
2 NULL 5 20.00
2 2 NULL 30.00
2 NULL NULL 40.00
NULL 2 5 50.00
NULL NULL 5 60.00
NULL 2 NULL 70.00

The entries are already sorted. Kimai takes the first row that exists (maybe the one with the most hits).

Explanation of the table:

  • user 1 on project 2 and task 5 has a rate of 10.00 € per hour
  • user 2 on task 5 has a rate of 20.00 € per hour
  • user 2 on project has a rate of 30.00 € per hour
  • user 2 has a rate of 40.00 € per hour
  • project 2 and task 5 have a rate of 50.00 € per hour
  • task 5 has a rate of 60.00 € per hour
  • project 2 has a rate of 70.00 € per hour

Some examples:

  • User 3 is working on project 2: his rate is 70.00 €
  • User 2 is working on project 1 and task 5: his rate is 20.00 €
  • User 2 is working on any project except the defined ones for him: his rate is 40.00 €
Clone this wiki locally