共用方式為

流程範本 XML 項目參考

  • 發行項

您可以自訂流程範本的根檔案以新增或移除外掛程式檔案。 根檔案會定義 [新增 Team 專案精靈] 將會處理的所有外掛程式和所有工作。 若是 Microsoft Solutions Framework (MSF) 的流程範本，根檔案的名稱為 ProcessTemplate，而且位於流程範本檔案的容器資料夾中。 如需詳細資訊，請參閱流程範本檔概觀。

根外掛程式檔案的父項目是 ProcessTemplate 項目，這個項目必須只能定義一個 metadata 和一個 groups 項目。 您必須為 Team 專案集合中的每個流程範本指派一個唯一的名稱，而且此名稱長度不得超過 124 個 Unicode 字元。

警告

如果您上傳一個與現有範本相同名稱的範本，現有範本將會被覆寫。

本主題內容

  • ProcessTemplate 語法結構

  • 中繼資料項目參考

  • 群組項目參考

ProcessTemplate 語法結構

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

以下範例顯示 ProcessTemplate 根項目的結構。 如需更詳盡的範例，請參閱使用流程範本外掛程式檔案定義根工作。

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

中繼資料項目參考

下列語法顯示 metadata 項目及其子項目的結構。

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

元素

語法

描述

description

 
<description>ProcessTemplateDescription</description>

metadata 的必要子項目。

定義出現在 [新增 Team 專案精靈] 中之流程範本的描述文字。

metadata

 
<metadata>
    <name> . . . </name>
    <description> . . . </description>
    <plugins> . . . </plugins>
</metadata>

ProcessTemplate 的必要子項目。

指定 [新增 Team 專案精靈] 所處理之外掛程式必要資訊的容器項目。

name

 
<name>ProcessTemplateName</name>

metadata 的必要子項目。

定義流程範本的名稱，這個名稱在整個 Team 專案集合中必須是唯一的。 此名稱的最大長度為 124 個字元。

plugin

 
<plugin name="Microsoft.ProjectCreationWizard.PluginName 
wizardPage="true | false" />

plugins 的必要子項目。

指定要併入流程範本建立作業中之外掛程式檔案的名稱，並指定此外掛程式在 [新增 Team 專案精靈] 中是否應該有可見的頁面。

plugins

 
<plugins>
   <plugin> . . . </plugin>
</plugins>

metadata 的必要子項目。

定義流程範本之外掛程式的容器項目。

version

 
<version type="ID" major="Number1" minor="Number2 " />

metadata 的選擇性子項目。

指定唯一 ID 和主要及次要修訂編號，以識別流程範本的版本。

群組項目參考

下列語法顯示 groups 項目及其子項目的結構。

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

元素

語法

描述

dependencies

 
<dependencies>
<dependency>. . . </dependency>
</dependencies>

group 的必要子項目。

指定此群組與其他群組的相依性。

dependency

 
<dependency groupId="groupId" />

dependencies 的選擇性子項目。

指定與此群組相依之另一個工作群組的 ID。 另一個群組必須先完成其工作，這個工作群組才能開始進行。

group

 
<group id="TaskGroupId" 
   description="TaskGroupDescription" 
   completionMessage="SuccessMessage" 
   failureMessage="FailureMessage">
   <dependencies> . . . <dependencies>
   <taskList> . . . </taskList>
</group>

groups 的必要子項目。

識別要在專案建立期間執行之外掛程式的工作集。 下列是每個屬性的有效值：

  • id：指定可識別工作群組的名稱。 如果有另一個工作群組相依於這個群組，它會參考這個 ID。 您必須將唯一的值指派給外掛程式檔案內的 ID。

  • description：指定在 Team 專案建立期間，表示正在處理工作群組的訊息。

  • completionMessage：指定在 Team 專案建立期間，表示工作群組已成功完成的訊息。 最大長度為 256 個字元。

  • failureMessage：指定在 Team 專案建立期間，表示工作群組無法成功完成的訊息。

groups

 
<groups>
    <group> . . . </group>
</groups>

ProcessTemplate 的必要子項目。

定義將在專案建立期間執行之工作群組的集合。

tasklist

 
<taskList filename="filePath" />

指定 XML 檔案，此 XML 檔案包含要執行之工作的清單。 群組的工作清單必須一律位於分開的 XML 檔中。 如需如何指定這些檔案的詳細資訊，請參閱定義要處理外掛程式的工作。

請參閱

概念

流程範本檔概觀

定義要處理外掛程式的工作

在外掛程式檔案中定義工作群組和工作的相依性

自訂流程範本

使用流程範本外掛程式檔案定義根工作