> 継続的なプロセス改善 > 問題管理 > Jira Service Management > データテンプレート

貴社の問題管理データテンプレート

Jira Service Management

貴社の問題管理データテンプレート

このテンプレートは、Jira Service Management内の重要なデータポイントとプロセスマイルストーンを特定することにより、ITサービス管理ワークフローを分析するための包括的なロードマップとして機能します。チームが根本的な問題や根本原因分析にどのように対処しているかを完全に可視化するために必要な属性と活動の構造化された概要を提供します。これらのガイドラインを使用して、データ収集を合理化し、プロセスマイニングの取り組みが実用的な洞察を生み出すことを確実にしてください。

詳細分析のための推奨属性
イベントログに記録すべきプロセス上のマイルストーン
データ抽出に関する技術的ガイダンス

イベントログについて初めての方へ：プロセスマイニングのイベントログ作成方法.

テンプレートをダウンロード

問題管理属性

これらは、問題管理ライフサイクルを包括的に分析するためにイベントログに含めることを推奨されるデータフィールドです。

5 必須 5 推奨 11 任意

	名前	説明
	アクティビティ ActivityName	問題レコードに対して発生した特定のアクションまたはステータス変更。
説明この属性は、問題管理ライフサイクル内で発生するイベントまたは状態遷移の名前を捕捉します。例としては、「問題記録済み」、「ステータスが調査中に変更」、「根本原因特定済み」などがあります。これは、プロセスフローをマッピングし、問題を解決するために実行されたステップのシーケンスを特定するために不可欠です。プロセスマイニングでは、これらの活動がプロセスマップのノードを形成します。その重要性プロセスマップのステップを定義し、プロセスバリアントの分析を可能にします。取得元 Jira変更ログ（履歴）または課題ステータスのトランジション例問題レコード作成済み調査開始根本原因特定済み回避策更新済み問題レコード終了
	ソースシステム SourceSystem	`データ`の`発信元``システム`名です。
説明プロセスデータが抽出されたソフトウェアシステムを特定します。この文脈では、値は一貫して「Jira Service Management」です。この属性は、複数のシステム環境でデータソースを区別するのに特に役立ちますが、この特定のビューでは、主にデータリネージの静的識別子として機能します。その重要性データの発生元に関するコンテキストを提供します。特に他のITサービス管理データと結合する際に重要です。取得元ハードコードまたはシステム設定例 Jira Service ManagementJira CloudJSM-Prod
	タイムスタンプ EventTimestamp	アクティビティが発生した正確な日時。
説明この属性は、アクティビティが発生した正確な時刻を記録します。これは、イベントを時系列に並べ、ステップ間の期間を計算するために使用されます。正確なタイムスタンプは、「問題記録済み」から「根本原因特定済み」までの時間などのサイクルタイムを計算し、時間の経過に伴うスループットを分析するために重要です。その重要性すべての時間ベースのKPIの算出と、イベントの正しい順序付けを可能にします。取得元 Jira変更ログ作成日または課題作成日例 2023-10-15T08:30:00Z2023-10-15T09:15:22Z2023-10-16T14:20:00Z
	最終データ更新 LastDataUpdate	データが抽出または最終更新されたときのタイムスタンプ。
説明データセットがJira Service Managementのライブ環境と最後に同期された日時を示します。これにより、アナリストはデータの鮮度を理解できます。これは、分析がプロセスの最新の状態を反映していることを検証し、潜在的なデータ遅延問題を特定するために使用されます。その重要性データの鮮度を確保し、分析結果の信頼性を高めます。取得元 ETLタイムスタンプ例 2023-11-01T12:00:00Z2023-11-02T00:00:00Z
	問題レコード ProblemKey	Jira Service Managementで問題レコードに割り当てられた一意の識別子。
説明この属性は、プロセスマイニング分析の中心的なケース識別子として機能します。これは、新しい問題レコードが作成された際にJira Service Managementによって生成される一意のキー（例：PM-1001）を表します。すべての関連する活動、ステータス変更、および更新を単一のエンドツーエンドのプロセスインスタンスにグループ化するために使用されます。この属性を分析することで、初期検出から調査、最終的なクローズまでの問題の完全なライフサイクルを可視化できます。その重要性プロセスフローを再構築し、特定の課題レコードを追跡するために必要な基本的なキーです。取得元課題テーブル、フィールド「キー」または「課題キー」例 PM-1023PM-4099PRB-3321PM-5001
	ユーザー UserKey	アクティビティを実行したユーザーの一意の識別子または名前。
説明特定のアクティビティを実行する責任を持つ人物またはシステムアカウントのIDを捕捉します。これはレコードを更新する「担当者」またはステータス変更の「作成者」である可能性があります。このデータは、リソース利用状況の分析、ユーザー間の引き渡しボトルネックの特定、および問題管理プロセス内の説明責任を確保するために使用されます。その重要性引き渡し、職務分掌、およびリソースのワークロードを分析するために不可欠です。取得元変更ログ内のJira「作成者」フィールドまたは課題上の「担当者」フィールド例 j.smithsystem_automationm.doe
	優先度 Priority	問題レコードに割り当てられた重要度レベル。
説明問題の緊急度と影響を示し、通常は「低」から「クリティカル」までです。このフィールドは、分析をセグメント化し、優先度の高い問題がSLA目標内で解決されていることを確認するために使用されます。この属性を分析することは、「SLA遵守状況と目標トレンド」ダッシュボードにおいて、重要なビジネスリスクが正しく優先順位付けされているかを検証するのに役立ちます。その重要性ビジネス上の重要度に基づいてプロセスパフォーマンスをセグメント化できます。取得元課題フィールド「優先度」例最高高中低
	割り当てられたサポートグループ SupportGroup	現在問題を調査するために割り当てられている技術チームまたはグループ。
