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

お困りですか?

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

コミュニティに質問

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

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

CSV 形式で書き込まれている出力ファイルは、RFC 4180 に準拠しています。これらのファイルには次のような特徴があります。

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

可用性

エクスポートされるデータは、Jira アプリとバージョンによって異なります。 

必要な Jira バージョンとアプリ...
Jira SoftwareJira Service Management
課題8.144.15
フィールド 

  • システム フィールド
8.144.15
  • カスタム フィールド
8.174.17
課題履歴8.184.18
課題リンク8.194.19
SLAN/A4.15
ユーザー8.19 (スキーマ 2)4.19 (スキーマ 2)

個々のフィールドは、以下の表で特に明記されていない限り、すべてのスキーマ バージョンで利用できます。

On this page:

課題スキーマ 

課題に関連するすべてのデータは、issuesCSV ファイルにエクスポートされます。
フィールド説明
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

スキーマ: バージョン 1 のみ。このデータは Users ファイルに含まれています。

reporter_id

タイプ: 数値

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

例: 10001

reporter_name

タイプ: 文字列

説明: 課題報告者の名前

例: Omar Darboe

スキーマ: バージョン 1 のみ。このデータは Users ファイルに含まれています。

assignee_id

タイプ: 数値

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

例: 10002

assignee_name

タイプ: 文字列

説明: 課題担当者の名前

例: Jie Yang Song

スキーマ: バージョン 1 のみ。このデータは Users ファイルに含まれています。

ステータス

タイプ: 文字列

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

例: 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

タイプ: 数値

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

例: 10002

スキーマ: バージョン 1 以降 (Jira 8.19 以降が必要)

archived_date

タイプ: 日付

説明: この課題がアーカイブされた UTC タイムゾーン日付 (ISO 文字列)。

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

スキーマ: バージョン 1 以降 (Jira 8.19 以降が必要)

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

Jira Software と Jira Service Management の各フィールドのデータは issue_fields CSV ファイルにエクスポートされて、すべてのカスタム フィールドは別の行に表示されます。カスタム フィールドを対応する課題にマッピングするには、このファイルから issue_id を使用して、その課題ファイルから一致する ID を探します。

一般的に、ユーザーが生成したカスタム フィールドとアプリによって提供されるフィールドは、エクスポート可能なタイプ (フィールド 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

タイプ: 数値

説明: 特定の JSM 課題のリクエスト参加者として割り当てられたユーザー ID のリスト。

:

[10100,10101,10000]

スキーマ: バージョン 2 以降

以前のスキーマ バージョン...

スキーマ バージョン 1 では、このフィールドにユーザー ID と名前が含まれていました。スキーマ バージョン 2 以降では、名前のデータは Users ファイルに含まれています。

[ 
 { 
  "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

課題履歴スキーマ

各課題の履歴は、issue_history CSV ファイルにエクスポートされます。エクスポートの fromDate 後の履歴のみが含まれます。

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"}

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

新しいエンティティ (新しい課題リンクなど) を作成すると、from / from_string フィールドは空になり、to / to_string フィールドは作成時の値になることにご注意ください。エンティティを削除すると、from / from_stringto / to_string の各フィールドは空の値になります。値を変更すると、両側に値が表示されるはずです。

例を表示する...

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

課題間の接続に関するすべてのデータは、issue_links CSV ファイルにエクスポートされます。

フィールド

説明

inward_issue_id

タイプ: 数値

説明: 元の課題の一意の ID。

例: 10022

outward_issue_id

タイプ: 数値

説明: 目的の課題の一意の ID。

例: 10016

issue_link_type_id

タイプ: 数値

説明: 課題リンク タイプの一意の ID。

例: 10000

issue_link_type_name

タイプ: 数値

説明: blocksduplicatesrelates to などの課題リンク タイプ。

例: blocks

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

Jira Service Management からの SLA サイクル フィールドに関するデータは、sla_cycles CSV ファイルにエクスポートされます。各課題には複数の SLA が適用される場合もあります。各 SLA のサイクル (OngoingCompleted) は、個別の行に表示されます。対応する課題に SLA をマッピングするには、このファイルの issue_id を使用して課題ファイルから一致する ID を探します。
フィールド説明
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 CSV ファイルにエクスポートされます。

フィールド

説明

user_id

タイプ: 文字列

説明: ユーザーの ID

例: 10001

スキーマ: バージョン 2 以降

instance_url

タイプ: URL

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

例: https://yoursitename.com

スキーマ: バージョン 2 以降

user_name

タイプ: 文字列

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

例: jsmith

スキーマ: バージョン 2 以降

user_fullname

タイプ: 文字列

説明: ユーザーの氏名。

例: John Smith

スキーマ: バージョン 2 以降

user_email

タイプ: メール

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

例: jsmith@example.com

スキーマ: バージョン 2 以降

無効なユーザー アカウントはエクスポートに含まれません。

最終更新日: 2021 年 10 月 19 日

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

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