使用提取要求自動完成工作專案

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

當您將工作項目連結至提取要求 （PR）時，您可以在完成PR時自動完成這些工作專案。 或者，您可以指定要在合併PR時將工作項目轉換成的工作流程狀態。

如需詳細資訊，請參閱 建立、檢視和管理提取要求。

必要條件

• 專案存取： 成為 項目成員。

• 權限：

  • 若要檢視、追蹤和編輯工作專案，請將 [檢視此節點 中的工作專案] 和 [編輯此節點 中的工作專案] 權限設定為 [ 允許]。 根據預設， 參與者 群組具有這些許可權。 如需詳細資訊，請參閱 設定工作追蹤許可權。

• 若要將標籤新增至工作專案，請將專案層級 的 [建立新的標籤定義 ] 權限設定為 [允許]。 根據預設， 參與者 群組具有此許可權。

• 存取層級：

  • 若要將新的標籤新增至工作專案，或檢視或追蹤提取要求，請至少 具有基本 存取權。
  • 若要檢視或追蹤工作專案，至少 要有項目關係人 存取權。 如需詳細資訊，請參閱 關於存取層級。
  • 所有項目成員，包括讀者群組中的成員，都可以傳送包含工作專案的電子郵件。

  注意

  • 為想要參與討論和檢閱進度的成員提供 項目關係人存取 權。 這些通常是不參與程式代碼的成員，但想要檢視工作專案、待辦專案、面板和儀錶板。
  • 項目關係人 無法新增標籤，即使許可權已明確設定，因為其存取層級。 如需詳細資訊，請參閱專案關係人存取快速參考。

• GitHub 許可權： 成為 GitHub 存放庫的參與者 。

自動完成工作專案

如下圖所示，在合併后核取 [完成連結的工作專案] 方塊。 系統會預設為未來PR的選取專案。

在下列情況下，系統不會將工作專案狀態自動更新為 工作項目類型 [完成]、 [已關閉] 或 [已完成 ] 類別（WIT）：

• 使用繼承進程模型管理 WIT 的工作專案已經處於 已解決 狀態。 在此實例中，系統不會更新狀態。 例如，如果衍生自 Agile 程式的 Bug 處於 已 解決狀態，系統就不會將它 轉換為 Closed。
• 工作項目已處於 [已完成 ] 狀態。 不需要進一步轉換。
• WIT 包含工作流程欄位規則，可防止工作項目前進到下一個狀態。 例如，規則可能需要在關閉工作項目時定義另一個字段。
• 針對內部部署和 Azure Boards 託管進程模型，您必須修改工作流程，以指定在轉換工作流程時要執行的動作（ACTION 元素）。 如需詳細資訊，請參閱 變更 WIT 的工作流程，指定動作。

如需詳細資訊，請參閱 自定義您的工作追蹤體驗。

指定連結工作專案的工作流程狀態

若要將工作項目轉換為特定工作流程狀態，您可以在提取要求描述中輸入資訊。 在 #ID 前面加上所提及工作專案的有效工作流程狀態。

下列範例顯示已轉換的用戶劇本 - 一個轉換為 [已解決] 狀態，另一個轉換為 [檢閱] 狀態。 此外，兩個工作會標示為 [完成]。

停用自動完成相關聯的工作專案

若要在使用者完成提取要求時停用相關聯工作項目的自動完成，請遵循下列步驟：

1. 移至 [ 項目設定>存放庫> ] 選取存放庫。
2. 在 [ 設定] 索引標籤中，將切換開關移至 [ 關閉 ] 以進行 認可提及工作專案解析。

不允許在認可批注中提及關閉工作專案（例如「修正 #123」）。

相關文章

• 建立、檢視和管理提取要求
• 自訂工作流程 （繼承程式）
• 自訂您的工作追蹤體驗
• 工作流程狀態和狀態類別如何在待辦專案和面板中使用