共用方式為

  • 發行項

若設定功能精靈無法更新您的 Team 專案，表示您的 Team 專案是從非 TFS 提供的流程範本建立，或者，您自訂 Team 專案的方式與其套用更新的能力有所衝突。 在這些情況中，您有下列選項可用來更新現有 Team 專案：

  • **選項 A：**將功能加入自訂的流程範本，然後執行 [設定功能精靈]。

    執行步驟：步驟 1、步驟 2、步驟 4 和步驟 5

    如果您對流程範本進行了大量自訂，請選擇此選項。

  • **選項 B：**將自訂套用至最新的流程範本，然後執行 [設定功能精靈]。

    執行步驟：步驟 1、步驟 3、步驟 4 和 步驟 5。

    如果您對流程範本進行了極少量自訂，請選擇此選項。

  • 選項 C：手動更新 Team 專案以加入功能。

    如果您對 Team 專案進行的自訂不存在於任何流程範本中，請選擇此選項。

  • **選項 D：**以程式設計方式更新許多 Team 專案。 首先，選擇 [選項 A] 或 [選項 B] 來更新您的自訂流程範本。 然後使用下列資訊和資源，批次更新為 Team 專案集合定義的所有 Team 專案：如何設定數十個 Team 專案的功能，以及Features4tfs CodePlex 方案。

    當您有數十個 Team 專案是從相同流程範本建立時，請選擇這個選項。

若要深入了解最新的預設流程範本中添加的功能，請參閱為了加入新功能而做的組態變更。

1.下載最新的流程範本

步驟 1您將從下載最新版本之流程範本的資料夾複製檔案，或將檔案加入至包含自訂流程範本定義的對應資料夾。

  1. 如果您更新的是以比 MSF 6.0 或 Visual Studio Scrum 2.0 更早的版本為基礎的流程範本，請先套用本主題的 2012 版本提供的更新。

    您可以檢查 ProcessTemplate.xml 檔案取得版本資訊。

  2. 若您尚未將應用程式層伺服器升級為含有您所需功能的 TFS 版本，請立刻進行升級。 取得下載以及升級 Team Foundation Server。

  3. 如果您不是 Project Collection Administrators 群組的成員，請加入。 您需要將 [管理流程範本] 權限設為 [允許]，才能下載及管理流程範本。

  4. 升級 TFS 之後，請從 TFS 下載最新的流程範本，並選擇最符合建立您 Team 專案時所使用的流程範本。

    請參閱下載最新版流程範本。

    若要下載或上傳流程範本，您必須從 Visual Studio 2013 或 Team Explorer 2013 連接到 TFS 2013。

  5. 將流程範本複製到您要套用自訂的新資料夾 (選項 B)，或是複製 XML 以將新功能加入現有的流程範本 (選項 C)。

2.將功能加入自訂的流程範本 (選項 A)

步驟 2   加入下列工作項目類型 (WIT) 以更新自訂的流程範本：

從下載最新版本之流程範本的資料夾複製檔案，或將檔案加入至包含自訂流程範本定義的對應資料夾。

加入功能及 Portfolio 待處理項目的支援 (需要 TFS 2013)

  1. 將 WorkItem Tracking/TypeDefinitions 資料夾的 Feature.xml 檔案複製到您的自訂流程範本的對應資料夾。

  2. 將 Feature Category 加入至位於 WorkItem Tracking 資料夾的 Categories 檔案。

    <CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </CATEGORY>

  3. 開啟位於 WorkItem Tracking 資料夾的 WorkItems 外掛程式檔案。

    1. 將上傳功能工作項目類型的工作加入至 <WORKITEMTYPES> 區段。

      <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Feature.xml" />

    2. 取代 PROCESSCONFIGURATION 項目中的兩個流程組態工作...

      <PROCESSCONFIGURATION>
   <CommonConfiguration fileName="WorkItem Tracking\Process\CommonConfiguration.xml"/>
   <AgileConfiguration fileName="WorkItem Tracking\Process\AgileConfiguration.xml"/>
