Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022
カスタム分析ビューを作成して、フィルター処理された一連のデータとその他の条件を定義して、Power BI レポートのニーズをサポートできます。 カスタム ビューを使用すると、フィルター条件と Power BI レポートに読み込むフィールドに対する柔軟性が向上します。
重要
分析ビューでは、Azure Boards データ (作業項目) のみがサポートされます。 分析ビューでは、パイプラインなどの他のデータ型はサポートされていません。 ビューには作業項目のフラット な一覧が用意されており、作業項目階層はサポートされていません。 この時点で、他の種類のデータをサポートするようにコネクタを更新する予定はありません。 その他の方法については、「 Power BI 統合について」を参照してください。
Azure DevOps 用の Web ポータルでカスタム ビューを作成します。 次に、 Power BI Data Connector を使用してビューを読み込みます。 作業項目のクエリと同様に、ビューを作成できるのは自分の使用に対してのみ、またはチームの他のユーザーと共有することだけです。
注
ボードが無効になっている場合、Analytics ビューも無効になります。 作業項目の追跡に関連付けられているすべてのウィジェットは、ウィジェット カタログでも無効になります。 サービスを再度有効にするには、「 Azure DevOps サービスを有効または無効にする」を参照してください。
ヒント
この記事の後半でAI を使用してこのタスクに役立てる方法をご説明します。または、Azure DevOps MCP Server で AI サポートを有効にする方法を参照して作業を開始できます。
前提条件
| カテゴリ | 要求事項 |
|---|---|
| アクセス レベル |
-
プロジェクト メンバー。 - 少なくとも ベーシック アクセス。 |
| 権限 | 既定では、プロジェクト メンバーには Analytics にクエリを実行してビューを作成する権限があります。 サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件の詳細については、「 Analytics にアクセスするためのアクセス許可と前提条件」を参照してください。 |
Analytics を開いてビューにアクセスする
Webポータルから、Boards>分析ビューを選択します。
Analytics ビューが表示されない場合は、Analytics を表示するためのアクセス許可があることを確認します。 Analytics にアクセスするためのアクセス許可と前提条件を参照してください。
![Azure DevOps Web ポータルのスクリーンショット。サイドでは、[ボード] ビューと [分析] ビューが強調表示されています。メイン ウィンドウに共有ビューが一覧表示されます。](media/analytics-views/open-analytics-2020.png?view=azure-devops)
ビューを閲覧する
次の図に示す [ すべて] ページから、プロジェクトに対して定義されているすべての Analytics ビューにアクセスできます。 個人用ビュー は、自分だけが使用または編集できるビューです。 共有ビュー は、プロジェクト全体で共有するビューです。 チームの全員が Power BI で共有ビューに接続して使用できます。
![共有ビューを表示できる [Analytics ビュー] ページを示すスクリーンショット。](media/editable-views/directory-actions.png?view=azure-devops#lightbox)
注
既定の分析ビューのラベルは、チーム プロジェクトで選択されたプロセス ( Basic、 Agile、 Scrum、 CMMI) によって異なります。 明示的に説明しない限り、使用可能な機能は変わりません。
ビューをお気に入りにするには、ビューの上にマウス ポインターを合わせ、星アイコン ( 
) を選択します。 お気に入りのビューが [ お気に入り ] ページに表示されます。
カスタム ビューを作成する
ダイアログを開いてカスタム ビューを作成するには、新しいビュー
選択します。 Power BI で表示するデータを整形するためのフィルター条件を完全に定義するには、各タブに表示されるフォームに入力します。
カスタム ビューを作成するには、次の手順を実行します。
注
ボードフィールドボード列、ボード列の完了、およびボードレーンは、Analyticsビューでフィルターやフィールドの選択として利用できません。 回避策として、 WorkItemBoardSnapshot エンティティ セットを使用して、OData クエリを使用してボード列データにアクセスできます。 詳細については、「 サンプル OData クエリを使用して累積フロー ダイアグラム (CFD) を生成する」を参照してください。 この機能に投票するには、「 分析ビュー - ビューで使用可能なフィールドの一覧にボード列を追加する」を参照してください。
1. ビューに名前を付け、共有オプションを選択する
ビューの名前を入力し、説明を入力します。 他のユーザーが Analytics ビューを表示して使用できるようにするには、[ 共有 ] オプションを選択します。 共有ビューの場合、「分析ビューの管理」の説明に従って、ビューを表示、編集、削除できるユーザーに関するアクセス許可 を設定できます。
![[共有ビュー] オプションを指定できる [新しいビューの全般] タブを示すスクリーンショット。](media/editable-views/general.png?view=azure-devops#lightbox)
2. 作業項目フィルターを指定する
フィルターを指定して、ビューから返される結果の数を減らします。 作業項目セクションで、作業項目フィールドに異なるフィルターを追加して、データのスコープを設定します。 使用可能な各フィールドの詳細については、 Azure Boards Analytics のメタデータ リファレンスを参照してください。
![[新しい作業項目の表示] タブを示すスクリーンショット。作業項目フィルターを指定できます。](media/editable-views/work-items-default.png?view=azure-devops#lightbox)
ヒント
データのスコープを設定して、すばやく更新するレポートを生成します。 大規模なデータセットの場合、フィルター処理されていないビューの更新は失敗する可能性があります。 結果を絞り込むには、適切なフィルター セットを追加します。 追加するフィルターが多いほど、Power BI でのビューの読み込みと更新が速くなります。
Teams またはエリア パス フィルターを追加する
既定では、ビューには現在のプロジェクトで定義されているすべてのチームが含まれます。 現在のプロジェクトのチームを具体的に選択するか、organizationで定義されている他のプロジェクトをフィルターに追加できます。
重要
選択内容は、Analytics ビューあたり 500 プロジェクトに制限します。 500 を超えるプロジェクトが必要な場合は、より多くの Analytics ビューを作成し、ビュー間でプロジェクトを分散します。
現在のプロジェクトの選択したチームを変更するか、フィルターに他のプロジェクトを追加します。 また、チームのフィルター処理からエリア パスに変更することもできます。 2 つの Fabrikam エリア パスでフィルター処理されたビューを次に示します。
![[Teams またはエリア パス] ダイアログを示すスクリーンショット。](media/editable-views/area-path.png?view=azure-devops)
バックログと作業項目の種類のフィルターを追加する
プロジェクト内の特定の作業項目の種類にデータのスコープを設定します。 バックログを指定して、特定のバックログ レベルに関連付けられている作業項目の種類でフィルター処理するか、個々の特定の作業項目の種類を追加します。 ビューには、選択した種類の作業項目が含まれます。
フィールド条件によるフィルターの追加
以前のすべてのフィルター条件に加えて、さまざまな作業項目フィールドに基づいてフィルターを追加します。 作業項目クエリに追加するフィールドの場合と同じ方法で、これらのフィールドを指定します。 次の例に示すように、フィルター処理して、特定の "修正プログラム" タグを持つ優先度の高いバグのみを表示できます。
![[バックログと作業項目] ダイアログを示すスクリーンショット。バグ、優先度、タグでフィルター処理できます。](media/editable-views/field-criteria.png?view=azure-devops)
タグの操作の詳細については、「 作業項目タグを追加してリストとボードを分類およびフィルター処理する」を参照してください。
注
フィルターが履歴データにどのように適用されるかを理解することが重要です。 詳細については、「 Analytics の履歴データ表現」を参照してください。
3. レポートに表示されるフィールドを選択する
次のタブの [フィールド] で、レポートで使用するフィールドを追加および削除します。 [追加を選択してフィールドを追加します。 新しいリストから始める場合は、[ すべて削除] を選択します。
![フィールドを選択できる [新しいビュー フィールド] タブを示すスクリーンショット。](media/analytics-views/fields-customize-no-common.png?view=azure-devops#lightbox)
継承されたプロセスを通じて、任意のユーザー設定フィールドを追加できます。
注
データ型がプレーン テキスト (長いテキスト) または HTML (リッチ テキスト) のフィールドを追加することはできません。 分析では、レポート用にこれらのフィールドは提供されません。
4. 傾向データのオプションを選択する
次のタブの [履歴] で、ビューから使用できる履歴データの量を決定するオプションを選択します。
この例では、10 個の作業項目があり、週単位の粒度で 14 日間のローリング期間を選択した場合、ビューには 30 行が含まれます。 土曜日に更新した場合、各作業項目について、直近の2回の土曜日の行と、最新の土曜日のデータの行が表示されます。
![[履歴] タブを示すスクリーンショット。履歴と粒度のオプションを選択できます。](media/editable-views/history-example.png?view=azure-devops#lightbox)
履歴
現在の状態のスナップショットについては、[ 現在のみ] を選択します。 傾向グラフの場合は、示されている他のオプションのいずれかを選択します。
| オプション | 説明 |
|---|---|
| 現在のみ | 作業項目の状態をスナップショットする場合は、このオプションを選択します。 Analytics データ ストア内の作業項目の最新の値と一致する作業項目ごとに 1 行を生成します。 |
| ローリング期間 | このオプションを選択し、データセットに含める現在の日の前の日数を入力します。 スライディング ウィンドウは、レポートを更新するたびに変更されます。 |
| 日付範囲 | このオプションを選択し、データセットに含める特定の開始日と終了日を選択するか、または 表示を選択して 、固定終了日のないローリング ウィンドウを指定します。 表示を選択すると、終了日はレポートが更新された日に対応します。 オフにすると、終了日は常に終了日フィールドで選択された日付になります。 |
| すべての履歴 | フィルター条件で選択したすべての作業項目の完全な履歴を含めるには、このオプションを選択します。 重要な履歴がある場合は、 週単位 または 月単位 の細分性を指定します。 |
開始日より前に完了した作業項目を除外 する - Analytics には、閉じた作業項目の変更履歴を含むすべての作業項目履歴が格納されます。 その結果、Analytics ビューでローリング期間を 14 日間選択した場合、ビューには、この期間より前に閉じたすべての作業項目の現在のリビジョンが含まれます。
特定の日付より前に完了した作業項目を除外するには、いずれかの履歴オプションの下にある対応するチェック ボックスをオンにします。 この設定により、Power BI に読み込まれるデータの量が大幅に削減され、 状態の時間などの高度な計算に役立ちます。 ローリング期間と日付範囲の場合、除外日は期間の開始によって設定されます。 [現在のみ] と [すべての履歴] では、その日付を指定する必要があります。 たとえば、次の図では、2024 年 8 月 24 日より前に完了したすべての作業項目が除外されています。
![スクリーンショットは、[履歴] タブを示しています。このタブでは、ローリング期間が 14 日間の作業項目を除外できます。](media/editable-views/history-exclude.png?view=azure-devops#lightbox)
粒度
各日、週、または月のすべての作業項目のスナップショットを取得することを選択できます。 各行は、定義された間隔の最新のリビジョンに基づいて項目を表します。
| オプション | 説明 |
|---|---|
| 毎日 | 各日の最新データを示す作業項目ごとに行を生成します。 |
| 毎週 | その週を表す日に取得された 1 週間あたりのデータを示す作業項目ごとの行を生成します。 この値の既定値は Saturday です。 |
| マンスリー | 各月の最終日のデータを示す作業項目ごとに行を生成します。 |
注
- プレビュー行は、履歴と粒度に基づいて計算される値であり、Power BI と一致しない可能性があります。
- 履歴データにフィルターを適用する方法を理解することが重要です。 詳細については、「 Analytics の履歴データ表現」を参照してください。
5. ビューを確認して保存する
最後の手順では、ビューに対してテスト クエリを実行し、フィルター条件を検証することで、ビューを検証します。 検証時間は、ビューで定義されているデータの量によって異なる場合があります。 たとえば、すべての作業項目の種類を含み、 すべての履歴 を指定するビューは、バグのみを含み、30 日間のローリング期間を指定するビューよりも検証に時間がかかります。
ヒント
ビューの確認は重要な手順です。 検証が正常に終了すると、Power BI でビューが正しく読み込まれる可能性が高くなります。 検証に時間がかかりすぎる場合は、ビューを調整できます。 フィルターを追加するか、履歴を絞り込み、ビューをもう一度確認します。
ビューが正常に検証されたら、保存します。 その後、 Power BI で使用を開始できます。
ビューの検証に失敗した場合は、問題を説明し、考えられる修正を示すエラーが表示されます。 定義を変更して、ビューをもう一度確認してください。 ビューが正常に検証されると、ビューに含まれる行数の見積もりを取得します。
たとえば、プロジェクトに対して定義されなくなったフィールドでフィルター処理しようとすると、エラーが発生します。 [ 作業項目 フィルター] タブのフィルターからそのフィールドを削除し、もう一度確認できます。
エラーの解決の詳細については、「 Analytics ビューに関連付けられているエラーを解決する」を参照してください。
ビューのフィルター条件を確認する
Analytics ビューで、[お気に入り] または [すべて] ページから任意のビューを選択して、ビューの定義とフィルターの概要を表示します。 [ 編集] を 選択してビューを編集します。
AI を使用して Power BI レポート用の分析ビューを作成する
Azure DevOps MCP Server を構成する場合は、AI アシスタントを使用して、適切なフィルターの定義、フィールドの選択、履歴オプションの選択、ビュー検証のトラブルシューティングを行い、ビューを Power BI にすばやく接続できるようにします。
プロンプトの例
| Task | プロンプトの例 |
|---|---|
| 既存のビューを一覧表示する | List the Analytics views in <ProjectName> in the <OrganizationName> organization, and tell me which ones are shared. |
| 共有ビューを編集できるユーザーを検索する | For the Analytics view <ViewName> in <ProjectName>, who can edit or delete it, and where do I change those permissions? |
| アクティブなバグのビューを作成する | What filters and fields should I include in an Analytics view to track active bugs by priority in <ProjectName>? |
| チーム別またはエリア パス別によるスコープ | I need a Power BI report for <TeamName>. How should I scope an Analytics view using team or Area Path filters in <ProjectName>? |
| レポートのフィールドを選択する | Recommend a minimal set of fields for a Power BI report that shows bug aging and owner for <ProjectName>, and tell me where to add them in the Analytics view UI. |
| 履歴と粒度の選択 | I want trend charts for the last <NumberOfDays> days. Which History and Granularity options should I select in an Analytics view for <ProjectName>? |
| 検証時間を最適化する | My Analytics view takes too long to verify in <ProjectName>. Suggest specific filters to reduce row count without losing the key metrics for my report. |
| 検証エラーのトラブルシューティング | My Analytics view in <ProjectName> failed verification with an error about a missing field. Help me identify which filter or field is invalid and how to fix it. |
| ビューと OData の間で決定する | I need board column data for a report in <ProjectName>. Should I use an Analytics view or OData (WorkItemBoardSnapshot), and what are the tradeoffs? |
ヒント
Visual Studio Code を使用している場合、エージェント モードはレポートの要件を反復処理するのに特に役立ちます。エージェントは、ビュー フィルターとフィールドを提案するようエージェントに依頼し、行数と検証結果を検証した後に絞り込みます。