上傳或下載程式範本

  • 發行項

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

當您建立專案時，會使用程式來指定要設定的工作項目類型和其他設定。 每個程式範本主要定義 Azure Boards 工作專案追蹤系統的建置組塊。 針對裝載的 XML 和內部部署 XML 進程模型，您可以將進程範本上傳至更新現有的專案或建立專案。 針對繼承程式模型，您可以透過入口網站自定義工作追蹤。 若要深入瞭解這些不同的程式，請參閱 自定義您的工作追蹤體驗。

您只能針對設定為使用內部部署 XML 進程的專案集合上傳和匯出進程範本。 此外，您也可以在新增專案時將範本標示為預設值。

重要

從 Azure DevOps 內容版本選取器選取版本。

選取對應至您平臺和版本的本文版本。 版本選取器位於目錄上方。 查閱您的 Azure DevOps 平臺和版本。

提示

透過 Azure DevOps Server，您可以選擇使用繼承的進程模型或內部部署 XML 進程模型。 如需詳細資訊，請參閱自定義工作追蹤體驗中的選擇專案集合的程式模型一節。 若要存取預設進程/進程範本的最新版本：

  • 繼承的進程模型：開啟 [ 行程 ] 頁面。 如需詳細資訊，請參閱 管理進程。
  • 內部部署 XML 行程模型：

必要條件

若要管理程式範本，您必須是 Project Collection 管理員 istrators 群組的成員，若要新增至此群組，請參閱變更專案集合層級許可權。

重要

不支援上傳和下載繼承的程式。 若要管理繼承的進程，請參閱 關於程式自定義和繼承的進程。

開啟 設定> Process

您可以從組織設定>程式建立、管理及自訂程式。

  1. 選擇 Azure DevOps 標誌以開啟 Projects。 然後選擇 [ 組織設定]。

    開啟 [項目>組織] 設定。

  2. 然後選擇 [ 處理]。

    然後選擇 [處理]。

    重要

    如果您沒有看到 Process，則您正在從 TFS-2018 或更早版本工作。 不支援 [ 處理 ] 頁面。 您必須使用內部 部署 XML 進程模型支援的功能。

您會從 Collection 設定> Process 建立、管理及進行自定義。

  1. 選擇 Azure DevOps 標誌以開啟 Projects。 選擇您要自定義其程式的專案集合，然後選擇 [集合] 設定。

    開啟項目>組織設定

  2. 然後選擇 [ 處理]。

    然後選擇 [處理]。

您可以從 管理員 設定>程式建立、管理及自訂程式。

  1. 選擇 Azure DevOps 標誌以開啟 Projects。 然後選擇 [管理員 設定]。

    開啟 [項目>組織] 設定。

  2. 然後選擇 [ 處理]。

    然後選擇 [處理]。

匯入行程樣本 （託管的 XML 行程）

  1. 從 [行程] 索引標籤中，選擇 [匯入程式]，然後拖放或流覽至您自定義程式的 zip 檔案。

    [匯入程式] 鏈接的螢幕快照。

    注意

    如果您沒有看到匯 入程序 連結，則您的組織並未設定為支援託管 XML 進程模型。 您應該使用 繼承程式模型 ，以符合您的自定義需求。 只有在您的帳戶是透過 資料匯入服務建立時，才支援裝載的 XML 進程模型。

  2. 選擇要上傳的檔案。 您的 自定義程式必須符合特定條件約束 ，才能在匯入期間通過驗證檢查。

    [匯入程式] 對話框，選擇要匯入的進程檔案。

    如果您要更新現有的範本，請檢查 [取代現有的範本]。 匯入程式會覆寫與您匯入之範本同名的任何範本，並要求您核取此方塊以確認您想要取代它。

    重要

    您無法更新其中一個鎖定的進程：Agile、Basic、CMMI 和 Scrum。

  3. 成功匯入時，您會看到下列訊息。

    [匯入程式成功] 對話框。

    如果行程未通過匯入時執行的驗證檢查，您會收到錯誤訊息清單。
    更正每個錯誤 ，然後重試匯入。

  4. 您可以使用新匯入的程式立即建立專案。

    [匯入程序動作] 功能表的螢幕快照：從匯入的程式建立新的小組專案。

  5. 完成出現的表單。 若要深入瞭解不同的選項，請參閱 建立專案。

    [建立新專案] 對話框。

