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 15 Next »

Reports consist of work log details and a financial summary (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 view modes - by clicking on the headline.

View Modes

Work log details can be displayed in two different view modes that are available as tabs:

  • list view (list of all work logs sorted by date/time descending)
  • structured view (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 Repair Work Logs (Moved Issues).

You can switch between the view modes by clicking on the respective tabs:

List View

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 top and bottom of the list:

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 (for the chosen search criteria).

Clicking on an issue, you will see all work logs for this issue (for the chosen search criteria):

Columns/Options

Both view modes have basically the same columns and options, but there are a few differences.

ColumnDescriptionRemarks
ExcludeCheckbox to excluse work logs from being charged.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 Global Plugin (Add-on) Configuration) and a user has decied to enter a corrected "time spent" value, it will be displayed here.Also refer to Log Work (Issue Screen).
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 Global Plugin (Add-on) Configuration and Log Work (Issue Screen).

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 Global Plugin (Add-on) 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 Global Plugin (Add-on) 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 (Issue Screen).

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 two scenarios, 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 Global Plugin (Add-on) 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.
  • It is required that the team assignment status for the work log you want to edit is consistent (for the user who has created this work log). Should this user has been a member of a team and has left and/or changed the team afterwards (see Project Teams), you will no longer be able to edit work logs this user has created before he/she has left/changed the team.

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 (Issue Screen).

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.

For the follwoing two scenarios, 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 Global Plugin (Add-on) 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.
  • It is required that the team assignment status for the work log you want to edit is consistent (for the user who has created this work log). Should this user has been a member of a team and has left and/or changed the team afterwards (see Project Teams), you will no longer be able to edit work logs this user has created before he/she has left/changed the team.

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 Repair Work Logs (Moved Issues).

Financial Summary

Please refer to Reports: Financial Summary.

  • No labels