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

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

この記事では、作業項目が作成、終了、解決、または変更された日時に基づいて作業項目を一覧表示する方法について説明します。 日付を指定することも、サポートされているマクロを使用することもできます。 @Today マクロを使用し、基準日に対して加算または減算する日数を指定します。 チームの現在のスプリントへの割り当てに基づいて作業項目を一覧表示するクエリでは、@CurrentIteration を使用します。

たとえば、次のクエリーを使用して、過去 3 日間に変更された作業項目を検索します。

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

[DateTime] フィールドまたは [イテレーション パス] フィールドを指定するクエリ句では、次の表に示す演算子とマクロを使用できます。

注:

1. @StartOfDay、@StartOfWeek、@StartOfMonth および @StartOfYear マクロは、Azure DevOps Server 2019.1 以降のバージョンでサポートされており、Web ポータルから実行する場合にのみ有効です。
2. @CurrentIteration +/- n マクロは、Azure DevOps Server 2019 以降のバージョンでサポートされており、Web ポータルから実行する場合にのみ有効です。

日付と時刻のパターン

DateTime フィールドに入力する日付と時間のパターンは、プロファイルで選んだものと一致する必要があります。 選択内容を表示または変更するには、「時刻とロケールのユーザー設定を設定する」を参照してください。

@CurrentIteration マクロの使用に関するクライアントの制限

クエリで @CurrentIteration マクロを使用できるのは次のクライアントです。

• Azure Boards に接続する Web ポータル
• Azure Boards に接続されている Visual Studio 2019 以降のバージョン
• REST API

Azure Boards, Azure DevOps Server 2019 以降のバージョンに対するクエリにある @CurrentIteration +/- n マクロを使用します。これには、パラメーターとしてチームを含む REST API があります。 たとえば @CurrentIteration('[Project]\Team') です。

Visual Studio の以前のバージョンや Microsoft Excel または Microsoft Project から@CurrentIteration マクロを含むクエリを開くとエラーが発生します。 また、テスト スイートとテストケースのコピーまたは複製、アラートの定義を行うときや、REST APIを使用するときも、このマクロは使用できません。

日付ベースのクエリ

作業項目を変更した日付または特定の期間ごとにフィルタリングします。 クエリーの範囲を制限します。これは、含まれる日付範囲に合った結果だけを返すことで、パフォーマンスに役立ちます。 初めてクエリを作成する場合は、「クエリ エディターを使用してクエリを一覧表示し、管理する」を参照してください。

すべてのフィールドがすべての作業項目の種類に対して有効なわけではありません。 クエリに含めることができるフィールドの一致機に対する [日付] フィールドと適用する作業項目の種類に移動します。

チームの現在のイテレーションのクエリを作成する

チームがスクラム プロセスに従っている場合は、作業がスプリント単位で完了するようにスケジュールします。 @CurrentIteration マクロを使用して、現在のスプリントで完了する要件、バグ、およびその他の作業の進捗を追跡できます。

チームの現在のイテレーション パスに対応するスプリントに割り当てられているすべての項目が見つかります。 たとえば、チームがスプリント 5 に対応している場合は、スプリント 5 に割り当てられた項目がクエリによって返されます。 その後、チームがスプリント 6 で作業しているときは、同じクエリによって、スプリント 6 に割り当てられた項目が返されます。

スプリントから移された作業項目を一覧表示する

スプリントに定義されたが、[イテレーション パス] の Was Ever 演算子を含む句を含むクエリを使用して後で移動した差表項目を一覧します。 このクエリは、WIQL 構文を使用してのみ作成します。 WIQL エディタ マーケットプレース拡張機能をインストールすることで、クエリー エディタで WIQL 構文を編集します。

たとえば、作業項目に関する次の構文クエリーは、次の基準を満たしています。

• 現在のプロジェクトで定義されています。
• 作業項目の種類が User Story または Bug と等しい。
• 作業項目は、Fabrikam Fiber Web チームの Area Path の下にあります。
• 作業項目が、Closed、Completed、Cut または Resolved 状態ではありません。
• Fabrikam Fiber Web チームの現在のイテレーション パスにありません。
• Fabrikam Fiber Web チームの現在のイテレーション パスに割り当てられました。
• Fabrikam Fiber Web チームの現在のイテレーション +1 に割り当てられました。
• 過去 30 日間内に (スプリントの長さ) 変更されました。

SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

構文のクエリ エディター ビューはこのように表示されます。

開始日の後にスプリントに追加された作業項目を一覧表示する

スプリント開始日の後に新たに作成されてスプリントに追加された作業項目を一覧表示するには、次の図のようなクエリを使用します。 このクエリは、現在のスプリントに割り当てられているがスプリントの開始日より後に作成された作業項目をフィルター処理することで機能します。 created Date = @Today - 28 句を使用します。

スプリント スコープの変更についてクエリを実行するためのその他のオプションについては、「スプリント、スクラムおよびプロジェクト管理の概要」の「スプリント スコープの変更」を参照してください。

日付およびイテレーション パスのフィールド

クエリーをフィルタ処理するには、[日付] フィールドを使用します。 これらのフィールドの一部では、作業項目がある状態から別の状態に進むにつれて情報が設定されます。 これらのフィールドのいくつかは作業項目フォームには表示されませんが、次の表に示す作業項目の種類に関して追跡されます。

メモ:

1. 「割り当てまたはワークフローの変更によるクエリの実行」の「日付フィールドと ID フィールド」も参照してください。

2. 作業項目の種類に対して定義するこれらのフィールドは、WORKFLOW作業項目の種類定義のセクションに含める必要があります。 たとえば、この構文は、Resolved 状態に変更する際に FIELDS 定義内に含まれます。

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
       <SERVERDEFAULT from="clock"  />  
    </FIELD >  
   

3. 開始日 と 終了日 の値は、Projectでプロジェクト計画を作成し、その計画を Azure Boards に格納されているタスクと同期する場合に計算されます。 これらのフィールドは、作業項目で表示されない場合がありますが、バックログ項目バックログ項目にリンクされているとタスクに対しては計算されます。 読み取り専用の値は、クエリまたは Excel からの結果で表示されます。

   重要

   Microsoft Project Integration および TFSFieldMapping コマンドは、以下ではサポートされていません。

   • Visual Studio 2019 および Azure DevOps Office Integration 2019。
   • Azure DevOps Server 2019 以降のバージョン (Azure DevOps Services を含む)。

   Microsoft Excel 統合の完全なサポートが維持されるため、作業項目の一括インポートと更新が可能です。 Microsoft Project を使用する代わりに、次のような方法があります。

   • 配信計画
   • Project Connect や GANTT チャートなどの Marketplace 拡張機能

関連記事

• 割り当てまたはワークフローの変更によるクエリの実行
• イテレーション (スプリント) パスの定義とチーム イテレーションの構成
• クエリ エディターを使用したマネージド クエリの作成
• クエリ演算子とマクロ
• 作業項目のフィールドと属性
• 作業項目クエリ言語 (WIQL) の構文

REST API

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

• Azure DevOps Services REST API リファレンス
• クエリ
• 作業項目クエリ言語
• プログラムでクエリを使って作業項目をフェッチする