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.

See the Schema section for a list of objects available for replication.

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 시작 구독에서는 사용할 수 없습니다. 다른 구독 계층이 있고 데이터 이동 게이트웨이를 사용하지 않으려면 없음을 선택합니다.

데이터 이동 게이트웨이의 이점과 이를 필요로 하는 사용 사례에 대한 자세한 내용은 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.

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

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!