共用方式為

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

  • 發行項

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

本主題內容

  • 解決配置功能精靈所報告的錯誤

    • 藉由修改流程範本解決這項錯誤。

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

    • 問題和解決方式

  • 解決配置功能精靈報告的警告

    • 解決了加入動作陳述式的警告加入至工作項目

    • 將腳本連結控制項

注意事項注意事項

如果您遇到問題，當執行下列程序時，您可能會在論壇中方案的 Team Foundation Server (TFS)]，在 Microsoft 網站上的下列網頁: 工作項目追蹤和 流程範本

必要的使用權限

  • 若要下載和上傳流程範本，您必須是 [Project Collection Administrators] 群組的成員。 如果已明確設定安全性權限，則您必須將 Team 專案集合的 [管理流程範本] 使用權限設定為 [允許]。

  • 若要執行 witadmin 命令列工具，您必須是群組的成員下列其中一個群組: [Team Foundation Administrators]、 [專案集合管理員] 或 [專案系統管理員] Team 專案中。

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

解決配置功能精靈所報告的錯誤

您可以解決錯誤透過修改流程範本可用於設定新功能，或是修改您的 Team 專案。 在您修正錯誤，然後重新執行精靈。

Hh913787.collapse_all(zh-tw,VS.110).gif藉由修改流程範本解決這項錯誤。

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

  1. 下載 Team Foundation Server的流程範本。 請參閱 下載最新版流程範本。

  2. 修改工作項目類型、分類或管理組態的定義檔。 請參閱 自訂專案追蹤資料、表單、工作流程和其他物件。

  3. 上傳流程範本給Team Foundation Server 請參閱 管理流程範本。

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

Hh913787.collapse_all(zh-tw,VS.110).gif藉由修改 Team 專案或 Team 專案集合來解決錯誤。

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

您可以匯出的型別定義，對欄位定義的變更，然後匯入型別定義的需要。 請參閱 從現有專案匯出和匯入工作項目類型。

Hh913787.collapse_all(zh-tw,VS.110).gif問題和解決方式

若要解決在下表中列出的錯誤，請使用對應的矯正措施，對流程範本或 Team 專案，然後重新執行精靈。

錯誤

問題

流程範本解析度

Team 專案解析度

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

必要工作項目從 Team 專案遺漏的原因有因為它已重新命名，取消或未加入。 將指定的工作項目類型定義、重新命名或從流程範本中的最新版本的遺漏工作項目隨 TFS 升級。

將指定的分類定義的工作項目類型指定現有的工作項目。

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

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

必要分類中選取更新 Team 專案的流程範本的分類定義檔的錯誤訊息。 加入遺漏的分類。

加入遺漏的類別加入至流程範本。 請參閱 工作項目類型 Categories 項目參考。

使用 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:SyncNameChanges欄位" {0} " 0"的工作項目類型" {1}" 1」衝突 SyncNameChanges 現有欄位。。

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

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

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

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

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

下載流程範本，開啟型別定義，找出 FIELD 任務，然後修改它符合該定義的集合。 之後,上傳流程範本

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

工作項目類型'{1}'中欄位'{0}'的參考名稱已經由某連結類型使用中

每個參考名稱指派至欄位，並連結類型必須是唯一的名稱在 Team 專案集合中。

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

提示提示
若要判斷連結類型是否為使用中，請建立直接連結查詢，以使用該連結類型，以及另一個工作項目連結的所有工作項目類型來篩選。

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

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

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

下載流程範本，修改類別檔將類別重新命名為，然後將流程範本上載。 請參閱 工作項目類型 Categories 項目參考。

使用 witadmin exportcategories，匯出類別檔中，修改易記名稱指派給類別'{1} '，並匯入檔案。 請參閱 自訂工作項目類型的分類 [witadmin]。

TF400654: 無法設定計劃工具。

在 CommonConfiguration 檔案中定義的對應指定不存在於針對 Team 專案定義的工作項目類型的欄位或陳述式。

下載流程範本，修改 CommonConfiguration 檔案更正對應，然後上載流程範本。 請參閱 自訂流程設定

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

若要了解詳細資訊，請參閱下列主題:

解決配置功能精靈報告的警告

若要解決在下表中列出的警告，請執行下列步驟解析，然後重新執行精靈。

警告

問題

解決方式

TF400609:無法將動作 '{0}' 加入工作項目類型 '{1}'，因為狀態'{2}'不存在。

必要的 STATE 遺失。

請參閱 剖析加入動作陳述式的錯誤加入工作項目。

TF400610:無法將動作'{0}'加入工作項目類型 '{1}' ，因為從狀態'{2}'到'{3}'的轉換不存在

必要 TRANSITION 陳述式遺漏。

請參閱 剖析加入動作陳述式的錯誤加入工作項目。

分鏡腳本:無法在分類'{1}'的工作項目類型'{2}'中插入索引標籤。

TabGroup 項目沒有出現在型別定義。

請參閱 將腳本連結控制項 。

Hh913787.collapse_all(zh-tw,VS.110).gif解決了加入動作陳述式的警告加入至工作項目

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

若要解除這項警告，請檢視所表示的工作項目類型的工作流程。 如有需要，請修改工作流程符合在升級的 TFS 安裝的流程範本以最新版的定義與的來建立 Team 專案的工作流程狀態和轉換。 然後，請重新執行精靈。 如需以 Agile 流程範本建立 Team 專案，請參閱 更新 Agile Team 專案的工作流程。

若要了解詳細資訊，請參閱下列主題:

Hh913787.collapse_all(zh-tw,VS.110).gif將腳本連結控制索引標籤

將 分鏡腳本，您可以使用腳本現在連結工作項目。 若要這麼做，您將 [分鏡腳本] 連結控制索引標籤加入至工作項目類型的定義。 如果配置功能精靈沒有或不可以將這個選項，則您可以手動加入。 在升級的 TFS 安裝的流程範本中的最新版本， Storyboard 連結控制索引標籤會出現在任何待處理項目的工作項目類型，例如產品待處理項目、使用者劇本和需求。

注意事項注意事項

如果 TabGroup 項目從工作項目 FORM 部分，遺漏配置功能精靈無法加入 [分鏡腳本] 連結控制索引標籤。下列程序將 [分鏡腳本] 索引標籤。如果您想要將標準集的待處理項目的工作項目表單的索引標籤，您的 Team 專案中的文件流程範本的最新版本的型別定義。請參閱 下載最新版流程範本。

  1. 若要執行 witadmin 命令列工具，請在安裝 Visual Studio 或 Team Explorer 的系統中開啟命令提示字元視窗，並輸入：

    cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

    在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%。

  2. 由用來取代您的資料匯出待處理項目的類型定義檔為引數的顯示:

    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.

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

  4. 加入這段程式碼片段</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>

  5. 儲存並關閉檔案。

  6. 透過輸入命令匯入類型定義檔，以您的資料並將顯示的引數:

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

  7. 確認索引標籤上的待處理項目的外觀。 請參閱 驗證中新功能的存取。。

請參閱

概念

更新已升級的 Team 專案以使用新功能