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

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

[區域路徑] 和 [反復專案路徑] 是所有工作專案類型的工作追蹤表單上出現的兩個欄位。 您可以為專案定義區域路徑反復專案路徑,然後選取您想要與小組建立關聯的專案。

若要進一步瞭解如何使用區域和反復專案路徑,請參閱 關於小組和敏捷式工具

注意

只有入口網站支援下列宏:@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 根據指派給特定小組的區域路徑篩選項目 () 。

注意

@CurrentIteration +/- nAzure 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 欄位。 若要深入瞭解,請參閱 規則和規則評估

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

欄位名稱 說明 參考名稱 Data type
區域 ID 此工作項目獲派之區域的唯一 ID。 System.AreaId 整數
反覆項目 ID 此工作項目獲派之反覆項目的唯一 ID。 System.IterationId 整數
節點名稱 區域路徑的最後一個節點名稱。 例如,如果區域路徑為 Project\A1\B2\C3,則節點名稱為 C3。 System.NodeName String

預設可報告類型為 none。 區域識別碼和反復專案識別碼會編制索引,節點名稱則不是。 若要深入瞭解欄位屬性,請參閱 工作專案欄位和屬性

REST API

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