作業項目フィールドの表示の制御

作業項目フォームでは、テキスト ボックスのラベル名、位置、およびサイズを制御できます。また、プレーンテキスト、整数、数値、日付、ツリー パスの各データ型の作業項目フィールドのその他の表示コントロールのラベル名、位置、およびサイズを制御できます。 これらのフィールドを表示するには、次の選択肢の中から適切な Control 要素を選択し、その Type 属性を指定する必要があります。

• DateTimeControl: データ型が DateTime である書式設定された日付フィールドを表示する際に使用します。

• FieldControl: プレーンテキスト フィールドおよび数値フィールドを表示する際に使用します。また、データ型が String、Identity、Integer、Double、または PlainText であるフィールドの値リストを表示する際にも使用します。

• HtmlFieldControl: データ型が HTML である複数行のリッチ テキスト形式フィールドを表示する際に使用します。

• WorkItemClassificationControl: データ型が TreePath である階層パス フィールドを表示する際に使用します。

その他の Type コントロールの詳細については、次のトピックを参照してください。

• 作業項目フォーム上のコントロールの指定

• 作業項目フォーム上の Web ページへのヘルプ テキスト、プロセス ガイダンス、Web コンテンツ、およびリンクの追加

• リンク コントロールの定義とリンク関係の制限

• 添付ファイル コントロールの追加

このトピックの内容

• データ フィールドのサイズと表示の制御

• フィールドにラベルを付け、また、フォーム上の 2 か所にフィールドを追加する

• フィールドを読み取り専用にする

• プレーンテキスト フィールドおよび数値フィールドを追加する

• 書式設定されたテキスト フィールドを追加する

• 日付フィールドまたはカレンダー フィールドを追加する

• 区分パスおよびイテレーション パスに対するフィールドを追加する

データ フィールドのサイズと表示の制御

各データ フィールドのスペーシングおよびサイズを制御するには、次の表に示すオプションの属性を使用します。

フィールドにラベルを付け、また、フォーム上の 2 か所にフィールドを追加する

フォーム上の各コントロールに対して、オプションのラベルとその位置を設定できます。設定するには、Label 属性および LabelPosition 属性を使用します。 FIELD 要素で設定されている表示名と異なる名前を設定することもできます。 ラベルを指定しなかった場合、表示名が使用されます。 チーム メンバーがクエリを実行して作業項目を検索するときは、必ず表示名が使用される点に注意してください。 ラベルの最大サイズは 80 文字です。

フォーム上の複数の領域 (例: フォーム上端およびプロパティ ページ上) に同じフィールドを追加するには、Name 属性を使用します。 Name 属性は単に、そのコントロールがフォーム上の他のコントロールと異なることを示します。

フィールドを読み取り専用にする

フィールドを読み取り専用にする方法は 2 とおりあります。 1 つ目の方法では、READONLY 要素を、種類を定義する FIELDS セクションの FIELD 要素の子要素として追加します。 READONLY 要素を使用することにより、特定のユーザーがそのフィールド値を修正できるかどうかを指定できます。 次の例では、プログラム マネージャーのみが Sub-Title フィールドを修正できます。

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

2 つ目の方法では、CONTROL 要素に対して ReadOnly 属性を指定します。 この方法では、すべてのユーザーがフィールドを編集できなくなります。

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

プレーンテキスト フィールドおよび数値フィールドを追加する

プレーンテキスト フィールドおよび数値フィールドをフォームに追加するには、FieldControl 型を使用します。 この属性は、選択リスト、人名表示用フィールド (例: Assigned To フィールド、Owner フィールド)、整数表示用フィールド、および実数表示用フィールドを追加する際にも使用されます。 フィールド コントロールでは、参照名でフィールドを参照する必要があります。 フィールド ラベルには、プレーンテキスト、またはハイパーリンクのスタイルを指定できます。 詳細については、「作業項目フォーム上の Web ページへのヘルプ テキスト、プロセス ガイダンス、Web コンテンツ、およびリンクの追加」を参照してください。

テキスト フィールド、整数フィールド、および選択リスト フィールド

数値フィールドの形式、および、テキスト フィールドまたは数値フィールドに入力できる最大文字数を制御するには、次の表に示すオプションの属性を使用します。

次のコードは、前の図に表示されるフィールドのグループを作成します。

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

書式設定されたテキスト フィールドを追加する

HTMLFieldControl 型を使用することにより、データ型が HTML であるフィールドを追加できます。 このコントロールは、複数行の書式付きテキストの表示をサポートします。

HTML フィールド

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" Dock="Left" MinimumSize="100,500" />

日付フィールドまたはカレンダー フィールドを追加する

DateTimeControl 型を使用することにより、カレンダー選択ツールを表示できます。ユーザーはこのカレンダー選択ツールで、DateTime フィールドに入力する日付を選択できます。 このコントロールによって、フィールドの日付と時刻をすばやく選択できます。

カレンダー フィールド (Format="Short" と指定した場合)

たとえば、将来の開始希望日または確認希望日を次のように指定できます。

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" Format="Time" />

DateTime フィールドの形式を制御するには、次の表に示すオプションの属性を使用します。

区分パスおよびイテレーション パスに対するフィールドを追加する

WorkItemClassificationControl 型を使用することにより、データ型が TreePath であるフィールドを追加できます。 このコントロールを使用した場合、区分パス フィールドおよびイテレーション パス フィールドを階層型ツリー形式で表示できます。 ツリーで表示される階層ノードは、展開および縮小できます。

<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />

詳細については、「区分およびイテレーションの作成および修正」を参照してください。

参照

その他の技術情報

作業項目フィールドの追加および修正とレポート作成

作業項目フォーム上の Web ページへのヘルプ テキスト、プロセス ガイダンス、Web コンテンツ、およびリンクの追加

添付ファイル コントロールの追加

リンク コントロールの定義とリンク関係の制限

作業項目フォームのデザインとカスタマイズ