簡単なウォークスルー: デフォルトのコード行数と複雑度レポートをカスタマイズする

簡単な例として、デフォルトのコード行数と複雑度レポートのカスタマイズをリハーサルすることができます。この例で metrics.xml ファイルに精通できるので、より複雑なカスタマイズ (独自レポートタイプの追加など) を実行できるようになります。この例では、Validate で変更内容が表示されることを確認する必要がある箇所についても示します。

'複雑度' と 'サイズ' のレポート名は予約されており、使用できません。

デフォルトのコード行数と複雑度レポートをカスタマイズするには:

  1. 次のファイルをバックアップします。<projects_root>/config/metrics.xml
  2. 編集する元の metrics.xml ファイルを開きます。
  3. コード行数レポートの場合、変更できるのは、Validate のレポートタイプリストに表示されるラベルだけです。このラベルを変更するには、<name> 要素の値を編集します (デフォルトでは 'コード行数')。

    例として、<name> 要素の値を "Lines of Code" に変更します。

    <category catid="TotalMetricValue">

    <metric>

    <name>コード行</name>

    <description>コード行</description>

    <!--involved kw internal metric kinds-->

    <kids>45,84</kids>

    <enable>true</enable>

    </metric>

    </category>

  4. 複雑度レポートの場合:
    • 短いタイトル (Validate のレポートタイプリストに表示されるラベル) を変更するには、<name> 要素の値を編集します (デフォルトでは「Complexity」)。
    • デフォルトしきい値 (Validate の編集可能な [しきい値] フィールドに表示される値) を変更するには、<default_threshold> 要素の値を編集します (デフォルトでは 20)。

    例として、<default_threshold> 要素の値を 10 に変更します。

    <category catid="EntityCountOverThreshold">

    <metric>

    <name>My Complexity</name>

    <description>Method Complexity >{threshold}</description>

    <kids>135</kids>

    <entityKids></entityKids>

    <default_threshold>10</default_threshold>

    <enable>true</enable>

    </metric>

    </category>

  5. ファイルを保存します。
  6. Validate サーバーを validate service restart または Windows Services 管理で再起動します。

    Validate ユーザーがログインしたとき、または [レポート] ページを更新したときに、行った変更の内容がすべてのユーザーに表示されます。変更内容が正しく表示されていることを確認します。

  7. Validate にログインします。
  8. プロジェクトの [レポート] をクリックします。

  9. [新規レポートの作成] をクリックします。

    レポートタイプを既に表示している場合は、ブラウザーを更新して metrics.xml に変更内容を反映します。

  10. レポートタイプが右側に表示されます。下へスクロールして [もっと見る] をクリックします。

    [コード行数] レポートタイプがリストに含まれて表示されます。

  11. [複雑度] を選択します。

    これでデフォルトのしきい値は、20 ではなく 10 に設定されます。