Polyspace Access でのソフトウェア品質目標 (SQO) の管理

事前定義 (Polyspace Bug Finder)されたソフトウェア品質しきい値またはユーザー定義のしきい値に照らしてコードの品質を監視するには、[品質目標] ダッシュボードを使用します。Monitor Code Quality Using Quality Objectives Dashboard in Polyspace Accessを参照してください。

新しいプロジェクトに初めて結果をアップロードするときに、Polyspace® Access™ はそのプロジェクトに既定の "Polyspace ソフトウェア品質目標" 定義を割り当てます。カスタム ソフトウェア品質目標 (SQO) 定義を作成するには、Customize Software Quality Objectivesを参照してください。

プロジェクトの SQO は、ユーザー インターフェイスまたはコマンド ラインから管理できます。

SQO 定義を割り当てた後、プロジェクト統計が再計算されるまでは、[品質目標] カードおよびダッシュボードにラベル SQO not computed (未計算) が表示されます。

プロジェクトの SQO 統計は、次のタイミングで再計算されます。

  • プロジェクトに新しい実行をアップロードするとき。

  • 調査結果を選択し、[結果の詳細] ペイン内のいずれかのフィールドに対して変更を加えるとき。

プロジェクトに割り当てる SQO 定義は、定義を割り当てた後にプロジェクトにアップロードする実行にのみ適用されます。

ヒント

[品質目標] 設定とプロジェクトの計算された統計が同期していない場合、[品質目標] ダッシュボードに警告が表示されます。

SQO 定義を削除する場合、Polyspace Access は、削除した定義が割り当てられていたすべてのプロジェクトに Polyspace ソフトウェア品質目標を割り当てます。

ユーザー インターフェイスでの SQO の管理

SQO 定義または SQO レベルをプロジェクトに割り当てるには、[プロジェクト エクスプローラー] でプロジェクトを右クリックするか、[品質目標] カードまたは [品質目標] ダッシュボードの Polyspace Access gear icon をクリックします。

Quality Objectives dashboard

複数のプロジェクトに適用される品質目標定義に変更を加えると、Polyspace Access に、警告と [品質目標の設定] ウィンドウの [プロジェクトの割り当て] タブへのリンクが表示されます。タブを開き、変更によって影響を受けるプロジェクトを判別し、それらのプロジェクトのコントリビューターであるユーザーに、品質目標定義に対する変更について通知します。

SQO 定義がどのプロジェクトに割り当てられているかを確認するには、[品質目標の設定] の [プロジェクトの割り当て] タブに移動します。

Quality Objectives settings view

コマンド ラインでの SQO の管理

コマンド ラインから SQO を管理するには、polyspace-access -set-sqo、polyspace-access -get-sqo、および polyspace-access -list-sqo コマンドを使用します。次の例では、$LOGIN は、ログイン資格情報やその他の接続情報を格納する変数です。この変数を構成するには、Encrypt Password and Store Login Options in a Variableを参照してください。

次が可能です。

  • プロジェクトに SQO レベルを割り当て、オプションで SQO 定義を割り当てます。たとえば、SQO 定義 My Custom SQO のレベル 3 を、プロジェクト パスが public/examples/myProject であるプロジェクト myProject に割り当てるには、次のコマンドを入力します。 

    polyspace-access -set-sqo public/examples/myProject -level 3 -name "My Custom SQO" $LOGIN

    オプション -level は必須であり、1 から 6 の任意の値または "exhaustive" を指定できるのに対し、オプション -name は任意です。

    -name を使用しない場合、ここで指定するレベルが、現在割り当てられている SQO 定義に適用されます。

  • プロジェクトに現在割り当てられている SQO 定義と SQO レベルを表示します。たとえば、プロジェクト パスが public/examples/myProject であるプロジェクト myProject に割り当てられている SQO のレベルと定義を表示するには、次のコマンドを入力します。

    polyspace-access -get-sqo public/examples/myProject $LOGIN
    このコマンドでは、SQO の名前とレベルが次の形式で出力されます。
    Current Quality Objectives: NAME My Custom SQO LEVEL SQO-3

  • 現在利用可能なすべての SQO 定義のリストを表示します。次のコマンドを入力します。

    polyspace-access -list-sqo $LOGIN

参考

トピック