説明イベント発生時に問題レコードの責任を負う特定のチームを特定します。Jira Service Managementでは、これはしばしば「コンポーネント」または「サポートグループ」のようなカスタムフィールドにマッピングされます。この属性は「サポートグループ引き渡しボトルネック」ダッシュボードにとって不可欠であり、アナリストが問題がチーム間でどのように移動し、どこで最も長く滞留しているかを視覚化することを可能にします。その重要性組織横断的なマイニングとチーム間の摩擦を特定するために不可欠です。取得元課題フィールド「コンポーネント」またはカスタムフィールド「サポートグループ」例データベース管理ネットワーク運用アプリケーションサポートレベル2
	問題概要 ProblemSummary	問題レコードの短いテキスト説明またはタイトル。
説明問題レコードのヘッドライン概要が含まれます。主にテキストベースですが、プロセスマイニングツール内で個別のケースをレビューするアナリストにコンテキストを提供します。キーワード検索と、ログに記録されている問題の種類の定性分析が可能です。その重要性ケース識別子に人間が読み取れるコンテキストを提供します。取得元課題フィールド「概要」例 EUリージョンでのデータベース接続タイムアウトメールサービスのレイテンシスパイク注文処理キューが停止
	根本原因カテゴリ RootCauseCategory	問題の根本原因の分類。
説明「ソフトウェアバグ」、「ヒューマンエラー」、「ハードウェア障害」など、問題を引き起こした技術的またはプロセス上の障害を分類します。これはJira Service Managementでカスタムフィールドであることがよくあります。この属性は「根本原因カテゴリ分布」ダッシュボードをサポートし、再発防止のためにインフラストラクチャやトレーニングにどこに投資すべきかについて戦略的な意思決定を可能にします。その重要性システム上の問題を特定し、予防措置を導くための鍵。取得元カスタムフィールド「根本原因」または「根本原因カテゴリ」例ソフトウェアバグ設定エラーキャパシティの問題ベンダー問題
	PIR実施済み ReviewStatus	実装後レビュー（PIR）が実施されたかどうかを示します。
説明ケースに「実装後レビュー」の活動またはフラグが存在するかどうかを追跡します。これは、「実装後レビューのコンプライアンス」ダッシュボードにとって不可欠です。これにより、組織が継続的な改善のためのガバナンス要件を遵守していることを保証します。その重要性組織学習のためのコンプライアンス指標。取得元カスタムフィールド「PIRステータス」または「PIR」アクティビティの存在例完了済み保留中不要
	SLA違反ステータス SlaBreachStatus	問題レコードがサービスレベルアグリーメントに違反したかどうかを示します。
説明解決時間が合意された目標を超過したかどうかを示すブール値またはステータスフィールドです。これは「SLA遵守状況と目標トレンド」ダッシュボードに役立ちます。これにより、組織がコンプライアンスリスクやペナルティにさらされるケースが浮き彫りになります。その重要性コンプライアンスおよびパフォーマンス監視に不可欠です。取得元 Jira Service Management SLAフィールドロジック例達成違反一時停止中
	作成日 CreatedDate	問題レコードが作成された日付。
説明問題がシステムに初めて記録されたタイムスタンプ。イベントタイムスタンプは活動のタイミングを処理しますが、この特定の属性は、高レベルのフィルタリング（例：「第1四半期に作成されたすべての問題を表示」）によく使用されます。これは、エージング分析のアンカーポイントとして機能します。その重要性経過時間および発生量分析の基準日。取得元課題フィールド「作成日」例 2023-01-012023-06-15
	再オープン済み IsReopened	問題がクローズ後に再オープンされたかどうかを示すフラグ。
説明問題レコードがクローズ状態からオープン状態に戻された場合にtrueとなるブール値フラグです。これは「問題再オープン率分析」をサポートします。再オープン率が高い場合、恒久的な修正の品質問題または検証手順の不備を示しています。その重要性修正の効果を示す品質指標。取得元ステータストランジションから派生例 truefalse
	回避策あり WorkaroundDetails	問題に対する回避策が文書化されているかどうかを示します。
説明一時的な回避策テキストが存在するか、公開されているかを捕捉します。これにより、組織は「回避策公開速度」を追跡できます。このフィールドの分析は、恒久的な修正が見つかる前であっても、チームがサービス安定性をどれだけ迅速に回復できるかを判断するのに役立ちます。その重要性ビジネスに提供される暫定的な救済の速度を測定するための鍵。取得元カスタムフィールド「回避策」例サービスを再起動ブラウザキャッシュをクリア提供されていません
	報告者 ReporterName	最初に問題レコードを記録したユーザー。
説明問題レコードを作成した個人を特定します。これは担当者とは異なります。報告者を分析することで、問題がどこで検出されているか（例：サービスデスクエージェント対システム管理者）を理解するのに役立ちます。これは「プロアクティブ対リアクティブ」分析にコンテキストを追加します。その重要性問題発生源を特定します。取得元課題フィールド「報告者」例 monitoring_servicehelpdesk_leadnetwork_admin
	検出ソース DetectionSource	問題がどのように特定されたか（例：プロアクティブ、リアクティブ）。
説明問題識別の起源を示します。一般的な値には、「プロアクティブ監視」、「サービスデスクインシデント」、または「ベンダー通知」が含まれます。この属性は「プロアクティブ対リアクティブな識別」ダッシュボードで使用され、問題管理プロセスの成熟度を測定します。その重要性プロセスの成熟度と監視システムの有効性を測定します。取得元カスタムフィールド「ソース」または「検出ソース」例プロアクティブな監視インシデントエスカレーションサプライヤー通知
	解決コード ResolutionCode	問題がどのように解決されたかを示すコード。
