Jira | Qlik Cloud Справка
Перейти к основному содержимому Перейти к дополнительному содержимому

Jira

Jira is a cloud-based platform that allows bug tracking and agile project management.

Jira integration replicates data from a Jira Cloud instance using the Jira Cloud REST API v2.

См. раздел Схема для получения списка объектов, доступных для репликации.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

Примечание к информацииУбедитесь, что используемая учетная запись имеет доступ для чтения к таблицам, которые требуется получить.

To set up a Jira connection in Qlik Talend Cloud, you need:

  • Jira permissions

    Qlik Talend Cloud can replicate only the Jira data that you can access (for example, issues, projects, and worklogs). If you cannot access specific records, Qlik Talend Cloud cannot replicate them. For more information, see Jira permission schemes.

  • Supported date locales

    Records that use date formats from the following locales are skipped:

    • Hungarian (Hungary): Magyar
    • Italian (Italy): Italiano
    • Japanese (Japan): 日本語 (日本)
    • Korean (South Korea): 한국어 (대한민국)
    • Polish (Poland): Polski
    • Thai (Thailand): ภาษาไทย
    • Turkish (Turkey): Türkçe
    • Chinese (China): 中文 (简体)
    • Chinese (Taiwan): 中文 (繁體)
    • Portuguese (Brazil): português (Brasil)
    • Portuguese (Portugal): Português (Portugal)
    • Vietnamese (Vietnam): Tiếng Việt

To generate your API token:

  1. Log into your Jira account.
  2. Navigate to User menu > Account settings > Security > Create and manage API tokens.
  3. Click Create API token.
  4. Enter a name for your new API token.
  5. Click Create.
  6. Copy and paste your API token into a secured file.

Before connecting to a self-managed (hosted) Jira instance, verify the following.

  • Your Jira server must use HTTPS. Qlik Talend Cloud does not support HTTP for security reasons. If the Jira base URL you enter in Qlik Talend Cloud does not use HTTPS, the connection will fail.
  • If your Jira instance is behind a firewall, allowlist Qlik Talend Cloud IP addresses so Qlik Talend Cloud can access the instance. For the current list, see Allowlisting domains and IP addresses.

Creating the connection

Для получения дополнительной информации см. раздел Подключение к приложениям SaaS.

  1. Заполните необходимые свойства подключения.
  2. Заполните поле Имя подключения.

  3. Установите флажок Открыть метаданные подключения, чтобы определить метаданные для подключения, когда оно будет создано.

  4. Щелкните Создать.

Connection settings
SettingDescription
Data gateway

Выберите шлюз Шлюз движения данных, если этого требует текущий сценарий использования.

Примечание к информации

Это поле недоступно при использовании подписки Qlik Talend Cloud Starter, так как она не поддерживает Шлюз движения данных. Если используется другой уровень подписки или не требуется использовать Шлюз движения данных, выберите Нет.

Для получения информации о преимуществах Шлюз движения данных и о сценариях, требующих его использования, см. раздел Шлюз данных Qlik — движение данных.

Start Date

Введите дату в формате MM/DD/YYYY, начиная с которой данные должны реплицироваться из источника в цель.

Base URLThe base URL is the main address of your Jira instance. Enter the URL you use to open Jira in a browser, for example https://yourcompany.atlassian.net.
Username or EmailEnter your email or username.
Password or TokenEnter your password or your generated token. When your Jira instance is cloud-hosted, use an API token.
GroupsOptional. User groups to include in replication.

Schema

Примечание к информации

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 2.

Depending on your destination, table and column names may not appear as they are outlined below.

changelogs

The changelogs table contains info about the changelogs associated with an issue.

Note: Due to a Jira limitation in the endpoint this connector uses to replicate changelogs, only the 100 most recent changelogs for any individual issue can be replicated. Refer to Jira documentation for more info.

Replication requirements

To replicate this data:

  1. The issues table must also be set to replicate. Note: When an issue is updated, all available changelogs for that issue will also be replicated.

  2. The Browse Projects project Jira permission is required.

Replication Method

CDC

Primary Key

id

Useful links

Jira API method

components

The components table contains info about components in projects in your JIRA account.

Replication requirements

Note: To replicate this data:

  1. The projects table must also be set to replicate, and
  2. The Browse Projects project Jira permission is required.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA API method

issue_comments

The issue_comments table contains info about comments made on issues.

Replication requirements

To replicate this data:

  1. The issues table must also be set to replicate. Note: When an issue is updated, all the comments for that issue will also be replicated.
  2. The Browse Projects project Jira permission is required.

Replication Method

CDC

Primary Key

id

Useful links

JIRA API method

issue_transitions

The issue_transitions table contains info about issue transitions.

Replication requirements

To replicate this data:

  1. The issues table must also be set to replicate. Note: When an issue is updated, all the transitions for that issue will also be replicated.
  2. The Browse Projects project Jira permission is required.

Replication Method

CDC

Loading Behavior

Append-Only

Primary Key

id

Useful links

JIRA API method

issues

The issues table contains info about the issues in your JIRA instance. This table only contains core issue data - some data is located in other tables, such as changelogs, issue_comments, and issue_transitions.

Note: To replicate this data, the Browse projects project Jira permission for the project that the issue is in is required.

Identifying deleted issues

When an issue is hard-deleted in JIRA, the record for the issue will remain in your destination. Currently, Jira’s API doesn’t include a way to identify deleted issues.

To identify deleted issues, Atlassian’s suggested workaround is:

  1. Create a status in JIRA that will be applied to issues you want to delete.
  2. Before deleting the issue, apply the status.
  3. Allow Qlik Talend Cloud to extract and load the updated data into your destination.
  4. Delete the issue.
  5. After Qlik Talend Cloud finishes loading the data, use the fields__status__name field in your queries to filter issues with the deleted status you applied in step 2.

Replication Method

CDC

Primary Key

id

Useful links

JIRA documentation

JIRA API method

project_categories

The project_categories table contains info about project categories.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA API method

project_types

The project_types table contains info about project types.

Replication Method

Full Table

Primary Key

key

Useful links

JIRA API method

projects

The projects table contains info about projects in your JIRA account.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA documentation

resolutions

The resolutions table contains info about issue resolutions.

Note: To replicate this data, the Administer Jira global Jira permission is required.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA API method

roles

The roles table contains info about the project roles in your JIRA account.

Note: To replicate this data, the Administer Jira global Jira permission is required.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA API method

users

The users table contains info about the users in your JIRA account.

Note: To replicate this data, the Administer Jira global Jira permission is required.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA API method

versions

The versions table contains info about versions in your JIRA account.

Replication requirements

Note: To replicate this data:

  1. The projects table must also be set to replicate, and
  2. The Browse Projects project Jira permission is required.

Replication Method

Full Table

Primary Key

id

Useful links

JIRA API method

worklogs

The worklogs table contains info about the worklogs in your JIRA account.

Note: For a worklog to be replicated, it must be set as Viewable by All Users, or the integration authenticating user (visible in the integration’s Integration Settings page), must be a member of the project role/group with permission to view the worklog.

If you’re missing worklogs, verify that you have the required permissions to access the worklog.

Replication Method

CDC

Primary Key

id

Useful links

JIRA API method

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице или с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом!