新增欄位和變更現有工作項目類型的配置

若要為工作項目追蹤其他資料，您可以加入欄位至工作項目類型，然後將其顯示在工作項目表單中，並讓它是可回報的。 您也可以變更工作項目表單的配置以求最能符合小組的需求。 在本主題中，茱莉亞和彼得是 Fabrikam Fiber小組的成員，他們自訂兩種不同類型的工作項目以支援他們的追蹤目標。

• 為了因應需求，追蹤要求新功能發生原因，茱莉亞加入有下拉式功能表的自訂欄位，並為產品待辦項目變更工作項目表單的配置。 茱莉執行五項工作以加入具有下拉式功能清單的自訂欄位和變更產品待辦項目的工作項目表單配置。

• 為了更有效地追蹤工作並改善他和小組預估工作的能力，彼得加入欄位至工作項目類型。

如下圖所示，茱莉亞和彼得在規定好的序列中分別執行他們的工作。

改變工作項目表單的配置。

將欄位加入至工作項目表單

在 Team Foundation Server的預設流程範本中，若要檢閱工作項目欄位或指派為可回報的欄位，請參閱 Visual Studio ALM 的工作項目欄位參考 和 Visual Studio ALM 的可報告欄位參考。

需求

• 您必須是 [Team Foundation Administrators] 群組的成員或專案之 [Project Administrators] 群組的成員，才能執行此程序。 如需詳細資訊，請參閱Team Foundation Server 使用權限。

注意事項
如果您是執行 Windows Vista，則您可能未設定為具有特定資料夾的權限。如果嘗試將工作項目類型匯出至您沒有設定權限的位置，登錄模擬技術便會自動重新導向已匯出的檔案，並將該檔案儲存在虛擬存放區中。若要避免此重新導向，您可以將此檔案匯出至您已設定權限的位置。如需虛擬登錄的詳細資訊，請參閱下列 Microsoft 網站的頁面：虛擬登錄 和 Windows Vista 中常見的檔案及虛擬登錄問題。

1.匯出工作項目類型定義

當您從小組專案下載類型定義，可確保您使用最新的版本。

注意事項
如果您需要小地方的變更而又不排斥使用 XML 格式的話，您可以使用 Notepad 或其他文字編輯器來修改檔案。或者，您也可以使用 [流程編輯器]，他是一個強大的工具並像增益集般安裝在Visual Studio上。使用這個工具，就不需要匯入或匯出類型定義。相反地，您可以使用流程編輯器開啟它們，也可以使用編輯器介面修改。 您可以從 Microsoft 網站上的下列網頁下載這個強大的工具：Team Foundation Server Power Tools。 如需如何下載流程範本之結構描述檔案的詳細資訊，請參閱流程範本外掛程式的 XML 項目定義索引。

若要從現有的 Team 專案匯出工作項目類型定義檔

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

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

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

2. 請輸入下列命令，由此處顯示的引數代替您的資料，其中 集合URL 指定小組專案集合的 URL， 專案名稱 指定集合內定義的小組專案的名稱，工作項目類型名稱指定匯出的工作項目名稱，檔案名稱指定要匯出的檔案之名稱和位置。 選取 Enter 鍵。

   witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
   

   範例：匯出產品待辦項目的定義

   例如，茱莉亞使用下列命令以匯出其 FabrikamFiber小組專案待辦項目的類型定義至 FF_ProductBItem.xml。

   witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml
   

   範例：匯出工作定義

   而彼得使用下列命令以匯出工作的類型定義並將其儲存到標記為FF_Task.xml的檔案。

   witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml
   

   順利完成時會顯示下列訊息：

   作業完成。

2.將欄位加入至類型定義

若要將欄位加入至型別定義，您必須在FIELDS 區段中加入FIELD 項目以及在FORM區段中加入 Control 項目。 此外，我們建議您遵守為該欄位訂定的命名規則。

若要將欄位加入至工作項目類型

1. 指定定義類別欄位的XML檔案區段的位置，然後使用FIELDS啟動。

2. 加入指定自訂欄位名稱的 FIELD 項目。 您必須指定下列必要的屬性：易記的 name、refname (參考名稱) 和 type。 如需詳細資訊，請參閱FIELD (定義) 項目。

   注意事項
   參考名稱 (或 refname) 為此欄位的程式設計名稱，所有其他規則都應該要參考這個 refname。如需詳細資訊，請參閱工作項目追蹤物件的命名慣例。

   範例：加入具有功能表清單的自訂欄位

   例如，茱莉亞輸入下列文字以加入[要求者]自訂欄位至產品待辦項目的類型定義，該欄位包含有 FabrikamFiber.MyTeam.Requestor 的參考名稱。 她也為欄位指定允許值的挑選清單以及清單中客戶的預設值。

   <FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
      <ALLOWEDVALUES>
         <LISTITEM value="Customer" />
         <LISTITEM value="Executive Management" />
         <LISTITEM value="Other" />
         <LISTITEM value="Support" />
         <LISTITEM value="Team" />
         <LISTITEM value="Technicians" />
         <DEFAULTVALUE value="Customer" />
       </ALLOWEDVALUES>
   </FIELD>
   

   如需挑選清單的詳細資訊，請參閱定義挑選清單。

   範例：增加預先定義的欄位。

   對於工作的型別定義，彼得增加預先定義的欄位[已完成的工作]，其包括 Microsoft.VSTS.Scheduling.CompletedWork 的參考名稱。

   <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />
   

   關於所有預先定義欄位的清單，請參閱Visual Studio ALM 的工作項目欄位參考。

