依日期或目前迭代查詢

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

在本文中，瞭解如何根據工作專案建立、關閉、解析或變更的時間來列出工作專案。 您可以指定日期或使用支援的巨集。 使用 巨集， @Today 並指定相對日期的加號或減號天數。 如需根據工作專案指派給小組目前短期衝刺的查詢，請使用 @CurrentIteration。

例如，尋找過去三天內使用下列查詢修改的工作專案。

先決條件

支援的運算子和巨集

指定 DateTime 欄位或 反覆項目路徑 欄位的查詢子句可以使用下表所列的運算子和巨集。

注意：

1. @StartOfDayAzure DevOps Server 2019.1 和更新版本支援 、 @StartOfWeek@StartOfMonth和 @StartOfYear 巨集。 只有在從入口網站執行時，才支持它們。
2. Azure DevOps Server 2019 和更新版本支援 @CurrentIteration +/- n 巨集，並且僅在從網頁入口網站執行時支援。

日期和時間模式

您針對 DateTime 字段輸入的日期和時間模式應該符合您透過設定檔選取的日期與時間模式。 若要檢視或變更您的選取範圍，請參閱 設定用戶喜好設定。

使用巨集的 @CurrentIteration 用戶端限制

您可以從 @CurrentIteration 下列客戶端在查詢中使用 巨集：

• 聯機至 Azure Boards 的入口網站
• 連線至 Azure Boards 的 Visual Studio 2019 或更新版本
• REST API

您可以在查詢中針對 @CurrentIteration +/- n Azure Boards、Azure DevOps Server 2019 和更新版本使用巨集，以及包含小組作為參數的 REST API。 例如 @CurrentIteration('[Project]\Team')。

如果您在舊版 Visual Studio 中開啟包含 @CurrentIteration 巨集的查詢，或是從 Microsoft excel 或 Microsoft Project 開啟包含巨集的查詢，就會發生錯誤。 此外，您無法在複製或複製測試套件和測試案例、定義警示或使用 REST API 時使用巨集。

以日期為基礎的查詢

依工作項目變更日期或特定時段篩選工作專案。 限制查詢的範圍。 此方法只會傳回符合您包含日期範圍的結果，以協助效能。 如果您不熟悉建立查詢，請參閱 定義工作項目查詢。

並非所有欄位都適用於所有工作項目類型。 您可以加入查詢和套用工作項目類型之欄位集合的日期欄位。

為小組目前的反覆專案建立查詢

如果您的小組遵循 Scrum 程式，您可以排程短期衝刺中完成的工作。 您可以使用 巨集，追蹤在目前短期衝刺 @CurrentIteration 中完成的需求、Bug 和其他工作進度。 如需詳細資訊，請參閱 管理短期衝刺時程表。

查詢會尋找指派給短期衝刺的任何專案，該短期衝刺對應至小組目前的反覆項目路徑。 例如，如果小組在Sprint 5上，查詢會傳回指派給Sprint 5的專案。 稍後，當小組在Sprint 6 中工作時，相同的查詢會傳回指派給Sprint 6的專案。

列出從短期衝刺移出的工作專案

列出針對短期衝刺定義的工作專案，但稍後使用查詢搭配包含 [反復項目路徑Was Ever子句來移出。 您只能使用 WIQL 語法來建構此查詢。 藉由安裝 WIQL 編輯器 Marketplace 延伸模組，在 查詢編輯器 中編輯 WIQL 語法。

例如，下列工作項目的語法查詢符合下列準則：

• 定義於目前專案中。
• 工作項目類型等於用戶劇本或 Bug。
• 工作項目位於 Fabrikam Fiber Web 小組區域路徑底下。
• 工作專案不是處於 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. 另 請參閱依指派或工作流程變更查詢。

2. 若要為工作項目類型定義這些欄位，則必須包含在 WORKFLOW 工作專案類型定義的 區段中。 例如，轉換至FIELDS狀態時，此語法會包含在定義中Resolved。

   <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 的替代方案包括：

   • 傳遞計劃
   • Marketplace 延伸模組，例如 Project Connect 或 GANTT 圖表

相關文章

• 依指派或工作流程變更進行查詢
• 定義反覆專案 （短期衝刺） 路徑，並設定小組反覆專案
• 在 Azure Boards 中定義工作項目查詢
• 查詢欄位、運算子和巨集
• 工作專案欄位和屬性
• 工作專案查詢語言 （WIQL） 語法

REST API

若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：

• Azure DevOps Services REST API 參考
• 查詢
• 工作項目查詢語言
• 以程序設計方式擷取具有查詢的工作專案