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

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

針對新的 Team 專案，您定義的分類會出現在 [區域和反覆項目] 對話方塊中，如下圖所示：

建立 Team 專案之後，您就可以使用任何 Team Foundation 的用戶端應用程式來修改區域和反覆項目。 您也可以定義權限來控制對專案區域或反覆項目的存取。 如需適用於分類的指導方針與命名限制，請參閱建立和修改區域和反覆項目。 如需追蹤區域和反覆項目之欄位的詳細資訊，請參閱區域和反覆項目欄位參考

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

重要

根據預設，Microsoft Solution Framework (MSF) 的流程範本不會定義任何區域節點，但是會指定三個反覆項目節點，其名稱分別為反覆項目 1、反覆項目 2 和反覆項目 3。在工作項目查詢的定義中會參考反覆項目節點，而且在 WorkItemTracking 和 Portal 外掛程式中會定義工作。

本主題內容

• Classification 外掛程式的名稱和位置

• 分類工作與相依性

• 指定初始專案區域

• 指定初始反覆項目

• 指定要上載的 Microsoft Office Project 欄位對應檔

• Classification 外掛程式項目參考

Classification 外掛程式的名稱和位置

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

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

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

回到頁首

分類工作與相依性

Classification 外掛程式檔案必須符合其結構描述定義 (如 Css.xsd 檔案中所指定)，而且必須在自己的檔案中指定外掛程式。 您可以從 Microsoft 網站的下列頁面下載流程範本的結構描述檔案：Visual Studio Team Foundation 的流程範本和工作項目 (英文)。

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

注意事項
如果您修改了流程範本的區域或反覆項目，請確保沒有破壞任何用於流程範本中定義之工作項目查詢或工作項目的指派。例如，適用於敏捷式軟體開發 (Agile Software Development) 之 MSF 流程範本的 Iteration1Backlog.wiq 工作項目查詢會參考反覆項目 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 中。

您可以指定巢狀節點與子節點的樹狀路徑，藉以定義區域和反覆項目。 如需詳細資訊，請參閱Restrictions on Area and Iteration Paths。

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>	對於 Classification 外掛程式，Nodes 是 taskXml 的必要子項目。 包含區域和反覆項目的定義。
properties	<properties>    <property /> </properties>	對於 Classification 外掛程式，properties 是 taskXml 的必要子項目。
property	<property name="property name" value="Classification\FileName" isFile="true | false" /> 其中下列定義適用於每個屬性： name：必要項。 定義屬性的名稱。 唯一有效名稱為 MSPROJ。 value：必要項。 定義欄位對應檔案的相對路徑。 isFile：選擇項。 指定是否在檔案中定義屬性。 如果值為 true，則此檔案必須存在，否則流程範本驗證會失敗。	property 是 properties 的必要子項目。 定義與專案相關的資料，例如 Microsoft Project 的 XML 對應資料。

回到頁首

請參閱

概念

建立和修改區域和反覆項目

在流程範本中自訂功能區域