プロセス テンプレートへのリンクの種類定義の追加
チーム メンバーがチーム プロジェクトの作業項目間で作成できるリンクとして、他の種類のリンクを定義できます。 リンクの種類では、その種類の作業項目間の関係またはリンクを制御するラベルと規則を定義します。 指定したリンクの種類により、階層リンク、依存リンクおよび関連リンクの既定の種類を補完します。 リンクの各種類の定義ファイルを別々のファイルで指定するか、または 1 つのファイルですべてを指定することもできます。 続いて定義ファイルを指定して、作業項目トラッキング プラグインの taskxml 要素にアップロードします。
Team Foundation Server (TFS) プロセス テンプレートでは、複数の作業項目の種類の定義で参照される 2 種類のリンクが定義されます。 これらは、システム定義のリンクの種類を補完します。 詳細については、「リンクの種類要素のリファレンス」を参照してください。
リンクの種類の定義は、作業項目の種類の定義の前にアップロードする必要があります。 詳細については、「プラグイン ファイルのタスク グループとタスクの依存関係の定義」を参照してください。
チーム プロジェクトを作成したら、witadmin コマンド ライン ツールを使用してチーム プロジェクト コレクションのリンクの種類を追加、削除、および名前を変更し、内容を変更することができます。 詳細については、「リンクの種類の管理 [witadmin]」を参照してください。
リンクの種類の定義
リンクの種類の定義ごとに、LinkType 要素を使用して指定する必要があります。 また、各定義は、workitemlinktypedefinition-01.xsd ファイルで定義されたリンクの種類のスキーマ定義に従っている必要があります。 作業トラッキングのスキーマ ファイルは、Microsoft Web サイトの「Process Template and Work Item Schemas for Visual Studio Team Foundation (Visual Studio Team Foundation のプロセス テンプレート スキーマと作業項目スキーマ)」でダウンロードできます。
リンクの種類 TestedBy を定義する構文構造を次の例に示します。
<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
<LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>
LinkTypes フォルダー内で、リンクの種類の定義ファイルをカスタマイズまたは作成できます。 リンクの種類を定義する方法の詳細については、「ユーザー設定のリンクの種類の定義」を参照してください。
ページのトップへ
アップロードするリンクの種類の定義の指定
プロセス テンプレートにリンクの種類の定義をアップロードするには、taskxml 要素内で LINKTYPE 要素を指定します。 filename 属性は、リンクの種類の定義ファイルの相対パスを表します。 たとえば、次の構文では、TestedBy.xml ファイルがアップロードされるように指定しています。
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
次の例は、MSF for Agile Software Development v5.0 のプロセス テンプレートで定義される 2 つのリンクの種類を作成するタスクの指定方法を示しています。 これらのリンクの種類は、SharedStep と TestedBy です。
<task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
<taskXml>
<LINKTYPES>
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
</LINKTYPES>
</taskXml>
</task>
ページのトップへ
LINKTYPES 要素リファレンス
リンクの種類の定義のアップロードに使用する要素を次の表に示します。 作業項目トラッキング プラグイン ファイルの taskXml コンテナー要素内で、次の要素を指定します。
注意
アップロードするリンクの種類を定義するファイルを指定するには、LINKTYPE (作業項目トラッキング)) 要素を使用します。リンクの種類の名前の定義を指定するには、LinkType (定義) 要素を使用します。
要素 |
構文 |
説明 |
---|---|---|
LINKTYPE |
|
LINKTYPES の子要素です (必須)。 アップロードするリンクの種類の定義を含むファイルのパスとファイル名を指定します。 |
LINKTYPES |
|
作業項目トラッキング プラグインの子要素です (省略可能)。 アップロードする定義ファイルをそれぞれ指定する LINKTYPE 要素のコレクションを格納します。 |
参照
関連項目
概念
作業項目トラッキング プラグインを使用した作業項目を追跡するためのオブジェクトの定義