このセクションの内容:
Table of Contents | ||||
---|---|---|---|---|
|
Jenkins ジョブ結果
このウィジェットは、Jenkins ジョブのビルド結果を表示します。このウィジェットは、Jenkins サーバーに匿名で接続することも、ウィジェット設定で認証情報を指定してユーザーとして接続することもできます。このウィジェットは、ジョブの名前、ビルド ID、および最後の実行の名前を表示します。モニタリングしたいジョブごとにこのウィジェットのインスタンスを追加します。このウィジェットを使用すると、DTP がデータを収集していない場合に、テスト対象アプリケーションのビルドに関連するエラーがないことを検証するのに役立ちます。
Excerpt | |||||
---|---|---|---|---|---|
|
ウィジェットの構成
以下の設定を行うことができます。
Scroll Table Layout | ||
---|---|---|
|
タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
---|---|
Jenkins サーバー | Jenkins サーバーの URL を指定します。プロトコルとポート番号を含めます。たとえば http://<HOST>:<PORT> |
Jenkins ジョブ | モニタリングする Jenkins ジョブの名前。 |
Jenkins ユーザー | (オプション) Jenkins サーバーにアクセスするユーザーの名前を指定します。ユーザーはプロジェクトにアクセスできなければなりません。 特定ユーザーのログインを提供しない場合、Jenkins ベースのウィジェットが正常に動作するには、匿名の読み取りアクセスを Jenkins サーバーが許可する必要があります。 |
Jenkins 認証 | (オプション) Jenkins サーバーにアクセスするユーザーのパスワードを指定します。ユーザーはプロジェクトにアクセスできなければなりません。 特定ユーザーのログインを提供しない場合、Jenkins ベースのウィジェットが正常に動作するには、匿名の読み取りアクセスを Jenkins サーバーが許可する必要があります。 |
アクション
ウィジェットをクリックすると、Jenkins サーバーのジョブ ステータスが表示されます。
カスタム ダッシュボード プロパティ
これはレガシー ウィジェットであり、カスタム ダッシュボード テンプレート に追加することはできません。
ポートフォリオ - 品質ステータス
このウィジェットは、指定されたポートフォリオのフィルターの品質ステータスを表示します。DTP でのポートフォリオの構成の詳細については、「Configuring Portfolios」を参照してください。
ポートフォリオのフィルターに関連付けられているプロジェクトのメンバーである場合、そのフィルターのウィジェットにエントリが表示されます。チーム メンバーシップの詳細については「Adding Teams to Projects」を参照してください。DTP のビルトイン ユーザー権限の詳細については「権限」を参照してください。
品質ステータスは、以下のメトリクスを使った、指定のビルドのデータに基づきます。
- 重要度 1 の違反
- 失敗したテスト
- コード カバレッジ
これらのメトリクスについて、許容レベルを定義するしきい値を設定できます (「ウィジェットの構成」を参照)。プロジェクト ステータスが「成功」に設定されるには、メトリクスのすべての値が許容範囲内になければなりません。品質メトリクスのデータが存在しない場合、プロジェクトのステータスは「成功」に設定されます。
ウィジェットの構成 Anchorportfolio-quality-status-settings portfolio-quality-status-settings
portfolio-quality-status-settings | |
portfolio-quality-status-settings |
タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
---|---|
ポートフォリオ | メニューからポートフォリオを選択します。詳細については「Configuring Portfolios」を参照してください。 |
ビルド | すべてのフィルターで使用するビルド ID を入力します。ビルド ID が指定されていない場合、デフォルトで最新のビルドが使用されます。 ビルド ID の詳細については「ビルド管理」を参照してください。 |
ビルド列の表示 | ウィジェットに [ビルド] 列を含めるには、メニューから [Yes] を選択します。[ビルド] 列には、[ビルド] フィールドで指定されたビルド ID が表示されます。 [ビルド] 列を非表示にする場合は [No] を選択します。[ビルド] 列が含まれていない場合は、[フィルター] 列のフィルターにポインタを合わせると、ビルド ID を表示できます。 ビルド ID の詳細については「ビルド管理」を参照してください。 |
違反列の表示 | ウィジェットに [重要度 1 の違反] 列を含めるには、メニューから [Yes] を選択します。[重要度 1 の違反] 列には、重大度 1 の違反の発生件数が表示されます。 [重要度 1 の違反] 列を非表示にする場合は [No] を選択します。以下で説明する "重要度 1 の違反のしきい値" の設定は、列が非表示の場合でも適用されます。 |
重要度 1 の違反のしきい値 | 重要度 1 の違反の最大数を指定します。レポートされた違反の数がこの設定よりも多い場合、品質ステータスは「失敗」に設定されます。 デフォルトのしきい値は 10 です。 |
テスト列の表示 | ウィジェットに [失敗したテスト] 列を含めるには、メニューから [Yes] を選択します。[失敗したテスト] 列には、発生した "テストの失敗" の数が表示されます。 [失敗したテスト] 列を非表示にする場合は [No] を選択します。以下で説明する "失敗したテストのしきい値" の設定は、列が非表示の場合でも適用されます。 |
失敗したテストのしきい値 | 失敗したテストの許容される最大数を指定します。失敗したテストの数がこの設定よりも多い場合、品質ステータスは「失敗」に設定されます。 デフォルトのしきい値は 10 です。 |
カバレッジ列の表示 | ウィジェットに [カバレッジ] 列を含めるには、メニューから [Yes] を選択します。[カバレッジ] 列には、コード カバレッジがパーセンテージで表示されます。 [カバレッジ] 列を非表示にする場合は [No] を選択します。以下で説明する "カバレッジのしきい値" の設定は、列が非表示の場合でも適用されます。 |
カバレッジのしきい値 | 許容されるカバレッジ率の最小値を指定します。レポートされたカバレッジ率がこの設定よりも低い場合、品質ステータスは「失敗」に設定されます。 デフォルトのしきい値は 25 です。 |
幅 | DTP ダッシュボードは、6 列のグリッドであり、行数に制限はありません。ウィジェットの列の数を指定します。デフォルトは 3 です。 「ダッシュボードのグリッド」も参照してください。 |
高さ | DTP ダッシュボードは、6 列のグリッドであり、行数に制限はありません。ウィジェットの行数を指定します。デフォルトは 2 です。 「ダッシュボードのグリッド」も参照してください。 |
アクション
以下の方法でウィジェットを操作できます。
- 列ヘッダーをクリックしてデータをソートします。
- [ビルド] 列のリンクをクリックして Build Audit Report を表示します。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「Custom Dashboard Templates」を参照)。
Code Block | ||
---|---|---|
| ||
"name": "Portfolio.Quality_Status" "type": "native", "uuid": "12c53f03-1ff6-4072-ba9f-ca7586cb1e31" |
品質ステータス
このウィジェットは、ターゲット ビルドの全般的なコード品質ステータスを表示します。以下のメトリクスを利用してステータスを決定します。
- 重要度 1 の違反の数
- 失敗したテストの数
- コード カバレッジのレベル
メトリクスごとにしきい値を設定して、品質ポリシーを定義できます。ターゲット ビルドにメトリクスのデータがない場合はクエスチョン マークが表示されます。
ウィジェットの構成
以下の設定を行うことができます。
Scroll Table Layout | ||
---|---|---|
|
タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
---|---|
フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
ターゲット ビルド | メニューからビルドを選択します。このビルドのデータだけがウィジェットに表示されます。 |
カバレッジ イメージ | メニューからカバレッジ イメージを選択します。ウィジェットでカバレッジ データを表示するにはこの設定が必要です。「Associating Coverage Images with Filters」を参照してください。 |
重要度 1 の違反のしきい値 | 重要度 1 の違反の最大数を指定します。レポートされた違反の数がこの設定よりも多い場合、品質ステータスは「失敗」に設定されます。 デフォルトのしきい値は 10 です。 |
失敗したテストのしきい値 | 失敗したテストの許容される最大数を指定します。失敗したテストの数がこの設定よりも多い場合、品質ステータスは「失敗」に設定されます。 デフォルトのしきい値は 10 です。 |
カバレッジのしきい値 | 許容されるカバレッジ率の最小値を指定します。レポートされたカバレッジ率がこの設定よりも低い場合、品質ステータスは「失敗」に設定されます。 デフォルトのしきい値は 25 です。 |
アクション
メトリクスごとに、関連するエクスプローラー ビューが開きます。
- Violations Explorer でビルド データを確認するには、[重要度 1 の違反] メトリクスをクリックします。
- Test Explorer でビルド データを確認するには、[失敗したテスト] メトリクスをクリックします。
- Coverage Explorer でビルド データを確認するには、[カバレッジ] メトリクスをクリックします。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「Custom Dashboard Templates」を参照)。
Code Block | ||
---|---|---|
| ||
"name": "Quality_Status" "type": "native", "uuid": "4181248e-95fc-421c-88b1-7e6423199177" |