Lattice's Jira integration allows users to connect their Lattice goals and have them automatically update progress when Jira is updated. This integration is only supported on Jira Cloud (your Jira board leads you to an atlassian.net URL), the Atlassian-hosted option.
Before you start
- To connect with Jira, you must be an admin in Lattice and Jira. Giving a Jira admin IT permissions in Lattice will allow them to connect the Jira integration without giving them visibility to employee data.
- Once you connect Jira with Lattice, the ability to connect Jira to a goal is not limited to those with Jira permissions. If the user belongs to the department or group set in the Connection Access settings, they will not have visibility to the issues within the query; however, they will still be able to connect.
- The JIRA integration will only track progress when the attached JIRA filter has 50 issues or less associated with it. If a filter has over 50 issues, the integration will only update based on the first 50. This filter pertains to each goal that has a Jira filter attached to it for progress tracking--not the entire integration overall.
- Lattice's integration does not touch any actual data inputs. It is a read-only API connection. The API connection will only pull in report outputs that it has been pointed towards. Additionally, a Lattice user can only access reports they have permission to view in Jira.
Connecting to Jira
- Navigate to Admin > Settings > Platform > Integrations.
- Scroll down to the Data Integrations and select Jira.
- Click Create Connection.
-
Enter the following fields:
- Connection Name: The name you want to give to the Jira connection
- Server: The server URL for your Jira instance (e.g. yourcompany.atlassian.net)
- Email: The email address of the person who created the token
-
Token: The API token from your Atlassian account. Learn how to create a token in Manage API tokens for your Atlassian account
Note: Jira offers both a general API and Admin API to its users. The API key you enter into Lattice must be generated for Jira's general API at https://id.atlassian.com/manage-profile/security/api-tokens to successfully connect.
- Connection Name: The name you want to give to the Jira connection
- (Optional) If you wish to limit the usage of the Jira connection to certain employees, expand the Limit connection access section and select the Departments or Users that should have access.
- Click Create to create the Jira integration.
After creating the integration, check out how to Connect Jira to a Goal.