レビュー (CMMI)

[アーティクル]
02/21/2013

このトピックでは、レビュー作業項目の詳細を入力する方法について学習できます。チームは、レビュー作業項目を使用してデザインレビューまたはコードレビューの結果を文書化できます。チームメンバーは、名前の正確性、コードの関連性、拡張性、コードの複雑性、アルゴリズムの複雑性、およびコードの安全性の領域において、デザインまたはコードがどのように標準を満たしているかを詳細に確認できます。詳細については、「開発タスクの実装」を参照してください。

このタイプの作業項目を作成する方法については、「作業項目とワークフロー (CMMI)」を参照してください。

このトピックの内容	関連トピック
レビューの定義要件、タスク、またはその他の作業項目へのレビューのリンクレビューへの詳細、添付ファイル、またはハイパーリンクの追加レビューの状態の変更	プロセスガイダンス開発タスクの実装フィールド参照レビュー会議のフィールド参照 (CMMI) タイトル、ID、説明、および履歴のフィールド参照割り当ておよびワークフローのフィールド参照作業項目、およびリンクコントロールと制約のリンク添付ファイルコントロールおよびフィールド参照

レビューの定義
要件、タスク、またはその他の作業項目へのレビューのリンク
レビューへの詳細、添付ファイル、またはハイパーリンクの追加
レビューの状態の変更

プロセスガイダンス

開発タスクの実装

フィールド参照

必要なアクセス許可

レビューを表示するには、読み取りユーザー グループのメンバーであるか、または [このノードの作業項目を表示します] が [許可] に設定されている必要があります。レビューを変更するには、貢献者グループのメンバーであるか、または [このノードの作業項目を編集します] のアクセス許可が [許可] に設定されている必要があります。詳細については、「アクセス許可の管理」を参照してください。

レビューの定義

レビューの作業項目フォームは、次の図に示すフィールドとタブにデータを保存します。

レビューの作業項目フォーム

レビューを定義する場合は、作業項目フォームの最上部のセクションにタイトルを定義し、[詳細] タブで目的を入力する必要があります。他のフィールドは、空白または既定値のままでかまいません。

単一のレビューを定義するには

作業項目フォームの最上部のセクションで、次のような情報を 1 つ以上指定します。
- [タイトル] (必須) に、レビューと他のレビュー作業項目を区別する簡単な説明を入力します。
  
  適切なタイトルを付けることで、レビュー済みのコードセクションまたはデザイン領域が識別されます。
- 担当者 の一覧で、レビューを担当するチームメンバーの名前を選択します。
  
  [!メモ]
  
  作業項目は、貢献者グループのメンバーにのみ割り当てることができます。
  
  レビューの担当者を割り当てない場合、レビューを定義するユーザーが自動的に担当者になります。
- [状態] ボックスでは、既定値であるアクティブをそのまま使用します。
- 招集者 のセクションでは、会議を呼びかけたチームメンバーの名前を選択します。
- 会議の種類 の一覧で、レビューに使用された会議の種類を選択します。
  
  有効な値は、[会議] または [オフライン] です。
DESCRIPTION のタブで、レビューデザインまたは基準に加え、コードの領域についてできる限り詳細に入力します。レビューに適用された。
分間のタブで、レビュー会議で得られた結果、ディスカッション、基準、および決定についてできる限り詳細に入力します。

この情報には、レビュー内容、適用された基準、特定された問題などが含まれます。
コメント のタブで、他の場所に反映されていないレビューに関するそのほかの情報を入力します。
ATTENDEES のタブで、レビューに必要な任意出席者、または実際の出席者である各チームメンバーの名前を選択します。

これらのチームメンバーは、レビュー委員会のメンバーです。
ALL LINKS のタブで、要件やタスクなどの一つ以上の作業項目のレビューをリンクします。
ATTACHMENTS のタブで、追加の指定、イメージ、または保持するレビューに関する詳細を提供する他のファイル。

詳細については、このトピックの次のセクションを参照してください。
- 要件、タスク、またはその他の作業項目へのレビューのリンク
- レビューへの詳細、添付ファイル、またはハイパーリンクの追加
作業項目の保存を選択します。

[!メモ]

レビューを保存すると、作業項目ツールバーの下のタイトルに識別子が表示されます。

要件、タスク、またはその他の作業項目へのレビューのリンク

特定の種類の作業項目への特定の種類のリンクを作成するには、[リンク] タブを使用します。詳細については、「Linking Work Items (CMMI)」を参照してください。

タスク、要件、またはその他の作業項目を作成してレビューにリンクするには

レビュー作業項目のフォームを開き、すべてのリンク のタブをクリックし、を新規作成を選択します。

[リンクされた新しい作業項目の追加] ダイアログボックスが開きます。
リンクの種類 の一覧のリンクの関連または追跡する関係を表す別の種類を選択します。
作業項目の種類 の一覧で、作成する作業項目の種類を選択します。
[タイトル] に、簡潔かつ具体的な説明を入力します。
(省略可能) [コメント] に、追加情報を入力します。
[OK] をクリックします。

