次の方法で共有

プロセス テンプレート プラグイン ファイルを使用したルート タスクの定義

  • [アーティクル]

更新 : 2011 年 4 月

ProcessTemplate.xml をカスタマイズすると、プロセス テンプレート プラグインが処理される順序を追加、削除、または変更できます。 ProcessTemplate.xml は、プロセス テンプレート全体およびすべての従属 XML ファイルを定義するルート ファイルです。 このファイルには、チーム プロジェクトを正しく作成するために実行する必要があるすべてのタスク グループが含まれます。 各タスク グループは、特定のタスクが定義されている従属 XML ファイル (通常はサブフォルダーにあります) を参照します。 一般には、プラグインごとに 1 つのタスク グループを指定します。

このトピックの内容

  • ProcessTemplate.xml ファイルの構造

  • プラグインとタスク グループの定義

  • プロセス テンプレート ファイルの例

プロセス テンプレートのコンテンツの概要については、「プロセス テンプレート ファイルの操作」を参照してください。

ProcessTemplate.xml ファイルの構造

各 ProcessTemplate.xml ファイルでは、メタデータとタスク グループを定義します。 次の例に示すように、メタデータでテンプレートを説明し、処理されるプラグインを指定します。

<metadata>
    <name>MSF for Agile Software Development v5.0</name>
    <description>You can use this template to organize and track the progress and health of a small-to-medium sized agile project.</description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
. . .
    </plugins>
</metadata>

タスク グループでは、次の例に示すように、各プラグインの依存関係と実行されるタスクを指定します。

<groups>
    <group id="Classification" description="Structure definition for the project." completionMessage="Project Structure uploaded.">
      <dependencies></dependencies>
      <taskList filename="Classification\Classification.xml" />
    </group>
    <group id="Groups" description="Create groups and assign permissions." completionMessage="Groups created and permissions assigned.">
      <dependencies>
        <dependency groupId="Classification" />
      </dependencies>
      <taskList filename="Groups and Permissions\GroupsandPermissions.xml" />
    </group>
. . .
</groups>

ページのトップへ

プラグインとタスク グループの定義

ProcessTemplate.xml ファイルをカスタマイズするには、ProcessTemplate 要素とその子要素を使用します。 各要素の構文の詳細については、「ProcessTemplate XML 要素のリファレンス」を参照してください。

次の情報を順序どおりに指定することで、処理されるプラグインとルート タスクを定義します。

  1. name。 この要素を使用して、プロセス テンプレートにラベルを割り当てます。 新しいチーム プロジェクト ウィザードでは、次の例のような名前に基づいてプロセス テンプレートを指定します。

    <name>Simplified Process</name>

    この要素は必須です。 名前は新しいチーム プロジェクト ウィザードのプロセス テンプレート リストだけでなく、プロセス テンプレート マネージャーのダイアログ ボックスにも表示されます。 各プロセス テンプレートの名前は、チーム プロジェクト コレクション内で一意でなければなりません。また、各テンプレート名の長さは、Unicodoe 文字で 254 文字以下にする必要があります。 既存のテンプレートと同じ名前を持つテンプレートをアップロードすると、既存のテンプレートが上書きされます。

  2. description。 この要素を使用して、次の例に示すように、新しいチーム プロジェクト ウィザードでプロセス テンプレートを説明するテキストを定義します。

    <description>Choose the simple process for projects that require little or no overhead and have very low cost.</description>

    このテキストは、プロジェクト リーダーや管理者が、使用するプロセス テンプレートを決めるときに、新しいチーム プロジェクト ウィザードの [プロセス テンプレートの選択] 画面に表示されます。 一般には、チームの規模、期間、コスト、および他の要因に関して、プロセス テンプレートが役立つプロジェクトの種類が説明されます。

  3. プラグイン。 plugins 要素および plugin 要素を使用して、プロセス テンプレートで使用するプラグインのセットを定義します。 従属 XML ファイルがプラグインを参照している場合は、そのプラグインがこのリストにある必要があります。 また、wizardPage 属性 (true または false) も指定して、プラグインが新しいチーム プロジェクト ウィザード上のページを必要とするかどうかを指定する必要もあります。 チーム プロジェクトの作成時に処理されるプラグインのセットを指定し、そのプラグラインが新しいチーム プロジェクト ウィザードにページを表示するかどうかを指定します。

    次の XML コードは、Visual Studio アプリケーション ライフサイクル管理 (ALM) に付属している 9 個の各プラグインで使用する正しい値を示しています。

    <plugins>   <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true"/>   <plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.WorkItemTracking" wizardPage="false"/>   <plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true"/>   <plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />   <plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />   <plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" /></plugins>

  4. タスク グループ。 タスク グループを定義するには、groups 要素および group 要素を使用します。 各タスク グループは、各プラグインの処理に必要な情報を定義します。 各タスク グループでは、処理するタスクのセットと、そのグループが他のタスク グループに対して持つオプションの依存関係を格納するファイルを指定します。 最も一般的で簡単な方法は、プラグインのグループごとに 1 つの taskList 要素を作成することです。

    次の例は、タスク グループで既定のグループとアクセス許可を作成する方法を示しています。 特定のタスクは、参照先ファイル (GroupsandPermissions.xml) で定義されています。 このタスク グループは、Classification グループのタスクの正常終了に依存します。

    <group id="Groups" description="Create groups and assign permissions." completionMessage="Groups created and permissions assigned.">   <dependencies>      <dependency groupId="Classification" />   </dependencies>   <taskList filename="Groups and Permissions\GroupsandPermissions.xml" /></group>

    各タスク グループには、次の情報を定義します。

    1. ID。 プラグインに割り当てられる一意の ID。

    2. 説明。 新しいチーム プロジェクト ウィザードでプラグイン タスクを説明するテキストです。

    3. 完了メッセージ。 プラグインのすべてのタスクが正常に完了した場合に、新しいチーム プロジェクト ウィザードに表示されるメッセージです。

    4. (省略可能) エラー メッセージ。 プラグインの 1 つ以上のタスクが失敗した場合に、新しいチーム プロジェクト ウィザードに表示されるメッセージです。

    5. (省略可能) プラグインの依存関係。 dependencies 要素および dependency 要素を使用して、処理されるプラグインの依存関係のセットを定義します。 依存関係とは、現在のプラグイン タスクを処理する前に正常に完了する必要があるプラグインに相当します。

    6. タスク ファイル。 プラグインを処理するタスクのセットを格納するファイルを指定するには、tasklist 要素を使用します。