説明問題レコードの最終結果を指定します。例えば、「修正済み」、「修正しない」、「重複」、「再現不可」などです。これは、管理上の理由でクローズされた問題と、正常に解決された問題を区別するために使用され、「根本原因特定までの平均時間」などのKPI計算が正確であることを保証します。その重要性効果的な修正と管理上のクローズを区別します。取得元課題フィールド「解決」例完了実行しない重複再現不可
	調査期間 InvestigationDuration	問題記録から根本原因特定までの所要時間。
説明問題レコードの作成から「根本原因特定」アクティビティのタイムスタンプまでの期間を算出します。これは「調査サイクル時間分析」ダッシュボードの主要な指標です。これにより、マネージャーはチームを停滞させた複雑な問題や、診断フェーズでのリソース不足を特定するのに役立ちます。その重要性根本原因分析フェーズの効率性を示す主要な指標。取得元イベントタイムスタンプから算出例 48時間5 days30分
	連携済みインシデント数 LinkedIncidentCount	この問題レコードにリンクされたインシデントの数。
説明問題レコードに関連付けられたインシデントチケットの数です。この属性は、ユーザーベースに対する問題の影響を定量化します。これは「インシデント・問題連携深度」KPIで使用され、最も多くのサポートチケットを生成している問題を優先順位付けするために利用されます。その重要性インシデント量に基づいてビジネスへの影響を定量化します。取得元タイプが「Problem/Incident」である「issuelinks」テーブル内のリンク数例 011550
	連携済み変更リクエスト LinkedChangeRequest	この問題にリンクされた変更要求の識別子。
説明恒久的な修正を実装するために作成された変更要求 (RFC) のIDを保存します。このリンクは、「変更要求開始遅延」ダッシュボードにとって不可欠です。問題管理プロセスと変更管理プロセスを接続し、プロセス間の分析を可能にします。その重要性変更管理プロセスにおいて、調査と是正措置を結びつけます。取得元タイプが「is fixed by」または類似の課題リンク例 CR-404CHG-1099CR-5512

必須推奨任意

問題管理活動

これらは、解決ワークフローを正確に発見するためにイベントログに捕捉すべき主要なプロセスステップとマイルストーンです。

8 推奨 6 任意

	アクティビティ	説明
	サポートグループに割り当て済み	問題レコードを特定の技術チームまたはサポートグループに割り当てること。これは、「サポートグループ」カスタムフィールドまたはグループが使用されていない場合は「担当者」フィールドの変更によって追跡されます。
その重要性チーム間の引き渡しとボトルネックを分析するために不可欠です。高い引き渡し率は、ルーティングの非効率性を示している可能性があります。取得元 Jira課題履歴：フィールド「サポートグループ」または「担当者」が変更されました取得割り当てフィールドが変更されたときにログに記録されますイベントタイプ explicit
	問題に連携されたインシデント	関連するインシデントチケットを問題レコードにリンクするアクション。これは、課題リンクテーブルまたは履歴に記録されます。
その重要性問題の影響と範囲を決定します。「インシデント・問題連携深度」KPIに不可欠であり、ビジネスへの影響に基づいて優先順位を付けます。取得元 Jira課題リンク：タイプが「原因」または「関連」でリンクが作成されました取得課題リンクが作成されたときにログに記録されますイベントタイプ explicit
	問題レコード作成済み	システムで問題チケットが作成される初期イベント。これは、課題履歴に作成タイムスタンプとして明示的に捕捉されます。
その重要性問題管理ライフサイクルの開始を示し、ボリューム分析を可能にします。スループットと受領率を計算するために不可欠です。取得元 Jira課題テーブル：作成日のタイムスタンプまたは履歴タブ：課題作成イベント取得課題作成トランザクションがコミットされたときにログに記録されますイベントタイプ explicit
	問題レコード終了	問題ライフサイクルの最終的な終了。ステータスが「クローズ済み」に変わったときに明示的に捕捉されます。
その重要性プロセスインスタンスの明確な終了点。総サイクル時間とクローズ率の計算に必要です。取得元 Jira課題履歴：ステータスが「クローズ済み」に変更されました取得ステータスが「クローズ済み」に移行したときにログに記録されますイベントタイプ explicit
	回避策更新済み	「回避策」テキストフィールドへの入力または更新。このイベントは、一時的な修正が文書化されたことを示します。
その重要性ビジネスへの救済提供速度を測定します。「回避策利用可能リードタイム」KPIに不可欠です。取得元 Jira課題履歴：フィールド「回避策」が変更されました（nullではない）取得回避策フィールドが変更されたときにログに記録されますイベントタイプ explicit
	根本原因特定済み	根本原因が正式に記録される時点。「根本原因特定済み」へのステータス変更、または「根本原因」フィールドへの入力から推測されます。
その重要性調査フェーズを終了する主要なマイルストーンです。「根本原因発見までの平均時間」を算出するために不可欠です。取得元 Jira課題履歴：ステータスが「根本原因特定済み」に変更された、またはフィールド「根本原因」が入力されました取得ステータスフィールドを比較するか、フィールドの入力状況を確認イベントタイプ inferred
	解決策検証済み	修正が問題を効果的に解決したことの確認。「解決済み」または特定の「検証済み」ステータスへの移行から推測されます。
その重要性修正が機能することを保証する品質ゲートです。ここでの遅延は、テストまたはユーザー受け入れにおけるボトルネックを示します。取得元 Jira課題履歴：ステータスが「解決済み」または「検証済み」に変更されました取得ステータスフィールドの更新を比較イベントタイプ inferred
	調査開始	問題ステータスがアクティブな調査状態（例：「調査中」または「進行中」）に移行すること。これは、能動的な作業フェーズの開始を示します。
