データ パイプライン エクスポート スキーマ

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このページでは、Jira データ エクスポート ファイルの構造とデータ スキーマについて説明します。

データ パイプラインを設定して構成する方法については、「データ パイプライン」をご参照ください。

CSV 形式で書き込まれている出力ファイルは、RFC 4180 に準拠しています。これらのファイルには次のような特徴があります。
  • 各ファイルにはヘッダーがあります。これには結果的にデータのないエクスポートからのファイルも含まれます。
  • 改行は CRLF 文字 \r\n で区切られます。
  • 改行 (CRLF)、二重引用符、およびカンマを含むフィールドは、二重引用符で囲まれます。
  • フィールド内に二重引用符がある場合、フィールド内で使用される二重引用符の前には別の二重引用符を付けてエスケープします ( "aaa""b""bb""ccc" など)。
  • CSV エクスポートでは、データのない (Null 値) フィールドは 2 つの連続した区切り文字で表されます (例: ,,)。
  • 組み込まれた改行はデフォルトでエスケープされて、n として印刷されます。 

Fields are available in all schema versions, unless specifically noted below.

このページの内容

課題スキーマ 

All data relating to issues will be exported to issues CSV file. 
フィールド説明
id (主キー)

タイプ: 数値

説明: この課題の一意の ID。主キーとして使用します。

例: 10002

instance_url

タイプ: 文字列

説明: 現在のインスタンスのベース URL

例: http://www.example.com/jira

URL

タイプ: 文字列

説明: 課題の URL

例: http://www.example.com/jira/browse/TEST-1002

鍵 (キー)

タイプ: 文字列

説明: この課題の一意のキー

例: TEST-1002

project_key

タイプ: 文字列

説明: この課題があるプロジェクトのキー

例: TEST

project_name

タイプ: 文字列

説明: 課題があるプロジェクトのタイトル

例: Sample Test Project

project_type

タイプ: 文字列

説明: 課題があるプロジェクトの種類 (ビジネス、ソフトウェア、サービス デスクなど)

例: Software

project_category

タイプ: 文字列

説明: この課題が含まれるプロジェクトに割り当てられたカテゴリー

例: Sample Project Category

issue_type

タイプ: 文字列

説明: 課題の種類 (タスク、バグ、エピックなど)

例: Task

要約

タイプ: 文字列

説明: 課題の要約

例: Sample issue

description

タイプ: 文字列

説明: 課題の説明 (2000 文字以内)

例: This is a sample issue for demo purposes.

creator_id

タイプ: 数値

説明: 課題を作成したユーザーの一意の ID (ディレクトリとは無関係)

例: 10000

creator_name

タイプ: 文字列

説明: ユーザー課題作成者の名前

例: Alana Grant

Schema: Version 1 only. This data is now contained in the Users file.

reporter_id

タイプ: 数値

説明: 課題報告者の一意の ID (ディレクトリとは無関係)

例: 10001

reporter_name

タイプ: 文字列

説明: 課題報告者の名前

例: Omar Darboe

Schema: Version 1 only. This data is now contained in the Users file.

assignee_id

タイプ: 数値

説明: 課題担当者の一意の識別子 (ディレクトリとは無関係)

例: 10002

assignee_name

タイプ: 文字列

説明: 課題担当者の名前

例: Jie Yang Song

Schema: Version 1 only. This data is now contained in the Users file.

ステータス

タイプ: 文字列

説明: この課題の現在のステータス

例: Not Started

status_category

タイプ: 文字列

説明: この課題に関する現在のステータスのステータス カテゴリー

例: In Progress

priority_sequence

タイプ: 文字列

説明: 優先順位 (管理者はこれを変更できるため、仮決まりの優先順位の順序になります)

例: 3

priority_name

タイプ: 文字列

説明: この課題の優先順位の名前

例: Medium

resolution

タイプ: 文字列

説明: 課題の最終ステータス。Jira は [解決状況] フィールドに値が存在すると、課題のワークフローが完了したと見なします。

例: Done

watcher_count

タイプ: 数値

説明: この課題をウォッチしているユーザー数

