次の方法で共有

Azure DevOps で Analytics にアクセスするためのアクセス許可と前提条件

  • [アーティクル]

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

Analytics を使用してレポートを作成するには、この記事の概要に示すように、いくつかの前提条件を満たす必要があります。

既定では、すべてのプロジェクト メンバーには、プロジェクト 閲覧者 グループに追加されたメンバーを含め、メンバーであるプロジェクトの Analytics データへのアクセス権が付与されます。 利害関係者アクセス権を持つユーザーは、Analytics ビューを表示または編集するためのアクセス権を持っていません。

サービスと機能の有効化

一般に、Analytics は常にオンであり、organizationまたはコレクションのメンバーがデータを表示してレポートを作成できます。

Analytics サービス

Azure DevOps Servicesの場合、Analytics は常にオンです。 無効にしたり、一時停止したりすることはできません。

Azure DevOps Server 2020 以降のオンプレミス バージョンの場合、Analytics は、作成する各プロジェクト コレクションと共に自動的にインストールされます。

Azure DevOps Server 2019 では、最初に作成する各プロジェクト コレクションに Analytics をインストールする必要があります。

サービスを一時停止して再起動できます。 一時停止すると、Analytics に新しいデータは追加されません。

詳細については、「 Analytics サービスをインストールまたは有効にする」を参照してください。

Azure DevOps Services

Azure DevOps サービスを実行するには、それを有効にする必要があります。 無効になっているサービスのデータはキャプチャできません。 サービスは、プロジェクトごとにプロジェクトで有効または無効にすることができます。

すべてのサービスが有効になっていることを確認するには、「 サービスのオンとオフを切り替える」を参照してください。

Analytics ビュー

Web ポータルのハブである分析ビューでは、分析データに基づいて Power BI レポートのフィルター条件を簡単に指定できます。 詳細については、Analytics サービスの概要に関する記事を参照してください。

Analytics ビューにアクセスするには、有効にする必要があります。 プロジェクト コレクション管理者グループのorganization所有者またはメンバーは、organization内のすべてのユーザーに対して有効にすることができます。 または、各プロジェクト メンバーが自分で有効にすることもできます。

方法については、「機能の 管理または有効化」を参照してください。

アクセス許可

プロジェクト レベルでサービスのアクセス許可を設定し、オブジェクト レベルで共有 Analytics ビューのアクセス許可を設定します。

次の表は、設定できるアクセス許可と、プロジェクト セキュリティ グループに対して行われた既定の割り当てをまとめたものです。

アクセス許可 Readers 共同作成者 プロジェクト管理者
分析の表示 ✔️ ✔️ ✔️
共有 Analytics ビューを表示する ✔️ ✔️
プライベートまたは共有の Analytics ビューを追加する ✔️ ✔️
共有 Analytics ビューを編集および削除する ✔️

データ追跡の前提条件

意味のあるデータをキャプチャするには、ソフトウェア チームが意味のあるアクションを実行する必要があります。 次のセクションでは、レポートするデータの種類に基づく一般的な推奨事項について説明します。

注意

ブランチ、パイプライン、およびテスト エンティティ セットは、Analytics v3.0-preview 以降の バージョンでサポートされています。 パイプライン ジョブ、タスク エージェント要求、タスク エージェント プール サイズをサポートするスナップショット エンティティ セットが、Analytics v4.0-preview バージョンで追加されました。 関心のあるエンティティ セットをサポートする Analytics バージョンを指定してください。

データをフィルター処理またはグループ化できるプロパティと列挙リスト値を理解するには、対応するエンティティ型 の Analytics メタデータを調 べる必要があります。

Azure Boardsと作業の追跡

クエリを実行できる使用可能なエンティティ セットの確認については、「Azure Boards Analytics のメタデータ リファレンス」を参照してください。

