作業項目フォームのレイアウトの修正

[アーティクル]
08/09/2011

XML ファイルをエクスポートし、FORM セクションの内容を変更することで、作業項目フォームのレイアウトを変更できます。 XML ファイルを変更し、インポートした後、更新された作業項目の種類で行われた変更を確認できます。レイアウト変更の対象となる種類の一部を次に示します。

フォーム上のフィールドのラベルまたは配置を変更する
フィールドのグループを別のタブに移動する
新しいタブまたは列を追加する

作業項目フォームに配置できるコントロールの概要については、「作業項目フォーム上のコントロールの指定」を参照してください。 FORM セクションの最上位の構造体要素の概要については、次を参照してください。作業項目フォームのレイアウトのデザイン.

このトピックの内容

作業項目の種類の定義ファイルをエクスポートして開く
定義ファイルの FORM セクションのレイアウトを変更する
変更が作業項目フォームに表示されていることを確認する

必要なアクセス許可

この手順を実行するには、Team Foundation 管理者グループのメンバーであるか、またはプロジェクトのプロジェクト管理者グループのメンバーである必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。

作業項目の種類の定義ファイルをエクスポートして開く

作業項目の種類の定義ファイルをエクスポートして開くには

行っているカスタマイズの範囲に基づいて、次のいずれかの手順を実行します。

単一のプロジェクトの作業項目の種類を変更する場合:
1. witadmin exportwitd を実行して、変更する作業項目の種類の XML ファイルをエクスポートします。詳細については、「作業項目の種類のカスタマイズと管理 [witadmin]」を参照してください。
  
  注意
  
  Windows Vista を実行している場合、アクセス権を持たないフォルダーが存在する可能性があります。アクセス権のない場所に作業項目の種類をエクスポートしようとすると、レジストリ仮想化テクノロジが、自動的にエクスポートされたファイルをリダイレクトし、仮想ストアに保存します。このリダイレクトが行われないようにするには、アクセス権のある場所にファイルをエクスポートします。レジストリの仮想化の詳細については、Microsoft Web サイトの「Registry Virtualization (レジストリの仮想化)」および「Windows Vista のファイルおよびレジストリの仮想化に関する一般的な問題」を参照してください。
2. Visual Studio の [ファイル] をクリックし、[開く] をクリックして、[ファイル] をクリックします。
3. [ファイルを開く] ダイアログボックスが表示されます。
4. [探す場所] で、ファイルをエクスポートした場所に移動します。
作業項目の種類を変更してプロセステンプレートをカスタマイズする場合:
1. プロセステンプレートをダウンロードした場所に移動します。
2. 更新する作業項目の種類の XML ファイルを選択し、[開く] をクリックします。改行コードに関する質問が表示されたら、[いいえ] をクリックします。

ページのトップへ

定義ファイルの FORM セクションのレイアウトを変更する

フォームレイアウトを変更するには

XML ファイルの <TabGroup> セクションを探します。 Links や File Attachments などの項目に対して <Tab> 要素があることを確認します。各 <Tab> 要素には、対応するコントロールを表示する <Control> 要素が含まれます。
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```
2 つの <Tab> 要素をマージして、両方のコントロールを含む Links and Attachments という単一の <Tab> 要素にするために、前の手順で示した XML を次の例に示す新しい XML で置き換えます。
```
<Tab Label="Links and Attachments">
  <Control Type="LinksControl" Label="Links" LabelPosition="Top" />
  <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />
</Tab>
```
Classification グループなどの変更対象のグループが定義されている <FORM>、<Layout> セクションを探します。
```
<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  </Column>
</Group>
```
注意

最適な結果を得るには、すべてのコントロールまたはグループを 1 つの列に表示する必要があります。その場合、その列がフォームの幅全体に広がることもあります。また、すべての列を 1 つのグループとして表示する必要があります。その場合、そのグループに表示されるラベルまたは境界がないこともあります。

次の例で太字で強調されている行を選択し、[編集] メニューの [コピー] をクリックして、この内容を後で使用できるようにクリップボードにコピーします。

  <Column PercentWidth="70">
    <Group>
      <Column PercentWidth="100">
        <Group Label="Classification">
          <Column PercentWidth="100">
            <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
            <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
          </Column>
        </Group>
      </Column>
    </Group>
  </Column>

次の XML で太字で示されている行を削除して、フォームの現在の位置から Classification グループを削除します。

<Layout>
  <Group>
    <Column PercentWidth="70">
      <Control Type="FieldControl" FieldName="System.Title" Label="&amp;Title:" LabelPosition="Left" />
    </Column>
    <Column PercentWidth="30">
      <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&amp;Discipline:" LabelPosition="Left" />
    </Column>
  </Group>
  <Group Label="Classification">
    <Column PercentWidth="100">
      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&amp;Area:" LabelPosition="Left" />
      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&amp;Iteration:" LabelPosition="Left" />
    </Column>
  </Group>

<TabGroup> セクションで、[Details] タブが定義されている次の行を探します。

<Tab Label="Details">
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.TaskHierarchy" Label="Task C&amp;ontext:" LabelPosition="Left" ReadOnly="True" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group Label="Schedule">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StartDate" Label="Start Dat&amp;e:" LabelPosition="Left" ReadOnly="True" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.FinishDate" Label="&amp;Finish Date:" LabelPosition="Left" ReadOnly="True" />
        </Column>
      </Group>
    </Column>
  </Group>
</Tab>

クリップボードの内容を次の場所に貼り付けて、これらのコントロールを [詳細] タブに移動します。

<Tab Label="Details">
  <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
  <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
...

次の例の太字で示されている変更を行って、移動したフィールドを囲むグループを作成し、フィールドを 2 つの列に分割します。

<Tab Label="Details">
  <Group Label="Classification">
    <Column PercentWidth="50">
      <Group>
        <Column PercentWidth="100">
          <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
          <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group>
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
  </Group>
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
...

ツールバーの [上書き保存] をクリックして、XML ファイルへの変更を保存します。
新しい作業項目の種類を単一のプロジェクトにインポートする方法については、「作業項目の種類のカスタマイズと管理 [witadmin]」を参照してください。作業項目の種類をプロセステンプレートに追加するには、「プロセステンプレートへの作業項目の種類定義の追加」を参照してください。

ページのトップへ

作業項目フォームでの Web ページまたは HTML コンテンツの表示の確認

1 つのプロジェクトにインポートされた変更を検証するには

チームエクスプローラーで、[最新の情報に更新] をクリックして、サーバーから最新の更新をダウンロードします。

これらの更新には、インポートした変更内容が含まれています。 [作業項目] ノードが読み込まれるまで数秒待ちます。読み込み中のノードには、"処理中" と表示されます。
変更した作業項目の種類を使用して、新しい作業項目を作成します。これを行うには、[作業項目] ノードを右クリックし、[作業項目の追加] をポイントして、作業項目の種類をクリックします。

この作業項目は、変更した作業項目の種類から作成されます。

Classification グループがメインフォームに存在しなくなったことに注意してください。 [Links and Attachments] タブと [Details] タブをクリックして、変更の結果を確認します。
[閉じる] をクリックして、新しい作業項目を閉じます。作業項目を保存するかどうかを確認するメッセージが表示されたら、[いいえ] をクリックします。

ページのトップへ

参照

作業項目フォームのレイアウトの修正

作業項目の種類の定義ファイルをエクスポートして開く

作業項目の種類の定義ファイルをエクスポートして開くには

定義ファイルの FORM セクションのレイアウトを変更する

フォーム レイアウトを変更するには

作業項目フォームでの Web ページまたは HTML コンテンツの表示の確認

1 つのプロジェクトにインポートされた変更を検証するには

参照

処理手順

参照

概念

その他の技術情報

その他のリソース

フォームレイアウトを変更するには