すべての WITD XML 要素のリファレンス
プロジェクト追跡の要件に対応するように、既存の作業項目の種類 (WIT) をカスタマイズするか、新しい WIT を作成できます。 WIT (バグ、要件、リスクなど) では、チーム プロジェクトで追跡される作業項目のフィールド、規則、ワークフロー状態、および遷移が定義されます。 チーム プロジェクトは、Visual Studio Online またはオンプレミスの Team Foundation Server (TFS) で作成します。
WIT の各定義におけるルート要素は、WITD 要素で、これには WORKITEMTYPE 要素が 1 つだけ定義されている必要があります。 WIT の名前は、チーム プロジェクト内において一意である必要があり、各種類の名前は Unicode 文字で最大 128 文字までにする必要があります。
WIT 定義をカスタマイズまたは作成するには、種類の定義 XML ファイルを変更します。 WIT のスコープは、プロジェクト コレクション内のチーム プロジェクトです。
WITD の構文構造
次の例は、WIT 定義の高レベルな構造を示しています。
<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
<WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
<DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
<GLOBALLISTS> . . . </GLOBALLISTS>
<FIELDS> . . . </FIELDS>
<WORKFLOW> . . . </WORKFLOW>
<FORM> . . . </FORM>
</WORKITEMTYPE>
</witd:WITD>
WITD 子要素
次の表では、上の例で使用されている構造体要素について説明します。
要素 |
説明 |
|---|---|
WITD |
WIT 定義全体は、タグ WITD でラップします。 アプリケーション名には、任意の名前を使用できます。 バージョンは、あるリリースから次のリリースまでに変更される可能性のある WIT のスキーマを識別します。 "1.0" を使用します。 |
WORKITEMTYPE |
WIT の名前は、特定のチーム プロジェクト内で一意である必要があります。 実行時には、この要素により指定された名前を使用します。 たとえば、名前はメニュー オプションとして表示できます。 この場合、ユーザーは、[新しい作業項目] メニューの [バグ] を選択できます。 表示名: この名前は、作業項目クエリのドロップダウン メニューに表示されます。 表示名は、チーム プロジェクト内で定義されるすべての WIT の名前の間で一意である必要があります。 名前は、英数字、アンダースコア、およびハイフンで構成する 128 文字以内の Unicode 文字で指定します。 参照名: この名前は、英数字、アンダースコア、およびハイフンで構成する 70 文字以内の Unicode 文字で指定します。 参照名には少なくとも 1 つのピリオド (.) が必要ですが、名前の先頭と末尾にはピリオドは使用できません。 また、参照名の先頭には、数字およびアンダースコアは使用できません。さらに参照名では、複数のハイフンを (--) のように連続して使用することはできません。 予約されたシステムと重複する名前を指定しないでください。 XXX および Microsoft。 XXX 名前空間。 「作業項目トラッキング オブジェクトの名前付け規則」を参照してください。 |
説明 |
定義する作業項目の種類について説明する文字列を指定します。 この説明は、WIT をカスタマイズするユーザーにとって役立ちます。 注意 説明は XML 定義内でのみ参照できます。説明はユーザー インターフェイスには表示できず、System.Definition フィールドとも関係しません。 定義する作業項目の種類について説明するテキスト文字列を指定します。 |
GLOBALLISTS |
WIT により使用されるグローバル リストの定義が含まれます。 グローバル リストを使用して、チーム プロジェクト コレクションに対して定義された複数の WIT 間で選択リストを共有します。 グローバル リストを使用すると、グループ間のコラボレーションがサポートされ、保守が容易になります。 |
FIELDS |
WIT のデータを追跡するために使用するすべてのフィールドを定義します。FIELDS 要素内では、データを追跡するために使用するすべてのフィールドを定義します。 これには、クエリの実行とレポートの生成に使用するフィールドが含まれます。 |
WORKFLOW |
新しい状態から終了または完了の状態に移動するときに、作業項目の状態を追跡するのに役立つワークフロー要素を定義します。 この要素には、ワークフローを定義する STATE 要素と TRANSITION 要素のセットが含まれます。 ワークフローとは、ある状態から別の状態への有効な遷移と、各遷移に関連付けられた特定の条件のセットです。 |
FORM |
フォームに表示されるフィールドとコントロール、およびその順序を定義することで、作業項目フォームのデザインを指定します。 LAYOUT、CONTROL、GROUP、TAB、TABGROUP、SPLITTER、およびその他の要素が含まれます。 |
プロセス テンプレートの作業項目の種類
TFS のインスタンスをインストールまたはアップグレードするときに、既定のプロセス テンプレートが次のディレクトリにダウンロードされます。
%programfiles%/Microsoft Team Foundation Server 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033
WIT 定義ファイルは、WorkItem Tracking\TypeDefinitions フォルダーに格納されます。
WIT を作成またはカスタマイズする方法の詳細については、「チームのプロセスをサポートするための作業トラッキング オブジェクトのカスタマイズ」を参照してください。 プロセス テンプレートに新しい WIT を追加する方法の詳細については、 「プロセス テンプレートへの作業項目の種類定義の追加」を参照してください。
参照
概念
チームのプロセスをサポートするための作業トラッキング オブジェクトのカスタマイズ