プラグインを処理するタスクの定義

[アーティクル]
08/09/2011

更新 : 2011 年 4 月

tasks 要素とその子要素を使用して、アップロードされる成果物またはプラグインとして作成される特定要素を定義します。タスクは、新しいチームプロジェクト内のプロセス固有のものを設定するために実行する必要がある作業を指定します。次の図に示すように、いくつかのタスクを定義することで、チームプロジェクトの既定の構造を構成します。他のタスクを定義して、Team Foundation ビルド、Visual Studio Lab Management、テストマネージャー、Team Foundation バージョン管理などのVisual Studio アプリケーションライフサイクル管理の他の領域を構成することもできます。

アジャイルチームプロジェクトの成果物の構造

このトピックの内容

タスクの構文構造
タスク要素リファレンス
機能別 taskXML 要素のインデックス
例: 作業項目の種類の定義

タスクの構文構造

プラグイン内に複数のタスクを指定して、これらのタスクに相互の依存関係を指定することができます。各プラグインに定義するタスクは、Tasks.xsd ファイルで定義されている tasks のスキーマ定義に従って、tasks コンテナー要素の独自のファイルで指定されている必要があります。プロセステンプレートのスキーマファイルは、Microsoft Web サイトの「Process Template and Work Item Schemas for Visual Studio Team Foundation (Visual Studio Team Foundation のプロセステンプレートスキーマと作業項目スキーマ)」でダウンロードできます。

次の構文は、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 のみです。	ビルドおよびラボのプラグインの taskXml 要素の子要素です (省略可能)。チームプロジェクトのビルド処理のサポート用にアップロードするファイルの名前、場所および配置先を指定します。
task	`<task id="task id" name="name of task" plugin="Microsoft.ProjectCreationWizard.<PluginName>" completionMessage="SuccessfulCompletionMessage" completionDescription="InProcessMessage"> <dependencies>. . . </dependencies> <taskXml>. . . </taskXml> </task>`	tasks の子要素です (必須)。新しいチームプロジェクトでプロセス固有のものを構成するために実行する必要がある作業を指定します。 id: タスクを識別する名前を指定します。別のタスクがこのタスクに依存する場合は、この ID が参照されます。プラグインファイルの中で ID に一意の値を割り当てる必要があります。 name: タスクが実行する内容を表します。 plugin: このタスクを実行するプラグインを識別します。 completionMessage: チームプロジェクトの作成時に表示する、タスクの処理が正常に完了したことを表すメッセージを指定します。最大長は 256 文字です。 completionDescription: チームプロジェクトの作成時に表示する、タスクが処理中であることを表すメッセージを指定します。最小長は 1 文字です。
tasks	`<tasks> <task>. . . </task> </tasks>`	taskXml の子要素です (必須)。 task 要素のコレクションを含みます。各タスクは、新しいチームプロジェクトでプロセス固有のものを構成するために実行する必要がある作業を指定します。
taskXml	`<taskXml> . . . </taskXml>`	プラグインファイルに必須のルート要素です。このタスクを完了するために必要な作業を示します。この要素ブロック内の XML は多様であり、各プラグイン固有です。メモ XML プロセッサは、要素内のコンテンツの妥当性検査を行いません。

ページのトップへ

機能別 taskXML 要素のインデックス

各プラグインに指定できる XML マークアップ要素の指定に関する詳細については、次のトピックを参照してください。

ビルド: Team Foundation ビルドの初期構成の定義
分類: 分類プラグインによる初期の区分およびイテレーションの定義
グループおよびアクセス許可: 初期のグループ、メンバー、およびアクセス許可の構成
ラボ: Lab Management の初期構成の定義
ポータル: プロセステンプレートのプロジェクトポータルプラグインの定義
レポート: プロセステンプレートへのレポートの追加
テスト管理: テストマネージャーの初期構成の定義
バージョンコントロール: Team Foundation バージョン管理の初期構成の定義
作業項目トラッキング: 作業項目を追跡するためのオブジェクトの作業項目トラッキングプラグインによる定義およびカスタマイズ

ページのトップへ

例: 作業項目の種類の定義

次の例では、種類ごとに定義ファイルを参照することによって 6 つの作業項目の種類を作成するタスクを示しています。

<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>

ページのトップへ

参照

概念

プラグインファイルのタスクグループとタスクの依存関係の定義

その他の技術情報

プロセステンプレートプラグイン

履歴の変更

日付	履歴	理由
2011 年 4 月	プラグインのタスクの定義、および tasks 要素の使用に関する情報と構造を追加しました。	情報の拡充

2011 年 4 月

プラグインのタスクの定義、および tasks 要素の使用に関する情報と構造を追加しました。

情報の拡充

次の方法で共有

プラグインを処理するタスクの定義

タスクの構文構造

タスク要素リファレンス

機能別 taskXML 要素のインデックス

例: 作業項目の種類の定義

参照

概念

その他の技術情報

履歴の変更

その他のリソース