</PROCESSCONFIGURATION>

      .. 成為參考 ProcessConfiguration 檔案的單一項目陳述式。

      <PROCESSCONFIGURATION>
   <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>

  4. 將已下載之流程範本的 WorkItem Tracking/Process 資料夾的 ProcessConfiguration 檔案複製到自訂範本資料夾的相同位置。

    將您對 AgileConfiguration 或 CommonConfiguration 檔案進行的任何自訂併入 ProcessConfiguration。 如需詳細資訊，請參閱流程組態 XML 項目參考。

  5. 從 WorkItem Tracking/Process 資料夾刪除 AgileConfiguration 和 CommonConfiguration 檔案。

    流程組態現在是由單一檔案 ProcessConfiguration 提供支援。

  6. 使用在相同位置中下載的流程範本檔案來取代自訂範本資料夾 Reports 中的 Backlog/Stories/Requirement Overview.rdl 和 Stories/Requirements Progress.rdl 檔案。

    這些變更會反映在引入功能 Portfolio 待處理項目工作項目類型時所需要的變更，如下列部落格文章所述：更新您的概觀和進度報告以支援 Portfolio 待處理項目。

  7. 以最新資料夾的內容取代位於 Windows SharePoint Services 資料夾底下的 Process Guidance 資料夾。

    這些檔案會提供最新流程指引內容的前導連結。

加入共用參數的支援 (需要 TFS 2013.2)

  1. 將 WorkItem Tracking/TypeDefinitions 資料夾的 SharedParameter.xml 檔案複製到您的自訂流程範本的對應資料夾。

  2. 將 Shared Parameter Category 加入至位於 WorkItem Tracking 資料夾的 Categories 檔案。

    <CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </CATEGORY>

  3. 將 Shared Parameter 加入 Hidden Types Categories。

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />  </CATEGORY>

  4. 開啟位於 WorkItem Tracking 資料夾的 WorkItems 外掛程式檔案。

  5. 將上傳共用參數 WIT 的工作加入至 <WORKITEMTYPES> 區段。

    <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedParameter.xml" />

加入測試計劃和測試套件 WIT (需要 TFS 2013.3)

當您將應用程式層伺服器升級為 TFS 2013.3 時，[TFS 升級精靈] 會自動更新您現有的 Team 專案，以支援測試計劃和測試套件的新工作項目追蹤物件。

這會變更您的 Team 專案，但不會變更任何現有的自訂處理序範本。 您可以手動更新自訂的處理序範本。 需要執行此動作的原因包括支援後續需要使用 [設定功能精靈] 的 TFS 升級，或您計劃要使用已經升級之伺服器上的自訂處理序範本來建立 Team 專案。 您需要手動將這些物件加入自訂的處理序範本。

  1. TestPlan.xml 和 TestSuite.xml 檔案從 WorkItem Tracking/TypeDefinitions 資料夾複製到自訂處理序範本的對應資料夾。

  2. 將 Test Plan Category 和 Test Suite Category 加入位於 WorkItem Tracking 資料夾的 Categories 檔案。

    <CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>

  3. 將 Test Plan Category 和 Test Suite Category 加入 Hidden Types Categories。

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>

  4. 開啟位於 WorkItem Tracking 資料夾的 WorkItems 外掛程式檔案。

  5. 將上傳測試計劃和測試套件 WIT 的工作加入 <WORKITEMTYPES> 區段。

    <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestPlan.xml" />
<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestSuite.xml" />

3.將自訂套用至流程範本 (選項 B)