作業の追跡に関するレポートを作成するには、チームが意味のあるデータを確実に使用できるように、いくつかのタスクを実行する必要があります。 Analytics のクエリとレポートを定義する前に、次のタスクを確認してください。

  • アクティブなバグやバグの傾向を報告するには、バグを定義し、バグ の状態 を修正、検証、閉じた状態として更新します。
  • バックログ作業またはその他の作業項目の種類をレポートするには、それらの作業項目を定義し、新しいアイテムから閉じられたアイテムに移動するときに 状態 を更新してください。 レポート内のデータをフィルター処理またはグループ化するために使用するフィールドまたはタグを検討し、適切に定義され、一貫性があることを確認します。
  • ロールアップ レポートをサポートするには、製品バックログ アイテムとタスク/バグの間に親子リンクが存在するか、機能またはポートフォリオ バックログ作業項目とその子アイテムの間に親子リンクが存在することを確認します。 詳しくは、バックログを整理し、子作業項目を親にマップする方法に関する記事を参照してください。
  • スプリント バーンダウンやリリース バーンダウンなどのバーンダウンまたはバーンアップ レポートを作成するには、レポート内のデータをフィルター処理してグループ化する方法を確認してください。 バーンダウン/バーンアップ レポートは、エンティティ セットを WorkItemsSnapshot 参照します。 スナップショット エンティティ セットは、毎日のスナップショットとしてモデル化されます。 データは、割り当てられた日付の時点で行われた割り当てに基づいて集計されます。 つまり、フィールドまたはタグの割り当てに基づいてバーンダウン/バーンアップ レポートをフィルター処理するには、レポート対象の期間より前にフィールドまたはタグを割り当てる必要があります。 それ以外の場合、フィールド/タグは、適用日までレポートに登録されません。
  • 要件の追跡をサポートするには、テスト ケースを定義し、各テスト ケースからユーザー ストーリー、製品バックログ 項目、または要件への [テスト対象] リンクを作成します。 テスト ケースを定義し、テスト ケースを親 PBI へ [テスト担当者] リンクを使用してリンクします。 「テストを作成する」を参照してください。
  • (推奨)レポート内でのフィルター処理とグループ化をサポートするには、すべての作業項目に 区分パス と 反復パス を割り当てます。 反復パスとエリア パスを定義する方法については、「 エリア パスを定義してチームに割り当てる 」または 「イテレーション パス (スプリント) を定義してチームのイテレーションを構成する」を参照してください。

注意

作業項目の種類に追加されたすべてのユーザー設定フィールドは、レポートで使用できます。 ユーザー設定フィールドには 、表示名からすべてのスペースが削除されたCustom_DisplayNameOfFieldでラベルが付けられます。

テスト計画

テスト計画の進行状況とテスト ケースの準備状況を確認するには、チームが次のアクティビティを実行する必要があります。

  • テスト ケース、テスト 計画、テスト スイートを定義し、現在の状態を指定します。 詳細については、「 テスト 計画とテスト スイートの作成」および「テストケースの作成」を参照してください。
  • [デザイン] から [準備完了] から [閉じる準備完了] に進むにつれて、テスト オブジェクトの状態を更新します。
  • 手動テストの場合は、テスト ケースの各検証手順の結果を、成功または失敗としてマークします。

    ヒント

    テスト担当者は、テスト ステップが検証テスト ステップである場合、そのことを示す状態でマークする必要があります。 テスト全体の結果は、マークされたすべてのテスト ステップの状態を反映します。 したがって、テスト ステップが失敗とマークされているか、またはマークされていない場合、テストは失敗の状態になります。

  • 自動テストの場合、各テストは成功または失敗として自動的にマークされます。
  • (推奨)レポート内でのフィルター処理とグループ化をサポートするには、テスト ケース、テスト スイート、テスト 計画に エリア パス と イテレーション パス を割り当てます。

Pipelines

パイプラインについて報告するには、チームは YAML を使用してパイプラインを定義し、パイプラインを定期的に実行する必要があります。 詳細については、「 新しい Azure Pipelines ユーザーの主要な概念」を参照してください。

さらに、次のアクションを検討してください。

パイプラインとテスト

パイプラインとテストの結果をレポートするには、必ずパイプライン定義にテスト タスクを追加してください。 詳細については、「タスクの ビルドとリリース-テスト」を参照してください。

作業を開始したばかりの場合は、この Learn モジュール「 Azure Pipelines を使用してビルド パイプラインで品質テストを実行する」を確認することを検討してください。