Jiraとストーリーポイントを同期する方法
Jiraをプランニングポーカーに接続し、適切なフィールドを選んで見積もりを同期します。設定手順と同期されない場合の対処法を紹介します。
Jiraのバックログから課題をルームへインポートし、チームで見積もり、確定したストーリーポイントを各課題に自動で書き戻せます。手作業でコピーする必要はありません。セッション後に数値を課題へ一件ずつ入力する、時間がかかり間違いやすい作業を省けます。ここではJiraの接続、課題のインポート、見積もりとポイントの反映方法、設定後の進め方を説明します。
ツールを比較中ですか？Marketplaceアプリをインストールせずに使えるJira向けプランニングポーカーもご覧ください。
必要なもの
- Jira Cloudサイト（Jira Data Centerには対応していません）。
- Jiraプロジェクトの閲覧（課題のインポート）と課題の編集（見積もりの書き戻し）ができるアカウント。担当者個人のアカウントではなく、
[email protected]のような共有アカウントが適しています。担当者が退職すると個人トークンは使えなくなるためです。 - Jiraを接続するための、組織でPlanning Pokerを管理する権限。オーナーには標準で付与されています。
手順1：Jiraを接続
- 設定 → 連携を開き、Jira、接続の順に選びます。
- 次のいずれかで接続します。
- OAuth：Atlassianに移動し、アクセスを許可して戻ります。コピーは不要です。ワークスペースに設定済みの場合に表示されます。
- APIトークン：個人用アクセスキーです。Jiraサイト（例：
https://your-team.atlassian.net）、アカウントのメールアドレス、APIトークンを入力します。トークンはAtlassianのid.atlassian.com → Security → API tokens → Create API tokenから作成します。「with scopes」ではない通常のトークンを選びます。接続は作成したアカウントと同じ権限を持ちます。手順とエラー時の確認事項はAPIトークンでJiraに接続をご覧ください。
- テストで接続を確認します。キーは安全に保存され、再表示されません。
手順2：見積もりの送信先を選ぶ
接続直後の設定画面で、確定した見積もりをJiraに送信するか、どのフィールドに入れるかを設定します。
- 確定した見積もりを送信を有効にします。
- 見積もりを保存するJiraフィールドを選びます。サイトの数値フィールドが表示され、Story point estimateが存在すれば標準で選択されます。
- この設定は後から見積もり設定で変更できます。
どちらのフィールドを選べばよいか分からない場合は、次の説明をご覧ください。
Story PointsとStory point estimateのどちらを選ぶか
Jiraには似た見積もりフィールドが2つあります。誤った方を選ぶと、見積もりがボードに表示されません。必要なフィールドはプロジェクトの種類によって異なります。
| プロジェクト | 選ぶフィールド | 見積もり設定の場所 |
|---|---|---|
| チーム管理 | Story point estimate | スペースごと：Features → Estimation |
| 会社管理 | Story Points | ボードごと：Board → Configure → Estimation |
注意点が2つあります。
- カスタムボードは会社管理のボードと同様に動作します。 チーム管理プロジェクトでも、カスタムボードで見積もり統計として使えるのはStory Pointsだけです。Atlassianはチーム管理プロジェクトと一緒に作成されたボードの使用を推奨しています。
- プロジェクトの種類を変えると見積もりが失われることがあります。 チーム管理から会社管理へ移行する際は、ストーリーポイントを引き継ぐため「Retain」を選択します。
どちらのフィールドを使う場合でも、プロジェクトの課題画面にそのフィールドがあることを確認してください。画面にないとJiraは更新を拒否します。
手順3：課題をルームに取り込む
- ルームを作成（または既存のルームを開き）、タスクパネルでインポートを選びます。
- Jira、対象のプロジェクトの順に選びます。
- スプリント、エピック、課題タイプ、ステータスで絞り込みます。テキスト検索もできます。
- 必要な課題（またはすべて）を選択してインポートします。
すでにルームにある課題には印が付き、重複して追加されません。各タスクにはJiraキー（例：PROJ-142）、課題へのリンク、説明の冒頭部分が保存されます。
手順4：見積もる
通常どおりセッションを進めます。タスクを開き、全員が投票し、結果を公開して差を話し合い、見積もりを確定します。詳しい手順はプランニングポーカーのガイドをご覧ください。確定した数値はルームを待たせず、すぐにJira課題へ書き込まれます。ルームの履歴には見積もりを送信、または送信できなかった理由が表示されます。
送信される値と、されない値
- 数値は送信されます。 Jiraのフィールドは数値型なので、小数のポイントも利用できます。
?、☕、Tシャツサイズは送信されません。 数値ではないため、履歴には「未送信」として残ります。
チームがTシャツサイズを使う場合、ルームでそのまま利用してJiraにはストーリーポイントを手入力するか、Jiraに送るセッションでは数値デッキを使う方法があります。
Jiraの有無にかかわらず、よい見積もりをする
- スプリント中ではなく開始前に見積もる。 次に作業するバックログ項目を確認し、全員が話し合った数値を持ってスプリントを始めます。
- 尺度を1つに決めて一貫して使う。 セッションごとにフィボナッチと別のサイズを切り替えると、履歴を比較できません。
- ポイントは時間ではなく、作業量と不確実性を表す。 時間に換算しないでください。次のスプリントで扱えるポイント数は、過去のベロシティから判断します。ストーリーポイントとは何かもご覧ください。
- 範囲が変わったら再見積もりする。 議論後にタスクが大きくなったなら、再度投票する価値があります。
プランニングポーカーは複数あるアジャイル見積もり手法の一つで、合意した数値をJiraのようなトラッカーへ書き戻す用途と特に相性がよい方法です。
見積もりが送信されない場合
- 「フィールドが画面にない」または権限エラー：対象プロジェクトの課題画面にフィールドがあり、接続アカウントに編集権限があるか確認します。
- 接続が動かなくなった：トークンが無効化または期限切れになった可能性があります。連携画面でテストし、必要なら再接続してください。
- 値が数値でない：
?、☕、Tシャツサイズは送信されません。これは想定どおりです。
接続は数分で完了し、その後はセッションの数値が手入力なしで適切な場所に反映されます。
よくある質問
Jira内でプランニングポーカーを実施できますか？
Jiraと連携したプランニングポーカールームで実施します。課題をインポートしてチームで見積もると、確定したストーリーポイントが各課題に自動で書き戻されます。
ストーリーポイントはJiraのどのフィールドに入りますか？
接続時に選択した数値フィールドです。通常はStory point estimateです。ボードに表示されるフィールドを選び、課題の画面に追加されていることを確認してください。
Jira Data CenterやServerにも対応していますか？
いいえ。連携に対応しているのはJira Cloudのみです。
APIトークンとOAuthのどちらが必要ですか？
どちらでも接続できます。OAuthはワークスペースに設定済みならワンクリックで許可できます。APIトークンはAtlassianで作成し、3つの項目に入力する個人用キーです。接続後の動作は同じです。
「?」やTシャツサイズなど、数値以外の投票はどうなりますか？
数値フィールドには送信できないため、履歴に「未送信」として残ります。Tシャツサイズを使う場合はJiraにポイントを手入力するか、Jira連携用のセッションで数値デッキを使ってください。
チーム全員にJiraアカウントが必要ですか？
いいえ。Jiraアカウントは接続にのみ使います。チームメンバーはアカウントなしでリンクからルームに参加でき、Jiraへ送信されるのは確定した見積もりだけです。