Jira
Visier can retrieve data through this connector if the following requirements are met.
Prerequisites
- Create an integration user in Jira.
Integration user
Create an integration user in your source system and assign it the appropriate security access so that Visier can retrieve your source data through this user.
You must be a Jira admin to change permissions:
- To access global permissions, click Settings
> System > Global Permissions.
- To access project permissions, click Settings
> Work items > Permission Schemes. Jira admins manage project permissions for company-managed projects through permission schemes.
Permission Type |
Required Permissions |
---|---|
Global Permissions |
|
Project Permissions |
|
Generate an API token
- Log in to Atlassian as the integration user.
- Click Create API token.
- In the Create API token dialog, enter a name that explains what the token is for, such as Visier Connector, and then click Create.
- Copy the generated token and save it somewhere safe as you will need to provide the credentials in Visier.
Connector credentials
You need to provide the following credentials to Visier so that we can retrieve data from your source system. To provide your credentials in Visier, see Set Up Data Connectors.
Credential |
Description |
Example |
---|---|---|
API Token |
The generated token for the integration user. |
Mixed-case alphanumeric string |
Hostname |
The subdomain of your Jira instance. To identify the hostname, look at your JIRA, which typically follows this format: https://<hostname>.atlassian.net. For example, if your URL is https://lumon-ind.atlassian.net, then the hostname is lumon-ind. |
lumon-ind |
Data files
The Jira data connector retrieves the following data types:
- Board
- Component
- Custom Fields
- Issue
- Issue Change Log
- Issue Comment
- Issue Component
- Issue Label
- Issue Link
- Issue Type
- Issue Work Log
- Priority
- Project
- Project Version
- Project Workflow
- Resolution
- Sprint
- Status
- User with Date
How the connector loads data
Initially, data connectors retrieve a full history for each subject to generate an initial history of events. In each subsequent data retrieval, each connector handles the data load differently.
- Full load: All data from the source system is loaded into Visier.
- Delta load: Only changed data is loaded into Visier. A delta load may take either the entire history or a specific number of years of history for each changed record.
- Snapshot load: All data at a particular point in time. A snapshot load does not contain historical records or show changes over time.
- Partial load: A subset of data is loaded into Visier.
After the initial load, this connector only retrieves data for changed records. For changed records, this connector retrieves the record's full history. You can configure how many years of history is retrieved.