解決設定功能時收到的錯誤

發行項
06/09/2015

您也許可以解決設定功能精靈所顯示的錯誤和警告。因為 Team 專案中的定義與上傳至 Team 專案集合之流程範本的定義相衝突，因此會發生這些問題。您應該變更流程範本以解決錯誤，並重新執行精靈。或者，您可以變更 Team 專案，然後重新執行精靈。

本主題內容

解決 [設定功能] 精靈所報告的錯誤
- 藉由修改流程範本解決錯誤
- 藉由修改 Team 專案或 Team 專案集合來解決錯誤
- 問題和解決
解決 [設定功能] 精靈所報告的警告
- 解決有關將 ACTION 陳述式加入工作項目類型的警告
- 加入分鏡腳本連結控制

注意事項
執行下列程序時若發生問題，可以在位於 Microsoft 網站之下列網頁上的 Team Foundation Server (TFS) 論壇中尋找方案：工作項目追蹤和流程範本。

必要的權限

若要下載和上傳流程範本，您必須是 [Project Collection Administrators] 群組的成員。如果已明確設定安全性權限，您必須將 Team 專案集合的 [管理流程範本] 權限設為 [允許]。
若要執行 witadmin 命令列工具，對於 Team 專案，您必須是下列其中一個群組的成員：[Team Foundation Administrators]、[Project Collection Administrators] 或 [Project Administrators]。

如需詳細資訊，請參閱Team Foundation Server 的權限參考。

解決 [設定功能] 精靈所報告的錯誤

您可以藉由以下方法解決錯誤：修改用於設定新功能的流程範本，或修改 Team 專案。更正錯誤之後，重新執行精靈。

藉由修改流程範本解決錯誤

您可以執行下列步驟來修改流程範本：

下載 Team Foundation Server 的流程範本。請參閱下載最新版流程範本。
修改工作項目類型、分類或流程組態的定義檔。請參閱自訂工作追蹤物件以支援小組的流程
上傳流程範本至Team Foundation Server。請參閱上傳、下載及刪除 Team 專案集合的流程範本。

請參閱更新自訂流程範本以使用新功能。

藉由修改 Team 專案或 Team 專案集合來解決錯誤

若要解決錯誤或警告，您可以使用 witadmin 命令，選擇修改 Team 專案或 Team 專案集合。請參閱 witAdmin：自訂及管理追蹤工作的物件。

您可以匯出類型定義，對欄位定義進行變更，然後視需要匯入類型定義。請參閱匯入、匯出和管理工作項目類型 [witadmin]。

問題和解決

若要解決下表所列的錯誤，請針對流程範本或 Team 專案採用對應的更正措施，然後重新執行精靈。

TF400613：分類 '{0}' 中指定的工作項目類型 '{1}' 不存在。

您的 Team 專案因已重新命名、已移除或者未加入，而遺漏必要的工作項目類型。重新命名指定的工作項目類型定義，或是從隨 TFS 升級安裝的最新版流程範本匯入遺漏工作項目類型。

變更指定之分類定義的工作項目類型，以指定現有的工作項目類型。

若要重新命名工作項目類型，請使用 witadmin renamewitd。若要加入遺漏的工作項目類型，請在最新的流程範本中找到該類型，然後使用 witadmin importwitd 將它匯入。請參閱匯入、匯出和管理工作項目類型 [witadmin]。

TF400614：分類 '{0}' 不存在。

選取並用來更新 Team 專案之流程範本中的分類定義檔，遺漏了必要的分類。加入遺漏的分類。

將遺漏的分類加入流程範本。請參閱使用分類以分組工作項目類型。

使用 witadmin importcategories，將遺漏的分類加入 Team 專案。請參閱匯入和匯出分類 [witadmin]

TF400617：工作項目類型 '{1}' 中的欄位類型 '{0}'，與現有欄位的類型衝突。

在要加入之工作項目類型中定義的欄位資料型別，與 Team 專案集合中所定義的資料型別不符。更正工作項目類型定義的指派，然後重新執行精靈。

注意事項
升級 Visual Studio Team Foundation Server 2012 會將 [描述] 欄位 (System.Description) 從純文字的欄位類型變更為 HTML，才能支援影像和超連結的文字格式和插入。在最新版 Team Foundation Server 中，您可以在 PlainText 和 HTML 資料型別之間切換。

