Important note Retirement of icTime and Retirement of biz on December 29th, 2023
Timesheet
By default, the Timesheet shows all my work logs and allows me to edit, resume, move and delete my work logs (additional JIRA permissions required: "Edit Own Worklogs", "Delete Own Worklogs"). Depending on permissions, the timesheet can also be used to view and manage work logs of other users. In addition, the timesheet can be used to do some simple reporting, and there is an option to log work for any issue from this screen, too.
If you have the respective ictime permission ("Log work for other users"), the timesheet can also be used to view work logs of other users. To be able to edit and/or delete work logs of other users, you need respective JIRA permissions, too ("Edit All Worklogs", "Delete All Worklogs").
Timesheet
Search/Filter
By default, your timesheet shows all your work logs for all active & inactive projects (work logs for closed projects are not displayed) for the last week. You can search/filter by the following criteria:
Option | Description | Remarks |
---|---|---|
Issue | Option to search for and select a single issue (JIRA issue picker). | When you have selected an issue, ictime automatically updates the "Projects" picker and loads all project related data for the issue (i.e. all project-related pickers will automatically update). The issue picker is a JIRA issue picker and shows JIRA default behaviour, i.e. the issues available will be limited by the JIRA project permissions of the current user. |
Project | Project picker. | All projects you (=current user) have browse project permission in JIRA. |
Components | Component picker. Filter your timesheet by component. | Only possible if you have chosen one single project. |
Versions | Version picker. Filter your timesheet by fix version. | Only possible if you have chosen one single project. Note that this is "fix for version" (not "affected version"). |
Date from/to | Enter date from/to. | Default is one week (today - 7 days). |
User | User (by default: current user). Only if you have respective permissions, this is a user picker (multi-select). User picker not available if the current user does not have the permission to log work for others in ictime. | Only if you have respective ictime permissions ("Log work for others", see ictime Permissions), you can select other users here. All active users with JIRA browse project permissions for any of the available projects will be available. Same applies if you have the ictime "Reporting" permission, in this case you also have the user picker (this does not mean that you can create work logs for other users, but it means you can pick other users here and at least view their work logs). |
Activity Types | Activity type picker. Filter your timesheet by activity type. | |
Status | Issue status. | |
Approval | Work log approval status. | Only available if feature is enabled. See General Configuration. |
Pickers usually provide the functionality known from JIRA pickers in the issue navigator, including a search field with suggestion list
However, there is no instant update of the results, but you have to click "Search" to apply your changes.
A user who no longer has JIRA "Browse project" permissions for a project or is inactive in JIRA won't appear in the user picker. However, if you have respective ictime permissions ("Log work for others") and "All" is selected, all users who have created work logs will be considered, their JIRA status and project permissions do not matter.
List View
This is the default view; it consists of a list of work logs, sorted by date/time descending. The list shows all my work logs for issues of active and inactive projects. If there are more than 15 entries, the list shows a following page navigation.
Column | Description | Remarks |
---|---|---|
Date | Date of the work log. | |
Project | Project key. | You can click the key to get to the project directly. |
(Type) | Issue type. | |
(Status) | Issue status. | |
(Operations) | All operations available in JIRA for the issue of the work log (like in the JIRA Issue Navigator). | |
Issue | Issuer key and summary. | You can click the key to get to the issue directly. |
Components | Component/s for this task. | |
Activity | Activity type for this work log. | "-" is displayed if the project had been configured not to work with activity types or if this is a work log from JIRA before you have installed ictime. |
Description | Description from your work log. | |
User | User name (full name). | |
Begin | Start time of the work log, if you have logged your time as span/period. | Empty if you have logged time as time spent. |
End | End time of the work log, if you have logged your time as span/period. | Empty if you have logged time as time spent. |
Time Spent (Result) | Time you have entered (or calculated result from start and end time) | Column name was renamed from "Result" to "Time Spent" in version 5.3.1 |
Rounded | Rounded time spent (if a rounding rule was applicable for the project at the moment you have saved this work log). | |
Corrected | Corrected time spent (that should be taken for accounting purposes) | Only available if feature is enabled. See General Configuration. |
Charge | Displays if entry should be charged or not. charge do not charge |
|
Approved | Approval status. approved not approved | Only available if feature is enabled. See General Configuration. |
Actions | Possible operations for the work log entry. Edit, move, resume or delete work log. See also Log Work and Move Work Logs. | Options available depending on your permissions in JIRA (edit own/all worklog permissions), on the task status in JIRA (no logging of work on closed issues) and on the task status in ictime (no changes for work logs already charged). Usually, options you are not allowed to execute are not displayed. In some cases (specifically when permissions required in JIRA and permissions required in ictime are inconistent), you will see the option, but will get an error message when trying to perform the action. Example: If you have the permission to log work for other users in ictime (ictime permission: "Log work for others") you will be able to see work logs from other users in your timesheet if you have selected another user or all users, but if at the same time, you do not have the permission to edit work logs of other users in JIRA (JIRA permission: "Edit All Worklogs"), you won't be able to edit the work log. |
As long as you already have logged work on an issue, you can also use your timesheet to work on issues. All options that are available for a task in the JIRA Issue Navigator result list are also available from the timesheet!
Structured View
The structured view groups work logs by project and issue and shows the total time by issue and project (for the chosen search criteria). In case of multiple projects, you get a list of projects first (for the chosen search criteria).
Click on a project to see the issues (for the chosen search criteria):
If your project list just contains one project, it will automatically show all issues.
Clicking on an issue, you will see all work logs for this issue (according to your search criteria, of course):
Fields and actions available on work log level are basically the same like for the list view (see table above).
Date Grid
You can also display the work logged on issues in a date grid.
This view does not offer operations on work logs.
The date grid is limited to a maximum of 100 days. If you are doing a search for a longer period of time, you won't get the date grid displayed.
Summary
Below the work log details, a summary of your time logged by project - for the selected time period - is displayed.
The list only displays projects where you have at least one work log in the selected time period.
View & Manage Work Logs of Other Users
If you have respective permissions, you can also manage work logs for other users, i.e. you can view, edit and delete such work logs. In this case, the user picker of the filter mask displays all users with browse project permission for the projects available in your project picker. You have all options known form the JIRA user picker, inluding search:
You can also choose "all" (by not picking any specific user).
Only if you have respective ictime permissions ("Log work for others", see ictime Permissions), you can select other users here. All active users with JIRA browse project permissions for any of the available projects will be available. To edit or delete work logs of other users, in addition you need the permission to edit/delete work logs of other users in JIRA (JIRA permission: "Edit All Worklogs" and "Delete All Worklogs"),
Log Work
You can log work for any issue directly from your timesheet and do not have to navigate to the issue.
Depending on your JIRA permissions, you can also log work for other users here. For details, please refer to Log Work.