使用工作項目範本

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

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015

使用工作項目範本建立預設值的工作項目,並在相似項目間套用一致的更新。 本文說明 Web 入口網站中的範本工作流程,以及在舊版環境中於 Visual Studio 2015 或更早版本內的範本工作流程。 範例請參見 範例工作項目範本。

對大多數團隊而言,請使用 Web 入口網站。 只有在仍依賴基於 Team Explorer 的模板管理時,才使用 Visual Studio 2015 搭配 Power Tools。

工作項目範本與流程範本不同。 背景請參見 「關於流程與流程範本 」以及 基礎、 敏捷、 Scrum 與 能力成熟度模型整合(CMMI)的預設流程指引。

Tip

你可以在本文的後面部分使用 AI 來協助此任務,或參考 啟用 Azure DevOps MCP Server 的 AI 協助功能 來開始。

選擇你的工作流程

請使用此表格為您的情境選擇最佳工作流程。

如果您想要... 使用…… 原因為何
在目前的 Azure DevOps 中建立、管理及套用範本 網頁入口 (主要) 支援標準 Web 體驗中的團隊範疇範本。
依團隊和工作項目類型重複使用共享預設值 已儲存的範本 協助團隊套用一致的欄位與數值。
分享一個直接連結,開啟預先填寫的工作項目 範本網址 最適合在儀表板、維基和聊天中輕量分享。
繼續使用基於 Team Explorer 的範本工作流程 Visual Studio 2015 與 Power Tools(舊版) 只有當你的環境仍然依賴舊有工具時才使用。

必要條件

Workflow Requirements
網頁入口 (主要) - 存取 Azure DevOps 組織與專案。
- 管理範本時,請成為擁有範本的團隊成員。
- 要套用範本,請讓貢獻 者 存取專案。
- 使用支援的瀏覽器,並在網頁入口開啟 Azure DevOps。
Visual Studio 2015 與 Power Tools(舊版) - 僅在環境仍依賴 Team Explorer 模板管理時使用此工作流程。
- 安裝 Microsoft Visual Studio Team Foundation Server 2015 Power Tools。
- 在此工作流程中建立的範本僅限使用者本人使用,且只會顯示於 Team Explorer 中。

使用範本的限制

網頁入口模板和 Visual Studio 範本是分開的儲存庫。 一個客戶端建立的範本不會出現在另一個客戶端。

範本類型 Scope 你可以在哪裡管理它 你可以在哪裡套用它
網頁入口模板 限定於團隊 入口網站 入口網站
Visual Studio 範本 使用者範圍限定 Visual Studio Visual Studio

你仍然可以使用兩種範本類型的 URL 在網頁入口網站中建立工作項目。

支援的模板任務

任務可用性取決於你使用的客戶端。 請使用網頁入口網站進行主要的 Azure DevOps 工作流程,而 Visual Studio 2015 搭配 Power Tools 則僅用於舊版案例。

下表顯示各用戶端的支援情況。

範本工作 入口網站 Visual Studio
將工作專案擷取為範本 ✅ 支援 ✅ 支援
管理工作項目範本
(定義、編輯、刪除、複製連結、建立複製和重新命名)
✅ 支援 ✅ 支援
複製範本的連結 (URL) ✅ 支援 ✅ 支援
使用範本新增工作專案 ✅ 支援 ✅ 支援
定義工作項目範本 ✅ 支援 ✅ 支援
將範本套用至一或多個工作專案 ✅ 支援 ✅ 支援
從範本新增或移除標籤 ❌ 未支援 ✅ 支援
定義具有超連結的範本 ✅ 支援 ❌ 未支援

將工作專案擷取為範本

使用符合你客戶端需求的流程:網頁入口(主要)或 Visual Studio 2015 及以前(舊版)。

你在 Web 入口網站中擷取的每個範本都會取得一個唯一的 GUID。 請依照以下步驟擷取工作項目作為範本並複製其連結。

  1. 在網頁入口中,打開你想用作範本來源的工作項目。

  2. 在右側,選取 [更多動作>> 範本擷取]:

    螢幕擷取畫面,示範如何從 [ 更多動作 ] 功能表選取擷取工作專案欄位定義作為範本選項。

  3. 在 擷取範本中,設定必需與可選欄位:

    • 團隊 (必備):選擇與範本關聯的團隊。

    • 名稱 (必填):輸入範本名稱。

    • 欄位:使用新增欄位來包含欄位,刪除移除欄位,並視需要設定欄位值。

    • 備註:加入範本上下文。 當你從範本建立工作項目時,這段文字會作為 討論 串的第一篇文章出現。

    螢幕擷取畫面,顯示如何在入口網站的 [擷取範本] 對話方塊上設定欄位。

  4. 選擇 儲存,然後選擇 複製連結 以複製範本網址。

    使用 URL 建立相同類型且含有預先定義值的工作項目。 關於常見的分享情境,請參考 「從範本網址建立工作項目 」及 「新增範本連結至團隊儀表板」。

  5. 驗證該範本是否出現在所選團隊的該工作項目範本清單中,複製的連結會開啟一個新的工作項目表單,裡面有預設值。