下載流程範本、開啟類型定義、找出 FIELD 指派、修改 type 屬性以符合為集合定義的指派，然後上傳流程範本。請參閱FIELD (定義) 項目參考。

提示

若要決定指派給欄位的類型，請執行 witadmin listsfields。

使用 witadmin changefield 並指定 type 屬性。請參閱管理工作項目欄位 [witadmin]。

注意事項
只有當類型為 PlainText 或 HTML時，您可以變更 Team 專案集合的類型定義。

TF400618：工作項目類型 '{1}' 中的報告類型欄位 '{0}'，與現有欄位的報告類型衝突。

在工作項目類型定義中指派給欄位的報告屬性，與 Team 專案集合中定義的屬性不符。

下載流程範本、開啟類型定義、找出 FIELD 指派，並修改 reportable 屬性，以符合集合定義的指派。然後，上傳流程範本。請參閱FIELD (定義) 項目參考。

使用 witadmin changefield 並指定 reportingtype 屬性。請參閱管理工作項目欄位 [witadmin]。

TF400619：工作項目類型 '{1}' 中欄位 '{0}' 的 SyncNameChanges ，與現有欄位的 SyncNameChanges衝突。

工作項目類型定義中指派給欄位的 syncnamechanges 屬性，與在 Team 專案集合中定義的屬性不符。這個屬性指定人員名稱在 Active Directory 中變更時，是否應更新其欄位。

下載流程範本、開啟類型定義、找出 FIELD 指派、加以修改以符合集合中的定義，然後上傳流程範本。請參閱 FIELD (定義) 項目參考。

使用 witadmin changefield 命令，並指定 /syncnamechanges 參數。請參閱管理工作項目欄位 [witadmin]。

TF400620：工作項目類型 '{1}' 中欄位 '{0}' 的易記名稱，與現有欄位的易記名稱衝突。

工作項目類型定義中指派給欄位的易記名稱，必須符合在 Team 專案集合中定義的名稱。

下載流程範本、開啟類型定義、找出 FIELD 指派，並加以修改以符合為集合定義的指派。然後，上傳流程範本。

若要變更 Team 專案集合的易記名稱，請使用 witadmin changefield 命令，並指定 /name 參數。請參閱管理工作項目欄位 [witadmin]。

TF400621：工作項目類型 '{1}' 中欄位 '{0}' 的參考名稱，正由連結類型使用中。

指派給欄位和連結類型的每個參考名稱，都必須是 Team 專案集合內的唯一名稱。

如果連結類型為作用中和使用中的連結工作項目，請下載流程範本、開啟類型定義、找出 FIELD 指派，並修改 refname 指派，以符合為集合定義的指派。然後，上傳流程範本。

提示

若要決定連結類型是否在使用中，請建立直接連結查詢，然後篩選出使用該連結類型連結至另一個工作項目的所有工作項目。

如果連結類型在 Team 專案集合中既不是作用中，也不是使用中的連結工作項目，請將其刪除。您可以使用 witadmin deletelinktype 刪除連結類型。請參閱管理連結類型 [witadmin]。

TF400624：分類 '{0}' 的易記名稱與分類 '{1}' 衝突。

您必須為 Team 專案的每一個分類指派一個唯一的參考名稱和易記名稱。您可以將流程範本或 Team 專案中現有的分類'{1}' 重新命名，以解決這個錯誤。

下載流程範本、修改分類檔將分類重新命名，然後上傳流程範本。請參閱使用分類以分組工作項目類型。

使用 witadmin exportcategories 匯出分類檔、修改指派給分類 '{1}' 的易記名稱，然後匯入檔案。請參閱匯入和匯出分類 [witadmin]。

TF400654：無法設定計劃工具。

在 CommonConfiguration 檔案中定義的對應，會指定不存在於為 Team 專案定義之工作項目類型中的欄位或狀態。

下載流程範本、修改 CommonConfiguration 檔案以更正對應，然後上傳流程範本。請參閱自訂流程組態

使用 witadmin exportwitd 匯出工作項目類型、加入遺漏的欄位或狀態，然後匯入工作項目類型。請參閱匯入、匯出和管理工作項目類型 [witadmin]。

如需詳細資訊，請參閱下列主題:

解決 [設定功能] 精靈所報告的警告

若要解決下表所列的警告，請遵循下列解決步驟，然後重新執行精靈。

