管理 Team Foundation Server 和 Project Server 之整合的欄位對應

發行項
08/12/2011

您可以修改欄位對應檔，自訂 Visual Studio Team Foundation Server 2010 與 Project Server 之間的資料同步方式。這個檔案會定義同步處理的資料欄位以及這些欄位支援 Team Foundation Server 與 Project Server 整合的同步方式。您可以使用 TFSAdmin ProjectServer 命令列工具的下列選項，管理這個檔案：

/DownloadFieldMappings：下載對 Team 專案集合所定義的欄位對應檔。
/UploadFieldMappings：驗證欄位對應檔的 XML 語法，並將它上載至集合。若要驗證語法，但不上載檔案，您可以使用 /validateonly 選項。

注意事項
用於整合 Team Foundation Server 和 Project Server 的欄位對應檔不同於 Microsoft Project 的欄位對應檔。如需如何下載或上傳第二個檔案的詳細資訊，請參閱 TFSFieldMapping。

如需欄位對應檔內容及其自訂方式的詳細資訊，請參閱Team Foundation Server 和 Project Server 之整合的欄位對應 XML 項目參考和自訂 Project Server 與 Team Foundation Server 之間的欄位對應。

若要使用 TFSAdmin ProjectServer 命令列工具，請在執行 Team 總管和 Visual Studio Team Foundation Server 2010 Service Pack 1 的電腦上開啟 [命令提示字元] 視窗。從下列目錄執行此工具：磁碟機:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。若是 64 位元電腦，此工具位於 Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE。

必要的使用權限

若要使用這些命令，Team 專案集合的 [管理 Project Server 整合] 使用權限必須設定為 [允許]。而且必須授與 Team Foundation Server 的服務帳戶必要的權限，以便與將參與資料同步處理的 Project Web Access 或 Project Web App (PWA) 執行個體進行互動。如需詳細資訊，請參閱指派權限以支援 Project Server 和 Team Foundation Server 的整合。

注意事項
即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟更高權限的 [命令提示字元] 視窗，請按一下 [開始]，並以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。如需詳細資訊，請參閱下列 Microsoft 網站的網頁：使用者存取控制。

即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 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	覆寫現有的對應檔。如果您要以不同的對應取代現有的對應，就必須指定此選項。

回到頁首

備註

您只能將企業自訂欄位或內建欄位對應到 Project Server。在 Project 中，您必須指定有效的欄位名稱。若要決定內建欄位的名稱，移除易記名稱中的任何空格，並在結果加上前置詞 pj。例如，狀態管理員的欄位名稱是 pjStatusManager，而 Custom 01 的欄位名稱是 pjCustom01。在如何對應內建及自訂欄位上會有限制，而且您也必須讓欄位的資料型別相符。如需詳細資訊，請參閱對應 Project Server 欄位以與 Team Foundation Server 整合的限制。

執行 TFSAdmin ProjectServer 命令時會顯示訊息，指出正在執行的動作和受影響的物件。例如，下列訊息顯示正在下載欄位對應檔：

Download field mappings from Collection0

命令動作都完成之後，就會出現另一個訊息。例如，欄位對應檔已下載時，就會出現下列訊息：

You have downloaded field mappings to C:MappingFile. . . Done.

上載欄位對應的相關注意事項

當您執行 /UploadFieldMappings 選項時，會發生下列動作：

如果沒有定義 Team 專案集合的欄位對應，也沒有指定 /useDefaultFieldMappings 選項，則會有訊息提示您建立預設欄位對應。
如果欄位對應存在，且您指定 /useDefaultFieldMappings 選項，則會出現訊息要您確認是否覆寫現有的對應。
如果您想要覆寫先前已上載至集合的欄位對應，您必須指定 /force 選項。
在上載欄位對應檔之前會對它進行驗證。如果有語法錯誤或指定無效的欄位，就會出現錯誤訊息。

如果上載成功欄位對應檔，請做下列變更：

Team Foundation 中的每個鏡像欄位是設定為符合對應的欄位。
對於集合或 Team 專案的已對應工作項目類型而言，新對應會顯示在工作項目表單的 [Project Server] 索引標籤上。

重要事項
當您將某個欄位從 Team Foundation Server 對應至 Project Server 時，請務必比對這些欄位的資料型別。否則，當您嘗試上載欄位對應時，可能會顯示下列錯誤：索引 (以零起始) 必須大於或等於零，並且小於引數清單的大小。如需詳細資訊，請參閱資料型別和欄位對應準則。

當您將某個欄位從 Team Foundation Server 對應至 Project Server 時，請務必比對這些欄位的資料型別。否則，當您嘗試上載欄位對應時，可能會顯示下列錯誤：

索引 (以零起始) 必須大於或等於零，並且小於引數清單的大小。

如需詳細資訊，請參閱資料型別和欄位對應準則。

回到頁首

範例

下載對 Team 專案集合所定義的欄位對應檔。

下列的範例會將針對 AWMappingFile.xml 所定義的欄位對應下載到 AdventureWorksCollection。

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

上載 Team 專案集合的欄位對應檔

下列範例會將 AWMappingFile.xml 上載至 AdventureWorksCollection，並覆寫先前定義的任何欄位對應。

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" /force

回到頁首