依區域或反覆專案路徑查詢

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

[區域路徑] 和 [反復項目路徑] 是所有工作項目類型的工作追蹤表單上顯示的兩個字段。 您可以針對專案定義它們—區域路徑 和 反覆專案路徑，然後選取您想要與小組建立關聯的專案。

若要進一步瞭解如何使用區域和反覆項目路徑，請參閱 關於小組和敏捷式工具。

注意

只有入口網站支援下列宏：@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity和@TeamAreas。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中開啟時，包含這些宏的查詢將無法運作。

支援的運算子和宏

建立查詢並指定區域路徑和反覆項目路徑欄位時，您可以使用下列運算子：

運算子	當您要...
=	指定一個特定區域或反覆項目路徑
<>	篩選掉一個特定區域或反覆項目路徑。
In	篩選一組區域或反覆項目路徑。
Not In	排除指派給一組區域或反覆專案路徑的專案。
Under	指定選取區域或反覆項目路徑下的所有路徑。
Not Under	排除在特定區域或反覆項目路徑下指派的專案。

除了這些運算子之外，您也可以在選取 [反復項目路徑] 時使用下列宏。 如需範例，請參閱 依日期或目前的反覆項目查詢。

Macro	當您要...
@CurrentIteration	指定與所選小組內容相關聯的目前反覆專案。
@CurrentIteration +/- n	根據指派至與所選小組內容相關聯的短期衝刺滑動窗口篩選專案。
@TeamAreas	根據指派給特定小組的區域路徑篩選專案。

注意

@CurrentIteration +/- n Azure DevOps Server 2019 和更新版本支援 和 @TeamAreas 宏。 只有入口網站才支持這些宏。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中開啟時，包含這些宏的查詢將無法運作。

區域路徑查詢

您可以使用 In 運算子，指定篩選指派給數個區域路徑的工作專案，如下列範例所示。

節點名稱和關鍵詞型查詢

使用 [ 節點名稱] 字段，根據使用 Contains 運算符的關鍵詞，篩選指派給區域路徑的工作專案。 節點名稱會指定區域路徑的最後一個節點，其對應至樹狀結構階層中的最後一個節點。

下列查詢會產生與上一個範例相同的結果。

在此範例中，篩選條件會傳回指派給區域路徑的任何工作專案，其最後一個節點包含 “Azure” 這個字。

以下是另一個使用節點名稱和 In 運算子的範例。

小組區域路徑查詢

使用@TeamAreas宏，快速尋找指派給特定小組的區域路徑的專案。 =指定運算子。 查詢編輯器 會自動提示您輸入小組的名稱。 您可以輸入小組的名稱，然後選擇出現在搜尋篩選準則中的小組值來新增它。

分類欄位參考

欄位名稱	說明	參考名稱
區域路徑	將工作專案分組至產品功能或小組區域。 區域必須是專案階層中的有效節點。	System.AreaPath
反覆項目路徑	依具名短期衝刺或時段將工作專案分組。 反覆項目必須是項目階層中的有效節點。	System.IterationPath

針對每個欄位，數據路徑=TreePath、可報告的類型=Dimension、索引屬性=True。

如果您定義長度超過 256 個字元的路徑名稱，則無法在 Microsoft Project 中指定它。 若要避免這個問題，請定義不超過 10 個字元的路徑名稱，而且不要巢狀節點超過 14 個層級。

您無法將大部分欄位規則套用至系統欄位，例如 System.AreaPath 和 System.IterationPath 字段。 如需詳細資訊，請參閱 規則和規則評估。

下列欄位不會出現在工作項目表單上，但會追蹤每個工作項目類型。 這些欄位會為每個針對專案定義的分類值提供數值。 您可以使用這些欄位來篩選查詢並建立報表。

欄位名稱	說明	參考名稱	資料類型
區域標識碼	指派此工作專案之區域的唯一標識符。	System.AreaId	整數
反覆項目標識碼	指派此工作專案之反覆專案的唯一標識符。	System.IterationId	整數
節點名稱	區域路徑的最後一個節點名稱。 例如，如果區域路徑是 Project\A1\B2\C3，則節點名稱為 C3。	System.NodeName	String

預設的可報告類型為 none。 區域標識碼和反覆專案標識碼已編製索引，節點名稱不是。 若要深入瞭解欄位屬性，請參閱 工作專案欄位和屬性。

相關文章

• 查詢快速參考
• 定義區域路徑並指派至小組
• 定義反覆專案 （短期衝刺） 路徑，並設定小組反覆專案
• 設定工作追蹤的許可權和存取權

REST API

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

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