警告	問題	解決方式
TF400609：無法將動作 '{0}' 加入工作項目類型 '{1}'，因為狀態 '{2}' 不存在。	遺漏必要的 STATE。	請參閱解決將 ACTION 陳述式加入工作項目類型的錯誤。
TF400610：無法將動作 '{0}' 加入工作項目類型 '{1}'，因為從狀態 '{2}' 到 '{3}' 的轉換不存在。	遺漏必要的 TRANSITION 陳述式。	請參閱解決將 ACTION 陳述式加入工作項目類型的錯誤。
分鏡腳本：無法在分類 '{2}' 的工作項目類型 '{1}' 中插入索引標籤。	類型定義中沒有 TabGroup 項目。	請參閱加入分鏡腳本連結控制。

解決有關將 ACTION 陳述式加入工作項目類型的警告

為支援 [我的工作] 功能，[設定功能] 精靈會將兩個 ACTION 陳述式加入工作項目類型之定義的工作流程轉換部分。如果遺漏從新狀態移至作用中狀態，或從作用中狀態移至新狀態的狀態或轉換，您將會收到警告。

若要解除這項警告，請檢閱指定之工作項目類型的工作流程。視需要修改工作流程，以符合針對最新版流程範本定義的工作流程狀態和轉換，而這個流程範本是安裝在升級的 TFS 上，其符合用來建立 Team 專案的流程範本。然後，重新執行精靈。有關以 Agile 流程範本為基礎的 Team 專案，請參閱更新 Agile Team 專案的工作流程。

如需詳細資訊，請參閱下列主題:

加入分鏡腳本連結控制索引標籤

加入分鏡腳本後，現在您就可以將工作項目連結到分鏡腳本。若要這麼做，請將 [分鏡腳本] 連結控制索引標籤加入工作項目類型的定義。如果 [設定功能] 精靈沒有或無法加入索引標籤，您就可以將它以手動方式加入。在升級的 TFS 上安裝的最新版流程範本中，Storyboard連結控制索引標籤會出現在所有待處理項目 (Backlog) 的工作項目類型，例如產品待處理項目 (Backlog)、使用者劇本和需求。

注意事項
若工作項目 FORM 區段中遺漏 TabGroup 項目，[設定功能精靈] 將無法加入 [分鏡腳本] 連結控制索引標籤。下列程序只會加入 [分鏡腳本] 索引標籤。如果要加入您待處理項目 (Backlog) 工作項目類型的標準索引標籤集，請參閱 Team 專案最新版流程範本的類型定義。請參閱下載最新版流程範本。

若要執行 witadmin 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %%programfiles%。

以您的資料取代如下所示的引數，匯出待處理項目 (Backlog) 的類型定義檔：

witadmin exportwitd  /collection:CollectionURL /p:"ProjectName" /n:"TypeName" /f:"DirectoryPath\FileName.xml"
   
Where:
   CollectionURL specifies the URL of the team project collection
   ProjectName specifies the name of your team project defined within the collection
   TypeName specifies the name of your backlog item, for example User Story or Product Backlog Item.
   
Use the following format for CollectionURL:  http://ServerName:Port/VirtualDirectoryName/CollectionName
For example: http://srvalm:8080/tfs/DefaultCollection.

使用文字編輯器 (例如 [記事本]) 開啟檔案。

在您待處理項目 (Backlog) 類型的 </Layout> 結束標記之前加入這個程式碼片段：

<TabGroup>
<Tab Label="Storyboards"> 
   <Control Name="StoryboardsControl" Type="LinksControl"> 
      <LinksControlOptions> 
         <WorkItemLinkFilters FilterType="excludeAll" /> 
         <ExternalLinkFilters FilterType="include"> 
            <Filter LinkType="Storyboard" /> 
         </ExternalLinkFilters> 
         <LinkColumns> 
            <LinkColumn RefName="System.Title" /> 
            <LinkColumn LinkAttribute="System.Links.Comment" /> 
         </LinkColumns> 
      </LinksControlOptions> 
   </Control> 
</Tab> 
</TabGroup>

儲存並關閉檔案。

藉由輸入這個命令匯入類型定義檔，以您的資料取代顯示的引數：

witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"

確認索引標籤出現在待處理項目 (Backlog) 中。

請參閱

概念

在 TFS 升級後設定功能

共用方式為