例: 5

vote_count

タイプ: 数値

説明: この課題の投票数

例: 4

created_date

タイプ: 日付

説明: この課題の UTC タイムゾーンにおける作成日 (ISO 文字列)

例: 2020-11-05T14:44:57Z

resolution_date

タイプ: 日付

説明: この課題の UTC タイムゾーンにおける解決日 (ISO 文字列)

例: 2020-11-05T14:44:57Z

updated_date

タイプ: 日付

説明: 課題が最後に更新された UTC タイムゾーン日付 (ISO 文字列)

: 2020-11-05T14:44:57Z

due_date

タイプ: 日付

説明: 課題が完了する予定の UTC タイムゾーン日付 (ISO 文字列)

例: 2020-11-05T14:44:57Z

見積

タイプ: 数値

説明: 初期見積から残り時間を秒単位で推定します (タイム トラッキングを有効にする必要があります)。

例: 5000

original_estimate

タイプ: 数値

説明: 秒単位で設定された初期見積 (タイム トラッキングを有効にする必要があります)

例: 2000

time_spent

タイプ: 数値

説明: 記録された作業量 (秒単位) (タイム トラッキングを有効にする必要があります)。消費時間がない場合、フィールドは null になります。

例: 4000

labels

タイプ: 文字列

説明: ラベル名の JSON 配列。ラベルがない場合、フィールドは null になります。