如需其他裝載的 XML 行程管理工作，請參閱 匯入和匯出裝載的 XML 進程。

管理行程樣本 （內部部署 XML 行程）

  1. 若要上傳進程範本，請選擇 [上傳進程範本 ] 選項。

    入口網站、所有進程、上傳程式範本的螢幕快照。

    在 [上傳程式範本] 對話框中，針對您要上傳的進程範本，選擇包含根檔案ProcessTemplate.xml.zip資料夾。 另 請參閱處理範本限制和驗證檢查。

    入口網站的螢幕快照，[上傳程序範本] 對話框。

  2. 若要下載或匯出程式範本，請選擇 動作圖示，然後選擇 [ 匯出 ] 選項。

    入口網站的螢幕快照、程式操作功能表、導出程式。

  3. 若要在新增專案時將進程設定為預設值，或停用正在使用的進程，請選擇進程的動作圖示，然後選取 [設定為默認進程] 或 [停用進程選項]。

    入口網站、程式操作功能表、停用或刪除進程的螢幕快照。

將程式範本與現有的專案相互關聯

若要判斷用來建立專案的程式範本類型，請檢閱 [Team Explorer 的新增工作專案] 功能表中所顯示的工作專案類型，然後將它們與下圖中的工作專案類型進行比較。 如果您的工作專案類型與顯示的這些專案不同，則可能已使用自定義進程範本。

敏捷式 基本 Cmmi Scrum
敏捷式工作項目類型 基本工作項目類型 CMMI 工作項目類型 Scrum 工作項目類型

處理範本限制和驗證檢查

如果您透過入口網站上傳程式範本，您可能會遇到錯誤，例如下圖所示的錯誤。

上傳進程範本錯誤的螢幕快照。

解決每個錯誤，然後重試上傳程式。 您可能會從解決程式匯入的驗證錯誤中找到解決進程範本錯誤的其他資訊。

上傳進程範本時，必須通過下列驗證檢查。

  • 進程範本名稱必須是唯一的，且 256 個 Unicode 字元或更少。 同名範本會覆寫現有的範本。 此外，名稱不能包含下列字元：。 , ;' ' : / \ * | ? " & % $ ! + = （ ） [ ] { } <>。 如需更多限制，請參閱 命名限制。
  • 進程範本資料夾不能包含任何.exe檔案。 如果成功上傳，程式範本可能會成功上傳，但專案建立失敗。
  • 程序範本大小總計應為 2 GB 或更少，或專案建立失敗。
  • 上傳程式會執行部分驗證檢查，以確保每個進程範本 XML 檔案的 XML 都有效。 如果您在嘗試上傳進程範本時收到任何錯誤，請檢閱 XML 以判斷錯誤的原因。 XML 檔案中的重複標記可能會導致錯誤。 如果 XML 中沒有錯誤，請檢查以確定所有適當的檔案都包含在正確資料夾位置的程式範本中。
  • 如果 XML 定義檔案參考延伸模組，則必須在集合中安裝並啟用延伸模組。

重要

進程範本的架構定義會混合使用駱駝大小寫和所有大寫元素。 如果您在驗證類型定義檔案時遇到錯誤，請檢查元素的案例結構。 此外，開啟和結尾標記的案例結構必須符合 XML 語法的規則。 另 請參閱處理範本外掛程式：索引至 XML 元素定義。

定期對程式範本進行更新，以支援新功能。 如需詳細資訊，請參閱 Azure DevOps Server 的版本資訊。