Document toolboxDocument toolbox

This article is for Timesheets for Cloud. Visit Data Center

Aggregating Internal Issues' Worklogs When Syncing with Jira

This feature is not yet available to all customers. To participate in Tempo's Early Access Program and gain access to this feature, visit our TempoLab page.

Internal issues frequently have the most worklogs in your Jira instance. If you’re concerned about exceeding Atlassian’s worklog limit per Jira issue, you can change how these worklogs are synced between Jira and Tempo. Alternatively, you can move or delete worklogs from any issue.

By default, when a worklog is first created in Tempo, a corresponding worklog is created in Jira. For Internal issues, the number of worklogs created in Jira can potentially exceed Atlassian’s worklog limit per Jira issue. If you don’t want to move or delete worklogs from Internal issues, you can aggregate the Tempo worklogs into a single Jira worklog per issue per day.

This aggregated worklog only applies to issues that are added to the Internal Issues page in Tempo Settings.

Required Permissions

Jira Global Permissions:

  • Tempo Administrator

Aggregating Internal Issues' Worklogs

Tempo worklogs for Internal issues are rolled up into a single summary Jira worklog for each Jira issue per day. This does not impact historical records, and the granular Tempo worklogs remain in Tempo. This can delay exceeding Atlassian’s worklog limit per Jira issue by years, depending on usage and how many worklogs are currently added to an issue.

daily-worklog-sync.png

For example, if five team members log time in Tempo on Monday to an internal issue for training-related activities, five Tempo worklogs are created. At the end of the day, a single Jira worklog is created for the internal issue that aggregates the time logged by the five team members.

This is recommended for organizations that:

  • use Tempo Reports and Tempo’s API for worklog-related reporting.

  • want to continue using long-running Internal issues.

Caveats

  • You may experience some data delay with the daily sync.

Enabling Aggregation

  1. Navigate to Tempo Settings and select Logging Time.

  2. Select Use aggregation when syncing worklogs on Internal Issues to Jira.

    internal-worklog-sync.png

Any new worklogs created for Internal issues' worklogs are aggregated.

Disabling Aggregation

Worklog sync settings apply to only the worklogs created when the specific sync mode is enabled.

For example:

  • In April, aggregation is disabled (the default option). All Tempo worklogs created for Internal issues in April will have an associated Jira worklog.

  • In May, you switch to a daily aggregated worklog for Internal issues. April’s worklogs are untouched. After you have switched, all Tempo worklogs for Internal issues are summarized and recorded in Jira at the end of the day.

  • In June, disable aggregation. April’s worklogs continue to be untouched. May’s aggregated worklogs are untouched. All Tempo worklogs created from June forward will have an associated Jira worklog.

Moving a Worklog

When you switch between sync modes, the behavior when moving a worklog can be different than expected.

Using the previous example, in May you decide to move a Tempo worklog created in April to a new issue. The worklog will be incorporated in the aggregated Jira worklog because you moved it while the aggregated worklogs were enabled.

In June, you decide to move a Tempo worklog created in May. Since you disabled aggregation in May, the time recorded in the Tempo worklog will be removed from the aggregated daily Jira worklog for that issue. The Tempo worklog will be moved to the new issue, and a Jira worklog will be created.

Â