ProcessTemplate XML 項目參考

發行項
08/12/2011

更新：2011 年 4 月

您可以自訂流程範本的根檔案以新增或移除外掛程式檔案。根檔案會定義 [新增 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 的必要子項目。定義流程範本之外掛程式的容器項目。

回到頁首

群組項目參考

下列語法顯示 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 檔中。如需如何指定這些檔案的詳細資訊，請參閱定義要處理外掛程式的工作。