作業項目を追跡するためのオブジェクトの作業項目トラッキングプラグインによる定義およびカスタマイズ

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

更新 : 2011 年 4 月

作業を追跡するためのチームプロジェクトの初期のオブジェクトは、作業項目を追跡するプラグインを使用して定義します。これらのオブジェクトには、作業項目の種類、作業項目クエリ、カテゴリ、リンクの種類、グローバルリストおよび作業項目のインスタンスが含まれます。これらのオブジェクトは、チームプロジェクトを作成した後で、witadmin コマンドラインツールを使用して変更できます。

プラグインファイルでは、1 つまたは複数のタスクとその依存関係を指定します。通常は、主要なアップロードアクティビティ、つまりリンクの種類、作業項目の種類、クエリ、およびカテゴリごとにタスクを 1 つ指定します。

重要

ファイルをアップロードするためのタスクを指定し、一定の順序 (最初にリンクの種類、次に作業項目の種類、その次にクエリ) でクエリを定義する必要があります。これらのオブジェクトの各定義ファイルは、定義ファイルの前にあるタスクで指定されている定義に依存します。通常は、カスタマイズしているプロセステンプレートで定義されているタスクの順序を維持します。詳細については、「プラグインファイルのタスクグループとタスクの依存関係の定義」を参照してください。

このトピックの内容

作業項目トラッキングプラグインの名前と場所
作業項目トラッキングプラグインの構文構造
作業項目トラッキングプラグインの要素リファレンス

定義できるオブジェクトの各種類の詳細については、次のいずれかのトピックを参照してください。

作業項目トラッキングプラグインの名前と場所

次の表に、MSF (Microsoft Solutions Framework) 用のプロセステンプレートのファイルの名前と場所、およびプラグインの名前を示します。

ファイル名:	WorkItems.xml
ファイルの場所:	WorkItem Tracking フォルダー
プラグイン名:	Microsoft.ProjectCreationWizard.WorkItemTracking

注意

この XML ファイルの名前と場所は変更できますが、プラグインの名前は変更できません。 Visual Studio Team Foundation Server には、クライアント側のプラグイン、ポリシー、その他の変更を配置する機構は含まれていません。このような機能を配置するには、配布とインストールを行う独自のプログラムを使用する必要があります。

ページのトップへ

作業項目トラッキングプラグインの構文構造

作業項目トラッキングのプラグインファイルは、WorkItemMethodology.xsd ファイルで定義されているスキーマ定義に従っている必要があり、プラグインは独自のファイルで指定されている必要があります。プロセステンプレートのスキーマファイルは、Microsoft Web サイトの「Process Template and Work Item Schemas for Visual Studio Team Foundation (Visual Studio Team Foundation のプロセステンプレートスキーマと作業項目スキーマ)」でダウンロードできます。

次の構文は、作業項目トラッキングプラグインの高レベルな構造を示しています。リンクの種類の定義のアップロード用に 1 つ、作業項目の種類用に 1 つ、クエリ用に 1 つ、カテゴリ用に 1 つ、合計 4 種類のタスクが指定されています。グローバルリストまたは作業項目インスタンスの定義を追加した場合は、インスタンスごとに追加のタスクを指定します。

各要素の詳細については、このトピックで後述する「作業項目トラッキングプラグインの要素リファレンス」を参照してください。

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

ページのトップへ

作業項目トラッキングプラグインの要素リファレンス

作業項目トラッキングオブジェクトのアップロードに使用する要素を次の表に示します。作業項目トラッキングプラグインファイルの taskXml コンテナー要素内で、次の要素を指定します。タスク、依存関係および taskXml 要素の詳細については、「プラグインを処理するタスクの定義」を参照してください。