指定した作業項目の種類のフォームが開き、入力した情報が表示されます。
次のトピックで説明されているように、残りのフィールドを指定します。
作業項目の保存を選択します。

1 つ以上の既存の作業項目をレビューにリンクするには

レビュー作業項目のフォームを開き、すべてのリンク のタブをクリックし、をリンク先を選択します。

[レビューへのリンクの追加] ダイアログボックスが表示されます。
リンクの種類 の一覧のリンクの関連またはで追跡し、リンクされた作業項目の種類に基づいてする関係を表す別の種類を選択します。
次のどれかの操作を実行します。
- [作業項目 ID] に、検索する作業項目の ID を入力します。複数の ID を指定するときは、コンマまたは空白で区切ります。
- 一覧から作業項目を指定するに参照を選択します。
  
  [リンクされた作業項目の選択] ダイアログボックスが表示されます。
  
  保存されたクエリ の一覧で、追加する作業項目が含まれているクエリを選択します。たとえば、作業項目を開く、アクティブなバグ、または アクティブタスクを選択できます。
  
  検索を選択し、懸案事項にリンクする選択し、OKを選択します。各作業項目の横にチェックボックスが。
- (省略可能) リンクする項目の説明を入力します。
[OK] をクリックします。

詳細については、「リンクまたはインポートする作業項目の検索」を参照してください。
作業項目の保存を選択します。

[!メモ]

リンクしたレビューと作業項目の両方が更新されます。

レビューへの詳細、添付ファイル、またはハイパーリンクの追加

追加情報は、次の方法で随時レビューに追加できます。

[詳細]、[会議メモ]、または [コメント] タブのボックスに情報を入力します。
ファイルを添付します。

たとえば、電子メールのスレッド、文書、イメージ、ログファイルなどのさまざまな種類のファイルを添付できます。
サーバーまたは Web サイト上に保存されている Web サイトまたはファイルへのハイパーリンクを追加します。

レビューに詳細を追加するには

ボックスの詳細、分、または コメント のタブと型情報をクリックします。

情報の書式を設定すると、強調文字や箇条書きリストを使用できます。

[!メモ]

チームメンバーが作業項目を更新するたびに、履歴には変更日、変更を行ったチームメンバーの名前、および変更されたフィールドが表示されます。

詳細については、「レビュー会議のフィールド参照 (CMMI)」および「タイトル、ID、説明、および履歴のフィールド参照」を参照してください。
作業項目の保存を選択します。

添付ファイルをレビューに追加するには

[添付ファイル] タブで、次のいずれかの操作を行います。
- ファイルを添付ファイル領域にドラッグします。
- CTRL-V を選択するか、コピーするファイルを貼り付けるします。
- 追加を選択し、参照を選択し、添付ファイル のダイアログボックスで、添付するファイルの名前を入力するか参照します。
  
  (省略可能) [コメント] ボックスには、添付ファイルに関する追加情報を入力します。添付ファイル のダイアログボックスを閉じるには、OKを選択します。
作業項目の保存を選択します。

レビューにハイパーリンクを追加するには

すべてのリンク のタブで、リンク先を選択します。
リンクの種類 の一覧で、ハイパーリンクを選択します。
[アドレス] ボックスで、次のいずれかの操作を行います。
- リンク先が Web サイトである場合は、[アドレス] ボックスに URL を入力するか、インターネットブラウザーから URL をコピーして貼り付けます。
- リンク先がサーバーの場所である場合は、UNC アドレスを入力します。
(省略可能) [コメント] ボックスには、ハイパーリンクに関する追加情報を入力します。
[OK] をクリックします。
作業項目の保存を選択します。

レビューの状態の変更

レビューによってデザインまたはコードを変更する必要がないことが確認されたら、レビュー作業項目を終了できます。デザインまたはコードに軽微な変更または重大な変更が必要な場合は、それを解決するために開発者にアクティブなレビュー作業項目が割り当てられます。軽微な変更のみが必要な場合、開発者はレビュー作業項目を終了できます。重大な変更が必要な場合は、2 回目のレビューが必要になります。2 回目のレビューが正常に完了した場合にのみ、レビュー作業項目を終了できます。

チームメンバーは次の状態を使用して、レビューの進行状況を追跡できます。

アクティブ
解決済み
Closed

レビューは、アクティブ状態で作成します。

作業項目の状態を追跡するために使用できるデータフィールドの詳細については、「割り当て、ワークフロー、および計画 (CMMI)」を参照してください。

レビューの状態を変更するには

レビュー作業項目を開きます。
状態の一覧で、解決済み か終了を選択します。
- 状態をアクティブから解決済みに変更すると、[理由] フィールドが自動的に [軽微な変更を伴って承諾済み] に変わります。
- 状態を解決済みから終了に変更すると、[理由] フィールドが自動的に [軽微な変更の完了] に変わります。
作業項目の保存を選択します。

通常のワークフローの流れ:

チームメンバーが、既定の理由である新規作成を指定して、アクティブ状態のレビューを作成する。
レビュー委員会が軽微な変更が行われる場合にコードは受容可能であると判断した場合、チームメンバーがレビューの状態をアクティブから解決済みに変更する。
必要な変更がすべて完了したら、チームメンバーが状態を解決済みから終了に変更する。

例外的な遷移:

チームメンバーが、既定の理由である承諾済み (現状) を指定して、状態をアクティブから終了に変更する。
レビュー委員会が、コードに重大な変更を行う必要があると判断し、状態を解決済みからアクティブに変更する。
チームメンバーが、そのレビューが誤って終了されたと判断し、状態を終了からアクティブに変更する。

レビュー状態の図

アクティブ (新規作成)

アクティブなレビュー作業項目は、デザインレビューまたはコードレビューの結果を文書化します。レビュー会議の出席者が、次に行う必要のある手順について決定します。変更の必要がなければ、レビュー作業項目を終了します。変更が必要であれば、レビュー作業項目はアクティブな状態のまま、適切な開発者に割り当てられます。開発者は、変更を完了してからレビュー作業項目を解決します。

アクティブから解決済みへ

チームメンバーは、次の表に示す理由により、アクティブなレビューを解決できます。

理由	使用する状況	追加で行う操作
軽微な変更を行った後に受容	開発者がデザインまたはコードの指摘された変更を完了したとき。	なし。
重大な変更を行った後に受容	開発者がデザインまたはコードの指摘された変更を完了したとき。	レビュー作業項目を再アクティブ化します。

チームメンバーがアクティブなレビューを解決すると、次のデータフィールドがキャプチャされます。

[解決者]: レビューを解決したチームメンバーの名前。
[解決日]: レビューが解決された日時 (サーバークロックで記録された日時)。
[状態の変更日]: レビューの状態が変更された日時。

アクティブから終了へ

チームメンバーは、レビュー委員会が理由のいかんにかかわらず変更は必要ないと決定した場合は、アクティブなレビューを終了できます。[理由] フィールドは自動的に [承諾済み (現状)] に設定されます。

チームメンバーがアクティブなレビューを終了すると、次のデータフィールドがキャプチャされます。

[終了者]: レビューを終了したチームメンバーの名前。
[終了日]: レビューが終了した日時 (サーバークロックで記録された日時)。
[状態の変更日]: レビューの状態が変更された日時。

解決済み

解決済みのレビュー作業項目は、必要な変更が軽微か重大かにかかわらず完了したことを示します。重大な変更の場合は、レビュー作業項目を終了する前に 2 回目のレビューを行う必要があります。2 回目のレビューで追加の変更が指摘された場合は、レビュー作業項目が再アクティブ化されます。

解決済みから終了へ

チームメンバーは、次の表に示す理由により、解決済みのレビューを終了できます。

理由	使用する状況	追加で行う操作
軽微な変更の完了	軽微な変更の指摘、実行、および検証が完了したとき。	レビューを製品所有者に割り当てます。

チームメンバーが解決済みのレビューを終了すると、次のデータフィールドが自動的にキャプチャされます。

[終了者]: レビューを終了したチームメンバーの名前。
[終了日]: レビューが終了した日時 (サーバークロックで記録された日時)。
[状態の変更日]: レビューの状態が変更された日時。

解決済みからアクティブへ

解決済みのレビューは、次の表に示す理由により、再アクティブ化できます。

理由	使用する状況	追加で行う操作
重大な変更の完了	問題が残っていないかどうかを検討するために、2 回目のレビューが必要なとき。	変更されたコードを検証するための別のレビュー会議を招集します。

チームメンバーが解決済みのレビューを再アクティブ化すると、次のデータが自動的にキャプチャされます。

[アクティブ化した人]: レビューを再アクティブ化したチームメンバーの名前。
[アクティブ化された日]: レビューが再アクティブ化された日時 (サーバークロックで記録された日時)。
[状態の変更日]: レビューの状態が変更された日時。

Closed

終了したレビューは、作業対象ではなくなります。ただし、レビューがスコープ内に戻った場合は、再アクティブ化できます。通常は、ビジネスアナリストまたはプログラムマネージャーが、終了したレビューを再アクティブ化します。

終了からアクティブへ

終了済みのレビュー作業項目は、レビューが完了し、必要な変更がすべて完了したことを示します。レビューが誤って終了した場合は、終了済みのレビューを再アクティブ化できます。再アクティブ化の理由が [エラーによる終了] に設定されます。

チームメンバーが終了済みのレビューを再アクティブ化すると、次のデータが自動的にキャプチャされます。

[アクティブ化した人]: レビューを再アクティブ化したチームメンバーの名前。
[アクティブ化された日]: レビューが再アクティブ化された日時 (サーバークロックで記録された日時)。
[状態の変更日]: レビューの状態が変更された日時。

参照

概念

レビュー会議のフィールド参照 (CMMI)

Visual Studio ALM の CMMI プロセステンプレート

Visual Studio ALM の作業項目フィールド参照

その他の技術情報

作業項目とワークフロー (CMMI)

次の方法で共有