作業項目フィールドの定義と変更

作業項目フィールドは、作業項目の種類のデータの追跡、クエリのフィルター条件の定義、およびレポートの生成に使用します。 Team Foundation Server '(TFS) のコア システムのデータ フィールドを除き、追跡するすべてのデータ要素、ワークフローの定義に使用するデータ要素、作業項目の種類のフォームに表示するすべてのデータ要素は、作業項目フィールドとして定義する必要があります。 作業項目フィールドは、作業項目の種類の定義、またはグローバル ワークフロー内で定義できます。

作業項目フィールドは、チーム プロジェクト コレクションで保持されます。 フィールドを追加するには、次のいずれかの操作を実行します。

• チーム プロジェクトを作成する。 作業項目の種類またはグローバル ワークフローの定義内で定義されたすべてのフィールドと、選択されたプロセス テンプレートに対して定義されたすべてのフィールドが作成されます。 コア システムのフィールドは、チーム プロジェクトに対して定義されている作業項目の種類ごとに自動的に定義されます。 これらのフィールドの一覧については、「Visual Studio ALM の作業項目フィールド参照」を参照してください。

• 作業項目の種類の定義をインポートします。 作業項目の種類の定義内で定義されたすべての新しいフィールドが、コレクションに追加されます。 詳細については、「すべての WITD XML 要素のリファレンス」を参照してください。

• グローバル ワークフローの定義をインポートします。 グローバル ワークフロー内で定義されたすべての新しいフィールドが、コレクションに追加されます。 複数の作業項目の種類で共有する一連の作業項目フィールドを保持する場合は、グローバル ワークフローを定義します。 詳細については、「グローバル ワークフローのカスタマイズ」を参照してください。

• プロジェクト コレクションを Project Web App (PWA) のインスタンスにマップします。 Team Foundation Server Extensions for Project Server をインストールした後、Team Foundation のさまざまなコンポーネントをマップすることによって統合を構成します。 コレクションをマップする場合に、Project Server フィールドのいくつかのフィールドをサポートするグローバル ワークフロー定義がインポートされます。 詳細については、「データの同期をサポートするために TFS に追加された Project Server フィールド」を参照してください。

すべてのチーム プロジェクトに対する、すべての作業項目の種類とすべてのグローバル ワークフローで定義されたすべてのフィールドは、コレクションに対して定義されたすべてのフィールドを構成しています。 既存のフィールドの属性の変更、名前の変更、および削除を実行できます。 ただし、それらのフィールドに変更を加える場合は、多少の犠牲を払うことになります。 詳細については、「チームのプロセスをサポートするための作業トラッキング オブジェクトのカスタマイズ」を参照してください。

コレクションのフィールドを追加、またはカスタマイズするには、作業項目の種類またはグローバル ワークフローの定義の XML コンテンツを変更します。 各フィールドは、作業項目の種類またはグローバル ワークフローのいずれかの定義の FIELD セクション内にある FIELDS 要素を介して定義されます。 構造体とこれらのファイルの場所については、「すべての WITD XML 要素のリファレンス」と「グローバル ワークフローのカスタマイズ」を参照してください。

FIELD (定義) 構文構造

各 FIELD (定義) 要素には、表示名 (オプション) と必須の参照名があります。 参照名は、コレクション内で一意である必要があります。 詳細については、「作業項目トラッキング オブジェクトの名前付け規則」を参照してください。

フィールドの定義は、作業項目の種類の定義ファイル内で、以下の XML 構文によって行います。

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

詳細については、「FIELD (定義) 要素リファレンス」を参照してください。

データ型

フィールドの種類によって、フィールドに格納できるデータの種類とサイズが定義されます。 フィールドは、チーム プロジェクト コレクション内で定義されている 1 種類だけを指定できます。 この制約によって、組織は、プロジェクトおよび作業項目の種類にわたって共通のフィールドを使用できます。

サポートされるフィールドの種類を次の一覧に示します。

レポート可能な属性

フィールド値の中には、レポート用として特に役立つものがあります。 作業項目の種類の定義の言語を使用すると、次のオプションの属性を指定できます。

• reportable。 reportable 属性は、フィールドをレポートに含めるかどうか、およびフィールドをレポートに含める方法に応じて、None、Detail、Dimension、または Measure に設定します。 この属性に None 以外の値が指定されたフィールドのデータは、データ ウェアハウスにエクスポートされ、レポートに取り込むことができます。

  既存のフィールドを作業項目の種類に追加するときは、reportable 属性の現在の値が使用されます。 フィールドを作業項目の種類に追加すると、reportable 属性を使用することで明示的に指定しない限り、レポートが無効になります。

