共用方式為


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

您可以使用 tasks 項目及其子項目定義要上傳的成品,或要針對外掛程式建立的特定項目。 工作 (Task) 會指定必須發生的工作 (Work),以便設定新的 Team 專案中某些特定的流程項目。 您可以定義上傳工作項目、工作項目查詢、文件、報告 Team 專案的工作。 您可以定義的其他工作會設定 Visual Studio Application Lifecycle Management 的其他區域,例如 Team Foundation Build、Visual Studio Lab Management、Test Manager 和 Team Foundation 版本控制。

本主題內容

  • 工作語法結構

  • 工作項目參考

  • 依功能排列的 taskXML 項目索引

  • 範例:定義工作項目的類型

工作語法結構

您可以在外掛程式中指定數個工作,而且這些工作彼此之間可能有相依性。 您針對每個外掛程式定義的工作必須符合 Tasks.xsd 檔案中定義之 tasks 的結構描述定義,而且必須在自己檔案中使用 tasks 容器項目指定。

下列語法顯示 tasks 項目及其子項目的高階結構。

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

回到頁首

工作項目參考

下表描述可以定義外掛程式之工作的每個項目。

元素

語法

描述

dependencies

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

task 的選擇性子項目。

指定與某個群組相依的其他群組。

dependency

<dependency taskId="taskId" />

dependencies 的選擇性子項目。

指定與此工作相依之另一個工作的 ID。 此另一個工作必須先完成,這個工作才能開始。

ProcessTemplate

<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

其中每個屬性定義如下:

  • Type:正在上傳之檔案的類型。 下列是有效值:用於組建範本的 Default 和 Upgrade,以及用於實驗室範本檔案的 Custom。

  • Filename:要上傳之檔案的本機目錄路徑和名稱。

  • Description:描述要上傳之檔案的簡短文字字串。

  • ServerPath:正在執行應該上傳檔案所在 Team Foundation Server 之伺服器的路徑。 唯一有效的上傳位置是 $/$$PROJECTNAME$$/BuildProcessTemplates。

用於 Build 和 Lab 外掛程式之 taskXml 項目的選擇性子項目。

指定要上傳之檔案的名稱、位置和目的地,以支援 Team 專案的建置程序。

task

<task id="task id" name="name of task" 
   plugin="Microsoft.ProjectCreationWizard.<PluginName>" 
   completionMessage="SuccessfulCompletionMessage" 
   completionDescription="InProcessMessage">
    <dependencies>. . . </dependencies>
    <taskXml>. . . </taskXml>
</task>

tasks 的必要子項目。

指定必須發生的工作,以便設定新的 Team 專案中某些特定的流程項目。

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

  • name:描述工作的用途。

  • plugin:識別必須執行這個工作的外掛程式。

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

  • completionDescription:指定訊息在 Team 專案建立期間顯示,表示工作正在進行處理。 最小長度為 1 個字元。

tasks

<tasks>
    <task>. . . </task>
</tasks>

taskXml 的必要子項目。

包含 task 項目的集合,每一個項目都會指定為了在新 Team 專案中設定程序特定之事項所必須進行的工作。

taskXml

<taskXml> . . . </taskXml>

外掛程式檔案的必要根項目。

描述完成此工作所需的作業。 這個項目區塊內的 XML 並非固定不變,會隨著每一個外掛程式而有所不同。

注意事項注意事項
XML 處理器不會嘗試驗證此項目中的內容。

回到頁首

依功能排列的 taskXML 項目索引

如需您可以針對每個外掛程式指定之 XML 標記項目特定的詳細資訊,請參閱下列其中一個主題:

回到頁首

範例:定義工作項目的類型

下列範例示範了可經由參考每種類型的定義檔案來建立六種工作項目類型的工作。

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

回到頁首

請參閱

概念

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

使用流程範本檔案