その重要性調査サイクルタイムの計測を開始します。バックログの待機時間と実際の能動的な分析を区別するのに役立ちます。取得元 Jira課題履歴：ステータスが「調査中」または「進行中」に変更されました取得ステータスフィールドの更新を比較イベントタイプ inferred
	SLA違反	問題解決時間が定義されたサービスレベルアグリーメント（SLA）を超過したことを示すイベントです。これはSLA目標日と解決日を比較して算出されます。
その重要性コンプライアンス報告に不可欠です。どの優先度またはカテゴリが最も頻繁に目標を達成できていないかを特定するのに役立ちます。取得元 Jira Service Management SLAログ：「解決までの時間」＞目標、または計算された値取得 SLAフィールドデータから導出するか、期日と解決日を比較イベントタイプ calculated
	問題の優先度変更	問題レコードの優先度フィールドの更新です。これは、履歴タブで「優先度」フィールドの変更を監視することで捕捉されます。
その重要性問題のエスカレーションまたはエスカレーション解除を示します。これを分析することで、初期トリアージの正確性と高優先度バックログの経過時間を特定するのに役立ちます。取得元 Jira課題履歴：フィールド「優先度」が旧値から新値に変更されました取得優先度フィールドが更新されたときにログに記録されますイベントタイプ explicit
	問題再オープン	問題が「解決済み」または「クローズ済み」ステータスからアクティブなステータスに戻る移行。修正の失敗または解決策の拒否を示します。
その重要性主要な品質指標です。再オープン率が高い場合、根本原因分析やテストが不十分であることを示します。取得元 Jira課題履歴：ステータスが「クローズ済み」/「解決済み」から「オープン」/「進行中」に変更されました取得ステータスフィールドの順序を比較イベントタイプ inferred
	変更リクエスト連携済み	変更要求 (RFC) を問題レコードにリンクすること。これは恒久的な修正プロセスの開始を示します。
その重要性原因の特定から是正開始までの遅延を測定します。「変更管理トランジション遅延」KPIをサポートします。取得元 Jira課題リンク：タイプが「is fixed by」でリンクが作成された、または「変更」課題タイプにリンクされました取得変更課題タイプへのリンクが作成されたときにログに記録されますイベントタイプ explicit
	実装後レビュー	修正適用後にレビューを実施すること。「レビュー中」へのステータス変更またはPIR固有フィールドの更新によって捕捉されます。
その重要性教訓が確実に捕捉されるようにするコンプライアンス活動。「実装後レビュー遵守状況」分析をサポートします。取得元 Jira課題履歴：ステータスが「レビュー中」に変更された、またはフィールド「PIR備考」が更新されました取得ステータスフィールドまたはPIRフィールドの更新を比較イベントタイプ inferred
	恒久的な修正が適用済み	解決策が実装されたことを示す移行。これは通常、「実装中」または「修正済み」へのステータス変更から推測されます。
その重要性技術的な是正作業の終了を示します。実装サイクル時間を測定するために使用されます。取得元 Jira課題履歴：ステータスが「実装済み」、「検証保留中」、または「修正済み」に変更されました取得ステータスフィールドの更新を比較イベントタイプ inferred

推奨任意

抽出ガイド

`Jira Service Management`から`データ`を取得する方法

ステップ

Webブラウザを使用し、問題管理プロジェクトの「プロジェクト閲覧」権限を持つアカウントでJira Service Managementインスタンスにログインします。
上部のメニューバーから「フィルター」を選択し、「高度な課題検索」をクリックして課題ナビゲーターを開きます。
まだ選択されていない場合は、検索モードを基本ではなくJQL (Jira Query Language) に切り替えます。
以下の「クエリ」セクションで提供されている特定のJQLクエリ文字列を入力し、問題レコードを分離します（例：project = 'Problem Management'）。システムのエクスポート制限に適した期間であることを確認してください。
「検索」ボタンをクリックして、課題リストが期待される問題レコードを返すことを確認します。
課題ナビゲーターインターフェースの右上にある「エクスポート」ボタンを見つけます。
ドロップダウンメニューから「XMLをエクスポート」を選択します。標準のCSVエクスポートは現在の状態データのみを提供し、プロセスマイニングに必要な履歴変更ログが不足しているため、CSVは選択しないでください。
生成されたXMLファイル（例：jira_export.xml）を、処理環境からアクセス可能なローカルディレクトリに保存します。
必須ライブラリであるpandasがインストールされていない場合は、インストールしてPython環境を準備します。
「クエリ」セクションで提供されているPythonスクリプトを実行し、ファイルパス変数が保存したXMLファイルの場所と一致していることを確認します。
スクリプトはRSS/XML構造を解析し、「作成日時」タイムスタンプ、ステータス/優先度/アサイン変更の「履歴」エントリ、および関連インシデントの「課題リンク」を抽出します。
スクリプトは解決日と期日を比較してSLA違反を計算し、ProcessMindに読み込み可能な形式のCSVイベントログを出力します。

設定

