自訂 Team 專案以支援小組欄位

發行項
06/10/2015

Team 專案的預設組態會設定每個小組做為區域路徑。如果您的組織有數個透過通用待處理項目和跨許多產品區域來工作的小組，這個組態可能不適合您想要組織工作的方式。藉由加入自訂欄位來表示組織的小組，您可以重新設定敏捷式軟體開發規劃工具和頁面來支援小組，並解除工作指派與小組及區域路徑的聯結。

當您自訂 Team 專案以支援小組欄位時，[小組欄位] 索引標籤會出現在 Team 專案和每個小組的管理頁面中。

為每個小組設定小組欄位

本主題說明如何重新設定以 TFS 所提供之 Scrum 流程範本為基礎的 Team 專案。如果 Team 專案是以另一個流程範本為基礎，而該範本與 TFS 2013 相容，則可以進行相同的變更。即使您已使用預設組態，仍然可以重新設定 Team 專案。

witadmin 命令列工具支援匯入和匯出定義檔。您也可以使用 Process Editor (可隨 TFS Power Tools 的下載一併取得) 或 TFS Team Project Manager (CodePlex 提供的社群資源專案)。

1.建立全域清單以管理小組

如果您不是 [Project Administrators] 群組的成員，請取得這些權限。
開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
```
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
```
在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%。您可以免費下載 Team Explorer。

匯出 Team 專案集合的全域清單。

witadmin exportgloballist /collection:"http://MyServer:8080/tfs/DefaultCollection" /f:Directory/globallist.xml"

加入小組的全域清單定義。包含要用於尚未指派給小組之項目的值。如果您的全域清單是空的，只需複製下列程式碼並在 XML 檔中貼上，然後修改以支援小組標籤。

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
   <GLOBALLIST name="Teams">
      <LISTITEM value="Unassigned"/>
      <LISTITEM value="Team A"/>
      <LISTITEM value="Team B"/>
      <LISTITEM value="Team C"/>
      <LISTITEM value="Team D"/>
   </GLOBALLIST>
</gl:GLOBALLISTS>

匯入全域清單定義。

witadmin importgloballist /collection:"http://MyServer:8080/tfs/DefaultCollection" /f:Directory/globallist.xml"

請注意，全域清單是針對 Team 專案集合中所有 Team 專案所定義。

2.將自訂小組欄位加入至工作項目類型

將自訂小組欄位加入包含於 [功能分類]、[需求分類] 和 [工作分類] 中的所有工作項目類型 (WIT)。而且，如果您已升級至 TFS 2013.3，請將自訂小組欄位加入 [測試計劃分類] 中包含的所有 WIT。

匯出工作項目類型定義。對於 Scrum，匯出功能、產品待處理項目、 Bug 和工作的類型定義。

witadmin exportwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /n:"Product Backlog Item" /f:Directory/pbi.xml
witadmin exportwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /n:Bug /f:Directory/bug.xml
witadmin exportwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /n:Task /f:Directory/task.xml 
witadmin exportwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /n:"Test Plan" /f:Directory/TestPlan.xml

在每個類型中，加入參考全域清單的自訂小組欄位。

<FIELDS>
. . . 
   <FIELD name="Team" refname="MyCompany.Team" type="String" reportable="dimension">
      <HELPTEXT>Name of the team that will do the work.</HELPTEXT>
      <ALLOWEXISTINGVALUE />
         <ALLOWEDVALUES >
            <GLOBALLIST name="Teams" />
         </ALLOWEDVALUES >
         <DEFAULT from="value" value="Unassigned" />
   </FIELD>
. . . 
</FIELDS>

提示

命名您的自訂欄位，使之與 TFS 欄位區分。不要使用 "System" 做為 refname 的前置詞。同時，分別讓 name 和 refname 標籤保持為 128 和 70 個字元。

將 [小組] 欄位加入至工作項目表單。

<FORM>
. . . 
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="MyCompany.Team" Type="FieldControl" Label="Team" LabelPosition="Left" EmptyText="&lt;None&gt;" />
         <Control Type="FieldControl" FieldName="System.AssignedTo" Label="Assi&amp;gned to:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="Stat&amp;e" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason" LabelPosition="Left" ReadOnly="True" />
         </Column>
   </Group>
. . . 
</FORM>

選擇性地將 [區域路徑] 欄位移至 [反覆項目路徑] 之前或之後。

匯入已更新的類型定義。

witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /f:Directory/pbi.xml
witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /f:Directory/bug.xml
witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /f:Directory/task.xml
witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /f:Directory/TestPlan.xml

3.將流程組態變更為參考小組欄位

匯出 ProcessConfiguration 定義。

