管理 TFS 與 Project Server 整合的欄位對應
您可以修改欄位對應檔，自訂 Visual Studio Team Foundation Server (TFS) 與 Project Server 之間的資料同步方式。 這個檔案會定義同步處理的資料欄位以及這些欄位支援 TFS 與 Project Server 整合的同步方式。 您可以使用 TfsAdmin ProjectServer 命令列工具的下列選項，管理這個檔案：
/DownloadFieldMappings：下載對 Team 專案集合所定義的欄位對應檔。
/UploadFieldMappings：驗證欄位對應檔的 XML 語法，並將它上載至集合。 若要驗證語法，但不上載檔案，您可以使用 /validateonly 選項。
.gif "注意事項") 注意事項 |
|---|
用於整合 Team Foundation Server 和 Project Server 的欄位對應檔不同於 Microsoft Project 的欄位對應檔。如需如何下載或上傳第二個檔案的詳細資訊，請參閱 上傳或下載 Microsoft Project 對應檔 [TFSFieldMapping]。 |
如需欄位對應檔內容及其自訂方式的詳細資訊，請參閱TFS 與 Project Server 整合的欄位對應 XML 項目參考和自訂 TFS 與 Project Server 之間的欄位對應。
若要使用 TfsAdmin ProjectServer 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %programfiles%。
需求
若要使用這些命令，Team 專案集合的 [管理 Project Server 整合] 使用權限必須設定為 [允許]。 而且必須授與 Team Foundation Server 的服務帳戶必要的權限，以便與將參與資料同步處理的 Project Web Access 或 Project Web App (PWA) 執行個體進行互動。 如需詳細資訊，請參閱指派權限以支援 TFS 與 Project Server 整合。
語法
TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]
參數
參數 |
描述 |
||
|---|---|---|---|
/collection:tpcURL |
指定 Team 專案集合的統一資源定位器 (URL)。 您可以使用下列格式指定 URL： http://ServerName:Port/VirtualDirectoryName/CollectionName 如果您未指定虛擬目錄，則可以使用下列格式指定 URI： http://ServerName:Port/CollectionName |
||
/filePath:mappingFile |
指定包含欄位對應之 XML 定義檔的路徑和檔案名稱。
|
||
/encoding:encoding |
指定 .NET Framework 2.0 的編碼格式的名稱。 此命令會以您所指定的編碼格式匯出或匯入 XML 資料。 例如，/e:utf-7 會指定 Unicode (UTF-7) 編碼方式。 如果您未指定此參數，命令就會嘗試偵測編碼方式，如果偵測失敗，會使用 UTF-8。 |
||
/validateOnly |
驗證對應檔案，但是不上載它。 |
||
/useDefaultFieldMappings |
上載預設欄位對應，而不是自訂對應檔。 如需詳細資訊，請參閱TFS 與 Project Server 整合的欄位對應 XML 項目參考。 |
||
/force |
覆寫現有的對應檔。 您必須指定這個選項，如果您以不同的對應時取代現有的對應指定 /useDefaultFieldMappings 參數。 |
備註
您只能將企業自訂欄位或內建欄位對應到 Project Server。 在 Project 中，您必須指定有效的欄位名稱。 若要決定內建欄位的名稱，移除易記名稱中的任何空格，並在結果加上前置詞 pj。 例如，狀態管理員的欄位名稱是 pjStatusManager，而 Custom 01 的欄位名稱是 pjCustom01。 在如何對應內建及自訂欄位上會有限制，而且您也必須讓欄位的資料型別相符。 如需詳細資訊，請參閱在 TFS 與 Project Server 整合中對應 Project Server 欄位的限制。
執行 TFSAdmin ProjectServer 命令時會顯示訊息，指出正在執行的動作和受影響的物件。 例如，下列訊息顯示正在下載欄位對應檔：
Download field mappings from DefaultCollection
命令動作都完成之後，就會出現另一個訊息。 例如，欄位對應檔已下載時，就會出現下列訊息：
You have downloaded field mappings to C:MappingFile. . . Done.
上傳欄位對應的相關注意事項
如果上載成功欄位對應檔，請做下列變更：
Team Foundation 中的每個鏡像欄位是設定為符合對應的欄位。
對於集合或 Team 專案的已對應工作項目類型而言，新對應會顯示在工作項目表單的 [Project Server] 索引標籤上。
重要
當您將某個欄位從 Team Foundation Server 對應至 Project Server 時，請務必比對這些欄位的資料型別。否則，當您嘗試上載欄位對應時，可能會顯示下列錯誤：
索引 (以零起始) 必須大於或等於零，並且小於引數清單的大小。
如需詳細資訊，請參閱資料類型和欄位對應準則。
範例
下載對 Team 專案集合所定義的欄位對應檔。
下列的範例會將針對 AWMappingFile.xml 所定義的欄位對應下載到 AdventureWorksCollection。
TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
上傳 Team 專案集合的欄位對應檔
下列範例上傳 AWMappingFile.xml 至 AdventureWorksCollection。
TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
請參閱
工作
概念
TFS 與 Project Server 整合的欄位對應 XML 項目參考
在 TFS 與 Project Server 整合中對應 Project Server 欄位的限制
對應整合元件 [TfsAdmin ProjectServer]