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

このページの内容

お困りですか?

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

コミュニティに質問

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

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

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

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

このページの内容

課題データ スキーマ 

課題に関連するすべてのデータは issues_job<job_id>_<timestamp>.csv にエクスポートされます。
フィールド説明
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

reporter_id

タイプ: 数値

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

例: 10001

reporter_name

タイプ: 文字列

説明: 課題報告者の名前

例: Omar Darboe

assignee_id

タイプ: 数値

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

例: 10002

assignee_name

タイプ: 文字列

説明: 課題担当者の名前

例: Jie Yang Song

ステータス

タイプ: 文字列

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

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

Jira Software および Jira Service Management フィールド用のデータ スキーマ

Jira Software と Jira Service Management の各フィールドのデータは issue_fields_job<job_id>_<timestamp>.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,
  "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

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

Jira Service Management からの SLA サイクル フィールドに関するデータは、sla_cycles_job<job_id>_<timestamp>.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

最終更新日 2021 年 7 月 1 日

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

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