管理工作項目範本

對於每個工作項目類型,你可以查看並管理團隊定義的範本。 你可以新增、編輯、複製、刪除、重新命名並複製範本連結。

請使用以下步驟在網頁入口網站中開啟工作項目範本:

  1. 在網頁入口網站中,開啟 Project 設定。

  2. 在 面板 下,選取 團隊設定。

  3. 如果你需要切換到其他團隊,請使用導覽路徑中的 團隊 選擇器。

  4. 在 看板 頁面,選擇 範本:

     截圖,顯示如何在專案設定、板子、團隊設定、模板中存取Azure DevOps已儲存的範本清單。

  5. 選擇工作項目類型,如 錯誤、 功能或 測試案例,以查看或新增該類型的範本:

    針對 Bug 工作專案類型定義的範本螢幕擷取畫面。

建立工作項目範本

請依照以下步驟在網頁入口網站建立工作項目範本:

  1. 在工作項目類型頁面,選擇 新範本:

    螢幕擷取畫面顯示如何為 Bug 工作專案類型新增範本。

    備註

    如果你打算在大型文字欄位使用 markdown,請加上 <br> 標籤來管理換行,並確保 markdown 正確呈現。

  2. 在 新範本 對話框中輸入一個 名稱 (必填),然後新增任何可選欄位和值。

  3. 選取 [儲存]。 複製 連結選項 變成可用。

  4. 選擇 複製連結 以複製範本網址。

  5. 請確認範本是否針對所選工作項目類型列出,且複製的連結是否會開啟一個包含範本值的新工作項目表單。

儲存範本後,你可以更新、移除、複製連結或建立副本。

在工作項目類型頁面,選擇 範本的更多動作 ,然後選擇以下選項之一:

所選範本的 [更多動作] 功能表選項的螢幕擷取畫面。

  • 編輯:選擇 編輯,更新範本,然後選擇 儲存。

  • 刪除:選擇 刪除,然後確認。 刪除的範本無法恢復。

  • 複製連結:選擇 複製連結 以複製範本網址。 關於分享選項,請參閱從 範本網址建立工作項目 及 新增團隊儀表板的範本連結。

  • 建立複製:選擇 建立複製,輸入名稱,並可選擇調整欄位,然後選擇 儲存。

  1. 確認範本清單是否反映你的操作(更新值、重新命名項目、複製範本或移除範本)。

  2. 確認複製 連結 會開啟一個包含預期範本值的新工作項目表單。

使用範本新增工作專案

在瀏覽器中使用範本連結,建立一個預設值的工作項目。

  1. 取得範本連結。 更多資訊請參閱編輯、刪除、複製連結、建立複製。

  2. 將範本連結貼到瀏覽器,填寫必填欄位,然後儲存你的修改。

  3. 在儲存前,請確認新工作項目開啟時已填入範本定義的數值。

將範本套用至新的或現有的工作專案

可以套用範本到新的或現有的工作項目,或使用範本進行大量更新。

在 Web 入口網站中,您可以將範本套用至已開啟的工作項目,或套用至選取的工作項目。

在工作專案中套用範本

請使用以下步驟將範本套用到新的或現有的工作項目上:

  1. 打開一個新或已存在的工作項目,並用範本定義的值更新。

  2. 選取 [ 更多動作>] [範本],然後選取預先定義範本的名稱:

    螢幕擷取畫面,顯示如何將範本套用至表單內的現有工作專案。

    備註

    範本清單會顯示為您所屬團隊定義的範本。 如果清單是空的,則可能沒有任何工作專案類型的範本。 重新整理瀏覽器以探索最新的可用範本。

  3. 選擇 儲存 以套用範本。 欄位變更記錄在工作項目 「歷史」 欄位中。

  4. 確認表單中的欄位更新,以及工作 項目歷史 記錄已儲存的變更。

將範本套用至數個工作專案

