依連結或附件計數查詢工作專案

  • 發行項

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

您可以 連結工作專案來追蹤相關的工作和相依性， 並 附加檔案來與小組共用資訊。 然後，您可以根據下列一或多個欄位列出工作專案：

  • 附件檔案計數
  • (討論) 批註計數
  • 外部連結計數
  • 超連結計數
  • 連結註解
  • 關聯連結計數
  • 遠端連結計數
  • 附件檔案計數
  • (討論) 批註計數
  • 外部連結計數
  • 超連結計數
  • 連結註解
  • 關聯連結計數

如需上述每個欄位的描述，請參閱 本文稍後提供的表格。

支援的運算子和宏

指定整數位段的查詢子句可以使用下列運算子。

= , <> , > , < , >= , <= ,
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field],
In, Not In,
Was Ever

您可以依連結類型、連結計數或附件計數來篩選工作專案。

篩選

包含這些查詢子句

具有附件的專案

Attached File Count >= 1

具有兩個或多個超連結的專案

Hyperlink Count >= 2

包含外部連結的專案、工作專案以外的物件連結

External Link Count >= 1

包含三到七個相關連結的專案

Related Link Count >= 3 And Related Link Count <= 7

包含遠端連結的專案

Remote Link Count > 0

列出樹狀檢視中的階層式專案

新增查詢，然後選取 工作專案的樹狀結構 以開始查詢。 您應該會看到類似下列範例的內容：

注意

您無法建構顯示Test Plans、測試套件和測試案例階層式檢視的查詢。 這些專案不會使用父子連結類型連結在一起。 不過，您可以建立列出測試相關工作專案的直接連結查詢。 此外，您也可以透過 [測試 > Test Plans] 頁面來檢視階層。

您可以從該處新增查詢子句，或變更連結工作專案的篩選選項。

篩選

包含這些查詢子句

僅檢視工作專案的子專案 645

新增至最上層工作專案的篩選：
ID = 645

工作或 Bug

新增至連結工作專案的篩選：
Work Item Type In Task,Bug

指派給小組的專案 (Web)

將 新增至頂端和底部篩選準則：
Assigned to In Group [Fabrikam Fiber]\Web

指派給我之工作的父專案

先將 [篩選] 選項變更為 [比對連結的工作專案]
新增至連結工作專案的篩選：
Assigned To = @Me

根據連結的相依專案列出專案

下列範例顯示相依連結查詢，此查詢會傳回其他小組和專案所管理工作上具有相依性的專案。

下列查詢會尋找所有專案中的工作專案，這些專案都連結至 Fabrikam 區域路徑下的工作專案，以及使用前置任務和後續任務連結類型的專案。

入口網站查詢編輯器、工作專案和直接連結的螢幕擷取畫面。

為什麼這樣就可以運作：

  • 核取 [ 跨專案查詢 ] 核取方塊可讓符合篩選準則的所有相依連結工作專案列出，不論其所屬的專案為何。

  • 指定 Fabrikam 子句下的 [區域路徑 ] 表示只尋找連結到 Fabrikam 專案下定義之工作專案的工作專案。

  • 指定 [僅傳回具有相符連結的專案] 和 [ 傳回選取的連結類型 ] 會導致查詢只傳回根據 [ 前置任務 ] 和 [ 後續任務 ] 連結類型連結的工作專案。

列出孤立使用者劇本

