Azure DevOps で分析ビューを作成する

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

カスタム分析ビューを作成して、フィルター処理された一連のデータとその他の条件を定義して、Power BI レポートのニーズをサポートできます。 カスタム ビューを使用すると、フィルター条件と Power BI レポートに読み込まれるフィールドに対する柔軟性が向上します。

重要

分析ビューでは、Azure Boards データ (作業項目) のみがサポートされます。 分析ビューでは、パイプラインなどの他のデータ型はサポートされていません。 ビューは作業項目のフラット リストを提供し、作業項目階層をサポートしていません。 この時点で、コネクタを更新して他の種類のデータをサポートする予定はありません。 その他の方法については、「Power BI 統合について」を参照してください。

Azure DevOps の Web ポータルでカスタム ビューを作成できます。 次に、Power BI Data Connector を使用してビューを読み込みます。 作業項目のクエリと同様に、ビューは自分で使用する場合にのみ作成することも、チームの他のユーザーと共有することもできます。

Note

ボードが無効になっている場合、Analytics ビューも無効になります。 作業項目の追跡に関連付けられているすべてのウィジェットは、ウィジェット カタログでも無効になります。 サービスを再度有効にするには、「Azure DevOps サービスを有効または無効にする」を参照してください。

前提条件

Analytics を開いてビューにアクセスする

Web ポータルから Boards Analytics ビューを選択>します。

Analytics ビューが表示されない場合は、Analytics を表示するためのアクセス許可があることを確認します。 Analytics にアクセスするためのアクセス許可と前提条件に関するページを参照してください。

Boards ハブを展開し、赤い四角形に囲まれた Analytics ビューを選択しているスクリーンショット。

ビューを参照する

次の図に示すように、[ すべて] ページから、プロジェクトに対して定義されているすべての Analytics ビューにアクセスできます。 個人用ビュー は、自分だけが使用または編集できるビューです。 共有ビュー は、プロジェクト全体で共有されるビューです。 チームの誰でも、Power BI で共有ビューに接続して使用できます。

共有ビューを表示できる [Analytics ビュー] ページを示すスクリーンショット。

Note

既定の分析ビューのラベルは、チーム プロジェクトで選択されたプロセス (Basic、Agile、Scrum、CMMI) によって異なります。 明示的に説明しない限り、使用可能な機能は変わりません。

ビューをお気に入りに表示するには、ビューの上にマウス ポインターを合わせ、星アイコンを選択します 。 お気に入りのビューが [お気に入り] ページに表示されます。

カスタム ビューを作成する

ダイアログを開いてカスタム ビューを作成するには、[新しいビュー] を選択します。 Power BI で表示するデータを整形するためのフィルター条件を完全に定義するには、各タブに表示されるフォームに入力します。

カスタム ビューを作成するには、次の手順を実行します。

  1. ビューに名前を付け、共有オプションを選択する
  2. 作業項目フィルターを指定する
  3. ビューのフィールドを選択する
  4. ビューに含まれる履歴データの量を選択する
  5. ビューを確認して保存する

Note

現時点では、ボード フィールドをフィルターまたは選択として追加して表示することはできません。 これらのフィールドには、ボード列、ボード列の完了、およびボード レーンが含まれます。 機能要求は、それらを追加するように定義されています。 分析ビュー - ビューで使用可能なフィールドの一覧にボード列を追加します。

ビューに名前を付け、共有オプションを選択する

ビューの名前を入力し、説明を入力します。 他のユーザーが Analytics ビューを表示して使用できるようにするには、[ 共有 ] オプションを選択します。 共有ビューでは、「分析ビューの管理」の説明に従って、ビューを表示、編集、削除できるユーザーに対するアクセス許可 を設定できます。

[共有ビュー] オプションを指定できる [新しいビューの全般] タブを示すスクリーンショット。

作業項目フィルターを指定する

フィルターを指定して、ビューから返される結果の数を減らします。 作業項目セクションでは、作業項目フィールドに異なるフィルターを追加して、データのスコープを設定できます。 使用可能な各フィールドの詳細については、Azure Boards Analytics のメタデータ リファレンスを参照してください。

