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 サービスを有効または無効にする」を参照してください

前提条件

  • 分析データを表示してサービスにクエリを実行するには、 Basic アクセス以上のプロジェクトのメンバーである必要があります。 既定では、すべてのプロジェクト メンバーには、Analytics のクエリと 分析ビューの定義に対するアクセス許可が付与されます。
  • サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件については、「 Analytics にアクセスするためのアクセス許可と前提条件」を参照してください。

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

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

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

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

ビューを参照する

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

Analytics views ディレクトリ

Note

既定の Analytics ビューの一覧に表示されるラベルは、チーム プロジェクトの作成時に選択されたプロセス (BasicAgileScrumCMMI) によって異なります。 ただし、明示的に言及しない限り、使用できる基本的な機能は変わりません。

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

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

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

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

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

Note

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

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

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

分析ビュー全般

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

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

作業項目フィルターを指定します。

ヒント

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

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

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

    重要

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

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

    エリア パス ピッカーの例

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

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

    作業項目の種類の選択

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

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

    バグ、優先度、タグでフィルター処理する例

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

    Note

    履歴データにフィルターを適用する方法を理解することが重要です。 詳細については、「履歴データに適用されるフィルター」を参照してください

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

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

フィールドの選択

継承されたプロセスを通じて追加した任意のユーザー設定フィールドを追加できます。

Note

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

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

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

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

[履歴] タブで、[履歴] と [粒度] オプションを選択します

履歴

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

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

[閉じたアイテムを除外する ] - Analytics には、閉じられた作業項目の変更履歴を含むすべての作業項目履歴が格納されます。 その結果、Analytics ビューで 14 日間のローリング期間を選択した場合、ビューには、この期間より前に閉じられたすべての作業項目の現在のリビジョンが含まれます。 特定の日付より前に完了した作業項目を除外するには、履歴のオプションの下に対応するボックスをチェックします。 これにより、Power BI に読み込まれるデータの量が大幅に削減され、 状態の時間 などの高度な計算がはるかにパフォーマンスが向上します。 ローリング期間と日付範囲の場合、作業項目を除外する日付は期間の開始によって設定されます。 [現在のみ] と [すべての履歴] では、その日付を指定する必要があります。 たとえば、次の図は、5 月 14 日 (月) より前に完了したすべての作業時間を除外しています。

ローリング期間 14 日間の作業項目を除外する

粒度

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

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

Note

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

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

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

ヒント

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

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

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

検証に成功しました

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

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

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

[分析] ビューの [ お気に入り] ページまたは [ すべて ] ページから任意のビューを選択すると、ビューの定義とフィルターの 概要 が表示されます。 [ 編集 ] リンクを選択してビューを編集します。

概要パネル

次のステップ