作業項目フィールドの定義
作業項目フィールドは、作業項目の種類のデータの追跡、クエリの条件の定義、およびレポートのデザインに使用します。作業項目の種類に対して定義されている作業項目フィールドの使用方法のカスタマイズや、追跡データの追加要件をサポートするフィールドの作成ができます。Team Foundation Serverの既定のプロセス テンプレート内で定義されるフィールドのインデックスに Visual Studio ALM の作業項目フィールド参照を参照してください。
次のような理由で、作業項目フィールドをカスタマイズする場合があります。
チームの名前付け規則に合致させるためにフィールド ラベルを変更する。
フィールドの属性を追加または変更する。
既定値を指定したり、ユーザーごとに設定できるフィールドの値を制御する。
フィールドを変更できるユーザーを制限する。
チームのプロセスまたは追跡要件に固有のデータをキャプチャするフィールドを追加する。
選択リストを定義またはカスタマイズする。
選択リストをグローバル リストで置き換えて、グループ間の一貫性をサポートし、保守を容易にする。
作業項目フォームでは、フィールドを使用してデータを表示し、ユーザーがデータ入力とオプション選択を実行できるようにしています。作業項目フォームのフィールドの外観と動作は、作業項目の種類の定義に目的のフィールドを定義することによって制御できます。
作業項目の種類の定義では、名前、参照名、および種類を指定することによってフィールドを定義します。フィールドに対して、ヘルプ テキストの設定、規則の順守、および特定のレポート動作の実行を定義することもできます。チーム プロジェクトまたはコレクションに定義される作業項目のすべての種類に適用されるフィールドは、グローバル ワークフローを使用して定義できます。グローバル ワークフローを使用すると、チーム プロジェクトまたはコレクションのすべての作業項目の種類に影響するフィールド規則を定義および更新できます。
作業項目フィールドは、チーム プロジェクト コレクションで保持されます。既存のフィールドの属性の変更、名前の変更、および削除を実行できます。
FIELD 要素の構文
フィールドは、次の構文構造と属性により定義されます。
<FIELD name="field display name" refname="field reference name" type="String | Integer |
Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportable="Dimension | Detail | Measure" formula="sum"
indexable="true | false" >
</FIELD>
属性の指定については、次の情報に注意してください。
フィールドに対して、異なる作業項目の定義で異なる名前を指定できます。すべてのフィールド データは、参照名に基づいて追跡されます。
型属性は、フィールドのデータ型を指定します。各データ型の詳細については、「作業項目フィールドの使用」を参照してください。特定のフィールド型を表示するコントロールについては、「作業項目フォーム上のコントロールの指定」を参照してください。
個人名を格納するために使用される文字列フィールドは、syncnamechanges 属性を true に設定する必要があります。この設定により、Active Directory またはワークグループ内の個人名に変更が加えられると、フィールドの内容が更新される必要があることが示されます。
Reportable 属性に Detail、Dimension、または Measure の値が割り当てられているフィールドは、データ ウェアハウスで追跡されます。詳細については、「作業項目フィールドの使用」を参照してください。
クエリの実行パフォーマンスを向上させるには、フィルター条件に指定されているフィールドの Indexable 属性を True に設定します。は、の作業項目クエリの多くで使用するカスタム フィールドを追加した場合、そのフィールドのインデックス作成を有効にすることもあります。
witadmin コマンド ライン ツールを使用すると、システム フィールドを除く任意のフィールドに対して、フィールド名、および Reportable 属性と Indexable 属性の割り当てを変更できます。詳細については、「作業項目フィールドの管理 [witadmin]」を参照してください。
ページのトップへ
一般的なタスク
タスク |
関連トピック |
|---|---|
指定できるフィールドの種類とフィールド属性について理解する。テキスト、数字、HTML コンテンツなど、特定の種類のデータを格納するフィールドを定義できます。レポート作成やクエリのためにデータ フィールドを使用する方法に応じて、追加の属性を設定できます。 |
|
FIELD (定義) 要素の構文を検索する。FIELD (定義) 要素を使用して、作業項目フィールドを定義します。1 つまたは複数の子要素を使用して、フィールドの動作の指定、既定値の定義、値の選択リストの定義などを実行できます。フィールド規則要素を結合できます。ほとんどの規則は、特定のユーザーやグループに適用したり、特定のユーザーやグループで無視するようにすることができます。 |
|
追跡プロセスで特定のアクションを実行するフィールドを指定する。Team Foundation は、作業項目のすべての種類を追跡するために使用できるシステム フィールドを管理します。これ以外のすべてのフィールドは、作業項目の種類の定義によってチーム プロジェクト コレクションに追加されます。作業項目の種類は、作成されたチーム プロジェクトのプロセス テンプレートで指定されます。作業項目の種類をチーム プロジェクトへ後でインポートすることもできます。 最適な結果を得るには、既に使用されているフィールドがプロジェクトの追跡のニーズを満たしている場合は、そのフィールドを指定することをお勧めします。 |
|
フィールド値の動作、既定値または条件を指定する。フィールド規則を設定することにより、フィールド値の動作と制約を定義できます。フィールド規則は、追加の要素として FIELD 要素コンテナー内に記述します。フィールド、状態、遷移、理由またはグローバル ワークフローについて、フィールド規則を定義できます。 |
|
リスト項目を定義し、これらの項目に対する条件をオプションで設定する。フィールド リストを使用して、許可値、推奨値、または禁止値のセットを列挙します。また、すべての種類の作業項目のグローバル リストを定義することもできます。 |
ページのトップへ
関連タスク
タスク |
関連トピック |
|---|---|
フィールドおよびその他の作業項目トラッキング オブジェクトの名前付けに関する制限を理解する。すべての作業項目トラッキング オブジェクトに対して表示名を指定できます。一部のオブジェクトについては、参照名も指定する必要があります。どちらの種類の名前も、オブジェクトの種類に基づいて定義されている要件を満たす必要があります。 |
|
フィールドを追加するか、既存のフィールドのレポート属性を変更する。レポートの作成をサポートするには、フィールドを新規に追加するか、または既存のフィールドの属性を変更します。フィールドを追加または変更するときは、系統的な名前を付けて Analysis Services キューブのフィールドを検索できるようにします。これは、フォルダー内でフィールドが論理的にグループ化されるためです。 |
|
プロジェクトまたはコレクションのすべての種類の作業項目で使用されるフィールドまたはリストを定義します。グローバル ワークフローの一部として定義することにより、フィールドおよび列挙リストの定義と更新を行うことができます。 |
|
ワークフローを制御する状態または遷移を追加、削除、または変更する。ワークフローは、その初期状態、有効な状態、それらの状態間の有効な遷移、およびその遷移を実行できるアクセス許可を持つユーザーまたはグループを定義することによって制御できます。作業項目の種類の WORKFLOW セクションによって、作業項目の追跡方法が制御されます。 |
|
作業項目の種類に対応する作業項目フォームを変更およびカスタマイズする。作業項目の種類の定義の FORM セクションを使用して、作業項目の種類でのユーザー インターフェイス要素の表示方法を制御できます。作業項目の各種類に対し、1 つのフォームを必ず対応付ける必要があります。タブ、フィールド、およびグループをすべて含めた、フォーム全体を定義します。 |
ページのトップへ
参照
概念
Visual Studio ALM のレポート可能フィールド参照
Visual Studio ALM の作業項目フィールド参照