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

このページの内容

お困りですか?

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

コミュニティに質問

Jira の現在の状態データをエクスポートしたあと、それを理解できるように表示する必要があります。そのためには、そのスキーマを理解する必要があります。そうすることで、既存のデータ管理プラット フォームまたはビジネス インテリジェンス ツールで適切に表示する方法を設定できます。 

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


  1. 各ファイルにはヘッダーがあります。空のファイルにはヘッダーが含まれていません (これは将来のリリースで修正されます)。
  2. 改行は CRLF 文字 \r\n で区切られます。
  3. 改行 (CRLF)、二重引用符、およびカンマを含むフィールドは、二重引用符で囲まれます。
  4. フィールド内に二重引用符が存在する場合、フィールド内で使用される二重引用符の前には、別の二重引用符を付けてエスケープします (例:"aaa", "b""bb", "ccc")。
  5. CSV エクスポートでは、データのないフィールド (Null 値) は、2 つの連続した区切り文字で表されます (例:,,)。
  6. 埋め込まれた改行は、既定でエスケープされ \n と出力されます。この設定方法については、「データ エクスポートの設定」を参照してください。


On this page:

課題データ スキーマ

課題に関連するすべてのデータは、issues_job<job_id>_<timestamp>.csv にエクスポートされます。このファイルのスキーマは次のように表示されます。

フィールド

スキーマ/タイプ

サンプル データ

説明

id (主キー)

NUMBER

10002

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

instance_url

文字列

http://www.example.com/jira

現在のインスタンスのベース URL。

url

文字列

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

課題へのリンク/URL。

key

文字列

TEST-1002

この課題の一意のキー。

project_key

文字列

TEST

この課題が含まれるプロジェクトのキー。

project_name

文字列

Sample Test Project

この課題が含まれるプロジェクトの名前。

project_type

文字列

Business / Software / Service Desk

この課題が含まれるプロジェクトのタイプ。

project_category

文字列

Sample Project Category

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

issue_type

文字列

Task

この問題のタイプ (例: タスク、バグ、エピック)

summary

文字列

Sample issue

課題の要約。

description

文字列

This is a sample issue for demo purposes.

課題の説明。フィールドは 2000 文字に切り捨てられます。

creator_id

NUMBER

10000

ディレクトリに関係なく、作成者の一意の識別子

creator_name

文字列

Some Name

現在の作成者の名前。

reporter_id

NUMBER

10001

ディレクトリに関係なく、報告者の一意の識別子

reporter_name

文字列

Other Name

報告者名。

assignee_id

NUMBER

10002

ディレクトリに関係なく、担当者の一意の識別子。

assignee_name

文字列

Another Name

担当者の名前。

status

文字列

In Progress

この課題の現在のステータス。

status_category

文字列

In Progress

この課題の現在のステータスのステータス カテゴリ。

priority_sequence

NUMBER

3

優先順位を表示します。ただし、管理者はこれを変更できるため、決定的でない優先順位の順序になります。

priority_name

文字列

Medium

この課題の優先度の名前。

resolution

文字列

Done

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

watcher_count

NUMBER

5

この課題に対するウォッチャーの数。

vote_count

NUMBER

4

この課題に対する投票数。

created_date

DATE

2020-11-05T14:44:57Z

UTC timezone creation date of this issue (ISO string).

resolution_date

DATE

2020-11-05T14:44:57Z

UTC timezone resolution date of this issue (ISO string).

updated_date

DATE

2020-11-05T14:44:57Z

UTC timezone date that the issue was last updated (ISO string).

due_date

DATE

2020-11-05T14:44:57Z

The issue's UTC timezone due date (ISO string).

estimate

NUMBER

5000 (in seconds)

初期見積から残り時間を見積もります (タイム トラッキングを有効にする必要があります)。

original_estimate

NUMBER

2000  (in seconds)

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

time_spent

NUMBER

4000  (in seconds)

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

labels

STRING[]

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

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

components

STRING[]

["component_a", "component_b"]

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

parent_id

NUMBER

10001

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

environment

文字列

"linux”

課題が発生した環境の簡単な説明 (例: IE9 on Windows 7)。このフィールドには 2000 文字の文字数制限があります

affected_versions

STRING[]

["a_version_1", "a_version_2"]

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

fix_versions

STRING[]

["f_version_1", "f_version_2"]

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

security_level

文字列

test-security-level

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

Jira Software フィールド データ スキーマ

Jira Software フィールドのデータは issue_fields_job<job_id>_<timestamp>.csv にエクスポートされ、すべてのカスタム フィールドは別の行に表示されます。カスタム フィールドを対応する問題にマッピングするには、このファイルから issue_id を使用して、その課題ファイルから一致する ID を見つけます。 

ユーザー生成のカスタム フィールドはエクスポートされません。

フィールド

タイプ

サンプル データ

説明

issue_id

NUMBER

10002

課題データ スキーマ内の対応する課題にリンクする ID です。

field_id

文字列

story_points

Jira Software フィールドの事前設定された ID。

field_name

文字列

Story Points

フィールドの名前。

field_value

NUMBER/STRING/JSON ARRAY

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

フィールドの値。

次の Jira Software フィールドは、非エピックの課題フィールドです。

フィールド ID

サンプル データ

説明

sprint

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

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

epic_link_id

10000

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

story_points

5

この課題に関連するストーリー ポイントの数。

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


フィールド ID

サンプル データ

説明

epic_color

ghx-label-3

エピックの色。

epic_name

Test Epic

エピックの名前。

epic_status

To Do

エピックのステータス。

Last modified on Mar 5, 2021

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

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