witadmin exportprocessconfig /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /f:Directory/ProcessConfiguration.xml

將 System.AreaPath 取代為用來指定 type="Team" 的欄位。
```
<TypeField refname="MyCompany.Team" type="Team" />
```

(選用) 將 [小組] 欄位加入待處理項目頁面的快速加入面板。

<RequirementBacklog category="Microsoft.RequirementCategory" parent="Microsoft.FeatureCategory" pluralName="Stories" singularName="User Story">
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
        <Field refname="MyCompany.Team " />
      </Fields>
    </AddPanel> 
. . .

匯入定義檔案。

witadmin importprocessconfig /collection:"http://MyServer:8080/tfs/DefaultCollection" /p:MyProject /f:Directory/ProcessConfiguration.xml

4.為每個小組設定小組欄位

在 Team Web Access (TWA) 中建立並設定小組，以比對和參考 [小組] 欄位。包括 Team 專案 (Fabrikam Fiber 網站) 在內的每個小組都必須使用 [小組] 欄位的預設值來設定。

重新整理 TWA，然後在 Team 專案首頁上，開啟產品待處理項目。確認變更如預期出現，而且您可以選取小組。
如果您尚未建立小組以符合全域清單中的小組，請立即建立一個小組。請參閱加入另一個小組。

如果您先前已經建立小組，這些小組將會繼續存在。您可視需要加以重新命名。
開啟 Team 專案的產品待處理項目或工作面板。您將會收到錯誤，表示您需要選取小組區域。
在 [管理] 頁面上，開啟 [小組欄位] 索引標籤，然後從您想要與預設小組產生關聯的全域清單中選取一或多個值。

為了支援將所有小組彙總為預設小組，會選取所有小組。
接下來，使用符合其名稱的 [小組] 欄位值來設定小組階層中的每個小組。

針對階層內的所有子小組重複執行此步驟。

使用小組欄位將工作指派給小組

在 Team 專案的產品待處理項目頁面中，您可以建立待處理項目，並藉由開啟每個項目和選取 [小組] 欄位，將這些項目指派給小組。指派的項目將出現在小組的待處理項目上，小組接著可使用其衝刺待處理項目和工作面板來使用這些項目。

處理一般待處理項目

針對您從小組待處理項目頁面建立的待處理項目，TFS 會將與小組相關聯的預設值指派給 [小組] 欄位。

問與答

如何針對自訂為使用小組欄位的已升級 Team 專案設定功能？

**答：**您必須先以本主題中概述的相同變更來自訂最新的流程範本，才能針對您自訂為使用小組欄位的已升級 Team 專案設定功能。基礎步驟如下：

將 TFS 升級為最新版本。
下載 TFS 流程範本，這個範本符合您用來建立 Team 專案的範本。

修改 ProcessTemplate 檔案，並更新流程範本名稱及版本號碼。例如：

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
  <metadata>
    <name>Microsoft Visual Studio Scrum 2013.3 with Team Field</name>
    <description>This template is for teams who follow the Scrum methodology and use Scrum terminology.</description>
    <version type="6B724908-EF14-45CF-84F8-768B5384DA45" major="3" minor="60" />

如將自訂小組欄位加入至工作項目類型中所述，請更新指派給功能、需求和工作分類之工作項目類型的 WIT 定義。在 Scrum 流程範本中，這會對應至 [功能]、[產品待處理項目]、[Bug]、[工作] 和 [測試計劃] WIT。
如變更流程組態以參考小組欄位中所述，請將 ProcessConfiguration 檔案更新為使用自訂小組欄位。
上傳 TFS 流程範本，也就是您剛才修改的範本。
使用精靈設定功能。在確認之後，這個精靈應該會選取您在上一個步驟中上傳的流程範本。

我加入至 Team 專案的小組為什麼沒有出現在 [小組] 欄位中？

**答：**您從 Team 專案的 [概觀] 頁面加入至 Team 專案的小組，不會顯示在您建立來擷取小組之自訂欄位的挑選清單中。您必須更新您在建立全域清單以管理小組中建立的全域清單，才能讓新小組出現。

使用全域清單加入新小組，然後再進行設定，如設定小組設定中所述。

還有哪些我可以使用的 witadmin 命令？

**答：**如需所有 witadmin 命令的清單，請參閱 witAdmin：自訂及管理追蹤工作的物件。

哪裡可以進一步了解流程範本？

**答：**請參閱自訂流程範本。

參與名單

適用於自訂從區域路徑分離出來的小組的指導方針是與 Martin Hinshel (資深 ALM 顧問兼 Microsoft Visual Studio ALM MVP) 共同開發的。