步驟 3 您可以使用此選項，將您對 Team 專案或流程範本執行的自訂套用至最新的流程範本 (且其最符合建立您 Team 專案時所使用的範本)。

  1. 將您所做的自訂套用至新的流程範本資料夾：

    • 將您執行的自訂套用至預設工作項目類型 (WIT) 定義。 這可能包含加入欄位，或修改工作流程或表單。

    • 將自訂 WIT 加入工作項目追蹤資料夾，並視需要更新 WorkItems 定義檔。 請參閱將工作項目的類型定義加入至流程範本。

      若您想要使用名稱與預設流程範本相同的自訂 WIT，請務必將 WIT 定義檔分頁出去。 若您想要使用名稱與預設流程範本不同的自訂 WIT，就必須先修改分類及流程組態定義檔，再進行匯入，以反映不同的命名。

    • 將自訂套用至 Categories 定義檔。

    • 將自訂套用至 ProcessConfiguration 定義檔。 檢查您需要的 WIT 是否都有正確的分類，而且所有工作流程狀態是否都有對應至轉移狀態 (metastate)。

    • 將其他您自訂的所有流程範本檔，複製到適當的流程範本資料夾中。 如需流程範本檔的完整清單，以及自訂它們的資訊，請參閱流程範本檔概觀。

  2. 請根據這份檢查清單檢閱您的變更，確保您已套用了所有必要的自訂：

    自訂

    更新或確認 WIT 定義

    更新或確認處理序組態定義

    將 WIT 加入需求分類

    (WIT 可以屬於需求分類或工作分類，但不能同時屬於兩者。)

    若要包括下列欄位：

    • 在流程組態檔中指派給 type=Order 的欄位值 (Scrum 中的待處理項目優先權、Agile 中的堆疊順位或 CMMI)

    • 在流程組態檔中指派給 type=Effort 的欄位值 (投入時間 (Scrum)、劇本點數 (Agile) 或大小 (CMMI))

    • 在流程組態檔中指派給 type=Team 的區域路徑或欄位值。

    • 處理序組態檔的 AddPanel 區段中包括的所有欄位 (欄位必須在 FIELDS 區段內定義，但不必包含在 FORM 區段內。

    若要在 RequirementBacklog 區段底下包含必要的中繼狀態對應：

    • 將需求分類中每個 WIT 的初始狀態對應至 type="Proposed"

    • 將每個您顯示在看板上的中繼工作流程狀態，對應到 type="InProgress"

    • 將每個工作流程狀態的結尾對應到 type="Complete"

      您可以有多個對應至 type="Complete" 的狀態

    包含要定義與 WIT 相關聯之色彩編碼的項目。 例如：

    <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

    變更需求分類中 WIT 的工作流程

    N/A

    若要包含必要的中繼狀態對應 (如上所述)，以將 WIT 加入需求分類。

    將 WIT 加入工作分類

    若要包括下列欄位：

    • 在流程組態檔中指派給 type=Order 的欄位值 (Scrum 中的待處理項目優先權、Agile 中的堆疊順位或 CMMI)

    • 在流程組態檔中指派給 type=Activity 的欄位值 (活動 (Scrum 或 Agile) 或專業領域 (CMMI))

    • 處理序組態檔中指派給 type=Team 的區域路徑或欄位值

    • 在流程組態檔中指派給 type=RemainingWork 的欄位值 (剩餘工作)

    • (選用) 原始工作和完成的工作 (僅限 Agile 和 CMMI)

    若要在 TaskBacklog 區段底下包含必要的中繼狀態對應：

    • 將工作分類中每個 WIT 的初始狀態對應至 type="Proposed"

    • 將每個您要顯示在工作面板上的中繼工作流程狀態，對應到 type="InProgress"

    • 將每個工作流程狀態的結尾對應到 type="Complete"

      您可以有多個對應至 type="Complete" 的狀態

    包含要定義與 WIT 相關聯之色彩編碼的項目。 例如：

    <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

    變更工作分類中 WIT 的工作流程

    N/A

    若要包含必要的轉移狀態對應 (如上所述)，以將 WIT 加入工作分類。

    將 WIT 加入 Bug 分類，或變更 Bug 分類中 WIT 的工作流程 (僅限 Agile 和 CMMI) (請參閱附註 a)

    若要支援小組可設定的設定值，以將 Bug 加入待處理項目，請包含下列欄位：

    • 在流程組態檔中指派給 type=Order 的欄位值 (Scrum 中的待處理項目優先權、Agile 中的堆疊順位或 CMMI)

    • 在流程組態檔中指派給 type=Effort 的欄位值 (投入時間 (Scrum)、劇本點數 (Agile) 或大小 (CMMI))

    若要在 BugWorkItems 區段底下包含必要的中繼狀態對應：

    • 將 Bug 分類中每個 WIT 的初始狀態對應至 type="Proposed"

    • 將您想要顯示在看板上或用於我的工作的中繼工作流程狀態，對應至 type="InProgress"

    • 將每個工作流程狀態的結尾對應到 type="Complete"

      您可以有多個對應至 type="Complete" 的狀態

    如需詳細資訊，請參閱使用我的工作支援 Bug 更新狀態。

    從需求分類或工作分類移除 WIT

    N/A

    移除只與該 WIT 相關聯的所有轉移狀態對應

    移除 WIT

    從分類檔中移除 WIT

    移除只與您所移除的 WIT 相關聯之所有轉移狀態對應，以及定義您所移除之 WIT 的色彩編碼之 WorkItemColor 項目。

    重新命名 WIT

    以新名稱更新分類檔案

    以新名稱更新流程組態檔

    注意：

    1. 如果您已更新至 TFS 2013.4，請參閱將 Bug 加入至工作面板或待處理項目。 TFS 2013.4 導入一個設定值，可讓每個小組檢視其待處理項目和看板上的 Bug。 此功能會參考在 BugWorkItems 底下進行的中繼狀態對應。

4.重新命名流程範本並上傳至 TFS

步驟 4   若要讓設定功能精靈選取最新版的流程範本，您必須更新 version 陳述式，以區別更新的流程範本版本和舊版流程範本。

  1. 開啟位於最上層資料夾的 ProcessTemplate 外掛程式檔案。

    1. 更新名稱以反映您所做的版本變更。 例如：

      <name>MyCompany Custom Scrum 2013.3  </name>

    2. 更新 description 項目後面的程式碼片段。 增加次要版本，以反映出您已對現有流程範本進行更新，並使其與預設 TFS 流程範本有所區別。

      您選擇的程式碼片段是根據您所更新的範本分類：

      分類

      版本陳述式

      Agile

      		 
      <version type="ADCC42AB-9882-485E-A3ED-7678F01F66BC" major="7" minor="20"/>

      CMMI

      		 
      <version type="27450541-8E31-4150-9947-DC59F998FC01" major="7" minor="10"/>

      Scrum

      		 
      <version type="6B724908-EF14-45CF-84F8-768B5384DA45" major="3" minor="10"/>

  2. 上傳處理序範本。

    若要確認您的變更，請建立測試專案。 請參閱建立 Team 專案。

5.執行設定功能精靈

步驟 5當您確認流程範本支援您的自訂時，請執行 [設定功能精靈] 以更新現有的 Team 專案。 請參閱 更新已升級的 Team 專案以使用新功能。

問與答

問：何種類型的自訂會使設定功能精靈無法更新 Team 專案？

**答：**下列流程範本的變更會干擾設定功能精靈的執行能力：

  • 重新命名或移除屬於需求分類或工作分類的 WIT。

  • 為屬於需求分類或工作分類的 WIT 定義了重新命名的狀態或自訂的工作流程狀態。 轉移狀態會定義計劃工具如何處理每個工作流程狀態。 至少要有一個工作流程狀態是對應至 InProgress，且對應至 Completed 轉移狀態。

  • 移除為屬於需求分類或工作分類的 WIT 所定義的欄位。 這些欄位會在 ProcessConfiguration 定義檔中定義，其中包含用於管理待處理項目優先權、投入時間、工作活動或專業領域，以及剩餘工作時所使用的欄位。

如需詳細資訊，請參閱處理序組態 XML 項目參考。

問：如何在流程範本中使用版本陳述式？

**答：**設定功能精靈會使用 version 陳述式，判斷在分類中的哪個流程範本是最新的版本並自動選取該版本。

如果 version 陳述式不存在，設定功能精靈就無法選取用於更新 Team 專案的流程範本。 此外，如果有多個上傳至 TFS 的流程範本均指定相同的最高版本號碼，則不會選取這些流程範本來更新 Team 專案。

問：我是使用流程範本的新手。關於執行手動更新，有哪些是我應該要知道的？

**答：**修改流程範本檔時請將這些提示謹記在心：

  • 如需什麼是流程範本檔及其檔案和資料夾的概觀，請參閱自訂流程範本 和流程範本檔概觀。

  • 請勿為了上傳檔案而移除任何檔案或工作，除非您確實知道所移除的檔案，而且未來將不會再使用它。

  • 若要找出您執行的自訂，可以對存在於兩個範本中的同等檔案執行差異作業。 但您可能會收到誤報，因為兩個版本間的項目定義序列可能會有所變更。

  • 您可以在所有外掛程式檔案中搜尋 dependency 項目，以了解有哪些工作是相依於正在完成的其他工作。 例如，Microsoft Test Manager 和 Lab Management 需要 SharedSteps 和 TestCase 工作項目類型、SharedSteps 和 TestedBy 連結類型以及分類。 請參閱 在外掛程式檔案中定義工作群組和工作的相依性。

問：如何重新命名工作項目類型？

**答：**使用 witadmin renamewitd 命令變更名稱，然後更新分類定義檔。 若要進一步了解，請參閱修改或加入自訂工作項目類型 (WIT)。

問：如果我想要使用多個層級的 Portfolio 待處理項目 (Backlog)，該如何處理？

**答：**您最多可以加入五個 Portfolio 待處理項目。 其中包括功能的預設待處理項目。 您可以將這個項目加入自訂流程範本，或是在您的 Team 專案更新之後加入。 若要開始使用，請參閱加入 Portfolio 待處理項目 (Backlog)。

問：哪裡可以進一步了解要修改的定義檔案？

**答：**如需詳細資訊，請參閱下列主題：

問：如果我有其他問題，可以在哪裡尋求解答？

**答：**您可以在這些論壇張貼問題或搜尋答案：Team Foundation Server - 工作項目追蹤或 Team Web Access。