共用方式為

依區域或迭代路徑查詢

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

[區域路徑] 和 [反覆專案路徑] 欄位會出現在每個工作專案類型的所有工作專案表單上。 您可以為專案定義這些路徑 （區域路徑 和 反覆專案路徑），然後選取您要與小組相關聯的路徑。

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

Prerequisites

Category Requirements
存取層級 - 若要檢視和執行共享查詢：專案成員。
- 若要新增和儲存共享查詢：需要至少擁有 基本 存取權限。
Permissions 將 參與權限 設定為允許 的資料夾，即您想要新增查詢的資料夾。 根據預設，參與者 群組沒有此許可權。

Note

具有 項目關係人 公用專案存取權的使用者，可以完整存取查詢功能，就像具有 Basic 存取權的使用者一樣。 如需詳細資訊，請參閱 項目關係人存取快速參考。

Category Requirements
存取層級 - 若要檢視和執行共享查詢：專案成員。
- 若要新增和儲存共享查詢：至少需要 基本 存取。
Permissions 將 參與權限 設定為允許 的資料夾，即您想要新增查詢的資料夾。 根據預設，參與者 群組沒有此許可權。

Note

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

支援的運算子和巨集

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

Operator 使用時當您要...
= 指定一個具體的區域或迭代路徑
<> 篩選出特定的區域或迭代路徑
In 篩選一組區域或迭代路徑
Not In 排除指派給一組區域或迭代路徑的項目
Under 指定所選區域或疊代路徑下的所有路徑
Not Under 排除在特定區域或疊代路徑下指派的項目

當您選取「疊代路徑」欄位時，可以使用下列巨集。 如需範例，請參閱本頁的查詢範例。

Macro 使用時當您要...
@CurrentIteration 指定與所選團隊情境相關的目前迭代
@CurrentIteration +/- n 根據指派給已選擇團隊情境的衝刺滑動窗口來篩選項目
@TeamAreas 根據指派給特定團隊的區域路徑篩選項目

Note

Azure DevOps 網頁入口會評估像是 @CurrentIteration、@CurrentIteration +/- n 和 @TeamAreas 這些宏（服務和伺服器）。 非-Web 用戶端（Visual Studio/Team Explorer、Excel、Project）和直接 WIQL/REST 呼叫需要明確的區域/迭代路徑，而且不接受原始巨集符號。 當您在 Web UI 中儲存查詢時，入口網站通常會將宏展開為儲存的 WIQL 中的具體值，如果您需要在 Web UI 外部使用查詢，請在您的環境中驗證此行為。

區域路徑查詢

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

螢幕擷取畫面，顯示數個區域的區域路徑查詢。

節點名稱和關鍵詞型查詢

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

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

螢幕擷取畫面，顯示數個區域的節點名稱查詢。

在此範例中，篩選會傳回指派給區域路徑的工作專案，其最後一個節點包含「Azure」一詞。

螢幕擷取畫面，顯示數個短衝的查詢。

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

螢幕擷取畫面，顯示數個區域的節點名稱查詢。

團隊區域路徑查詢

使用 @TeamAreas 巨集來尋找指派給特定小組所使用區域路徑的項目。 指定 = 運算子。 查詢編輯器會提示您輸入小組名稱;從建議的清單中選取小組。

螢幕擷取畫面，顯示指派給小組之區域路徑的查詢。

分類欄位參考

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

針對每個欄位，資料路徑=TreePath、可報告的類型=Dimension、index 屬性=True。

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

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

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

欄位名稱 Description 參考名稱 資料類型
區域識別碼 您指派此工作專案之區域的唯一識別碼。 System.AreaId Integer
疊代識別碼 您指派此工作項目的迭代的唯一識別碼。 System.IterationId Integer
節點名稱 區域路徑的最後一個節點名稱。 例如，如果區域路徑是 Project\A1\B2\C3，則節點名稱為 C3。 System.NodeName String

預設的可報告類型為無。 區域 ID 和疊代 ID 具有索引。 節點名稱沒有。 若要深入瞭解欄位屬性，請參閱 工作專案欄位和屬性。

相關內容

REST API

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

  • Last updated on