共用方式為

上傳或下載 Microsoft Project 對應檔 [TFSFieldMapping]

  • 發行項

使用 TFSFieldMapping 上傳和下載 Microsoft Project 對應檔案。 此檔案控制 Microsoft Project 如何將工作發行至 Visual Studio Team Foundation Server 2013 中所建立的指定 Team 專案。 例如，您可以修改檔案以支援您加入工作項目類型的欄位，或修改現有欄位的發行和重新整理方式。

您可以指定將 Team Foundation 中的哪些欄位對應至 Microsoft Project 欄位。 您也可以透過 PublishOnly 屬性控制發行行為，以及指定特殊欄位，如內容欄位。 如需對應檔案的完整 XML 語法，請參閱 自訂 Microsoft Project 欄位對應檔。 此檔案是用來建立 Team 專案之流程範本中所定義的相同檔案。 請參閱將 Microsoft Project 欄位對應至 Team Foundation 欄位

若要存取 TFSFieldMapping 命令列工具，請開啟已安裝 Project 和 Team Explorer 或 TFS 的命令提示字元視窗，並輸入：

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0
注意事項注意事項

即使您使用系統管理權限登入，還是必須開啟提升權限的命令提示字元，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟提升權限的命令提示字元，請選擇 [開始]，並開啟 [命令提示字元] 捷徑功能表，然後選擇 [以系統管理員身分執行]。如需詳細資訊，請參閱 Microsoft 網站。

必要的使用權限

您必須是 [Team Foundation Administrators] 或 [Project Administrators] 安全性群組的成員，才能使用 TFSFieldMapping 命令。 如需詳細資訊，請參閱Team Foundation Server 的權限參考。

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

參數

引數

描述

upload | download

指定要下載還是上傳欄位對應檔案。

/collection:CollectionURL

指定下列格式的 Team 專案集合 URI：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果您未指定虛擬目錄，則必須使用下列格式：

http://ServerName:Port/CollectionName

如果您先前已連接到伺服器，您可以指定伺服器的易記名稱，而非 URI。

/teamproject:ProjectName

指定要修改其對應參數之 Team 專案的名稱。 如果名稱中包含空格，請使用引號括住該名稱。

/mappingfile:MappingFile

指定對應檔案的名稱和檔案路徑。

若要變更工作項目欄位對應至 Project 的方式

  1. 開啟已安裝 Project 和 Team Explorer 或 TFS 的命令提示字元視窗，並輸入：

    cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

    提示

    Project 不需要下載對應檔案，不過需要上傳對應檔案。

  2. 輸入下列命令，即可下載對應檔案：

    TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

    提示

    如果名稱中包含空格，請使用引號括住該名稱。

  3. 在文字編輯器或 XML 編輯器中開啟對應檔案。

  4. 加入新的對應，或編輯下列格式的現有對應：

    <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
   ProjectField=""
   ProjectName=""
   ProjectUnits=""
   PublishOnly=""
   IfSummaryRefreshOnly=""/>

    例如，若要將其他排程欄位加入使用 Scrum 流程範本所建立的 Team 專案，請加入下列對應：

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />

    預設 Scrum 範本只會將 [剩餘工作] 欄位對應至 Project。

    注意事項注意事項

    如需 ProjectField 屬性之所有 Office Project 欄位值的完整清單，請參閱 Microsoft Project 中的欄位對應。

  5. (選擇性) 指出是否發行欄位，而不重新整理欄位。 將 PublishOnly 屬性加入該欄位的對應區段，並將屬性設為 true。 此屬性可以用來允許小組成員在 Team Foundation 中看到欄位值，但無法將其變更。

  6. (選擇性) 指出如何在 Project 中重新整理摘要工作。 加入 fSummaryRefreshOnly="true" 屬性可指出欄位絕不會發行至工作項目資料庫，但是在下列情況會從工作項目資料庫重新整理：欄位的資料列是 Project 中的摘要工作、摘要工作具有 [發行並重新整理=是]，以及摘要工作包含至少一個發行至 TFS 的子工作。

  7. 儲存並上傳檔案：

    TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

請參閱

參考

Microsoft Project 中的欄位對應

概念

自訂 Microsoft Project 欄位對應檔