クエリグラフの例

[アーティクル]
04/05/2024

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

クエリグラフは、状態や傾向を視覚化するのに最適な方法です。また、ダッシュボードに複数のグラフを追加することで、チームやプロジェクトで監視したい重要なデータをすぐに確認できます。そのことを念頭に置いて、チームで次の質問に対処することを検討してください。

"作成および監視するのに最も役に立つクエリグラフは何ですか?"
"バックログの安全性を維持するのに役立つグラフは何ですか?"
"傾向グラフを作成するとき、どのような期間を監視する必要がありますか?"

すべてのチームが同じ目標や追跡の必要性を持っているわけではありません。ただし、アジャイル手法を採用しているチームは、次のタスクを日常的に実行している傾向があります。そのため、チームがこれらのタスクを実行するために役立つステータスと傾向のグラフを検討します。

入ってきた作業をトリアージして、新しい作業が適切に定義されていることを確認します
スクラムとベストプラクティスで説明されているように、スプリントを計画し、スプリント目標を設定します
毎日のスタンドアップを実施します。

前提条件

クエリグラフを作成したり、クエリページからクエリグラフを表示したりするには、基本以上のアクセス権が必要です。 利害関係者アクセスを持つユーザーは、[クエリ] ページからグラフを表示または作成することはできませんが、チームダッシュボードに追加されたグラフを表示することはできます。詳細については、「利害関係者アクセスクイックリファレンス」を参照してください。
クエリチャートをダッシュボードに追加するには:
- クエリを [共有クエリ] フォルダーの下に保存する必要があります。そのためには、クエリをフォルダーの下に保存するためのアクセス許可が付与されている必要があります。アクセス許可の付与については、クエリとクエリフォルダーに対するアクセス許可の設定に関する記事を参照してください。
- ダッシュボードを作成しているか、ダッシュボードを編集するためのアクセス許可が付与されている必要があります。ダッシュボードのアクセス許可の詳細については、「ダッシュボードのアクセス許可を設定する」を参照してください。
ダッシュボードに追加されたクエリグラフを表示するには、基となるクエリに対する読み取りアクセス許可が必要です。そのアクセス許可が拒否された場合、"ウィジェットを読み込めません" というメッセージがウィジェットに表示されます。

注意

パブリックプロジェクトの利害関係者アクセスを持つユーザーは、基本アクセスを持つユーザーと同様に、クエリグラフの機能にフルアクセスできます。詳細については、「利害関係者アクセスクイックリファレンス」を参照してください。

クエリグラフを作成するためのヒント

クエリグラフの作成の詳細については、「状態と傾向のクエリベースのグラフを使って進行状況を追跡する」を参照してください。クエリが次のガイドラインを満たしていることを確認します。

クエリの種類は [作業項目の単純なリスト] のみを選びます。クエリグラフをサポートするのは、単純なリストのクエリのみです。
[グラフ] ページに切り替える前に、句または列オプションを変更した後は、常にクエリを保存してください。
In および Not In 演算子を使って、複数の作業項目の種類、ワークフローの状態、またはその他の目的のグループ化を指定します
傾向グラフを作成する場合、クエリで返される作業項目が 1,000 個以下であることを確認します。この数を超えると、ウィジェットエラーが表示されます。
クエリ句または列オプションのいずれかにグラフで使うフィールドを追加します。日付-時刻、自由形式のテキスト、タグフィールドを除く任意のフィールドでグラフをグループ化できます。例:
- 状態でグループ化するには、[状態] フィールドを含めます
- 作業の割り当てでグループ化するには、[割り当て先] フィールドを含めます
- スプリントやイテレーションでグループ化するには、[イテレーションパス] を含めます
- チームごとにグループ化するには、区分パスのリーフノードを表示する [ノード名] フィールドを含めます
- カスタムフィールドでグループ化するには、それを含めます。
数値列を合計するには、クエリ句または列オプションに対応するフィールドを含めます。数値フィールドから作成されるグラフのその他の例については、数値フィールドによるクエリに関する記事を参照してください。
次のフィールドデータ型でグラフをグループ化することはできません。
- 作業項目 [ID] または [親] フィールド
- [作成日]、[変更日] などの日付-時間フィールド
- [タイトル] などのプレーンテキストフィールド
- [説明]、[受け入れ基準]、[ステップの再現] などのリッチテキストフィールド
- タグ (タグを使ってクエリをフィルター処理できますが、タグを使ってクエリグラフを構成することはできません)。
注意

クエリベースのグラフをタグでグループ化することはできませんが、「作業項目ウィジェットのグラフを構成する」で説明したように、作業項目ウィジェットのグラフをダッシュボードに追加したタグでグループ化することができます。
ダッシュボードにクエリグラフを追加する予定がある場合は、まずダッシュボードを作成します。その後、[クエリ]>[グラフ] ページからダッシュボードに追加できます。
クエリを追加した後、それをダッシュボードからダッシュボードに追加する場合は、新しく追加したクエリを登録するために、まずダッシュボードのブラウザーを更新する必要があります。
複雑なクエリのパフォーマンスを最適化するには、「統合のベストプラクティス」の、「クエリの最適化」を参照してください。

バックログの安全性を維持する

次のクエリは、作業が確実に割り当てられるようにすることで、チームが正常なバックログを維持するのに役立ちます。次の表では、定期的に (通常はスプリントの開始時または終了時) 確認するクエリの例をいくつか示します。この一覧から、チームや組織の目標に合ったものを確認してください。 "Fabrikam チーム" を自分のチームに置き換え、必要に応じて他のフィルターを追加します。

注意

プロジェクトに適用される作業項目の種類とワークフローの状態は、プロジェクトが使うプロセスによって、次の例で示すものと異なる場合があります。

クエリの着目点

クエリ句

未割り当ての作業: 現在のスプリントに割り当てられた作業で、チームメンバーに割り当てられていないもの

現在のイテレーションでは [割り当て先] フィールドが空白になっているクエリエディターのスクリーンショット。