Page tree

This documentation describes all functionality of the latest ictime version (5.x for JIRA 7 and 4.x for JIRA 6.x ) for administrators and users. For documentation of older versions, please refer to Documentation History.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

Report results always consist of work log details and a summary & analysis part (see Reports: Financial Summary). This chapter explains all available options for the work log details of a report.

Work Log Details

You can hide/show the work log details - in all views - by clicking on the headline.

Display Work Log Details:

Hide Work Log Details:

Work log details can be displayed in two different views that are available as links in the navigation bar:

  • List (list of all work logs sorted by date/time descending); this is the default view
  • Structured (work logs grouped by project and issue).

In addition, there might be an additional tab called "Warnings". This tab appears if your report contains "broken" work logs that have been caused by moving issues between different projects in JIRA. For details, refer to Fix Work Logs (Warnings Tab).

List

The list view displays work logs by date/time descending.

This view mode displays 15 work logs per page and has a page navigation on the bottom of the list:

The list displays the following information:

ColumnDescriptionRemarks
Exclude

Checkbox to exclude work logs from being charged when using a report as base for charging work logs. See Charge Work Logs - Create Invoice.

This column is only available if you have chosen "Prepare charging work logs" when creating the report. See Create Reports.
DateDate of the work log. 
ProjectProject key.You can click the key to get to the project overview in JIRA.
(Type)Issue type (JIRA icon). 
(Status)Issue status (JIRA icon). 
(Issue Actions) All operations available in JIRA for the issue a work log belongs to (like in the JIRA Issue Navigator). For details, see below. 
IssueIssue key and summary. Display of longer summary is limited to a define dnumber of characters.

You can click the key to get to the issue directly.

If an issue is a sub-task, display will show the sub-task key plus the parent issue key in brackets in front of the summary:

ComponentComponent for this issue, if available. 
ActivityActivity type for this work log, if available."-" is displayed if the project had been configured not to work with activity types or if this is a historic work log from JIRA before you have installed ictime.
DescriptionDescription from your work log. 
UserUser who has created this work log. Full name is displayed (not the user name). 
BeginStart time of the work log, if you have logged your time as span/period. 
EndEnd time of the work log, if you have logged your time as span/period. 
ResultTime you have entered (time spent or calculated result from start and end time) 
RoundedRounded resultIf a rounding rule was applicable for the project at the moment you have last saved this work log. See Configure Rounding Rules and Project Rounding Rule.
CorrectedIf the feature is enabled (see General Configuration) and a user has decided to enter a corrected "time spent" value, it will be displayed here.Also refer to Log Work.
Charge

Displays if entry should be charged or not, i.e. should appear in the "Charge" or "No Charge" section of the financial summary (see Reports: Financial Summary). See also General Configuration and Log Work.

charge

do not charge

In case of "no charge", if the user has entered additional information (e.g. the reason why a work log should not be charged), this information will be displayed on mouseover.
 

Approved

Approval status of a work log (if approval is enabled, see General Configuration).

work log is approved

work log is not approved

See Reports: Approval.

Work Log Actions

 

All available operations for the work log. For details, see below.

Options available depend on

  • your permissions in JIRA (edit own/all worklog permissions),
  • on the issue status in JIRA (no logging of work on closed issues),
  • and on the task status in ictime (no changes for work logs already approved or charged).

If a work log has been charged already, the $ sign will be displayed in the "actions" column and no actions will be available.

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). By clicking on rows for project and issue, you open more information.

