作業項目ウィジェットのグラフを構成する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
作業項目のグラフウィジェットでは任意のフラット リスト クエリを選択し、サポートされているグラフ タイプのいずれかをサポートするように構成できます。 このウィジェットを構成する手順は、クエリベースのグラフを構成するために実行する手順とよく似ています。
ダッシュボードにグラフを表示するには、[クエリ]>[グラフ] ページから開始し、ダッシュボードにグラフを追加することを選択します。 ダッシュボードに追加されたグラフは作業項目のグラフ ウィジェットとして表示され、ラベルの変更、サイズ変更、再構成を行うことができます。 作業項目のグラフ ウィジェットを追加し、クエリを選択して通常どおりグラフを構成することもできます。
[クエリ]>[チャート] ページでは実行できないタスクのなかで、作業項目のウィジェットから実行できる唯一のタスクは作業項目をタグ別にグループ化することです。 この機能は、Azure DevOps Server 2022 以降のバージョンでサポートされています。
前提条件
Note
パブリック プロジェクトの 利害関係者 アクセスが付与されたユーザーは、基本 アクセスが付与されたユーザーと同様に、クエリ グラフ機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
カテゴリ | 必要条件 |
---|---|
アクセス | プロジェクトメンバー は少なくとも ベーシック アクセス権を持っています。 利害関係者 アクセス権を持つユーザーは、クエリ ページからグラフを表示または作成できません。 チーム ダッシュボードに追加されたグラフを表示できます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。 |
アクセス許可 | - 既定では、少なくとも Basic アクセス権を持つユーザーはグラフを作成できます。 利害関係者アクセスが付与されているユーザーは、[クエリ] ページからグラフを表示または作成することはできませんが、チーム ダッシュボードに追加されたグラフを表示することはできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。 - 共有クエリ フォルダーにクエリを保存するには: フォルダーにクエリを保存する権限。 詳細については、「クエリとクエリ フォルダーの権限を設定する」を参照してください。 - チーム ダッシュボードにウィジェットを追加するには:チームのメンバーまたは プロジェクト管理者のメンバー セキュリティ グループ。 - プロジェクト ダッシュボードにウィジェットを追加するには:ダッシュボードの作成者または ダッシュボードの の編集アクセス許可、または プロジェクト管理者 セキュリティ グループのメンバー。 - ダッシュボードに追加されたクエリベース ウィジェットを表示するには: 基になるクエリに対する読み取りアクセス許可が必要です。 そのアクセス許可が拒否されると、ウィジェットに ウィジェットが表示され、メッセージ 読み込めませんでした。 |
クエリ | - フラット リスト クエリのみがグラフをサポートします。 - グラフをダッシュボードに追加するには:クエリを 共有クエリ フォルダーに保存します。 これを行うには、フォルダーの下にクエリを保存するアクセス許可を取得します。 |
カテゴリ | 必要条件 |
---|---|
アクセス | 少なくとも Basic アクセス権を持つプロジェクト メンバー。 利害関係者 アクセス権を持つユーザーは、クエリ ページからグラフを表示または作成できません。 チーム ダッシュボードに追加されたグラフを表示できます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。 |
アクセス許可 | - 既定では、少なくとも Basic アクセス権を持つユーザーはグラフを作成できます。 利害関係者アクセスが付与されているユーザーは、[クエリ] ページからグラフを表示または作成することはできませんが、チーム ダッシュボードに追加されたグラフを表示することはできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。 - 共有クエリ フォルダーにクエリを保存するには、フォルダーへのクエリ保存権限が必要です。 詳細については、「クエリとクエリ フォルダーの権限を設定する」を参照してください。 - チーム ダッシュボードにウィジェットを追加するには:チームのメンバーまたは プロジェクト管理者のメンバー セキュリティ グループ。 - プロジェクト ダッシュボードにウィジェットを追加するには:ダッシュボードの作成者または ダッシュボードの の編集アクセス許可、または プロジェクト管理者 セキュリティ グループのメンバー。 - ダッシュボードに追加されたクエリベースのウィジェットを表示するには、基になるクエリに対する 読み取り アクセス許可が必要です。 そのアクセス許可が拒否されると、ウィジェットに ウィジェットが表示され、メッセージ 読み込めませんでした。 |
クエリ | - フラットリストクエリのみが グラフをサポートしています。 - グラフをダッシュボードに追加するには:クエリを 共有クエリ フォルダーに保存します。 これを行うには、フォルダーの下にクエリを保存するアクセス許可を取得します。 |
ダッシュボードのアクセス許可の詳細については、「ダッシュボードのアクセス許可を設定する」を参照してください。
フラット リスト クエリを定義して保存する
作業項目のグラフ ウィジェットから、グラフを作成する作業項目を含むクエリを選択します。 グラフをサポートするクエリを作成する場合は、「フラット リスト クエリを作成する」に記載されているガイドラインに従ってください。
ヒント
作業項目のグラフウィジェットを構成してから選択するクエリを追加する場合は、新しく追加されたクエリを選択するためにダッシュボード ブラウザー ページを更新する必要があります。
ダッシュボードを作成する
ダッシュボードにウィジェットを追加する前に、まずダッシュボードをプロジェクトに追加する必要があります。 その方法については、「ダッシュボードの追加、名前の変更、削除」を参照してください。
作業項目のグラフ ウィジェットをダッシュボードに追加する
Web ポータルから、グラフを追加するダッシュボードを開きます。
ダッシュボードにウィジェットを追加するには、
[編集] を選択してウィジェット カタログを開きます。
Note
[編集] オプションが表示されない場合は、ダッシュボードを編集するためのアクセス許可を取得する必要があります。
作業項目のグラフ ウィジェットを選択してから、[追加]を選択するかダッシュボードにウィジェットをドラッグします。
ウィジェットを構成するには、ウィジェットの
[その他のアクション] を選択して
[構成] オプションを選択します。
[構成] ダイアログが開きます。
[タイトル] にタイトルを入力して [幅] と [高さ] を選択し、グラフの基になっているフラット リスト クエリ を選択します。 次に、[グラフの種類] を選択します。
グラフにタイトルを付け、グラフの基になっているフラット リスト クエリを選択し、グラフの種類を選択します。
グラフの種類に基づいて、残りのフィールドの値を指定します。 表示されている色から別の色を選択するだけで、グラフの色を変更できます。 特定のグラフの種類の選択と構成に関するその他のガイダンスについては、「状態と傾向のクエリベースのグラフを使用して進行状況を追跡する」を参照してください。
変更を保存すると、新しいグラフがダッシュボードに追加されたことがわかります。
ヒント
必要なすべての行または列がグラフに表示されない場合は、グラフの [幅] と [高さ] を変更してみてください。 ピボット テーブルやその他のグラフの種類では、ダッシュボードに表示される領域に基づいて、より多くのデータが表示されます。
ダッシュボード上の任意の場所にタイルをドラッグして、目的の場所に配置します。
変更が完了したら、[編集完了] を選択してダッシュボード編集モードを終了します。
Web ポータルから、グラフを追加するダッシュボードを開きます。
ダッシュボードにウィジェットを追加するには、
[編集] を選択してウィジェット カタログを開きます。
Note
[編集] オプションが表示されない場合は、ダッシュボードを編集するためのアクセス許可を取得する必要があります。
作業項目のグラフ ウィジェットを選択してから、[追加]を選択するかダッシュボードにウィジェットをドラッグします。
ウィジェットを構成するには、ウィジェットの
[その他のアクション] を選択して
[構成] オプションを選択します。
[構成] ダイアログが開きます。
[タイトル] にタイトルを入力して [サイズ] を選択し、グラフの基になっているフラット リスト クエリ を選択します。 次に、[グラフの種類] を選択します。
グラフの種類に基づいて、残りのフィールドの値を指定します。 表示されている色から別の色を選択するだけで、グラフの色を変更できます。 特定のグラフの種類の選択と構成に関するその他のガイダンスについては、「状態と傾向のクエリベースのグラフを使用して進行状況を追跡する」を参照してください。
変更を保存すると、新しいグラフがダッシュボードに追加されたことがわかります。
ヒント
必要なすべての行または列がグラフに表示されない場合は、グラフの [サイズ] を変更してみてください。 ピボット テーブルやその他のグラフの種類では、ダッシュボードに表示される領域に基づいて、より多くのデータが表示されます。
ダッシュボード上の任意の場所にタイルをドラッグして、目的の場所に配置します。
変更が完了したら、[編集完了] を選択してダッシュボード編集モードを終了します。
タグでグラフをグループ化する
Note
クエリベースのグラフをタグでグループ化することはできませんが、ダッシュボードに追加したタグで [作業項目のグラフ] ウィジェットをグループ化することはできます。
グラフをタグ別にグループ化するには、前のセクションと同じ手順を実行します。 フラット リスト クエリに、クエリ句または列オプションとして [タグ] が含まれていることを確認します。 次に、[グループ化] のオプションとして [タグ] を選択します。 一部のタグのみを表示するようにグラフをフィルタリングするには、 [選択したタグ] ラジオ ボタンを選択し、グラフに表示するタグを選択します。
タグの使用の詳細については、「作業項目へのタグの追加」を参照してください。