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

データ パイプライン

このページの内容

関連コンテンツ

お困りですか?

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

コミュニティに質問

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

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


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


課題データ スキーマ

課題に関連するすべてのデータは、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 タイムゾーンでの作成日 (ISO 文字列)。

resolution_date

DATE

2020-11-05T14:44:57Z

この課題の UTC タイムゾーンでの解決日 (ISO 文字列)。

updated_date

DATE

2020-11-05T14:44:57Z

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

due_date

DATE

2020-11-05T14:44:57Z

課題の UTC タイムゾーンでの期日 (ISO 文字列)。

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 Service Management フィールド用のデータ スキーマ

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

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

フィールド

タイプ

サンプル データ

説明

issue_id

NUMBER

10002

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

field_id

文字列

story_points

Jira Software および Jira Service Management フィールドの事前設定された 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

エピックのステータス。

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

フィールド ID

サンプル データ

説明

customer_request_type

Request new software

JSM カスタマー リクエストのカスタマー リクエスト タイプ。

organizations

["org1", "org2"]

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

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

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

satisfaction_comment

I got a prompt response. Thank you!

JSM 課題満足度調査でのコメント。

satisfaction_rating

4.0

JSM 課題満足度調査での評価。

satisfaction_scale

5.0

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

satisfaction_date

2020-10-04T18:44:13Z

満足度調査が完了した日付。

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

Jira Service Management からの SLA サイクル フィールドに関するデータは、sla_cycles_job<job_id>_<timestamp>.csv. にエクスポートされます。各課題には複数の SLA が適用される場合もあります。各 SLA のサイクル (Ongoing および / または Completed) は、個別の行に表示されます。対応する課題に SLA をマッピングするには、このファイルの issue_id を使用して、課題ファイルから一致する ID を探します。


フィールド ID

スキーマ/タイプ

サンプル データ

説明

issue_id

NUMBER

10002

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

sla_id

NUMBER

15364

SLA サイクルが属する SLA の ID。

sla_name

文字列

Time to first response

サイクルが属する SLA の名前。

cycle_type

文字列

Ongoing / Completed

現在の SLA サイクルが Ongoing か、Completed か。

start_time

NUMBER

2020-01-10T12:50:30Z

SLA サイクル開始時のタイムスタンプ。

stop_time

NUMBER

2020-01-10T12:50:30Z / empty

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

paused

ブーリアン

true / false / empty

SLA サイクルが停止中かどうか。Ongoing サイクルでのみ使用可能。

remaining_time

NUMBER

14400000 (in milliseconds)

予定の SLA 上限を超過するまでの残り時間 (ミリ秒)。

残り時間は 30 分ごとに計算され、更新されます。そのため、出力された値はその時点での実際の残り時間を表していない場合があります。

elapsed_time

NUMBER

14400000 (in milliseconds)

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

goal_duration

NUMBER

14400000 / empty (in milliseconds)

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

Last modified on Mar 22, 2021

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

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

Powered by Confluence and Scroll Viewport.