[新しい作業項目の表示] タブを示すスクリーンショット。作業項目フィルターを指定できます。

ヒント

データのスコープを設定して、すばやく更新するレポートを生成します。 大規模なデータセットの場合、フィルター処理されていないビューの更新が失敗する可能性があります。 結果を絞り込むには、適切なフィルター セットを追加します。 追加するフィルターが多いほど、Power BI でのビューの読み込みと更新が速くなります。

  • Teams またはエリア パス フィルターを追加する

    既定では、ビューには現在のプロジェクトで定義されているすべてのチームが含まれます。 現在のプロジェクトのチームを具体的に選択するか、organizationで定義されている他のプロジェクトをフィルターに追加できます。

    重要

    Analytics ビューあたり 500 プロジェクトに制限することをお勧めします。 500 を超えるプロジェクトが必要な場合は、追加の Analytics ビューを作成し、ビュー間でプロジェクトを分散できます。

    現在のプロジェクトの選択したチームを変更したり、フィルターに他のプロジェクトを追加したりできます。 また、チームのフィルター処理からエリア パスに変更することもできます。 2 つの Fabrikam エリア パスでフィルター処理されたビューを次に示します。

    [Teams またはエリア パス] ダイアログを示すスクリーンショット。

  • バックログと作業項目の種類のフィルターを追加する

    プロジェクト内の特定の作業項目の種類にデータのスコープを設定します。 バックログを指定して、特定のバックログ レベルに関連付けられている作業項目の種類でフィルター処理したり、個々の特定の作業項目の種類を追加したりできます。 選択した種類の作業項目がビューに含まれます。

    バックログと作業項目のドロップダウン メニューを示すスクリーンショット。

  • フィールド条件によるフィルターの追加

    以前のすべてのフィルター条件に加えて、さまざまな作業項目フィールドに基づいてフィルターを追加できます。 作業項目クエリに追加するフィールドの場合と同じ方法で、これらのフィールドを指定します。 次の例に示すように、フィルター処理して、特定の "修正プログラム" タグを持つ優先度の高いバグのみを表示できます。

    [バックログと作業項目] ダイアログを示すスクリーンショット。バグ、優先度、タグでフィルター処理できます。

    タグの操作の詳細については、「 作業項目タグを追加してリストとボードを分類およびフィルター処理する」を参照してください。

    Note

    フィルターが履歴データにどのように適用されるかを理解することが重要です。 詳細については、「Analytics の履歴データ表現」を参照してください。

レポートに表示されるフィールドを選択する

次のタブの [フィールド] では、レポートで使用するフィールドを追加および削除できます。 [追加] を選択してフィールドを追加します。 新しいリストから始める場合は、[ すべて削除] を選択します。

フィールドを選択できる [新しいビュー フィールド] タブを示すスクリーンショット。

継承されたプロセスを通じて追加する任意のカスタム フィールドを追加できます。

Note

データ型がプレーン テキスト (長いテキスト) または HTML (リッチ テキスト) のフィールドを追加することはできません。 これらのフィールドは、レポートの目的で Analytics からは使用できません。

傾向データのオプションを選択する

次のタブの [履歴] で、ビューから使用できる履歴データの量を決定するオプションを選択します。

この例では、10 個の作業項目があり、週単位の粒度で 14 日間のローリング期間を選択した場合、ビューには 30 行が含まれます。 土曜日に更新する場合は、各作業項目の最後の 2 つの土曜日の行と、土曜日の最新データの行があります。

[履歴] タブを示すスクリーンショット。履歴と粒度のオプションを選択できます。

履歴

現在の状態のスナップショットの場合は、[現在のみ] を選択します。 傾向グラフの場合は、示されている他のオプションのいずれかを選択します。

