共用方式為

查詢工作項目歷程記錄和討論欄位

  • 發行項

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

記錄工作項目歷史的內容包括：誰創建了該項目、所做的變更，以及這些變更的原因。 這項資訊對於追蹤一段時間內專案的演進至關重要。 將專案新增至歷程記錄欄位時，請包含詳細資訊，以協助下一個工作項目擁有者瞭解變更的內容和所需的動作。

注意

沒有個別 [討論 工作專案] 欄位。 若要查詢在[討論]區域帶有批註的工作項目，請篩選[歷程記錄]欄位。 在 [討論] 方塊中輸入的所有文字都會自動包含在 [歷程記錄] 字段中。

先決條件

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

注意

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

  • 存取層級：
    • 若要檢視及執行共享查詢，為 項目成員。
    • 若要新增並儲存共用查詢，需要至少 基本 權限。
  • 許可權： 將 參與 許可權設定為 允許新增查詢的資料夾。 根據預設，參與者 群組沒有此許可權。

支援的運算子和巨集

  • 支援的運算子：

    • 含有字詞
    • 不包含單字

  • 搜尋方法：

    • 確切片語： 找出確切的字詞序列。
    • 通配符 （*）： 只在部分單字或片語結尾使用。

  • 全文檢索： [歷史記錄] 欄位在可用時會自動編製索引以供全文檢索。

查詢工作項目的歷程記錄

您可以使用入口網站或 Team Explorer 來檢視工作專案的歷程記錄，或根據 [記錄] 字段搜尋工作專案。 搜尋 [記錄] 欄位只會傳回在該欄位中記錄變更的工作專案，且不包含對其他字段所做的變更。

查詢編輯器的螢幕快照，用於根據歷程記錄字段中所包含的文字搜尋項目。

根據 [歷程記錄] 欄位的內容列出項目

使用查詢編輯器將 History 欄位包含在 查詢子句中。

  • 可查詢的內容： 在討論區 中輸入的評論。
  • 不可查詢的內容： 變更記錄項目，例如修改欄位，都是不可查詢的。
  • 替代搜尋方法： 若要搜尋 討論區、描述或其他 RTF 文字欄位中的單字，請使用 工作項目搜尋。
  • 依變更日期篩選： 依變更日期篩選工作專案，或指定特定時段。

篩選

包含這些查詢子句

歷程記錄欄位包含「可重現」一詞的項目

History Contains Words reproducible

[歷程記錄] 欄位未包含 「beta」 一字的專案

History Does Not Contain Words beta

包含片語「堆疊追蹤」且已關閉但重新啟用的項目

History Contains Words stack traces And State Was Ever Closed
And State <> Closed

在指定期間內關閉的專案

State = Done
And Closed Date > 7/1/2015
And Closed Date <= 7/21/2015

我已與物品建立關聯

History Contains Words MyName
Or Assigned To Was Ever _ @Me

使用查詢編輯器的秘訣

  • 依日期範圍限制查詢範圍： 縮小日期範圍以改善效能，並只傳回相關的結果。

  • 使用完整的單字或詞組：

    • 從 [歷程記錄] 字段中輸入完整字詞或確切片語。
    • 不完整的單字不會傳回工作項目。 例如：
      • 搜尋「可重現的行為」能找到項目。
      • 搜尋「重現」找不到。
    • 在字組或片語結尾使用通配符，例如 repro*。

  • 注意「停止」字組：

  • 執行並驗證您的查詢：

    • 在查詢編輯器工具列中，選取 [執行查詢] 或 [舊版執行查詢]。
    • 請確定查詢會傳回預期的結果。
    • 如果結果遺失，請調整您的搜尋字詞，然後再次執行查詢。

檢視工作項目的歷程記錄

每次儲存工作專案時，[記錄] 字段都會新增一個條目。 若要檢視變更的歷程記錄，請開啟現有的工作項目，然後選擇 [歷程記錄] 索引標籤圖示 或 [歷程記錄]，或針對某些工作項目類型 （WIT），選擇 [詳細資料]。

顯示的歷程記錄詳細數據取決於平臺、版本和用戶端。

[工作專案] 表單、入口網站、[選擇歷程記錄] 索引標籤的螢幕快照。

狀態變更歷程記錄圖表會先出現。 若要檢視狀態變更的整個歷程記錄，請選擇 [顯示所有]。