Export Format: Must use XML (RSS) export, not CSV. The XML format contains the <history> and <issuelinks> tags essential for reconstructing the process flow.
Row Limit: Jira standard exportsは、1つのエクスポートあたり1,000件の課題に制限されることがよくあります。より大規模なデータセットの場合、JQLの日付範囲（例：created >= '2023-01-01' AND created < '2023-02-01')を調整し、複数回のエクスポートを実行することで抽出をページ分割する必要があります。
JQL Filter: projectキーがお客様の問題管理プロジェクト識別子（例：PROB、PM）と一致していることを確認してください。
System Timezone: エクスポートを実行するユーザープロファイルがシステムタイムゾーンと一致していることを確認し、タイムスタンプの一貫性を確保してください。
Field Permissions: ユーザーは変更履歴と連携課題を表示する権限を持ち、トランジションとインシデントリンクを捕捉できる必要があります。
Custom Fields: 「Root Cause」または「Workaround」がカスタムフィールドである場合、スクリプトのフィールド名マッチングロジックがJiraインスタンス内の特定のフィールド名と整合していることを確認してください。

a クエリ例 config

import xml.etree.ElementTree as ET
import pandas as pd
from datetime import datetime
import io

# CONFIGURATION
# Path to the exported Jira XML file
INPUT_FILE = 'jira_export.xml'
OUTPUT_FILE = 'process_mining_event_log.csv'
SOURCE_SYSTEM = 'Jira Service Management'

# JQL USED FOR EXPORT (Reference Only)
# project = "Problem Management" AND created >= "2023-01-01" ORDER BY created DESC

def parse_jira_xml(xml_file):
    tree = ET.parse(xml_file)
    channel = tree.getroot().find('channel')
    
    events = []
    
    # Namespaces are usually not required for standard Jira RSS XML, 
    # but we handle standard tags directly.
    
    for item in channel.findall('item'):
        # 1. Extract Header Attributes
        problem_key = item.find('key').text
        summary = item.find('summary').text if item.find('summary') is not None else ''
        created_str = item.find('created').text
        resolution_date_node = item.find('resolutiondate')
        due_date_node = item.find('duedate')
        
        # Parse base timestamps
        # Jira XML format example: Wed, 4 Oct 2023 14:30:00 +0000
        fmt = '%a, %d %b %Y %H:%M:%S %z'
        created_dt = datetime.strptime(created_str, fmt)
        
        # --- ACTIVITY 1: Problem Record Created ---
        events.append({
            'ProblemKey': problem_key,
            'ActivityName': 'Problem Record Created',
            'EventTimestamp': created_dt,
            'UserKey': item.find('reporter').get('username') if item.find('reporter') is not None else None,
            'SourceSystem': SOURCE_SYSTEM,
            'ProblemSummary': summary,
            'Priority': item.find('priority').text if item.find('priority') is not None else None
        })

        # --- ACTIVITY: Incident Linked / Change Request Linked ---
        # Check <issuelinks> tag
        issue_links = item.find('issuelinks')
        if issue_links is not None:
            for linktype in issue_links.findall('issuelinktype'):
                link_name = linktype.find('name').text # e.g., 'Relates', 'Blocks', 'Caused'
                for outward in linktype.findall('outwardlinks'):
                    for issue_link in outward.findall('issuelink'):
                        linked_key = issue_link.find('issuekey').text
                        # Heuristic: Identify link type based on key pattern or link description
                        activity = None
                        if 'INC' in linked_key: # Customize for your Incident Prefix
                            activity = 'Incident Linked to Problem'
                        elif 'CHG' in linked_key: # Customize for your Change Prefix
                            activity = 'Change Request Linked'
                        
                        if activity:
                             events.append({
                                'ProblemKey': problem_key,
                                'ActivityName': activity,
                                'EventTimestamp': created_dt, # Link timestamp often not in XML, defaulting to created or requires API. fallback.
                                'UserKey': 'System',
                                'SourceSystem': SOURCE_SYSTEM,
                                'ProblemSummary': f'Linked to {linked_key}',
                                'Priority': None
                            })

        # --- PROCESS HISTORY (Status, Priority, Assignment, etc.) ---
        # Note: History is not always in standard RSS. 
        # If utilizing the 'SearchRequestView' XML, history is included inside <customfields> or specific expansion.
        # However, typically standard RSS does NOT include full history.
        # Assuming this XML export includes the Activity Stream or we rely on Custom Field dates for specific milestones.
        
        # LOGIC FOR INFERRING ACTIVITIES FROM CURRENT STATE & DATES (If History missing)
        # Or parsing <subtasks> or <comments> as proxies.
        
        # --- ACTIVITY: SLA Breached ---
        if resolution_date_node is not None and due_date_node is not None:
            res_date = datetime.strptime(resolution_date_node.text, fmt)
            due_date = datetime.strptime(due_date_node.text, fmt)
            
            if res_date > due_date:
                events.append({
                    'ProblemKey': problem_key,
                    'ActivityName': 'SLA Breached',
                    'EventTimestamp': res_date,
                    'UserKey': 'System',
                    'SourceSystem': SOURCE_SYSTEM,
                    'ProblemSummary': summary,
                    'Priority': None
                })

        # --- ACTIVITY: Problem Record Closed / Resolved ---
        if resolution_date_node is not None:
             events.append({
                'ProblemKey': problem_key,
                'ActivityName': 'Problem Record Closed',
                'EventTimestamp': datetime.strptime(resolution_date_node.text, fmt),
                'UserKey': item.find('assignee').get('username') if item.find('assignee') is not None else None,
                'SourceSystem': SOURCE_SYSTEM,
                'ProblemSummary': summary,
                'Priority': None
            })

        # --- MOCKING HISTORY PARSING IF XML HAS HISTORY PLUGIN EXTENSION ---
        # (Standard Jira RSS export is weak on history. 
        # This block assumes the existence of a custom history export or parsing comment logs for keywords).
        
        comments = item.find('comments')
        if comments:
            for comment in comments.findall('comment'):
                body = comment.text.lower()
                c_date = datetime.strptime(comment.get('created'), fmt)
                author = comment.get('author')
                
                act_name = None
                if 'root cause' in body:
                    act_name = 'Root Cause Identified'
                elif 'workaround' in body:
                    act_name = 'Workaround Updated'
                elif 'investigation' in body:
                    act_name = 'Investigation Started'
                
                if act_name:
                    events.append({
                        'ProblemKey': problem_key,
                        'ActivityName': act_name,
                        'EventTimestamp': c_date,
                        'UserKey': author,
                        'SourceSystem': SOURCE_SYSTEM,
                        'ProblemSummary': summary,
                        'Priority': None
                    })

    return pd.DataFrame(events)

