| Table of Contents | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Start timer in Jira and stop it in Clockify web/desktop application*
You can start a timer in any Jira issue and stop it later with one of the Clockify applications you prefer to use. The Jira issue work-log item will be added automatically.
* Webhook setup is required.
Start and stop timer in Clockify web/desktop application*
You can start/stop a timer in one of the Clockify applications if you prefer to manage all in one place. In your time entry description, you have to specify a Jira issue key like - RET-12 timer summary is here, where RET-12 is a Jira issue key. Plugin will add the Jira issue work-log item automatically.
Current use case works only for users who have registered their Clockify API token in the add-on app.
* Webhook setup is required.
Add time entry manually in Clockify web/desktop application*
You can add your time entry manually in Clockify web/desktop application and specify a Jira issue key in the description, for example - RET-12 timer summary is here, where RET-12 is a Jira issue key. Plugin will add the Jira issue work-log item automatically.
Current use case works only for users who have registered their Clockify API token in the add-on app.
* Webhook setup is required.
...
Update time entry details in Clockify web/desktop application*
The application tries to keep data sync between Jira (issue work-log items) and Clockify (time entries). So when you update your time entry in the Clockify web/desktop application, the changes automatically apply to existing "mapped" issue work-log items.
* Webhook setup is required
Delete time entry in Clockify web/desktop application*
The application tries to keep data in sync between Jira (issue work-log items) and Clockify (time entries). So when you delete your time entry in the Clockify web/desktop application, the add-on tries to find a mapped Jira issue work-log item and sets the duration equal to 0. It also adds "out of sync with Clockify" to the item description.
* Webhook setup is required
...
To support different scenarios for timer and time entry (please read sections above marked with *) - you should set up Clockify webhooks. Just follow this short video tutorial below and add 5 webhook events:
...
Navigate to the board where you would like to have timer badge and open board configuration page, see image below.
On the loaded page select “Card layout“ tab and navigate to the “Active sprints“ section.
Add a custom field that was created for you when you enabled the timer badge option (in our test example it’s - “RET: Clockify timer badge”) and save changes.
Setup timer automation rules
You can manage an automation rules that will start/stop your Clockify timer each time you change your Jira issue status.
For example - when you set the status of your Jira issue to the
| Status | ||||
|---|---|---|---|---|
|
Next steps describe how you can configure those rules:
Navigate to the Jira project and click the “Project settings” item which is located on the left sidebar menu (see screenshot below).
On the loaded page, in the same left sidebar menu, navigate and click the “Apps” drop-down. On the opened list find and click the “Clockify for Jira“ link
On the loaded page find and click the “Timer automation“ tab (see screenshot below)
In the form that will appear select needed values (statuses) by which Clockify timer will be started or stopped automatically and click “Save” button to save your changes.