在 Classification 外掛程式中定義初始區域和反覆項目

發行項
06/09/2015

類別可根據有用的分類 (如相關產品功能和專案里程碑) 加速對工作的追蹤、分組和報告。您可以定義多個區域，以將工作項目組織為邏輯、實體或功能等分類。您可以定義反覆項目，以將工作項目分組為里程碑或時間循環等分類。例如，小組可以將產品工作組織為工作區、伺服器區域和擴充性區域。您定義的反覆項目可決定小組將重複特定一組主要活動 (如規劃、開發和測試) 多少次。

您定義的類別會出現在新 Team 專案的 [區域] 和 [反覆項目] 頁面上 (如下圖所示)。您可以從 Team Web Access 管理頁面存取此頁面。若要開啟此頁面，請移至這裡。

Team 專案的 [區域] 頁面、TWA 管理內容

從 Team Web Access (TWA) 管理內容存取這些頁面。若要開啟管理內容，請選擇設定圖示 (Team Web Access) 齒輪 [設定] 圖示。

選擇齒輪圖示開啟管理頁面

若要了解如何連接至 TWA，請移至這裡。

建立 Team 專案之後，請使用 TWA 修改區域和反覆項目。您也可以定義權限來控制對專案區域或反覆項目的存取權。如需套用至類別的方針和命名限制，請參閱加入及修改區域和反覆項目路徑。如需追蹤區域和反覆項目之欄位的詳細資訊，請參閱區域和反覆項目欄位參考。

除了區域和反覆項目之外，您還可以指定要在 Classification 外掛程式內上傳之 Microsoft Project 的對應檔案。

重要

根據預設，Microsoft Solution Framework (MSF) 的流程範本預設不會定義區域節點以及三個反覆項目節點 (命名為反覆項目 1、反覆項目 2 和反覆項目 3)。工作項目查詢的定義中參考反覆項目節點，且工作定義於 WorkItemTracking 和 Portal 外掛程式中。

Classification 外掛程式名稱和位置

下表列出 Microsoft Solutions Framework (MSF) 流程範本之檔案、資料夾與外掛程式的名稱：

檔案名稱：	Classification.xml
資料夾名稱：	類別
外掛程式名稱：	Microsoft.ProjectCreationWizard.Classification

注意事項
您可以變更 XML 檔案和資料夾的名稱，但無法變更外掛程式的名稱。Team Foundation Server 並未包含部署用戶端外掛程式、原則或其他修改的機制。如果您想要部署這種功能，就必須使用您自己的散發與安裝程式。

Classification 工作和相依性

Classification 外掛程式檔案必須符合其結構描述定義 (如 Css.xsd 檔案中所指定)，而且外掛程式必須指定在其專屬檔案中。

在 XML 檔案中，請指定一或多項工作及其相依性。一般而言，您只需要一項工作來指定 Team 專案所需的所有反覆項目和節點。

注意事項
如果您修改流程範本的區域或反覆項目，請確定未中斷用於工作項目查詢或是流程範本中所定義之工作項目的任何指派。例如，敏捷式軟體開發之 MSF 流程範本的 Iteration1Backlog.wiq 工作項目查詢參考 Iteration 1。如需詳細資訊，請參閱將工作項目查詢加入至流程範本。

指定初始產品區域

使用下列語法，以指定區域的根節點：

<Node StructureType="ProjectModelHierarchy" Name="Area" >

針對您流程所需的最大區域數，指定零或多個子節點。使用 Node 項目指定每個區域，以及將 StructureType 屬性設為 ProjectModelHierarchy。

<Node StructureType="ProjectModelHierarchy" Name="NodeName" ></Node>

下列範例顯示如何指定兩個區域 (Client 和 Server)：

<?xml version="1.0" encoding="utf-8" ?>
<tasks>
   <task
      id="UploadStructure"
      name="Creating project structure"
      plugin="Microsoft.ProjectCreationWizard.Classification"
      completionMessage="Portfolio project structure created.">
      <taskXml>
         <Nodes>
            <Node StructureType="ProjectModelHierarchy" Name="Teams" >
               <Children>
                  <Node StructureType="ProjectModelHierarchy" Name="Client"></Node>
                  <Node StructureType="ProjectModelHierarchy" Name="Server"></Node>
               </Children>
            </Node>
         </Nodes>
      </taskXml>
   </task>