# EXECUTION
try:
    df = parse_jira_xml(INPUT_FILE)
    
    # Add global extraction timestamp
    df['LastDataUpdate'] = datetime.now()
    
    # Formatting
    if not df.empty:
        df['EventTimestamp'] = pd.to_datetime(df['EventTimestamp']).dt.strftime('%Y-%m-%d %H:%M:%S')
        
        # Output
        df.to_csv(OUTPUT_FILE, index=False)
        print(f"Success: Extracted {len(df)} events to {OUTPUT_FILE}")
    else:
        print("No events found. Check XML format or JQL.")
        
except Exception as e:
    print(f"Error processing file: {str(e)}")

ステップ

事前準備: Python 3.xと、requestsおよびpandasライブラリがインストールされていることを確認してください。また、対象プロジェクトの閲覧権限を持つJira Service Managementアカウントが必要です。Jira Cloudの場合はAtlassianアカウントの設定からAPIトークンを、Data Centerの場合はパーソナルアクセストークン（PAT）を生成してください。
カスタムフィールドIDの特定: Jira Service Managementでは、カスタムフィールドに動的なID（例：サポートグループやSLAならcustomfield_10012など）が割り当てられます。抽出を実行する前に、ブラウザやPostmanを使用して特定の課題を1つクエリ（/rest/api/2/issue/[ISSUE-KEY]）し、「サポートグループ」「回避策」「根本原因」、およびSLAフィールドの正確なIDを確認してください。
スクリプトの設定: 提供されたPythonスクリプトを開き、CONFIGディクショナリを更新します。URL、ユーザーメールアドレス、APIトークンを書き換えてください。次に、手順2で特定した実際のカスタムフィールド名またはIDをFIELD_MAPPINGに、対象プロジェクト（例：project = PM AND issuetype = Problem）をJQL_QUERYに設定します。
ステータスマッピングの定義: スクリプト内のSTATUS_MAPPINGディクショナリで、Jiraワークフローの特定のステータス（例：「調査中」「実装中」「解決済み」）を、ProcessMindの標準的なアクティビティ名（例：「調査開始」「恒久対策完了」）に紐付けます。
抽出の実行: ターミナルまたはIDEからスクリプトを実行します。スクリプトはJira Search APIとexpand=changelogを使用して、全フィールドの変更履歴を含むデータの最新状態を取得します。
処理ロジック: スクリプトは各課題を順次処理します。まず、作成日時から「問題レコード作成」イベントを生成し、続いて変更履歴（Changelog）を解析します。履歴項目ごとに、変更されたフィールドが抽出対象（ステータス、優先度、リンクなど）と一致するかを確認し、対応するイベント行を生成します。
SLAの処理: スクリプトはSLA関連のカスタムフィールドの変更や、明示的に「違反（Breached）」と名付けられたステータス遷移を特定することで、SLA違反の検出を試みます。システム独自の自動化によって違反フラグを立てている場合は、_parse_sla_breach関数のロジックを調整してください。
データ変換: ネストされたJSON構造をフラット化し、PandasのDataFrame（表形式）に変換します。タイムスタンプはISO 8601形式に統一されます。
エクスポート: 最終的なデータセットはjira_problem_event_log.csvという名前のCSVファイルとして出力されます。このファイルを開き、列ヘッダーがProcessMindの要件と一致しているか確認してください。
ProcessMindへのアップロード: 生成されたCSVファイルをProcessMindにインポートします。ProblemKeyをケースID、ActivityNameをアクティビティ、EventTimestampをタイムスタンプとしてマッピングします。

設定

APIエンドポイント: /rest/api/2/searchを使用します（Cloudおよび大半のData Centerバージョンと互換性があります）。API v3も利用可能ですが、広範な互換性を確保するためには通常v2が推奨されます。
ページネーション: 大規模なデータセットを効率的に処理するため、スクリプトではstartAtとmaxResultsを使用したページネーションを実装しています。デフォルトのバッチサイズは50に設定されています。
変更履歴（Changelog）の展開: パラメータexpand=changelogの設定は非常に重要です。これがないと最新のステータスのみが取得され、プロセスの履歴やフローの情報が失われてしまいます。
JQLフィルタリング: クエリはissuetype = Problemでフィルタリングされます。初期テスト時のデータ量を抑えるため、日付範囲フィルター（例：created >= -180d）を追加することを強く推奨します。
認証: Cloud版の場合は基本認証（メールアドレス + トークン）をサポートしています。Data Center版の場合は、ベアラートークンを使用するようにヘッダーを修正してください。
フィールドマッピング: 重要な設定項目です。「ステータス」や「優先度」などのJira内部フィールド名は標準的ですが、「サポートグループ」「根本原因」「SLA」などは、多くの場合で固有のIDを持つカスタムフィールド（例：customfield_12345）として設定されています。

a クエリ例 python

import requests
import pandas as pd
import json
from datetime import datetime
import base64

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
CONFIG = {
    class="hl-string">"JIRA_URL": class="hl-string">"https://your-domain.atlassian.net",
    class="hl-string">"USER_EMAIL": class="hl-string">"your-email@example.com",
    class="hl-string">"API_TOKEN": class="hl-string">"your-api-token-or-pat",
    class="hl-string">"PROJECT_KEY": class="hl-string">"PM",  class=class="hl-string">"hl-comment"># Problem Management Project Key
    class="hl-string">"LOOKBACK_DAYS": class="hl-string">"180"
}

