このセクションの内容:

概要

変更エクスプローラーは、コードの変更を把握し、開発中のアプリケーションへの影響を確認できるインターフェースです。変更エクスプローラーを表示するには、[ファイル - 変更済み] ウィジェットで項目をクリックするか、レビューレポートまたはレビュー指摘事項レポートでリンクをクリックします。

変更エクスプローラーは以下の 6 個のパネルから構成されます。

検索パネル: 検索パネルの使用
検索結果パネル: 検索結果の参照
ベースラインパネル: 変更のレビュー
変更パネル: 変更のレビュー
サマリーパネル: サマリー情報の参照
レビューおよび違反パネル: 指摘事項のレビュー

検索パネルの使用

変更エクスプローラーには、変更エクスプローラーを開いたウィジェットで指定されたフィルター、ベースラインビルド、およびターゲットビルドに関するデータが表示されます。簡単に検索範囲を変更して特定の情報を表示できます。

[検索条件] をクリックして [検索オプション] オーバーレイを開きます。

以下の操作を実行できます。

- フィルターを変更する: ドロップダウンメニューから新しいフィルターを選択します (詳細については「フィルターの作成と管理」を参照)。
- ベースラインビルドを指定する: ドロップダウンメニューからベースラインビルドを選択します。ベースラインビルドは、以前の状態のコードのスナップショットです。
- ターゲットビルドを指定する: ドロップダウンメニューからターゲットビルドを選択します。ターゲットビルドは、ベースラインビルドと比較して更新されたファイルを含みます。
- レビュー ID を指定する: ドロップダウンメニューからレビュー ID を選択し、特定のレビューに関連する情報を表示します。レビューは、ベースラインビルドとターゲットビルドの特定の比較に紐付けられます。たとえば、ベースラインビルド A とターゲットビルド B の変更点を見ているときにレビューを追加した場合、レビュー ID が生成されます。ビルド A をターゲットビルド C と比較する場合、このレビュー ID は検索条件として使用できません。
- ファイルのスコープを指定する: [含めるファイルのパターン] あるいは [除外するファイルのパターン] をクリックし、ファイルパスを指定して検索範囲を絞り込みます。Ant スタイルのパターンをサポートします。
検索結果パネルに結果をロードするための検索パラメーターを指定したら、[検索] をクリックします。

検索結果の参照

検索結果パネルは、検索範囲にあるファイルをモジュールごとに表示します。検索結果の色は変更を示します。緑色のファイル名は、ベースラインビルド後に追加されたファイルです。赤いファイル名は、ベースラインビルド後に削除されたファイルです。

重要な変更はアイコンで示されます。たとえば新しい静的解析違反や修正された静的解析違反などです。

ファイルをクリックすると、ベースラインビルドパネルとターゲットビルドパネルに差分が表示されます (「変更のレビュー」を参照)。

以下の画像は、変更エクスプローラーに表示されるアイコンの説明です。比較に関係する静的解析違反のアイコンは、サマリーパネルの [違反サマリー] タブで定義されます。「サマリー情報の参照」も参照してください。

ファイルをフィルタリングして、検索結果を確認しやすくすることができます。フィルターアイコンをクリックすると、フィルタリングオプションが表示されます。

オプションを選択して [OK] をクリックしてフィルターを適用するか、[キャンセル] をクリックしてフィルターを設定せずにメニューを閉じます。適用したすべてのフィルターを削除するには [消去] をクリックします。

変更のレビュー

ベースラインビルドパネルとターゲットビルドパネルで、コードの変更についてレビューし、パネルの余白に注釈を入れることができます。ファイルのバージョン間の差分がハイライトされます。詳細については「指摘事項のレビュー」を参照してください。

ソースコードビューワーの余白をクリックして指摘事項を追加します。これはインラインコメントであり、ベースラインビルドとターゲットビルドの特定の変更に関連付けられます。指摘事項がすでに存在する場合、余白にアイコンが表示されます。アイコンをクリックすると、指摘事項を表示できます。

ファイルに静的解析違反がある場合も余白にアイコンが表示されます。このアイコンをクリックすると、静的解析違反の詳細を表示できます。違反 ID のリンクをクリックすると、違反エクスプローラーで詳細を確認できます。

サマリー情報の参照

ベースラインビルドとターゲットビルドの間でのファイルの変更については、サマリーパネルで確認できます。

ベースラインビルドからターゲットビルドの間の静的解析違反の変更について確認するには、[違反サマリー] タブをクリックします。

指摘事項のレビュー

レビューパネルでは、コードの変更をレビューしたり指摘事項を追加することができます。レビューは、フィルター ID、ベースラインビルド、ターゲットビルドの特定の組み合わせに関連付けられます (「検索パネルの使用」を参照)。指摘事項は、レビューに関連付けられた個々の注釈です。

レビューが存在する場合、レビューパネルで [指摘事項のレビュー] タブをクリックすると、指摘事項の一覧を確認できます。[指摘事項のレビュー] タブには以下の情報が表示されます。

指摘事項 ID	指摘事項の一意な識別子。
ステータス	オープン、クローズ済み、または作業中。
作成者	コードを作成したユーザー。
担当者	指摘事項に割り当てられたユーザー。
優先度	指摘事項の重要度: 緊急、高、中、低、非表示、未定義。
ファイル名	指摘事項に関連付けられたソースファイル。
行	指摘事項に関連付けられたソースファイルのコード行。

表のエントリをクリックすると、ベースラインビルドまたはターゲットビルドのソースコードパネルに指摘事項が表示されます。

[ソース履歴] タブをクリックすると、選択したファイルについて以下のソース管理情報を確認できます。

リビジョン	リビジョンの一意な識別子。
日付	リビジョンの日付。
作成者	コードを作成したユーザー。
メッセージ	ファイルのリビジョンをチェックインした担当者が追加した、変更についての説明。

リビジョンはビルドでグループ化され、ターゲットまたはベースラインとしてマークされます。