オプション 説明
現在のみ 作業項目の状態をスナップショットする場合は、このオプションを選択します。 Analytics データ ストア内の作業項目の最新の値と一致する作業項目ごとに 1 行を生成します。
ローリング期間 このオプションを選択し、データセットに含める現在の日の前の日数を入力します。 スライディング ウィンドウは、レポートを更新するたびに変更されます。
日付範囲 このオプションを選択し、データセットに含める特定の開始日と終了日を選択するか、または表示を選択して、固定終了日のないローリング ウィンドウを指定します。 表示を選択すると、終了日はレポートが更新された日に対応します。 選択を解除すると、終了日は常に終了日フィールドで選択された日付になります。
すべての履歴 フィルター条件で選択したすべての作業項目の完全な履歴を含めるには、このオプションを選択します。 重要な履歴がある場合は、週単位または月単位の細分性を指定します。

開始日 より前に完了した作業項目を除外する - Analytics では、閉じた作業項目の変更履歴を含むすべての作業項目履歴が格納されます。 その結果、Analytics ビューで 14 日間のローリング期間を選択した場合、ビューには、この期間より前に閉じられたすべての作業項目の現在のリビジョンが含まれます。

特定の日付より前に完了した作業項目を除外するには、履歴のオプションの下にある対応するボックスを選択します。 これにより、Power BI に読み込まれるデータの量が大幅に削減され、状態の時間などの高度な計算に役立ちます。 [ローリング期間] と [日付] の範囲では、作業項目を除外する日付が期間の開始によって設定されます。 [現在のみ] と [すべての履歴] では、その日付を指定する必要があります。 たとえば、次の図は、2024 年 8 月 24 日より前に完了したすべての作業時間を除外しています。

スクリーンショットは、[履歴] タブを示しています。このタブでは、ローリング期間が 14 日間の作業項目を除外できます。

粒度

各日、週、または月のすべての作業項目のスナップショットを取得することを選択できます。 各行は、定義された間隔の最新のリビジョンに基づいて項目を表します。

オプション 説明
毎日 各日の最新データを示す作業項目ごとに行を生成します。
週次 その週を表す日に取得された 1 週間あたりのデータを示す作業項目ごとの行を生成します。 この値の既定値は Saturday です。
毎月 各月の最終日のデータを示す作業項目ごとに行を生成します。

Note

  • プレビュー行は、履歴と粒度に基づいて計算された値であり、Power BI と一致しない可能性があります。
  • 履歴データにフィルターを適用する方法を理解することが重要です。 詳細については、「Analytics の履歴データ表現」を参照してください。

ビューを確認して保存する

最後の手順では、ビューに対してテスト クエリを実行し、フィルター条件を検証することで、ビューを検証します。 検証時間は、ビューで定義されているデータの量によって異なる場合があります。 たとえば、すべての作業項目の種類を含み、すべての履歴を指定するビューは、バグのみを含み、30 日間のローリング期間を指定するビューよりも検証に時間がかかります。

ヒント

ビューの確認は重要な手順です。 検証が正常に終了すると、Power BI でビューが正しく読み込まれる可能性が高くなります。 検証に時間がかかりすぎる場合は、ビューを調整できます。 フィルターを追加するか、履歴を絞り込み、ビューをもう一度確認します。

ビューが正常に検証されたら、保存します。 その後、 Power BI で使用を開始できます。

ビューが正常に検証されない場合は、問題を説明し、考えられる修正を示すエラーが表示されます。 定義を変更して、ビューをもう一度確認してください。 ビューが正常に検証されると、ビューに含まれる行数の見積もりを取得します。

成功した確認メッセージを示すスクリーンショット。これには、行数の見積もりが含まれています。

たとえば、プロジェクトに対して定義されなくなったフィールドでフィルター処理しようとすると、エラーが発生します。 [作業項目フィルター] タブのフィルターからそのフィールドを削除し、もう一度確認できます。

エラーの解決の詳細については、「 分析ビューに関連するエラーを解決する」を参照してください。

ビューのフィルター条件を確認する

Analytics ビューで、[お気に入り] または [すべて] ページから任意のビューを選択して、ビューの定義とフィルターの概要を表示します。 [編集] を選択してビューを編集します。

スクリーンショットは、ビューの定義とフィルターの概要パネルを示しています。

カスタム分析ビューを使用してアクティブなバグ Power BI レポートを作成する