請使用以下步驟,將範本套用到選取的工作項目以進行批量更新:

  1. 從 待辦清單 或 查詢 結果列表中選擇工作項目。 所有選取的項目必須是相同的工作項目類型,例如錯誤( Bug )或 功能(Feature)。

  2. 選取 更多動作>的範本,針對其中一個已選取的工作專案,然後選取要套用的範本。

    螢幕擷取畫面,示範如何將範本套用至多個工作專案以進行大量更新。

    欄位變更會自動套用並儲存。 欄位變更記錄在工作項目 「歷史」 欄位中。 如需瞭解更多有關大量更新的資訊,請參閱 大量修改工作專案。

  3. 驗證每個選取的工作項目是否顯示更新的欄位值及對應 的歷史 條目。

從範本新增或移除標籤

在 Visual Studio 2015 或更早版本中,你可以為範本新增標籤。 使用範本時,標籤會自動套用到工作項目上。 若要新增兩個或多個標籤,請以逗號 (,) 分隔它們。 你不能在網頁入口新增標籤。

編輯範本對話方塊的螢幕擷取畫面,顯示如何新增或移除標籤。

如果你沒有指定要移除的標籤,工作項目中的所有標籤都會保持定義狀態。 即使你將工作項目範本套用到現有的工作項目上,標籤仍保持定義。

在 Visual Studio 中,確認儲存後範本仍保留已設定的標籤,且已套用的工作項目包含這些標籤。

從範本網址建立工作項目

建立可開啟含有預先定義欄位值之新工作項目的 URL。 當你想要一個可分享的捷徑到共同工作項目配置時,可以使用這種方法。

使用儲存的範本,讓團隊管理的預設值可重複使用。 當直接連結分享是主要體驗時,請使用模板網址。

  • 當團隊需要集中管理的預設值時,使用已儲存的範本。
  • 當你需要在儀表板、維基或訊息中輕量分享時,可以使用模板網址。
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

以下範例建立一個任務工作項目,並預設標題、指派對象、描述、標籤、活動及迭代路徑。

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

備註

某些瀏覽器用戶端會對欄位值施加 2,000 個字元的限制。

你可以將網址儲存為文字檔,或在儀表板或網頁上新增為超連結。

驗證開啟 URL 會載入正確的工作項目類型,並在新的工作項目表單中顯示預設欄位值。

在網頁入口網站的團隊儀表板上,為 Markdown 小工具新增範本連結。 每個連結都會開啟一個帶有預設範本值的新工作項目。

以下範例展示了一個帶有三個範本連結的 Markdown 小工具:

帶有模板鏈接的 Markdown 小部件的屏幕截圖。

關於設定步驟,請參見 「將 Markdown 加入儀表板」的 Markdown 小工具。

疑難排解範本問題

  • 範本選單不出現:請確認你有專案存取權,且是否使用客戶支援的工作流程。
  • 網頁入口網站的範本清單是空的:確認所選工作項目類型的範本是否存在,且你是擁有這些範本的團隊成員。 重新整理瀏覽器頁面以載入最新範本。
  • 無法管理團隊範本:請確認你是擁有該範本的團隊成員。
  • 無法套用範本對多個工作項目:確認所有選取的工作項目都是相同的工作項目類型。
  • Visual Studio 範本選項無法使用:請確認您使用的是舊版 Visual Studio 2015 工作流程,並且已安裝 Microsoft Visual Studio Team Foundation Server 2015 Power Tools。
  • 範本 URL 在開啟時未帶入預期值:請確認每個欄位參考名稱對目標工作項目類型皆有效,且值已進行 URL 編碼(例如,空格編碼為 + 或 %20)。
  • 範本 URL 載入失敗:確認該 URL 使用正確的組織、專案和工作項目類型,且你已登入具有專案權限的帳號。
  • 模板中的某些欄位無法被填入:確認這些欄位仍然存在於工作項目類型中,且不受流程自訂規則限制。

利用 AI 來建立並套用工作項目範本

如果你設定 Azure DevOps MCP 伺服器,就能用自然語言描述範本相關任務,而不必在網頁入口網站或團隊檔案總管中手動完成每個步驟。

以下提示將視為情境範例。 可用的操作會依 MCP 伺服器版本、啟用的工具及您的權限而異。

在執行提示前,先用環境中的值替換佔位符:<ProjectName>、<TeamName>、<TemplateName><WorkItemId><IterationPath>、 和 。

任務 範例提示
從一個物品建立範本 Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
建立一個新範本 Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
套用範本到一個項目 Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
批次套用範本 Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
從範本建立工作項目 Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
產生範本網址 Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
更新範本 Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
複製範本 Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
尋找缺少範本的團隊 List teams in project <ProjectName> that don't have a Bug template defined
稽核範本的使用 Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

備註

如果你用的是 Visual Studio Code,代理模式對於複雜的範本操作特別有幫助。