このスライスは、定義済みの重み付けされたルール プロファイルを開発プロジェクトに適用することで、KPI (METRIC.KPIIF) スコアを計算します。重み付けされたルール プロファイルを利用すると、ルールのカスタム セットを定義し、各ルールに個別に重み付けを適用することができます。このスライスを呼び出すと、プロジェクト中の各ファイルのルール違反の数がカウントされます。ルールごとに、「ルール違反の数」が「ルール プロファイルで指定されたルールの重み付け」で乗算されます。ルールに対してルール プロファイルに定義された重みがない場合、そのルールのカウントは収集されません。KPI スコアを出すために、重み付けされたカウントの合計がファイルの論理コード行 (METRIC.NOLLOCIF) で除算されます。

このアーティファクトのダウンロードとライセンスについては Parasoft 製品テクニカル サポート センターまでお問い合わせください。このアーティファクトも Security Compliance Pack for DTP 5.4.2 に同梱されています。これには、セキュリティ コンプライアンス標準に関連する KPI を計算するためのコンフィギュレーションが含まれます。

このセクションの内容:

要件

追加されるコンポーネント

KPI スライスをインストールすると、4 つのサンプル プロファイル (下記で説明) が追加されます。

インストール

  1. アーティファクトのインストール方法については 「アーティファクトのダウンロードとインストール」 を参照してください。
  2. Extension Designer のアクション メニューから [読み込み] > [ライブラリ] > [Process Intelligence] > [Key Performance Indicator] > [Key Performance Indicator] を選択してサービスにアーティファクトをインポートします。
  3. [デプロイ] をクリックします。

アップグレードについての注意事項

KPI 2.1 にアップグレードしている場合、モデルとプロファイルを含め、アーティファクトから以前のバージョンをアンインストールします。 

バージョン 2.1 より、プロファイルごとにメトリクス ID を定義することができます。特定のメトリクス ID とプロファイルを関連付けると、結果を上書きせずに複数のメトリクスについて KPI を参照できます。

以前のバージョンに同梱のデフォルト プロファイルを変更した場合、またはカスタム プロファイルを作成した場合、プロファイルをエクスポートし、以下の属性を追加します (「プロファイルのエクスポートとインポート」も参照)。

デフォルト値を変更する場合、メトリクス ID 接頭辞を METRIC.KPI.<スペースなしのプロファイル名> に設定することを推奨します。メトリクスには完結な名前を使用してください (最大 30 文字)。

構成

このスライスは、KPI モデル プロファイル タイプを使って KPI スコアを計算します。プロファイルは、ウィジェット リクエストで送られた “profile” クエリー パラメーターから決定されます。このスライスにはサンプル プロファイルがいくつか含まれており、[モデル プロファイル] タブで確認できます。

詳細については「モデル プロファイルの使用」を参照してください。

フィルター ID はウィジェットによってクエリー パラメーターとして渡されます。これは、プロファイルがどの DTP フィルターに対して計算すべきかを決定します。以下のサンプル プロファイルは、モデル プロファイルの設定を簡単にするためにディストリビューションと共にインストールされます。

All Rulesこのプロファイルはすべての Jtest 静的解析ルールに等しく「100/重要度」の重みを割り当てます (たとえば、重要度 1 の違反には 100 を、重要度 2 の違反には 50 を割り当てます)。
Recommended Rulesこのプロファイルは、Recommended Rules テスト コンフィギュレーションでアクティブな Jtest 静的解析ルールに重みを割り当てます。重みは、All Rules プロファイルと同じ方法で計算されます。
Flow Analysisこのプロファイルは、Flow Analysis テスト コンフィギュレーションでアクティブな Jtest 静的解析ルールに重みを割り当てます。重みは、All Rules プロファイルと同じ方法でマッピングされます。

計算の実行

KPI スライスは長時間実行するスライスです。理想的には夜間ジョブの一部として、サード パーティによって実行されたときにだけ計算されます。

  1. [サービス] タブでサービス カテゴリをクリックし、エンドポイントを表示します。API または直接のエンドポイント パスを使用できます (詳細については「サービス カテゴリ ページ」を参照してください)。



  2. エンドポイントをコピーし、必須パラメーターと共に REST リクエストをエンドポイントに送ります。利用可能な場合 API エンドポイントを使用します (詳細については「フローの使用」を参照してください)。以下の表で必須パラメーターについて説明します。

filterId計算を実行するプロジェクトのフィルター ID。
profile計算に使用するルールと重み付けのプロファイル名。
buildId計算を実行するビルド ID。ビルド ID を指定しない場合、このパラメーターのデフォルトは最新ビルドです。

サンプルの実行

以下のコマンドを実行して、スライスを実行して計算を行うことができます。

curl "http://localhost:8321/slices/a37fbfb6.59b87?filterId=71&profile=All%20Rules"
{{success: {title: "KPI", message: "Calculation has successfully started for filter 'Parabank-v3' using profile 'Security Impact'."}}

成功の場合、以下のようなレスポンスを受け取ります。


DTP でのデータの確認

計算が完了して KPI メトリクスが DTP にレポートされたら、DTP のダッシュボードにメトリクス ウィジェットを追加し、[メトリクス] ドロップダウン メニューから Key Performance Indicator を選択できます。詳細については「ウィジェットの追加」を参照してください。

ユーザーの指定に従ってウィジェットにメトリクスが表示されます。

ウィジェットをクリックすると、その詳細を メトリクス エクスプローラー で確認できます。