ページのトップへ

プロセス テンプレート ファイルの例

次の XML 構文は、Microsoft Visual Studio Scrum 1.0 の ProcessTemplate.xml ファイルの内容です。 このテンプレートは、Microsoft Web サイトの「Microsoft Visual Studio Scrum 1.0」からダウンロードできます。

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
  <metadata>
    <name>Microsoft Visual Studio Scrum 1.0</name>
    <description>By using this template, you can organize and track the progress and health of a small-to-medium sized Scrum project.</description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.WorkItemTracking" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" />
    </plugins>
  </metadata>
  <groups>
    <group id="Classification" description="Structure definition for the project." completionMessage="Project structure uploaded.">
      <dependencies></dependencies>
      <taskList filename="Classification\Classification.xml" />
    </group>
    <group id="Groups" description="Create groups and assign permissions." completionMessage="Groups created and permissions assigned.">
      <dependencies>
        <dependency groupId="Classification" />
      </dependencies>
      <taskList filename="Groups and Permissions\GroupsAndPermissions.xml" />
    </group>
    <group id="WorkItemTracking" description="Work item definitions uploading." completionMessage="Work item tracking tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
      </dependencies>
      <taskList filename="WorkItem Tracking\WorkItems.xml" />
    </group>
    <group id="VersionControl" description="Creating version control." completionMessage="Version control task completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
        <dependency groupId="WorkItemTracking" />
      </dependencies>
      <taskList filename="Version Control\VersionControl.xml" />
    </group>
    <group id="Build" description="Build default processes uploading." completionMessage="Build default processes uploaded.">
      <dependencies>
        <dependency groupId="VersionControl" />
        <dependency groupId="Groups" />
      </dependencies>
      <taskList filename="Build\Build.xml" />
    </group>
    <group id="Lab" description="Creating Lab." completionMessage="Lab task completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
        <dependency groupId="WorkItemTracking" />
        <dependency groupId="Build" />
      </dependencies>
      <taskList filename="Lab\Lab.xml" />
    </group>
    <group id="TestManagement" description="Test Management default configurations uploading." completionMessage="Test Management default configurations uploaded.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
        <dependency groupId="WorkItemTracking" />
      </dependencies>
      <taskList filename="Test Management\TestManagement.xml" />
    </group>
    <group id="Reporting" description="Project reports uploading." completionMessage="Project reporting tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="WorkItemTracking" />
        <dependency groupId="VersionControl" />
      </dependencies>
      <taskList filename="Reports\ReportsTasks.xml" />
    </group>
    <group id="Portal" description="Creating project portal site" completionMessage="Project portal tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Reporting" />
      </dependencies>
      <taskList filename="Windows SharePoint Services\WssTasks.xml" />
    </group>
  </groups>
</ProcessTemplate>

ページのトップへ

参照

概念

プロセス テンプレート ファイルの操作

その他の技術情報

ProcessTemplate XML 要素のリファレンス

プロセス テンプレートのカスタマイズ

履歴の変更

日付

履歴

理由

2011 年 4 月

ルート構文の定義順序の説明、およびプロセス テンプレートの構文構造の例を記載するために変更しました。

情報の拡充