3. 將 FORM區段內的CONTROL 項目加入，如此自訂欄位會出現在群組項目中的工作項目表單，會是你想要它顯示的地方。 您必須指定控制項的 type 屬性。 如需詳細資訊，請參閱Control XML 項目參考。

   範例：將自訂欄位加入至產品待辦項目的表單

   範例：加入欄位控制項。

   例如，如下列程式碼範例所示，茱莉亞加入要求者欄位的 Control 項目以顯示在工作項目表單的 [原因] 欄位下方。

   <Column PercentWidth="50">
      <Group Label="Status">
         <Column PercentWidth="100">
            <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
            <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
            <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
            <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
         </Column>
      </Group>
   </Column>
   

   提示

   工作項目追蹤的結構描述定義會以駝峰式大小寫定義所有 FORM項目的子項目，並以大寫定義其他所有的項目。如果在驗證型別定義檔時發生錯誤，請檢查項目的大小寫結構。此外，開頭和結尾標記的大小寫結構也必須符合 XML 語法的規則。

   下圖顯示，現在產品待辦項目的工作項目表單包含新的欄位。

   

   範例：加入預先定義的欄位到工作表單。

   如下列程式碼範例所示，針對工作項目類型，彼得將Control 欄位加入在[剩餘工作] 欄位上方：

   <Column PercentWidth="50">
      <Group Label="Details">
         <Column PercentWidth="100">
            <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed Work:" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Type="FieldControl" Label="Remaining Work:" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.BacklogPriority" Type="FieldControl" Label="Backlog Priority:" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.Activity" Type="FieldControl" Label="Activity:" LabelPosition="Left" />
            <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area:" LabelPosition="Left" />
         </Column>
      </Group>
   </Column>
   

   下圖顯示，現在工作的工作項目表單包含[已完成工作] 欄位。

   

4. 將您的變更儲存到 XML 檔案。

進一步了解如何將工作項目欄位加入至類型定義

• 加入和修改工作項目欄位以支援報告

• FIELD Element (Work Item Methodology Schema)

• Control XML 項目參考

• 工作項目類型的 XML 項目定義索引

3.將索引標籤群組的表單配置從兩個資料行變更至單行。

茱莉亞想要變更產品待辦項目的表單配置，以便描述欄位橫跨表單的寬度。 如下圖所示，預設配置會顯示兩組索引標籤群組。 若要變更配置給一組索引標籤群組， Jill需要變更第一個資料行項目為百分之百的寬度，並從 FORM區段移除多餘的 Column 和 TabGroup 項目。

將表單配置的兩個資料行索引標籤群組變更至單一索引標籤群組

1. 尋找 XML 檔的 TabGroup 區段。 請注意到項目的 Tab元件(例如 [說明]、 [工作]、驗收準則和每個 Tab 元件包含會給予個別控制項的 Control 之 [歷程記錄] 。

   <Group>
      <Column PercentWidth="50">
         <TabGroup>
         . . .
         </TabGroup>
      </Column>
      <Column PercentWidth="50">
         <TabGroup>
         . . .
         </TabGroup>
      </Column>
   </Group>
   

2. 保護所有在TabGroup之下的 <Tab> . . . </Tab> 項目。 移除 Group、 Column和多餘的 TabGroup 項目。 下列程式碼範例示範新的XML語法結構。

   <Group>
      <Column PercentWidth="100">
         <TabGroup>
         . . .
         </TabGroup>
      </Column>
   </Group>
   

   注意事項
   為了得到最佳結果，即使資料行橫跨表單的整個寬度，每個控制項或群組還是應該會顯示在資料行中。因此，即使群組沒有可見的標籤或界限，每個資料行也都應該會顯示在群組中。如需詳細資訊，請參閱設計和自訂工作項目表單。

   下圖顯示單行索引標籤群組。

   

3. 將變更儲存到 XML 檔案。

4.匯入工作項目類型定義

在您自訂型別定義之後，您必須匯入至小組專案以驗證您的變更並讓其可以使用。 您匯入的 XML 檔案會覆寫掉目前類型定義的內容。 匯入程序在上載之前驗證 XML 語法。

若要將工作項目類型匯入至現有的 Team 專案

• 根據本主題之前說明的，從步驟一 : 1. 匯出工作項目類型定義 指定的命令提示字元視窗和資料夾，輸入下列命令，然後選取 [輸入]鍵。

  witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
  

  範例：匯入產品待辦項目的定義

  例如，吉兒使用下列命令以匯入待辦項目的類型定義至 FabrikamFiber小組專案，該待辦項目的類型定義是她之前匯出至FF_ProductBItem.xml的類型定義。

  witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml
  

  範例：匯入工作定義

  而彼得使用下列命令匯入儲存到 FF_Task.xml 的工作類型定義。

  witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml
  

  順利完成時會顯示下列訊息：

  工作項目類型匯入已完成。

5.重新整理小組專案並確認類型定義的變更

在匯入類型定義之後，則必須重新整理小組總管中的快取讓變更是可使用的。 當您匯入類型定義時開啟 Visual Studio 並連接至 Team Foundation Server ，您才必須重新整理快取。

重新整理小組總管並建立產品待辦項目

重新整理快取。

1. 在Team Explorer中， 選擇 重新整理按鈕。

   會從伺服器下載最新的更新 (包括您剛剛匯入的變更)。

   等候幾秒直至重新整理完成。

2. 選取 [工作項目]。

3. 選取 [新增工作項目]，然後選取您要修改的工作項目類型，例如 [產品待辦項目] 或 [工作]。

4. 確認您所做的變更出現在工作項目表單中。

5. 選取 [關閉] 按鈕關閉新的工作項目。 當您收到儲存工作項目的提示時，選擇 [否]。