Creating connection to Jira
This only applies if you are hosting ManicTime Server yourself. It does not apply if you are using ManicTime Cloud.
Before users can make a connection to Jira to get issues, ManicTime Server needs to be connected to Jira.
- On Jira, go to Jira developer console. Then click on the Create and OAuth 2.0 integration.
Jira developer console |
Fill the name field
For Permissions you need to add Scopes for Jira API. Required scopes are:
- View Jira issue data
- View user profiles
- Create and manage issues
Permissions tab |
Needed scopes |
- To get the Authorization callback url for the callback Url field in Authorization Tab, go back to ManicTime server, Administration and under Jira configuration, you will see a list of possible Redirect Uris.
Possible redirect Uris |
- Copy one of them to Jira Callback URL field.
Jira Authorization |
- Go to settings tab where you will see client Id and secret.
Jira Client Id and Secret fields |
- Copy Client ID and secret to ManicTime Server Jira Connection Configuration screen.
Copy Client Id and Secret to ManicTime Server Jira Configuration screen |
- Click "Test connection" to see if the connection is set properly, then save it.
When you click "Test connection", you will go through the authentication process, like all users who will try to connect to Jira.
Editing or deleting configuration
Any changes to Client Id or Secret will delete existing connections for all users.
If you delete the configuration all users data will be also deleted.
Connection settings
In the Jira configuration settings, you have the ability to control the visibility of issues for users. You can set up various filters to determine which issues a user can see. These filters can be based issue states (opened or resolved), time frames (e.g., issues closed in the last X days) and assignment to users.
One important setting in Jira is the "Authenticated user" setting. This refers to a specific user account that is used to authenticate and query data from Jira. This user should have access to all projects you want to import issues from.
Users then need to go to Administration -> My connections and authenticate with Jira, and the tags should be visible in the add tag window.
Syncing time with Jira
Please note that users must use tags that came from Jira to successfully send tags back to Jira.
This connection also has the ability to send tags back to Jira as worklogs. You can enable this feature in Connection settings. The user needs to use tags from Jira and then they are automatically sent back to Jira every 2 hours or you can send tags to Jira manually, if you click the Sync now button. The connection can send tags for a maximum of 30 days back. Tags are assigned to the Jira user that corresponds to the ManicTime user who created the Jira tag.
Sync now and Sync reports buttons |
You can also see status of the synced tags, if you click Sync reports where you have a summary for every sync. If you click on it you have a detailed report for synced tags.
Sync reports |
Sync report |