• reportingname。 レポートにデータを表示するときに使用されるフィールドに、別のラベルを割り当てます。 値を指定しなかった場合は、name 属性に割り当てられた表示名が使用されます。

• reportingrefname。 データがリレーショナル データ ウェアハウスにエクスポートされる際に使用されるフィールドには、別の参照名を割り当てます。 値を指定しない場合は、refname 属性に割り当てられた値が使用されます。

  この属性を使用して、レポートに含まれているフィールドを結合または分岐します。 別の参照名があり、かつ別のプロジェクト コレクションで定義された 2 つのフィールドを結合するには、両方のフィールドに同じ reportingrefname を割り当てる必要があります。 同じ参照名があり、かつ別のプロジェクト コレクションで定義された 2 つのフィールドを分岐するには、各フィールドに別の reportingrefname を割り当てる必要があります。

フィールドを定義した後、コマンド プロンプトで witadmin changefield コマンドを使用して refname 属性を除くすべての属性値を変更できます。

レポート用のフィールドにラベルを付けるベスト プラクティスについては、「レポート作成をサポートするための作業項目フィールドの追加および変更」を参照してください。

レポート可能な属性の値

次の表に示すように、reportable 属性には、none、dimension、detail および measure のいずれかの値を割り当てることができます。

レポートを指定する方法の例

Detail の例

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Dimension の例

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Measure の例

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

インデックス付きフィールド

witadmin indexfield コマンドを使用して、作業項目フィールドのインデックス作成を有効または無効にすることができます。 フィールドのインデックス作成を有効にすると、クエリでそのフィールドを指定する作業項目を検索するパフォーマンスが向上することがあります。 作業項目クエリの多くで使用するカスタム フィールドを追加した場合、そのフィールドのインデックス作成を有効にすることをお勧めします。 詳細については、「作業項目フィールドの管理 [witadmin]」を参照してください。

FIELD (定義) 子要素

作業項目フィールドに指定可能な多数のオプションの子要素があります。以下に例を示します。

• ヘルプ テキスト。 作業項目フォームのフィールドに表示されるツール ヒントまたはヘルプ情報を定義します (HELPTEXT)。

• フィールドの制限。 フィールドを、必須、読み取り専用、空、固定、特定のパターン一致として指定します (REQUIRED、READONLY、EMPTY、FROZEN、MATCH)。

• フィールド値の自動設定。 フィールドの値を指定します (DEFAULT、COPY、SERVERDEFAULT)。

• フィールドの一覧。 許可値、推奨値、または禁止値を指定します。 (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• フィールド条件。 別のフィールドが変更された場合、変更されない場合、特定の値の場合、特定の値ではない場合、または他の条件の場合にフィールドに適用される 1 つ以上の規則を指定します (WHEN、WHENNOT、WHENCHANGED、WHENNOTCHANGED、CANNOTLOSEVALUE、 NOTSAMEAS)。

詳細については、「すべての FIELD XML 要素のリファレンス」を参照してください。

システム フィールドと定義済みフィールド

システム定義のすべてのフィールドには、"System" で始まる参照名が指定されます。たとえば、System.AreaPath、System.AssignedTo というパターンで続きます。

TFS が提供する既定のプロセス テンプレートにより定義される定義済みフィールドは、Microsoft.VSTS で始まり、その後は用途により異なります。 共通で使用される定義済みフィールド、スケジューリング目的で使用されて Microsoft Project と統合される定義済みフィールド、Team Foundation ビルドと統合される定義済みフィールド、および Team Foundation と統合される定義済みフィールドの例は以下のとおりです。

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

TFS が提供する既定のプロセス テンプレートに対して定義されるすべてのシステム フィールドおよび定義済みフィールドの概要については、「Visual Studio ALM の作業項目フィールド参照」を参照してください。 フィールド名の指定方法の詳細については、「作業項目トラッキング オブジェクトの名前付け規則」を参照してください。

非表示の変更できない属性および作業項目フィールド エクスプローラー

作業項目フィールドの変更できる属性に加えて、各フィールドには変更できず、事実上、非表示の属性が数多く存在します。 作業項目フィールド エクスプローラー ツールを使用して、これらのフィールドの割り当てを参照することができます。 作業項目フィールド エクスプローラーには、パワー ツールであるプロセス エディターからアクセスします。

作業項目フィールド エクスプローラー

参照

関連項目

作業項目フィールドの管理 [witadmin]

概念

レポート作成をサポートするための作業項目フィールドの追加および変更

すべての FIELD XML 要素のリファレンス

その他の技術情報

クエリ、レポート、ワークフローをサポートするフィールドの変更または変更