</tasks>

指定初始反覆項目路徑

使用下列語法，以指定反覆項目的根節點：

<Node StructureType="ProjectLifecycle" Name="NodeName" >

針對您流程所需的最大反覆項目數，指定零或多個子節點。使用 Node 項目指定每個反覆項目，以及將 StructureType 屬性設為 ProjectLifecycle。

下列範例顯示如何指定四個反覆項目：Milestone 1、Milestone 2、Beta 和 RTM。

<?xml version="1.0" encoding="utf-8" ?>
<tasks>
   <task
      id="UploadStructure"
      name="Creating project structure"
      plugin="Microsoft.ProjectCreationWizard.Classification"
      completionMessage="Team project structure created.">
      <taskXml>
         <Nodes>
            <Node StructureType="ProjectLifecycle" Name="Iteration" >
               <Children>
                  <Node StructureType="ProjectLifecycle" Name="Milestone 1"></Node>
                  <Node StructureType="ProjectLifecycle" Name="Milestone 2"></Node>
                  <Node StructureType="ProjectLifecycle" Name="Beta"></Node>
                  <Node StructureType="ProjectLifecycle" Name="RTM"></Node>
               </Children>
            </Node>
         </Nodes>
      </taskXml>
   </task>
</tasks>

指定 Microsoft Project 的欄位對應檔案

在 Classification.xml 檔案的 properties 區段中，指定含有 Microsoft Project 之欄位對應的檔案。使用 property 項目指定要上傳的檔案 (標示為 MSF 流程範本的 FileMapping.xml)。此檔案包含 Microsoft Project 中欄位與 Team Foundation 中欄位之間的對應。此檔案會上傳至 Team 專案的資料庫。下列範例顯示此項目的語法結構：

<properties>
   <property name="MSPROJ" 
             value="Classification\FileMapping.xml" 
             isFile="true" />
</properties>

若要自訂此檔案，請參閱將 Microsoft Project 欄位對應至 Team Foundation 欄位。

Classification 外掛程式項目參考

下表描述您用來定義初始產品區域和反覆項目的項目。在 Classification 外掛程式檔案的 taskXml 容器項目中指定這些項目。如需此項目的詳細資訊，請參閱定義要處理外掛程式的工作。

警告

Css.xsd 結構描述檔案未定義 property 或 properties 項目。當您上傳流程範本時，流程範本管理員會先驗證這些項目，再將它們儲存在 Team Foundation Server 中。

指定巢狀節點和子節點的樹狀路徑，以定義區域和反覆項目。如需詳細資訊，請參閱加入及修改區域和反覆項目路徑。


Children	`<Children> <Node> . . . </Node> </Children>`	Children 是 Node 的選擇性子項目。包含子區域或反覆項目的定義。
Node	`<Node StructureType="ProjectLifecycle \| ProjectModelHierarchy" Name="NodeName"> <Node> . . . </Node> <Children> . . . </Children> </Node>`	Node 是 Nodes 和 Children 的選擇性子項目。定義樹狀目錄的結構。針對反覆項目使用 ProjectLifecycle，並針對區域使用 ProjectModelHierarchy。節點名稱不應該超出 255 個字元。
Nodes	`<Nodes> <Node> . . . </Node> </Nodes>`	Nodes 是 Classification 外掛程式之 taskXml 的必要子項目。。包含區域和反覆項目定義。
properties	`<properties> <property /> </properties>`	properties 是 Classification 外掛程式之 taskXml 的必要子項目。。
property	`<property name="property name" value="Classification\FileName" isFile="true \| false" />` 其中每個屬性都會套用下列定義： name：必要項。定義屬性的名稱。唯一有效的名稱是 MSPROJ。 value：必要項。定義欄位對應檔案的相對路徑。 isFile：選擇項。指定屬性是否在檔案中定義。如果此值為 true，則檔案必須存在，否則流程範本驗證會失敗。	property 是 properties 的必要子項目。定義專案相關資料 (如 Microsoft Project 的 XML 對應資料)。

請參閱

概念

加入及修改區域和反覆項目路徑