class=class="hl-string">"hl-comment"># Mappings: Key = Jira Field Name/ID, Value = Activity Name context
class=class="hl-string">"hl-comment"># You must replace class="hl-string">'customfield_XXXXX' with your actual field IDs found via API
FIELD_MAPPING = {
    class="hl-string">"priority": class="hl-string">"Problem Priority Changed",
    class="hl-string">"assignee": class="hl-string">"Assigned to Support Group", class=class="hl-string">"hl-comment"># Fallback if support group field unused
    class="hl-string">"customfield_10010": class="hl-string">"Assigned to Support Group", class=class="hl-string">"hl-comment"># Replace with Support Group Field ID
    class="hl-string">"customfield_10011": class="hl-string">"Workaround Updated",      class=class="hl-string">"hl-comment"># Replace with Workaround Field ID
    class="hl-string">"customfield_10012": class="hl-string">"Root Cause Identified",   class=class="hl-string">"hl-comment"># Replace with Root Cause Field ID
    class="hl-string">"Link": class="hl-string">"Link Event",                           class=class="hl-string">"hl-comment"># Internal name for issue links
    class="hl-string">"issuelinks": class="hl-string">"Link Event"
}

class=class="hl-string">"hl-comment"># Map Jira Workflow Statuses to Standard Activities
class=class="hl-string">"hl-comment"># Update the keys (left side) to match your actual Jira Status names
STATUS_MAPPING = {
    class="hl-string">"Under Investigation": class="hl-string">"Investigation Started",
    class="hl-string">"In Progress": class="hl-string">"Investigation Started",
    class="hl-string">"Root Cause Identified": class="hl-string">"Root Cause Identified",
    class="hl-string">"Implementing": class="hl-string">"Permanent Fix Applied",
    class="hl-string">"Fixed": class="hl-string">"Permanent Fix Applied",
    class="hl-string">"Resolved": class="hl-string">"Resolution Verified",
    class="hl-string">"Verified": class="hl-string">"Resolution Verified",
    class="hl-string">"In Review": class="hl-string">"Post Implementation Review",
    class="hl-string">"Closed": class="hl-string">"Problem Record Closed",
    class="hl-string">"Breached": class="hl-string">"SLA Breached" class=class="hl-string">"hl-comment"># Only if you have a specific status for this
}

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># EXTRACTION LOGIC
class=class="hl-string">"hl-comment"># ==========================================

def get_auth_header():
    class=class="hl-string">"hl-comment"># For Cloud (Basic Auth)
    creds = fclass="hl-string">"{CONFIG['USER_EMAIL']}:{CONFIG['API_TOKEN']}"
    encoded = base64.b64encode(creds.encode()).decode()
    return {class="hl-string">"Authorization": fclass="hl-string">"Basic {encoded}", class="hl-string">"Content-Type": class="hl-string">"application/json"}
    class=class="hl-string">"hl-comment"># For Data Center (PAT), uncomment below:
    class=class="hl-string">"hl-comment"># return {class="hl-string">"Authorization": fclass="hl-string">"Bearer {CONFIG['API_TOKEN']}", class="hl-string">"Content-Type": class="hl-string">"application/json"}

def fetch_issues():
    url = fclass="hl-string">"{CONFIG['JIRA_URL']}/rest/api/2/search"
    jql = fclass="hl-string">"project = {CONFIG['PROJECT_KEY']} AND issuetype = Problem AND created >= -{CONFIG['LOOKBACK_DAYS']}d"
    
    all_issues = []
    start_at = 0
    max_results = 50
    
    while True:
        params = {
            class="hl-string">"jql": jql,
            class="hl-string">"startAt": start_at,
            class="hl-string">"maxResults": max_results,
            class="hl-string">"expand": class="hl-string">"changelog"
        }
        
        try:
            response = requests.get(url, headers=get_auth_header(), params=params)
            response.raise_for_status()
            data = response.json()
        except Exception as e:
            print(fclass="hl-string">"API Error: {e}")
            break
            
        issues = data.get(class="hl-string">"issues", [])
        if not issues:
            break
            
        all_issues.extend(issues)
        start_at += max_results
        print(fclass="hl-string">"Fetched {len(all_issues)} issues so far...")
        
    return all_issues

