バグ (アジャイル)
このトピックでは、バグ作業項目の詳細を入力する方法について学習できます。バグ作業項目を作成する方法については、「作業項目とワークフロー (アジャイル)」を参照してください。
このトピックの内容 |
関連トピック |
---|---|
バグの作成と追跡の概要
|
プロセス ガイダンス ブック ダッシュボードとレポート フィールド参照 |
必要なアクセス許可
バグを表示するには、読み取りユーザー グループのメンバーであるか、または [このノードの作業項目を表示します] が [許可] に設定されている必要があります。バグを作成または変更するには、貢献者グループのメンバーであるか、または [このノードの作業項目を編集します] のアクセス許可が [許可] に設定されている必要があります。詳細については、「アクセス許可の管理」を参照してください。
バグの定義
バグとは、チームが開発しているコード内に問題がある可能性を伝えるものです。バグを定義する場合は、閲覧者が問題の影響をすべて理解できるように、問題を正確に報告する必要があります。また、バグを見つけた際に行った操作を記述して、他のチーム メンバーが容易にその動作を再現できるようにする必要があります。テスト結果は、問題を明確に示す必要があります。明確に理解できるように記述することにより、バグを修正できる可能性が高まります。
バグの作業項目フォームは、次の図に示すフィールドとタブにデータを保存します。
バグを定義する場合は、作業項目フォームの最上部のセクションに [タイトル] を定義する必要があります。他のフィールドは、空白または既定値のままでかまいません。
バグを定義するには
バグ用作業項目フォームの最上部のセクションで、次のフィールドを 1 つ以上指定します。
[タイトル] に、見つけたコード障害についての説明を入力します (必須)。
[担当者] の一覧で、バグの修正を担当するコントロールを選択するか、トリアージの際に割り当てます。このフィールドを空白のままにしてチーム メンバーの名前を指定します。
[!メモ]
作業項目は、貢献者グループのメンバーにのみ割り当てることができます。
[区分] と [イテレーション] の一覧で、適切な区分とイテレーションをクリックするか、計画またはトリアージ会議のときに割り当てます。これらのフィールドを空白のままにします。
[!メモ]
各チーム プロジェクトのプロジェクト管理者は、プロジェクトの区分とイテレーション パスを定義することで、チームがその指定によって進行状況を追跡できるようにします。詳細については、「区分およびイテレーションの作成および修正」を参照してください。
**[スタック順位]**では、同じイテレーションの他のバグと比較した場合のバグの相対的な重要度を示す数値を入力します。
[優先度] の一覧で、1は最も重要である。4は最も重要である、バグの優先度を示す値を選択します。
既定では、このフィールド値は 2 です。
[深刻度] の一覧で、プロジェクトのバグの影響を示す値を選択します。
既定では、このフィールド値は [3 - 中] です。
[再現手順] のタブに、別のチーム メンバーが修正する必要のある問題について理解するために必要な詳細な情報を入力します。
このフィールドに入力する内容は書式設定できます。
[システム情報] のタブで、次のような情報を一つ以上指定します。:
[発見されたビルド] の一覧で、障害が検出されたビルドの名前を選択または入力します。
[!メモ]
各ビルドには、関連付けられた一意のビルド名があります。ビルド名を定義する方法については、「Customize Build Numbers」を参照してください。
バグを作成する際は、[ビルドに統合] にはビルドを指定しないでください。バグを解決するときに、コードを取り込むか、またはバグを修正するビルドの名前を入力します。
[システム情報] に、バグが発見されたソフトウェア環境を記述します。
[HISTORY] のタブで、必要に応じて詳細を提供します。
ここに入力する内容は書式設定できます。
チーム メンバーがバグを更新するたびに、履歴には変更日、変更を行ったチーム メンバー、および変更されたフィールドが表示されます。
(省略可能) テスト ケースや別のバグなど、別の作業項目にバグをリンクします。
これらのアクティビティの詳細については、このトピックの「テスト ケースとバグのリンク」を参照してください。
作業項目ツール バーで、**[作業項目の保存]**を選択 します。
[!メモ]
バグを保存すると、作業項目ツール バーの下のタイトルに識別子が表示されます。
テスト ケースとバグのリンク
テスト ケースとバグをリンクすることにより、MSF for Agile Software Development 用に定義されている多くのレポートの正確性と完全性を確保できます。
既存のテスト ケースをバグにリンクするには
[テスト ケース] のタブで、**[リンク先]**を選択 します。
[バグへのリンクの追加] ダイアログ ボックスが表示されます。
[リンクの種類] は既定値である [テスト担当者] のままにします。[テスト ケース] タブで追加するリンクでサポートされているリンクの種類はこれだけです。
**[作業項目 ID]**では、バグをリンクする入力するか、をリンクするテスト ケースを検索するに [参照] を選択します。一つ以上のテスト ケースのIDが。テスト ケースを検索し、リンクするテスト ケースの横のチェック ボックスをオンにする [担当テスト ケース] のチーム クエリを選択できます。
詳細については、「リンクまたはインポートする作業項目の検索」を参照してください。
(省略可能) リンクするテスト ケースの説明を入力します。
[OK] をクリックします。
**[作業項目の保存]**を選択 します。
[!メモ]
リンクしたバグとテスト ケースの両方が更新されます。
バグへの詳細、添付ファイル、またはハイパーリンクの追加
他のメンバーがバグを再現したり修正したりできるように、バグの情報を追加することができます。バグへの詳細の追加は、次の方法で実行します。
[再現手順] または [履歴] の各フィールドに情報を入力します。
ファイルを添付します。
たとえば、電子メールのスレッド、文書、イメージ、ログ ファイルなどのさまざまな種類のファイルを添付できます。
サーバーまたは Web サイト上に保存されている Web サイトまたはファイルへのハイパーリンクを追加します。
バグに詳細を追加するには
[詳細] のタブをクリックします。
[再現手順] に情報を入力します。
(省略可能) [履歴] に情報を入力します。
テキストの書式を設定すると、強調文字や箇条書きリストを使用できます。詳細については、「タイトル、ID、説明、および履歴のフィールド参照」を参照してください。
**[作業項目の保存]**を選択 します。
バグに添付ファイルを追加するには
[添付ファイル] タブで、次のいずれかの操作を行います。
ファイルを添付ファイル領域にドラッグします。
選択 するか、コピーするファイルを貼り付けるにCTRL-Vを押します。
Choose **[追加]**は、を [参照]を選択します。[添付ファイル] ダイアログ ボックスで、添付するファイルの名前を入力するか参照します。
(省略可能) [コメント] ボックスには、添付ファイルに関する追加情報を入力できます。[添付ファイル] のタブに戻るには、**[OK]**を選択します。
**[作業項目の保存]**を選択 します。
バグにハイパーリンクを追加するには
[すべてのリンク] のタブで、**[リンク先]**を選択 します。
[リンクの種類] の一覧で、**[ハイパーリンク]**を選択します。
[アドレス] ボックスに、リンク先のアドレスを入力します。
リンク先が Web サイトである場合は、[アドレス] ボックスに URL を入力するか、インターネット ブラウザーから URL をコピーして貼り付けます。リンク先がサーバーである場合は、アドレスを UNC 名の形式で入力します。
(省略可能) [コメント] ボックスには、ハイパーリンクに関する追加情報を入力します。
**[OK]を選択し、[作業項目の保存]**を選択 します。
バグの解決と終了
バグが修正されたら、その状態をアクティブから解決済みに変更します。修正が検証されたら、その状態を解決済みから終了に変更します。バグの状態はどのチーム メンバーでも変更できます。また、後で説明するように、修正できないバグでも、他の理由によって解決済みにすることができます。詳細については、「割り当ておよびワークフローのフィールド参照」を参照してください。
バグを解決または終了するには
バグの作業項目フォームを開きます。
[状態] の一覧で、[解決済み] か **[終了]**を選択します。
状態をアクティブから解決済みに変更すると、[理由] フィールドが修正済みに変わります。
[理由] の値が正しいことを確認するか、別のオプションを選択します。
詳細については、このトピックの「アクティブから解決済みへ」を参照してください。
状態を解決済みから終了に変更すると、"理由" フィールドが検証済みに変わります。
**[作業項目の保存]**を選択 します。
通常のワークフローの流れ:
その他のワークフローの流れ:
|
バグの状態 |
アクティブ (新規またはビルド エラー)
チーム メンバーが、バグを作成してわかりやすいタイトルを付け、バグについてのできるだけ詳細な情報を [説明] に追加します。バグの状態は、調査および修正中はアクティブのままになります。
アクティブから解決済みへ
バグを解決する際、次の表に示す理由のいずれかを指定できます。
理由 |
使用する状況 |
追加で行う操作 |
---|---|---|
修正済み (既定) |
バグにより示される問題を修正し、問題が修正されたことを確認するための単体テストを実行して、変更されたコードをチェックインした後。 |
修正をチェックインする際、バグを変更セットにリンクします。 |
遅延 |
現在のイテレーションでバグを修正しない場合。バグは、チームが今後のイテレーションまたは製品バージョン用に再検証できるようになるまで、延期されます。 |
(省略可能) バグを今後のイテレーションまたはバックログに移動し、アクティブ状態のままにします。 |
Duplicate |
別のアクティブなバグが同じ問題を報告している場合。 |
重複バグを作成したチーム メンバーがバグを終了する前に重複を簡単に検証できるように、アクティブのままのバグへのリンクを作成します。 |
仕様 |
バグが、システムで予測される状態または動作を示している、またはそのバグが影響するアプリケーション領域またはユーザー ストーリーのいずれかにおいて承認基準外である場合。 |
なし。 |
再現不可能 |
チーム メンバーが、バグが報告する動作を再現できない場合。 |
なし。 |
廃止 |
バグがその製品に適用されなくなった場合。たとえば、バグが製品に既に存在しない機能領域についての問題を示している場合など。 |
なし。 |
バグの状態がアクティブから解決済みに変わると、次のデータ フィールドが自動的にキャプチャされます。
[解決者]: バグを解決したチーム メンバーの名前。
[解決日]: バグが解決された日時 (サーバー クロックで記録された日時)。
[状態の変更日]: バグの状態が変更された日時。
解決済み
バグの修正を担当するチーム メンバーが、バグを修正して解決します。または、次の表に示すように、チーム メンバーが、他の理由によりバグを解決済みにする必要があると判断する場合もあります。
解決済みから終了へ
バグの終了についてサポートされる理由は、検証済みであることのみです。
バグの状態が解決済みから終了に変わると、次のデータ フィールドが自動的にキャプチャされます。
[終了者]: バグを終了したチーム メンバーの名前。
[終了日]: バグが終了した日時 (サーバー クロックで記録された日時)。
[状態の変更日]: バグの状態が変更された日時。
解決済みからアクティブへ
解決済みとなっているバグを再アクティブ化する際、次の表に示す理由のうちいずれかを指定できます。
理由 |
使用する状況 |
追加で行う操作 |
---|---|---|
修正なし |
解決が承認できない場合、または修正が正しくない場合。 |
解決を否定する理由、または修正が正しく機能しなかった理由を詳しく説明します。この情報は、次にこのバグを担当するメンバーがバグの解決に役立てることができる内容にします。 |
テスト失敗 |
テストにより、バグがまだ存在していることが実証された場合。 |
どのビルドでどのテストが失敗したかを詳しく説明します。 |
バグの状態が解決済みからアクティブに変わると、次のデータ フィールドが自動的にキャプチャされます。
[アクティブ化した人]: バグを再アクティブ化したチーム メンバーの名前。
[アクティブ化された日]: バグが再アクティブ化された日時 (サーバー クロックで記録された日時)。
Closed
チーム メンバーは、バグによって示される問題またはコード障害が再び現れた場合、またはそもそも修正されていなかった場合、終了のバグをアクティブに変更することができます。
終了からアクティブへ
終了となっているバグを再アクティブ化する際、次の表に示す理由のうちいずれかを指定できます。
理由 |
使用する状況 |
追加で行う操作 |
---|---|---|
回帰 |
コードの後のビルドでバグが再出現した場合。 |
なし。 |
再アクティブ化済み |
バグがエラーまたはその他の理由により終了していた場合。 |
なし。 |
バグの状態が終了からアクティブに変わると、次のデータ フィールドが自動的にキャプチャされます。
[アクティブ化した人]: バグを再アクティブ化したチーム メンバーの名前。
[アクティブ化された日]: バグが再アクティブ化された日時 (サーバー クロックで記録された日時)。