例: ["test-label", "test2-label”]

コンポーネント

タイプ: 文字列

説明: コンポーネント名の JSON 配列。ラベルがない場合、フィールドは null になります。

例: ["component_a", "component_b"]

parent_id

タイプ: 数値

説明: 親課題の ID。課題がサブタスクでない場合、フィールドが null になります。

例: 10001

environment

タイプ: 文字列

説明: 課題が発生した環境の簡単な説明 (例: IE9 on Windows 7)。このフィールドは 2000 文字以内です

例: "linux”

apected_versions

タイプ: 文字列

説明: 影響を受けるバージョン名の JSON 配列。ラベルがない場合、フィールドは null になります。

例: ["a_version_1", "a_version_2"]

fix_versions

タイプ: 文字列

説明: 修正バージョン名の JSON 配列。ラベルがない場合、フィールドは null になります。

例: ["f_version_1", "f_version_2"]

security_level

タイプ: 文字列

説明: セキュリティ レベル名。: これは、データ エクスポート間で変更される可能性があります。

例: staff-only

archived_by_user_id

タイプ: 数値

Description: Unique identifier of the user who archived the issue, regardless of directory.

例: 10002

Schema: Version 1 and later (requires Jira 8.19 or later)

archived_date

タイプ: 日付

Description: UTC timezone date this issue was archived (ISO string).

Example: 2020-11-05T14:44:57Z

Schema: Version 1 and later (requires Jira 8.19 or later)

Jira Software フィールドと Jira Service Management フィールド用のフィールド スキーマ

Data from Jira Software and Jira Service Management fields will be exported to the issue_fields CSV file and every custom field is displayed on a separate row. To map a custom field to its corresponding issue, use the issue_id from this file and find its matching ID from the Issues file. 

一般的に、ユーザーが生成したカスタム フィールドとアプリによって提供されるフィールドは、エクスポート可能なタイプ (フィールド implement ExportableCustomFieldsType) である限り含まれます。

カスタム フィールドに値が含まれない場合は、エクスポートされません。

フィールド説明
issue_id

タイプ: 数値

説明: 課題データ スキーマ内の対応する課題にリンクする ID

例: 10002

field_id

タイプ: 文字列

説明: Jira Software フィールドと Jira Service Management フィールドの事前設定された ID。

例: story_points

field_name

タイプ: 文字列

説明: フィールドの名前

例: Story Points

field_value

タイプ: 数値、文字列、JSON 配列

説明: フィールドの値

: 4 / [{"sprintName": "A"}, {"sprintName": "B"}]/5000

次の Jira Software フィールドは、エピックに関連していません。
sprint

タイプ: JSON

説明: 課題が現在発生している、または以前から発生していたスプリント。すべての日時は UTC タイムゾーンで ISO 文字列としてフォーマットされます。

:

[
  {
    "id": 2,
    "name": "Sample Sprint 1",
    "goal": "",
    "boardId": 1,
    "state": "FUTURE",
    "startDate": "2020-09-20T19:44:13Z",
    "endDate": "2020-10-04T18:44:13Z",
    "endDate": "2020-10-04T18:44:13Z"
  }
]
epic_link_id

タイプ: 数値

説明: この課題にリンクされているエピックの ID

例: 10000

story_points

タイプ: 数値

説明: この課題に関連付けられているストーリー ポイントの数

例: 5

次の Jira Software フィールドは、エピックに関連しています。
pic_color

タイプ: 文字列

説明: エピックの色

例: ghx-label-3

epic_name

タイプ: 文字列

説明: エピックの名前

例: Test Epic

epic_status

タイプ: 文字列

説明: エピックのステータス

例: To Do

Jira Service Management に関連するフィールドは以下のとおりです。
customer_request_type

タイプ: 文字列

説明: JSM カスタマー リクエストのカスタマー リクエスト タイプ

例: Request new software

組織

タイプ: 文字列

説明: 特定の JSM 課題に割り当てられた組織のリスト。組織とは管理者が顧客を分類できるエンティティです。

: ["org1", "org2"]

request_participants

タイプ: 数値

Description: List of users IDs assigned as request participants for a given JSM Issue.

:

[10100,10101,10000]

Schema: Version 2 and later

Earlier schema versions...

In schema version 1, this field contained the user ID and name. From schema version 2, name data is contained in the Users file.

[ 
 { 
  "id": 10100, 
  "name": "User 1 display name" 
 }, 
 { 
  "id": 10101, 
  "name": "user 2 display name" 
 } 
]
satisfaction_comment

タイプ: 文字列

説明: JSM 課題満足度調査の一環として入力されたコメント

例: I got a prompt response. Thank you!

satisfaction_rating

タイプ: 文字列

説明: JSM 課題満足度調査の一環として入力された評価

例: 4.0

satisfaction_scale

タイプ: 文字列

説明: 特定の満足度の基準となる尺度 (最大評価)

例: 5.0

satisfaction_date

タイプ: 日付

説明: 満足度調査が完了した日付

例: 2020-10-04T18:44:13Z

課題履歴スキーマ

The history of each issue will be exported to issue_history CSV file. Only history after the export fromDate will be included.

issue_id フィールドを使用して、このテーブルを Issues テーブルと Fields テーブルに結合します。

フィールド説明

issue_id (外部キー)

タイプ: 数値

説明: この課題の一意の ID。この課題テーブルにある対応する課題にリンクします。

例: 10002

changelog_id

タイプ: 数値

説明: 同時に行われた変更や一連の変更の ID。フィールドと組み合わせて、1 つの変更を識別します。

例: 10456

author_id

タイプ: 数値

説明: 変更を行ったユーザーの一意の ID。

例: 10000

author_key

タイプ: 文字列

説明: 変更の作成者の一意の ID を一意の文字列として指定します。

例: JIRAUSER10000

created_date

タイプ: 日付

説明: この変更 (ISO 文字列) の UTC タイムゾーンの日付。分単位に切り捨てられます。

例: 2021-05-12T23:01:42Z

field

タイプ: 文字列

説明: 変更されたフィールドの名前。

例: assignee (担当者)

field_type

タイプ: 数値

説明: 変更されたフィールドのタイプ (Jira またはカスタム)

例: jira

from

タイプ: 文字列

説明: 変更前のフィールドの値の ID。2000 文字以内。

例: JIRAUSER10001

from_string

タイプ: 文字列

説明: 変更前のフィールドの値 (文字列型)。2000 文字以内。

例: Alana Grant

to

タイプ: 文字列

説明: 変更後のフィールドの値の ID。2000 文字以内。

例: JIRAUSER10002

to_string

タイプ: 文字列

説明: 変更後のフィールドの値を文字列として指定します。2000 文字以内。

例: Omar Darboe

additional_information

タイプ: 文字列

説明: 変更に関連する追加情報 (JSON 形式)。

例:
{"old_status_category_id":"2",
"old_status_category_name":"New",
"new_status_category_id":"4",
"new_status_category_name":"In Progress"}

課題履歴のエクスポートには時間がかかります。また、課題の詳細の取得後、課題が更新される可能性もわずかながらあります。これによって、課題ファイルの更新日が課題履歴ファイルの最終変更よりも前になる場合があります。

例を表示する...

たとえば、DEV-456 が 10:02:00 に、さらに 15 秒後にも更新されたとします。データ パイプラインがその瞬間に課題の詳細を取得していた場合、課題ファイルの更新時間は 10:02:00 となりますが、課題の履歴ファイルには 10:02:15 に行われた変更が含まれます。

All data relating to connections between issues will be exported to issue_links CSV file. 

フィールド

説明

inward_issue_id

タイプ: 数値

Description: Unique ID of the source issue.

例: 10022

outward_issue_id

タイプ: 数値

Description: Unique ID of the destination issue.

Example: 10016

issue_link_type_id

タイプ: 数値

Description: Unique ID of the issue link type.

例: 10000

issue_link_type_name

タイプ: 数値

Description: Issue link type, such as blocks, duplicates, relates to.

例: blocks

SLA サイクル データ スキーマ (Jira Service Management のみ)

Data relating to SLA Cycle fields from Jira Service Management will be exported to sla_cycles CSV file. Each issue can have multiple SLAs, where each SLA cycle (Ongoing and/or Completed) is displayed on a separate row. To map an SLA to its corresponding issue, use the issue_id from this file and find its matching ID from the Issues file.
フィールド説明
issue_id

タイプ: 数値

説明: 課題データ スキーマ内の対応する課題にリンクする ID

例: 10002

sla_id

タイプ: 数値

説明: SLA サイクルが属する SLA の ID

例: 15364

sla_name

タイプ: 文字列

説明: サイクルが属する SLA の名前

例: Time to first response

cycle_type

タイプ: 文字列

説明: 現在の SLA が OngoingCompleted

例: Ongoing

start_time

タイプ: 日付

説明: SLA サイクルが開始された時刻のタイムスタンプ

例: 2020-01-10T12:50:30Z

stop_time

タイプ: 日付

説明: SLA サイクルの Ongoing から Completed へのトランジション時のタイムスタンプ。Ongoing サイクルでのみ利用可能です。

例: 2020-01-10T12:50:30Z

paused

タイプ: ブール

説明: SLA サイクルが一時停止しているかどうかを示します。真、偽、または空にできます。Ongoingサイクルでのみ利用できます。

例: True

remaining_time

タイプ: 数値

説明: 予定の SLA 上限を超過するまでの残り時間 (ミリ秒)。残り時間は 30 分ごとに計算されて更新されます。そのため、出力された値はその時点での実際の残り時間を表していない場合があります。

例: 14400000

elapsed_time

タイプ: 数値

説明: SLA サイクル開始時からの経過時間 (ミリ秒)。

例: 14400000

goal_duration

タイプ: 数値

説明: 現在のサイクルを完了するのに要した時間 (ミリ秒)。Completed サイクルでのみ利用可能です。

例: 14400000

Users schema

All data relating to issues will be exported to users CSV file. 

フィールド

説明

user_id

タイプ: 文字列

説明: ユーザーの ID

例: 10001

Schema: Version 2 and later

instance_url

タイプ: URL

説明: 現在のインスタンスのベース URL。

例: https://yoursitename.com

Schema: Version 2 and later

user_name

タイプ: 文字列

説明: ユーザーのユーザー名

例: jsmith

Schema: Version 2 and later

user_fullname

タイプ: 文字列

説明: ユーザーの氏名。

例: John Smith

Schema: Version 2 and later

user_email

タイプ: メール

説明: ユーザーのメール アドレス

例: jsmith@example.com

Schema: Version 2 and later

Disabled user accounts are not included in the export.

最終更新日 2021 年 8 月 26 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.