依區域或迭代路徑查詢
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
[區域路徑] 和 [迭代路徑] 是所有工作項目類型的工作追蹤表單上顯示的兩個欄位。 您可以為專案定義它們—區域路徑 和 反復專案路徑，然後選取您想要與小組建立關聯的路徑。
若要進一步瞭解如何使用區域和迭代路徑，請參閱 關於團隊與敏捷式工具。
先決條件
| 類別 | 要求 |
|---|---|
| 存取層級 | - 若要檢視和執行共享查詢：專案成員。 - 若要新增和儲存共享查詢：需要至少擁有 基本 存取權限。 |
| 許可權 | 將 參與權限 設定為允許 的資料夾，即您想要新增查詢的資料夾。 根據預設，參與者 群組沒有此許可權。 |
注意
具有 項目關係人 公用專案存取權的使用者，可以完整存取查詢功能，就像具有 Basic 存取權的使用者一樣。 如需詳細資訊，請參閱 項目關係人存取快速參考。
| 類別 | 要求 |
|---|---|
| 存取層級 | 若要檢視及執行共享查詢：專案成員。 - 若要新增和儲存共享查詢：至少需要 基本 存取。 |
| 許可權 | [貢獻] 權限設定為 [允許] 該資料夾中您想新增查詢的資料夾。 根據預設，參與者 群組沒有此許可權。 |
注意
只有入口網站支援下列巨集：@CurrentIteration、@CurrentIteration +/-n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity和 @TeamAreas。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中開啟時，包含這些巨集的查詢將無法運作。
支援的運算子和巨集
建立查詢並指定區域路徑和反覆項目路徑欄位時，您可以使用下列運算子：
| 操作員 | 使用時當您要... |
|---|---|
= |
指定一個具體的區域或迭代路徑 |
<> |
篩選出一個特定的區域或迭代路徑。 |
In |
篩選一系列區域或迭代路徑。 |
Not In |
排除指派到某一組區域或反覆專案路徑的項目。 |
Under |
指定所選區域或迭代路徑下的所有路徑。 |
Not Under |
排除指定在特定區域或迭代路徑下的項目。 |
除了這些運算子之外，您也可以在選取[疊代路徑]時使用下列巨集指令。 如需範例，請參閱 依日期或目前迭代查詢。
| 巨集 | 使用時當您要... |
|---|---|
@CurrentIteration |
指定與所選團隊背景相關聯的目前迭代。 |
@CurrentIteration +/- n |
根據指派至與所選小組情境相關聯的短衝程滑動窗口的項目篩選條目。 |
@TeamAreas |
根據指派給特定團隊的區域路徑篩選項目。 |
注意
Azure DevOps Server 2019 和更新版本支援 @CurrentIteration +/- n 和 @TeamAreas 巨集。 這些巨集僅在網站入口支援。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中開啟時，包含這些巨集的查詢將無法運作。
區域路徑查詢
您可以使用 In 運算符，指定篩選指派給數個區域路徑的工作專案，如下列範例所示。
節點名稱和關鍵詞型查詢
使用 [節點名稱] 欄位，根據關鍵詞，使用 Contains 運算符，篩選指派到特定區域路徑的工作專案。 節點名稱 指定 區域路徑的最後一個節點，其對應至樹狀結構階層中的最後一個節點。
下列查詢會產生與上一個範例相同的結果。
在此範例中，篩選條件會傳回指派給區域路徑的任何工作專案，其最後一個節點包含 “Azure” 這個字。
以下是另一個範例，使用 節點名稱 和 In 運算子。
團隊區域路徑查詢
使用 @TeamAreas 巨集，快速尋找分配給指定小組的區域路徑之項目。 指定 = 運算子。 查詢編輯器會自動提示您輸入小組的名稱。 您可以輸入小組的名稱，然後選擇出現在搜尋篩選準則中的小組值來新增它。
查詢指派給小組 的區域路徑
分類欄位參考
| 欄位名稱 | 描述 | 參考名稱 |
|---|---|---|
| 區域路徑 | 將工作項目依據產品功能或小組區域進行分組。 區域必須是專案階層中的有效節點。 | System.AreaPath |
| 反覆運算路徑 | 依具名短期衝刺或時段將工作專案分組。 迭代必須是項目階層中的有效節點。 | 系統.迭代路徑 |
針對每個欄位，資料路徑=TreePath、可報告的類型=Dimension、index 屬性=True。
如果您定義長度超過 256 個字元的路徑名稱，則無法在 Microsoft Project 中指定它。 為了避免這個問題，請定義每個路徑名稱不超過 10 個字元，而且不要將節點嵌套超過 14 個層級。
您無法將大部分欄位規則套用至系統欄位，例如 System.AreaPath 和 System.IterationPath 字段。 如需詳細資訊，請參閱 規則和規則評估。
下列欄位不會出現在工作項目表單上，但會追蹤每個工作項目類型。 這些欄位會為每個針對專案定義的分類值提供數值。 您可以使用這些欄位來篩選查詢並建立報表。
| 欄位名稱 | 描述 | 參考名稱 | 數據類型 |
|---|---|---|---|
| 區域標識碼 | 指派此工作專案之區域的唯一識別碼。 | System.AreaId | 整數 |
| 迭代識別碼 | 指派此工作項目所屬迭代的唯一識別碼。 | System.IterationId | 整數 |
| 節點名稱 | 區域路徑的最後一個節點名稱。 例如，如果區域路徑是 Project\A1\B2\C3，則節點名稱為 C3。 | System.NodeName | 字串 |
預設的可報告類型為無。 區域標識碼和迭代標識碼已編製索引，節點名稱則未編製索引。 若要深入瞭解欄位屬性，請參閱 工作專案欄位和屬性。
相關文章
REST API
若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：