管理 Team Foundation Server 和 Project Server 之整合的欄位對應
您可以自訂如何將修改欄位對應檔同步處理 Visual Studio Team Foundation Server 2012 與 Microsoft Project Server 之間的資料。這個檔案會定義同步處理的資料欄位以及這些欄位支援 Team Foundation Server 與 Project Server 整合的同步方式。您可以使用 TfsAdmin ProjectServer 命令列工具的下列選項，管理這個檔案：
/DownloadFieldMappings：下載對 Team 專案集合所定義的欄位對應檔。
/UploadFieldMappings：驗證欄位對應檔的 XML 語法，並將它上載至集合。若要驗證語法，但不上載檔案，您可以使用 /validateonly 選項。
.gif "注意事項") 注意事項 |
|---|
用於整合 Team Foundation Server 和 Project Server 的欄位對應檔不同於 Microsoft Project 的欄位對應檔。如需如何下載或上傳第二個檔案的詳細資訊，請參閱 上傳或下載 Microsoft Project 對應檔 [TFSFieldMapping]。 |
如需欄位對應檔內容及其自訂方式的詳細資訊，請參閱Team Foundation Server 和 Project Server 之整合的欄位對應 XML 項目參考和自訂 Project Server 與 Team Foundation Server 之間的欄位對應。
若要使用 TfsAdmin ProjectServer 命令列工具，請開啟 Visual Studio 或 Team Explorer 安裝的命令提示字元] 視窗並輸入:
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%。
必要的使用權限
若要使用這些命令，Team 專案集合的 [管理 Project Server 整合] 使用權限必須設定為 [允許]。而且必須授與 Team Foundation Server 的服務帳戶必要的權限，以便與將參與資料同步處理的 Project Web Access 或 Project Web App (PWA) 執行個體進行互動。如需詳細資訊，請參閱指派權限以支援 Project Server 和 Team Foundation Server 的整合。
| 注意事項 |
|---|
即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟較高權限的 [命令提示字元] 視窗，請選取 [開始]，開啟 [命令提示字元]捷徑功能表，然後選取 [以系統管理員身分執行。]。如需詳細資訊，請參閱下列 Microsoft 網站的網頁：使用者存取控制。 |
語法
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 定義檔的路徑和檔案名稱。 注意事項
如果您使用的是 Windows Vista，則可能沒有存取特定資料夾的使用權限。如果嘗試將工作項目類型匯出至您沒有權限的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。若要避免此重新導向，您可以將此檔案匯出至您已擁有權限的位置。如需詳細資訊，請參閱 Microsoft 網站的下列頁面：登錄虛擬化 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。
|
/encoding:encoding |
指定 .NET Framework 2.0 的編碼格式的名稱。此命令會以您所指定的編碼格式匯出或匯入 XML 資料。例如，/e:utf-7 會指定 Unicode (UTF-7) 編碼方式。如果您未指定此參數，命令就會嘗試偵測編碼方式，如果偵測失敗，會使用 UTF-8。 |
/validateOnly |
驗證對應檔案，但是不上載它。 |
/useDefaultFieldMappings |
上載預設欄位對應，而不是自訂對應檔。如需詳細資訊，請參閱Team Foundation Server 和 Project Server 之整合的欄位對應 XML 項目參考。 |
/force |
覆寫現有的對應檔。您必須指定這個選項，如果您指定 /useDefaultFieldMappings 參數，以不同的對應時取代現有的對應。 |
回到頁首
備註
您只能將企業自訂欄位或內建欄位對應到 Project Server。在 Project 中，您必須指定有效的欄位名稱。若要決定內建欄位的名稱，移除易記名稱中的任何空格，並在結果加上前置詞 pj。例如，狀態管理員的欄位名稱是 pjStatusManager，而 Custom 01 的欄位名稱是 pjCustom01。在如何對應內建及自訂欄位上會有限制，而且您也必須讓欄位的資料型別相符。如需詳細資訊，請參閱對應 Project Server 欄位以與 Team Foundation Server 整合的限制。
執行 TFSAdmin ProjectServer 命令時會顯示訊息，指出正在執行的動作和受影響的物件。例如，下列訊息顯示正在下載欄位對應檔：
Download field mappings from DefaultCollection
命令動作都完成之後，就會出現另一個訊息。例如，欄位對應檔已下載時，就會出現下列訊息：
You have downloaded field mappings to C:MappingFile. . . Done.
.gif "Gg412643.collapse_all(zh-tw,VS.110).gif")
上載欄位對應的相關注意事項
如果上載成功欄位對應檔，請做下列變更：
Team Foundation 中的每個鏡像欄位是設定為符合對應的欄位。
對於集合或 Team 專案的已對應工作項目類型而言，新對應會顯示在工作項目表單的 [Project Server] 索引標籤上。
.gif "重要事項") 重要事項 |
|---|
當您將某個欄位從 Team Foundation Server 對應至 Project Server 時，請務必比對這些欄位的資料型別。否則，當您嘗試上載欄位對應時，可能會顯示下列錯誤： 索引 (以零起始) 必須大於或等於零，並且小於引數清單的大小。 如需詳細資訊，請參閱Data Types and Field Mapping Criteria。 |
回到頁首
範例
下載對 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"
回到頁首
請參閱
工作
設定 Team Foundation Server 和 Project Server 的整合
概念
Team Foundation Server 和 Project Server 之整合的欄位對應 XML 項目參考
對應 Project Server 欄位以與 Team Foundation Server 整合的限制
使用 TfsAdmin ProjectServer 管理 Project Server 整合