如果您通常會在功能下組織使用者劇本，您可以開啟產品待辦專案、啟用 [上層 ] 檢視選項，然後向下捲動至列出 [敏捷式) ] 或 [未 (親 和待處理 待辦專案 ] (Scrum) 的區段，以快速找到孤立的使用者劇本。

列出孤立劇本或待辦專案

或者，您可以使用 工作專案和直接連結 查詢來尋找未父系待辦專案。 例如，下列查詢會列出沒有 Parent 連結之 Azure DevOps 小組的作用中使用者劇本。

查詢編輯器、工作專案和直接連結、入口網站、未親和使用者劇本的螢幕擷取畫面。

下表描述與連結和附件相關聯的欄位。 這些欄位大部分不會出現在工作專案表單內，但會追蹤所有工作專案類型。

欄位名稱

說明

工作項目類型

附件檔案計數

附加至工作項目及儲存在工作項目追蹤資料庫中的檔案數目。
參考名稱=System.AttachedFileCount， 資料類型=Integer

注意

針對Azure Boards (雲端服務) ，您可以將最多 100 個附件新增至工作專案。 嘗試在儲存工作專案時新增更多會導致錯誤訊息。

All

批註計數

新增至工作專案 [ 討論 ] 區段的批註數目。
參考名稱=System.CommentCount， 資料類型=Integer

注意

適用于 TFS 2017，其中包含支援 討論 區段和更新版本的新工作專案表單。

All

**外部連結計數**

從工作專案到非工作專案的成品的連結數目。 例如提取要求、認可、變更集或其他連結類型。
參考名稱=System.ExternalLinkCount， 資料類型=Integer

All

**超連結計數**

針對工作項目定義的超連結數。

參考名稱=System.HyperLinkCount， 資料類型=Integer

All

連結註解

包含建立連結之小組成員的註解。 您可以將此欄位設定為在工作專案表單的連結清單中顯示為數據行。 查詢編輯器不支援 (。)

參考名稱=System.Links.Comment， 資料類型=PlainText

All

連結描述

包含做為連結目標之工作項目的工作項目類型、ID 及標題。 您可以將此欄位設定為在工作專案表單的連結清單中顯示為數據行。 查詢編輯器不支援 (。)

參考名稱=System.Links.Description， 資料類型=PlainText

All

**Parent**

當包含在待辦專案或查詢結果清單中做為資料行選項時，會顯示父工作專案的 標題 。 在內部， 系統會在 [ 整數] 欄位中儲存工作專案的識別碼。

注意

您可以藉由指定 父 工作專案識別碼，將 Parent 欄位新增為數據行，或在查詢子句內指定它。
參考名稱=System.Parent，資料類型=Integer

All

**Parent**

當包含在待辦專案或查詢結果清單中做為資料行選項時，會顯示父工作專案的 標題 。 在內部， 系統會在 [ 整數] 欄位中儲存工作專案的識別碼。

注意

[父] 欄位可從 Azure DevOps Server 2020 和更新版本取得。 您無法在查詢子句內指定此欄位。
參考名稱=System.Parent，資料類型=Integer

All

**相關連結計數**

為使用工作連結類型的工作專案定義的連結數目，例如 Parent-Child、Predecessor-Successor 和 Related。 如需完整清單，請參閱 連結類型參考。
參考名稱=System.RelatedLinkCount， 資料類型=Integer

All

**遠端連結計數**

僅適用于Azure DevOps Services。 從工作專案到另一個組織中定義之工作專案的連結數目。 組織必須由相同的 Azure Active Directory 管理。 支援的連結類型包括「取用來源」、「產生者」和「遠端相關」。 若要深入瞭解，請參閱 新增工作專案的連結、連結至遠端工作專案。
參考名稱=System.RemoteLinkCount， 資料類型=Integer

All

您可以安裝 Visual Studio Marketplace、Azure DevOps 索引標籤中可用的 工作專案視覺效果延伸模組 ，以檢視工作專案表單內的相關工作專案和物件。

若要新增連結類型，請參閱 管理連結類型 [witadmin] 。

支援在工作專案之間建立連結的所有索引標籤，都是使用工作專案表單上的 LinksControl 元素來實作。 此元素會控制篩選和限制您可以連結的工作專案類型、您可以建立的連結類型，以及是否可以連結到另一個專案中的工作專案。 若要自訂連結控制項和限制，您可以修改工作專案類型的 定義 LinksControlOptions ，請參閱 LinksControlOptions XML 元素。

您可以在連結清單中加入或移除資料行，且您可以自訂預設資料行及資料行順序。 如需詳細資訊，請參閱 LinksControlOptions XML 元素。