次の方法で共有

日付または現在のイテレーションによるクエリの実行

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

この記事では、作成、変更、解決、または終了日で作業項目を一覧表示する方法と、チーム スプリントに日付マクロ ( @Today など) とイテレーション マクロを使用する方法について説明します。 反復パスの基礎とクライアント/マクロの制限については、「 領域または反復パスによるクエリ」を参照してください。

Prerequisites

Category Requirements
アクセス レベル - 共有クエリを表示して実行するには、プロジェクトメンバーが必要です。
- 共有クエリを追加して保存するには:少なくとも Basic アクセス。
Permissions クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。

Note

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

Category Requirements
アクセス レベル - 共有クエリを表示して実行するには、プロジェクトメンバーが必要です。
- 共有クエリを追加して保存するには: 少なくとも Basic アクセスが必要です。
Permissions クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。

サポートされている演算子と日付マクロ

クエリ エディターの DateTime フィールドと反復パス フィールドには、次の演算子とマクロを使用します。

  • DateTime 演算子: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • 日付マクロ: @StartOfDay、 @StartOfWeek、 @StartOfMonth、 @StartOfYear、 @Today
    +/- nをこれらのマクロ (@Today - 7 など) と組み合わせることができます。
  • 繰り返しマクロ: @CurrentIteration と @CurrentIteration +/- n (クライアントの制限とチーム パラメーターの動作については、次のメモとリンクを参照してください)。

Note

反復マクロとクライアントの制限については、「反復」ページの「 領域別のクエリまたは反復パス」で詳しく説明します。 Web 以外のクライアントで、または Web UI の外部の REST/WIQL を使用してクエリを実行する必要がある場合は、環境内でマクロのサポートを確認し、マクロを明示的なパスに拡張することを検討してください。

簡単な日付の例 (一般的なクエリ)

  • 過去 30 日間に作成された アイテム: 過去 30 日間に作成されたアイテムを検索するためのクエリ エディター句を示すスクリーンショット。

  • 特定の日付に変更されたアイテム: 特定の 日付に変更されたアイテムを検索するためのクエリ エディター句を示すスクリーンショット。

  • 今日解決されたアイテム: 現在解決されたアイテムを検索するためのクエリ エディター句を示すスクリーンショット。

  • 指定した期間内に閉じられたアイテム: 指定した期間内 に閉じられたアイテムを検索するためのクエリ エディター句を示すスクリーンショット。

  • [終了日] が null (閉じていない) アイテム: [終了日] が空または null のアイテムを検索するためのクエリ エディター句を示すスクリーンショット。

  • 過去 1 週間に状態が変更されたアイテム: 過去 1 週間に状態が更新されたアイテムのクエリ エディター句を示すスクリーンショット。

@CurrentIteration マクロの使用 (短いガイド)

@CurrentIterationを使用してチームの現在のスプリントをターゲットにし、@CurrentIteration +/- nを使用してスプリントのスライディング ウィンドウ (最後の 2 つ、現在のスプリント、次の 2 つのスプリントなど) を作成します。 重要な点:

  • @CurrentIteration は、クエリの実行時に使用されるチーム コンテキストの現在のスプリントに割り当てられた項目を返します。
  • @CurrentIteration +/- n スプリントのウィンドウを n ずつシフトします。傾向分析や繰り越し分析に役立ちます。
  • マクロの動作とクライアントのサポートは異なるため、チーム パラメーター、クライアントがマクロを評価する方法、およびクエリを保存するときのマクロの格納/展開方法の詳細については、 領域別または反復パス別 のクエリを参照してください。

画像の例 (Web ポータル クエリ エディター):

CurrentIteration マクロとチーム パラメーターを使用したクエリ エディター フィルターを示すスクリーンショット。

スプリントのスライディング ウィンドウにおける CurrentIteration のプラス条件とマイナス条件を示すスクリーンショット。

Tip

@CurrentIteration期待される結果が返されない場合は、チームの設定でチームが選択したイテレーションとイテレーションの日付範囲を確認します。

日付マクロ: 開始日/週/月/年

マクロの開始は、一貫性のある相対日付範囲の構築に役立ちます。

  • @StartOfDay、 @StartOfWeek、 @StartOfMonth、 @StartOfYear- これらのマクロを +/- n と共に使用して、"週の開始以降" や "過去 3 か月間" などの範囲を構築します。
  • これらのマクロは、Web ポータル UI によって評価されます。Web 以外のシナリオでの動作は異なる場合があります。ターゲット クライアントでテストします。

クエリの例:

過去 10 日間で変更された項目を検索するためのクエリ エディター句を示すスクリーンショット。

今後 3 か月で完了する予定の機能のクエリ エディター句を示すスクリーンショット。

WIQL を直接使用する場合

WIQL は次の場合に使用します。

  • 反復パスの変更に WAS EVER などの高度な演算子が必要です。
  • クエリ エディターは、句をサポートされていないものとしてブロックまたはマークします (たとえば、一部の Was Ever 使用)。 WIQL エディター拡張機能を使用すると、これらのクエリを作成して保存できます。

例については、 作業項目クエリ言語 (WIQL) 構文 と WIQL エディター マーケットプレース拡張機能を参照してください。

関連コンテンツ

REST API

プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。

  • Last updated on