要素	構文	説明
CATEGORIES	`<CATEGORIES fileName="CategoriesFilePathName" />`	作業項目トラッキングプラグインの taskXml 要素の子要素です (省略可能)。作業項目トラッキングプラグインタスクが処理されるときにアップロードされる、カテゴリの定義を格納するファイルのパスと名前を指定します。
FIELD	`<FIELD refname="FieldReferenceName" value="Value" />`	WI の子要素です (必須)。作業項目インスタンス内のフィールドの値を定義します。
GLOBALLISTS	`<GLOBALLISTS fileName="GlobalListFilePathName" />`	作業項目トラッキングプラグインの taskXml 要素の子要素です (省略可能)。作業項目トラッキングプラグインのタスクが処理されるときにアップロードされる、グローバルリストの定義を格納するファイルのパスと名前を指定します。
HYPERLINK	`<HYPERLINK URL="URL" relativePath="false" />`	WI の子要素です (省略可能)。作業項目のインスタンスのハイパーリンクを定義します。
LINKTYPE	`<LINKTYPE fileName="LinkTypeFilePathName" />`	LINKTYPES の子要素です (必須)。アップロードするリンクの種類の定義を含むファイルのパスとファイル名を指定します。
LINKTYPES	`<LINKTYPES> <LINKTYPE /> . . . </LINKTYPES>`	作業項目トラッキングプラグインの taskXml 要素の子要素です (省略可能)。アップロードする定義ファイルをそれぞれ指定する LINKTYPE 要素のコレクションを格納します。
Permission	`<permission allow="ListOfPermissions" identity="GroupName" />`	Query の子要素です (省略可能)。チームクエリに割り当てられる既定のアクセス許可を指定します。詳細については、「作業項目クエリのアクセス許可の割り当て」を参照してください。
Query	`<Query name="QueryName" fileName="QueryFilePathName" />`	QUERIES の子要素です (必須)。アップロードするクエリを定義する .wiq ファイルの名前とパスを指定します。
QueryFolder	`<QueryFolder name=" FolderName ">`	QUERIES の子要素です (省略可能)。クエリフォルダーの名前を指定します。
QUERIES	`<QUERIES> . . . </QUERIES>`	作業項目トラッキングプラグインの taskXml 要素の子要素です (省略可能)。既定のクエリを作成するために使用するクエリ定義ファイルを指定します。
WI	`<WI type="WorkItemType"> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI>`	WORKITEMS の子要素です (必須)。作成する作業項目の種類と、特定のフィールドに割り当てる値を定義します。
WORKITEMS	`WORKITEMS> <WI> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> </WORKITEMS >`	作業項目トラッキングプラグインの taskXml 要素の子要素です (省略可能)。作業項目インスタンスを定義する WI 要素のコレクションを格納します。
WORKITEMTYPE	`<WORKITEMTYPE fileName="WITFilePathName" />`	WORKITEMTYPES の子要素です (必須)。アップロードする種類の定義を含むファイルのパスとファイル名を指定します。
WORKITEMTYPES	`<WORKITEMTYPES> <WORKITEMTYPE /> . . . </WORKITEMTYPES>`	作業項目トラッキングプラグインの子要素です (必須)。アップロードする定義ファイルをそれぞれ指定する WORKITEMTYPE 要素のコレクションを格納します。

ページのトップへ

参照

履歴の変更

日付	履歴	理由
2011 年 4 月	要素リファレンスのセクション、トラッキングオブジェクトの種類を示す個々のトピックへのリンクを追加しました。削除されたトピックへのリンクが削除されました。	情報の拡充

2011 年 4 月

要素リファレンスのセクション、トラッキングオブジェクトの種類を示す個々のトピックへのリンクを追加しました。削除されたトピックへのリンクが削除されました。

情報の拡充

作業項目を追跡するためのオブジェクトの作業項目トラッキング プラグインによる定義およびカスタマイズ

作業項目トラッキング プラグインの名前と場所

作業項目トラッキング プラグインの構文構造

作業項目トラッキング プラグインの要素リファレンス

参照

処理手順

概念

その他の技術情報

履歴の変更

その他のリソース

作業項目を追跡するためのオブジェクトの作業項目トラッキングプラグインによる定義およびカスタマイズ

作業項目トラッキングプラグインの名前と場所

作業項目トラッキングプラグインの構文構造

作業項目トラッキングプラグインの要素リファレンス