作業項目フォームに Web コンテンツを追加するための WIT 定義の編集

[アーティクル]
09/12/2015

作業項目フォームに Web コンテンツまたは HTML コンテンツを追加するには、種類の定義 XML ファイルをエクスポートし、WebpageControl セクションに FORM を追加します。 XML ファイルを変更し、インポートした後、更新された作業項目の種類の Web コンテンツの表示を確認できます。

次のいずれかの方法で、表示する Web コンテンツを指定できます。

Web ページの URL
作業項目に対して定義されている 1 つ以上のフィールド値に基づいて実行時に動的に決定される URL パス
HTML コンテンツ

作業項目の種類 (WIT) への Web コンテンツの追加に使用する要素の構文構造については、「WebpageControlOptions XML 要素のリファレンス」および「Link および Param XML 要素のリファレンス」を参照してください。

必要条件

対象チームプロジェクトのプロジェクト管理者グループのメンバーでなければなりません。「チームプロジェクトへのユーザーの追加」を参照してください。

WIT 定義ファイルをエクスポートして開く

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

単一のプロジェクトの作業項目の種類を変更する場合:
1. witadmin exportwitd を実行して、変更する作業項目の種類の XML ファイルをエクスポートします。詳細については、「作業項目の種類のインポート、エクスポート、および管理 [witadmin]」を参照してください。
2. Visual Studio で [ファイル]、[開く]、[ファイル] の順にクリックします。
3. [探す場所] で、ファイルをエクスポートした場所に移動します。
作業項目の種類を変更してプロセステンプレートをカスタマイズする場合:
1. プロセステンプレートをダウンロードした場所を検索します。
2. 更新する作業項目の種類の XML ファイルを選択し、[開く] をクリックします。改行コードに関する質問が表示されたら、[いいえ] をクリックします。

定義ファイルの FORM セクションに Web コンテンツを追加します

XML ファイルの <TabGroup> セクションを探します。 Links や File Attachments などの項目に対して <Tab> 要素があることを確認します。各 <Tab> 要素には、対応するコントロールを表示する <Control> 要素が含まれます。
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

作業項目フォームに表示する Web コンテンツまたは HTML コンテンツを格納する新しい <Tab> 要素を追加します。 Web コンテンツの定義方法に基づいて、ファイルの <TabGroup> セクションに次のコードをコピーします。

Web ページの URL を指定するには:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Tab Label および URL of Web Page を、作業項目フォームに表示する情報に置き換えます。

実行時に決定される動的な URL を指定するには:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" URLPath="URL path with parameters >
      <Param Index="0" Value="Param Value 0"/>
      <Param Index="1" Value="Param Value 1"/>
      <Param Index="2" Value="Param Value 2"/>
               </Link>
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Tab Label、URL of Web Page、URL path with parameters、Param Value 1、2、3 を、作業項目フォームに表示する情報に置き換えます。

HTML コンテンツを指定するには:
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
Tab Label および HTML Content を、作業項目フォームに表示する情報の置き換えます。

注意

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

変更内容を XML ファイルに保存します。
witadmin importwitdを使用して新しい作業項目の種類を単一のプロジェクトにインポートします。作業項目の種類をプロセステンプレートに追加するには、「プロセステンプレートへの作業項目の種類定義の追加」を参照してください。

フォームで Web ページまたは HTML コンテンツの表示を確認する

チームエクスプローラーで、変更した WIT の定義を含むチームプロジェクトの作業項目を開き、 [最新の情報に更新] をクリックします。

先ほどインポートした変更を含む、最新の更新情報がサーバーからダウンロードされます。 [作業項目] ノードが最新の情報に更新されるまで数秒待ちます。読み込み中のノードには、"処理中" と表示されます。
変更した WIT を使って、作業項目を作成します。

フォームに、Web ページまたは HTML コンテンツが想定どおりに表示されることを確認します。
[閉じる] をクリックして、新しい作業項目を閉じます。

参照

概念

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

次の方法で共有

作業項目フォームに Web コンテンツを追加するための WIT 定義の編集

WIT 定義ファイルをエクスポートして開く

定義ファイルの FORM セクションに Web コンテンツを追加します

フォームで Web ページまたは HTML コンテンツの表示を確認する

参照

関連項目

概念

その他のリソース