Jira

Visier can retrieve data through this connector if the following requirements are met.

For more information about the data that is retrieved through this connector, see the Connector Definitions.

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
  • Browse users and groups

Project Permissions
  • Browse projects
  • View aggregated data
  • View Read-only workflow

Generate an API token

  1. Log in to Atlassian as the integration user.
  2. Click Create API token.
  3. In the Create API token dialog, enter a name that explains what the token is for, such as Visier Connector, and then click Create.
  4. 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.