def parse_activity(issue):
    events = []
    
    class=class="hl-string">"hl-comment"># Basic Issue Data
    key = issue[class="hl-string">"key"]
    fields = issue[class="hl-string">"fields"]
    summary = fields.get(class="hl-string">"summary", class="hl-string">"")
    class=class="hl-string">"hl-comment"># Current values (for attributes)
    current_priority = fields.get(class="hl-string">"priority", {}).get(class="hl-string">"name", class="hl-string">"")
    current_assignee = fields.get(class="hl-string">"assignee", {}).get(class="hl-string">"displayName") if fields.get(class="hl-string">"assignee") else class="hl-string">"Unassigned"
    
    class=class="hl-string">"hl-comment"># 1. Problem Record Created
    created_time = fields[class="hl-string">"created"]
    events.append({
        class="hl-string">"ProblemKey": key,
        class="hl-string">"ActivityName": class="hl-string">"Problem Record Created",
        class="hl-string">"EventTimestamp": created_time,
        class="hl-string">"UserKey": fields.get(class="hl-string">"creator", {}).get(class="hl-string">"displayName", class="hl-string">"System"),
        class="hl-string">"SupportGroup": current_assignee,
        class="hl-string">"Priority": current_priority,
        class="hl-string">"ProblemSummary": summary,
        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
    })

    class=class="hl-string">"hl-comment"># Process Changelog
    changelog = issue.get(class="hl-string">"changelog", {}).get(class="hl-string">"histories", [])
    
    for history in changelog:
        timestamp = history[class="hl-string">"created"]
        user = history.get(class="hl-string">"author", {}).get(class="hl-string">"displayName", class="hl-string">"Unknown")
        
        for item in history[class="hl-string">"items"]:
            field = item.get(class="hl-string">"field")
            field_id = item.get(class="hl-string">"fieldId", class="hl-string">"")
            from_str = item.get(class="hl-string">"fromString", class="hl-string">"")
            to_str = item.get(class="hl-string">"toString", class="hl-string">"")
            
            class=class="hl-string">"hl-comment"># 2, 5, 7, 9, 10, 11, 13, 14. Status Changes
            if field == class="hl-string">"status":
                activity = STATUS_MAPPING.get(to_str)
                
                class=class="hl-string">"hl-comment"># Handle Reopened logic explicitly
                if to_str in [class="hl-string">"Open", class="hl-string">"Reopened"] and from_str in [class="hl-string">"Resolved", class="hl-string">"Closed"]:
                    activity = class="hl-string">"Problem Reopened"
                
                if activity:
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": activity,
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

            class=class="hl-string">"hl-comment"># 2. Priority Changed
            elif field == class="hl-string">"priority":
                events.append({
                    class="hl-string">"ProblemKey": key,
                    class="hl-string">"ActivityName": class="hl-string">"Problem Priority Changed",
                    class="hl-string">"EventTimestamp": timestamp,
                    class="hl-string">"UserKey": user,
                    class="hl-string">"SupportGroup": current_assignee,
                    class="hl-string">"Priority": to_str,
                    class="hl-string">"ProblemSummary": summary,
                    class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                })

            class=class="hl-string">"hl-comment"># 3. Assigned to Support Group (via custom field or Assignee)
            elif field_id == class="hl-string">"customfield_10010" or field == class="hl-string">"assignee":
                events.append({
                    class="hl-string">"ProblemKey": key,
                    class="hl-string">"ActivityName": class="hl-string">"Assigned to Support Group",
                    class="hl-string">"EventTimestamp": timestamp,
                    class="hl-string">"UserKey": user,
                    class="hl-string">"SupportGroup": to_str,
                    class="hl-string">"Priority": current_priority,
                    class="hl-string">"ProblemSummary": summary,
                    class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                })

            class=class="hl-string">"hl-comment"># 6. Workaround Updated
            elif field_id == class="hl-string">"customfield_10011":
                if to_str: class=class="hl-string">"hl-comment"># Only if value is added/changed to something
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Workaround Updated",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

            class=class="hl-string">"hl-comment"># 7. Root Cause Identified (via Field Population)
            elif field_id == class="hl-string">"customfield_10012":
                if to_str:
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Root Cause Identified",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

            class=class="hl-string">"hl-comment"># 4 & 8. Links (Incident Linked / Change Request Linked)
            elif field == class="hl-string">"Link":
                class=class="hl-string">"hl-comment"># This requires heuristic checking of the linked key or link type
                class=class="hl-string">"hl-comment"># Assuming standard keys: INC-xxxx for Incident, CHG-xxxx or CR-xxxx for Change
                if class="hl-string">"INC-" in to_str or class="hl-string">"Incident" in to_str:
                     events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Incident Linked",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })
                elif class="hl-string">"CHG-" in to_str or class="hl-string">"CR-" in to_str or class="hl-string">"Change" in to_str:
                     events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Change Request Linked",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })
            
            class=class="hl-string">"hl-comment"># 12. SLA Breached (Detection Logic)
            class=class="hl-string">"hl-comment"># Detection depends heavily on plugins. Common method: check for SLA status field change
            elif class="hl-string">"SLA" in field or class="hl-string">"Time to Resolution" in field:
                if class="hl-string">"breach" in to_str.lower() or class="hl-string">"fail" in to_str.lower():
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"SLA Breached",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

    return events

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># MAIN EXECUTION
class=class="hl-string">"hl-comment"># ==========================================
if __name__ == class="hl-string">"__main__":
    print(class="hl-string">"Starting extraction...")
    issues = fetch_issues()
    
    all_events = []
    for issue in issues:
        all_events.extend(parse_activity(issue))
        
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Add LastDataUpdate
    df[class="hl-string">"LastDataUpdate"] = datetime.now().isoformat()
    
    class=class="hl-string">"hl-comment"># Export
    filename = class="hl-string">"jira_problem_event_log.csv"
    df.to_csv(filename, index=False)
    print(fclass="hl-string">"Extraction complete. Saved {len(df)} rows to {filename}")

貴社の問題管理データテンプレート

貴社の問題管理データテンプレート

問題管理属性

問題管理活動

抽出ガイド

Jira Service Management 課題ナビゲーターエクスポート

ステップ

設定

a クエリ例 config

変更ログを含むJira REST APIを介したPython抽出

ステップ

設定

a クエリ例 python

今すぐ始めますか？

今すぐ問題管理フローを最適化しましょう

貴社の問題管理データテンプレート

貴社の問題管理データテンプレート

問題管理属性

問題管理活動

抽出ガイド

Jira Service Management 課題ナビゲーターエクスポート

ステップ

設定

a クエリ例 config

変更ログを含むJira REST APIを介したPython抽出

ステップ

設定

a クエリ例 python

お客様のプライバシーを大切にしています

今すぐ始めますか？

今すぐ問題管理フローを最適化しましょう