工作項目窗體、入口網站、狀態變更歷程記錄圖（僅限入口網站）的螢幕快照。

選擇左窗格中的項目，並檢視變更的詳細資訊。

工作項目表單、歷史索引標籤、網頁入口、詳細數據螢幕快照。

篩選歷程記錄檢視

[歷程記錄] 索引標籤的設計目的是追蹤對工作專案所做的所有變更，以支援完整的可追蹤性。 結果所產生的長期修訂歷程記錄，可能會讓您難以瞭解特定欄位何時發生變更。 若要快速尋找針對特定欄位或特定人員所做的修訂，請篩選歷程記錄檢視。

注意

切換篩選器 功能需要默認啟用的 New Boards Hub 功能。 如需詳細資訊，請參閱 管理或啟用功能。

若要檢閱特定人員的更新，請從 [依 更新] 功能表中選取其名稱。

工作項目表單的螢幕擷取畫面、歷程記錄標籤、依據誰進行更新的篩選。

若要檢閱對一或多個字段所做的更新，請從 [字段] 功能表中選取字段。

[工作專案] 表單的螢幕快照，[歷程記錄] 索引標籤，篩選對 [指派給] 字段所做的變更。

支援歷史記錄、稽核和版本追蹤的欄位

您可以使用下列欄位來篩選查詢並建立報表。 其中數個字段會填入資訊，因為工作專案會從某個狀態進行到另一個狀態。 其他欄位會在修改工作專案時更新。 有些欄位不會出現在工作項目表單上，但仍然會在所列的工作項目類型中被追蹤。

欄位名稱

描述

工作項目類型

變更者

最近修改工作專案的小組成員名稱。

Reference name=System.ChangedBy, Data type=String

所有

變更日期

修改工作專案的日期和時間。

Reference name=System.ChangedDate, Data type=DateTime

所有的

關閉日期 1

關閉工作專案的日期和時間。
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

全部

建立日期

建立工作專案的日期和時間。

Reference name=System.CreatedDate, Data type=DateTime

都

歷史

建立工作項目之後對工作專案所做的變更記錄。 每次更新工作專案時，信息都會附加至歷程記錄，指定變更的日期、進行變更的人員，以及哪些欄位已變更。

注意

歷史欄位查詢會傳回工作項目，其 討論 評論或 Description 欄位包含符合所輸入關鍵字的字詞。 您無法使用 [歷程記錄] 字段來查詢對其他欄位所做的變更。

您無法將格式化文字新增至歷程記錄欄位。 儲存工作項目之後，就無法改變歷程記錄。
History 欄位以及 Description、Steps to Repro 和 Title 欄位會自動編製全文搜尋的索引，如 查詢欄位、運算元和巨集所述。

Reference name=System.History, Data type=History

全部

已解決日期 1

工作專案已移至 [已解決] 狀態的日期和時間。

Reference name=Microsoft.VSTS.Common.ResolvedDate, Data 類型=DateTime

錯誤（敏捷開發，CMMI）

轉速

指派給工作項目歷史版本的數字。

注意

透過 Azure DevOps Services 的 REST API 進行的更新，其工作專案修訂上限為 10,000。 此限制會限制來自 REST API 的更新，不過，來自入口網站的更新不會受到影響。

Reference name=System.Rev, Data type=Integer

都

修訂日期

修改或修訂工作項目的日期和時間。

Reference name=System.RevisedDate, Data type=DateTime

共用參數、共用步驟、測試案例

狀態變更日期

State 欄位值變更的日期和時間。

Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

全部

測試套件稽核

追蹤修改測試套件時執行的其他作業，例如，將測試新增至測試套件或變更組態。 此欄位可透過 [歷程記錄] 索引標籤或個別查詢來檢視。 有整合的歷史記錄檢視，包含對工作項目欄位進行的變更，以及由相關工件如測試點和配置造成的變更。

Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText

測試套件

浮水印

系統管理的欄位（不可編輯），會隨著對工作專案所做的變更而遞增。

Reference name=System.Watermark, Data type=Integer

所有

注意

  1. 這些欄位必須包含在 WIT 定義的 WORKFLOW 區段中。 例如，轉換至 Resolved 狀態時，此語法會包含在 FIELDS 定義中：

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
   <SERVERDEFAULT from="clock" />
</FIELD>

REST API

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