Clicking on one issue (row), you will see all work logs for this issue (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 (see above). If your project list just contains one project, it will automatically show all issues (for the chosen search criteria).

Columns/Options

Both views have basically the same columns and options, but there are a few differences. Some operations - like approval - are only possible from the structured view.

ColumnDescriptionRemarks
ExcludeCheckbox to exclude work logs from being charged when using a report as base for charging work logs. See Charge Work Logs - Create Invoice.Only available if you have chosen "Prepare charging work logs" when creating the report. See Create Reports.
DateDate of the work log. 
ProjectProject key.You can click the key to get to the project overview in JIRA.
(Type)Issue type. 
(Status)Issue status. 
(Issue Actions) All operations available in JIRA for the issue a work log belongs to (like in the JIRA Issue Navigator). For details, see below. 
TaskTask key and name.You can click the key to get to the issue directly.
ComponentComponent for this task. 
ActivityActivity type for this work log."-" is displayed if the project had been configured not to work with activity types or if this is a historic work log from JIRA before you have installed ictime.
DescriptionDescription from your work log. 
UserUser who has created this work log. 
BeginStart time of the work log, if you have logged your time as span/period. 
EndEnd time of the work log, if you have logged your time as span/period. 
ResultTime you have entered (time spent or or calculated result from start and end time) 
RoundedRounded resultIf a rounding rule was applicable for the project at the moment you have last saved this work log. See Configure Rounding Rules and Project Rounding Rule.
Corr.If the feature is enabled (see General Configuration) and a user has decied to enter a corrected "time spent" value, it will be displayed here.Also refer to Log Work.
Charge

Displays if entry should be charged or not, i.e. should appear in the "Charge" or "No Charge" section of the financial summary (see Reports: Financial Summary). See also General Configuration and Log Work.

charge

do not charge

In case of "no charge", if the user has entered additional information (e.g. the reason why a work log should not be charged), this will be displayed on mouseover:


 

Appr. Stat.

Approval status of a work log or issue (if approval is enabled, see General Configuration).

work log is approved

work log is not approved

some, but not all work logs are approved (displayed on issue level)

See Reports: Approval.

Appr.Option to approve selected work logs or all work logs of one issue (if approval is enabled, see General Configuration).Only available in structured view mode. See Reports: Approval.

(Work Log) Actions

 

All available operations for the work log. For details, see below.

Options available depend on

  • your permissions in JIRA (edit own/all worklog permissions),
  • on the issue status in JIRA (no logging of work on closed issues),
  • and on the task status in ictime (no changes for work logs already approved or charged).

If a work log has been charged already, the $ sign will be displayed in the "actions" column.

Export Work Log Details

You can export the work log details in both view modes via the respective buttons on top/bottom of the list as .xls file.

The export files always contains all work logs of the report.

Operations

Work log details - in both view modes - are the base for a couple of operations on JIRA issues and on work logs.

JIRA does not allow to log work or edit/delete work logs for issues in JIRA status "closed". ictime usually follows this logic, but in the Reporting section, for practical reasons, all operations on work logs are possible regardless of JIRA issue status. It is a very typical use case that an administrative user has to make corrections on work logs and that issues are already closed. It would not make sense that the issue has to be reopened just for this purpose.

Operations on Issues

All operations possible for an issue in JIRA can directly be accessed from the report in both view modes:

JIRA permissions and restrictions apply.

Edit Work Logs

You can edit work logs appearing in your report result list. Click on the respective icon.

For details on editing work logs, please refer to Log Work.

If you can edit a work log in this interface depends on

  • your JIRA permissions ("Edit Own Worklogs" and/or " Edit All Worklogs" permission)
  • the ictime work log status (you can't edit work logs that have already been charged)
  • the ictime approval status (you can't edit work logs that have already been approved)

In all these cases, you usually should not see the "Edit" icon/option.

For the follwoing scenario, you will be able to start editing a work log, but might get an error message:

  • In case team & price list checks are activated in JIRA (see General Configuration and Project Teams), your change requires a valid price list (for the user who has created this work log). This only applies when you try to change the date for the work log and the date is not within the range of any valid price list.

For the follwoing scenario, you will be able to edit a work log, but will get a warning message:

  • If the team assignment status for the work log you want to edit is not consistent (for the user who has created this work log). Should this user have been a member of a team and has left and/or changed the team afterwards (see Project Teams), you will be able to edit work logs this user has created before he/she has left/changed the team, but your changes will be saved using the current user settings, this way overwriting the original settings used when creating the work log.

The following restrictions do not apply when editing a work log here (they only apply if you try to edit a work log in other interfaces):

  • the ictime project status (usually, you can't edit work logs any longer if the project status is inactive),
  • the JIRA issue status (usually, you can't edit work logs for closed issues).

Delete Work Logs

You can delete work logs appearing in your report result list. Click on the respective icon.

For details on deleting work logs, please refer to Log Work.

If you can delete a work log in this interface depends on

  • your JIRA permissions ("Delete Own Worklogs" and/or " Delete All Worklogs" permission)
  • the ictime work log status (you can't delete work logs that have already been charged)
  • the ictime approval status (you can't delete work logs that have already been approved)

In all these cases, you usually should not see the "Delete" icon/option.

The following restrictions do not apply when deleting a work log here (they only apply if you try to delete a work log in other interfaces):

  • the ictime project status (usually, you can't delete work logs any longer if the project status is inactive),
  • the JIRA issue status (usually, you can't delete work logs for closed issues).

Move Work Logs

You can move work logs appearing in your report to another issue of the same project. Click on the respective icon.

For details, refer to Move Work Logs.

If you can move a work log in this interface depends on the same restrictions like editing a work log, i.e.

  • your JIRA permissions ("Edit Own Worklogs" and/or " Edit All Worklogs" permission)
  • the ictime work log status (you can't edit/move work logs that have already been charged)
  • the ictime approval status (you can't edit/move work logs that have already been approved)

In all these cases, you usually should not see the "Edit" icon/option.

The following restrictions do not apply when moving a work log here (they only apply if you try to move a work log in other interfaces):

  • the ictime project status (usually, you can't edit work logs any longer if the project status is inactive),
  • the JIRA issue status (usually, you can't edit work logs for closed issues).

Warnings (Repair Work Logs)

The "Warnings" tab shows broken work logs, i.e. work logs with inconsistencies between the JIRA work log and enhanced ictime data for a work log. This situation is always caused by moving an issue in JIRA to a different project. The "Warning" tab is not available if a project does not have inconsistent work logs.

For more details, please refer to Fix Work Logs (Warnings Tab).

Financial Summary

Please refer to Reports: Financial Summary.

  • No labels