作業項目フォーム上の Web ページへのヘルプ テキスト、プロセス ガイダンス、Web コンテンツ、およびリンクの追加
作業項目フォームをカスタマイズするときは、チームがフォーム内のフィールドを定義するのに役立てるため、コンテンツに情報またはリンクを設定できます。情報をフォームに配置するか、使用できるを簡単にすると、チーム メンバーは有用なデータをより的確に追跡できます。
このトピックで説明しているフォーム コントロールを使用して、フィールドごとのツールヒント テキスト、スタンドアロン テキスト、Web ページへのハイパーリンク、埋め込みの HTML コンテンツ、Web コンテンツをフォームに追加できます。
作業項目の種類の定義を変更して、作業項目フォームを変更します。witadmin のコマンド ライン ツールを使用して 作業項目の種類のカスタマイズおよび管理 [witadmin]、またはプロセス エディターが表示されます。
プロセス エディターには、をダウンロードしてインストールできる Visual Studio のパワー ツールのアドインです。ツールのメニューの下にあるをクリックし、プロセス エディターが Team Foundation Server でカスタマイズするためのグラフィカル ユーザー インターフェイスを使用した作業項目の追跡するオブジェクトを提供します。インポート、作業項目の種類をエクスポートし、定義を変更するには、このツールを使用できます。詳細については、Microsoft Web サイトの次のページを参照: Team Foundation Server のパワー ツール[.]
ヘルプ テキストまたはツールヒント テキストを指定します。
ヘルプ テキストは、2 つの方法のいずれかで提供できます。1 つ目の方法では、HELPTEXT 要素を、種類を定義する FIELDS セクションの FIELD 要素の子要素として追加します。HELPTEXT を使用して、フィールドごとのツール ヒントを作成します。この方法で設定できるのは最大で 255 文字です。
<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>
2 つ目の方法では、LabelText 子要素と Text 子要素を使用して、スタンドアロン テキストを指定します。この方法では、情報を必要なだけ追加できるうえに、テキストを常にフォーム上に表示できます。ユーザー操作は必要ありません。次の例に示すように Link 要素を使用してオプションのリンクを追加することで、詳細情報を提供することもできます。
<Control FieldName=" ACME.ACE.ImpactStatement" Type="HTMLControl" Label="Impact" LabelPosition="Left">
<LabelText>
<Text>Provide information about the impact to the ACE organization. Specifically address the following: customer segment, target strategic opportunity, resources required, and time dependencies. For more detailed information, see the Impact Statement specification at:
<Link OpenInNewWindow="true" UrlRoot=http://ACE.ImpactStatement.aspx />
</Text>
</LabelText>
</Control>
スタンドアロン テキストとハイパーリンクのフィールド ラベルを追加します。
Control 要素の Type 属性の LabelControl オプションを使用して、作業項目フィールドに関連付けられていない作業項目フォームにテキストを追加できます。テキストは、プレーンテキストでもハイパーリンクでもかまいません。また、FieldControl オプションを使用して、追加されたフィールド ラベルにハイパーリンクを添付できます。
.gif "Ff731584.collapse_all(ja-jp,VS.110).gif")
例: プレーンテキストのラベル
次の例では、"Fill in the details of the bug here.Fields that are not required are recommended to be filled in." というプレーンテキストを作業項目フィールドに追加します。
<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />
例: ハイパーリンクのフィールド ラベル
フィールド ラベルにハイパーリンクを追加する方法を次の例に示します。
<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
<LabelText>
<Text>
<Link UrlRoot="http://www.live.com/" />
Title 2
</Text>
</LabelText>
</Control>
[!メモ]
Team Foundation クライアントが最新バージョンにアップグレードされていない場合、Label 属性のテキストが表示されます。Visual Studio 2012 クライアントの場合、Text タグは、Link タグで定義された URL でハイパーリンクとして表示されます。
例: テキストの一部にハイパーリンクを含むフィールド ラベル
フィールド ラベルの一部にハイパーリンクを追加する方法を次の例に示します。この例では、URL が、特定の作業項目に基づいて Param 要素に割り当てられてた値で決定されます。
<Control Type="FieldControl" FieldName="System.IterationPath">
<LabelText LabelPosition="Left">
<Text>
<Link UrlRoot="@ProcessGuidance" UrlPath="{0}.html">
<Param Index="0" vValue"System.WorkItemType"/> </Link>
Iteration Path
</Text>
<Text> (must be 3 levels deep)</Text>
</LabelText>
</Control>
例: ハイパーリンクのテキスト ラベル
ハイパーリンクのテキスト ラベル
.png "スタンドアロン ラベルに適用したハイパーリンクの例")
次の例では、作業項目フォームに表示されるテキストにハイパーリンクを追加する方法を示します。
<Group>
<Column PercentWidth="100">
<!-- Standalone label control 2 -->
<Control Type="LabelControl" Label="How do I use this work item?">
<Link UrlRoot="http://www.live.com"></Link>
</Control>
</Column>
</Group>
例: 単一ラベル内でのテキストとハイパーリンクをまとめること
単一ラベル内でのテキストとハイパーリンクの結合
.png "テキストに適用した 2 つのハイパーリンクの例")
次の例では、作業項目フォームのラベルの一部に 2 つのハイパーリンクを追加する方法を示します。
<Group>
<Column PercentWidth="100">
<!-- Standalone label control 3 -->
<Control Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">
<LabelText>
<Text>Click here for </Text>
<Text>
<Link UrlRoot="https://www.msn.com"></Link>
work item guidance</Text>
<Text> or here for </Text>
<Text>
<Link UrlRoot="http://www.msdn.com"></Link>
process guidance
</Text>
</LabelText>
</Control>
</Column>
</Group>
例: パラメーターによって生成されるハイパーリンクのフィールド ラベル
次の例では、フィールド ラベルにハイパーリンクを追加する方法を示します。このフィールド ラベルは、開いている作業項目に対して評価されたパラメーター値から生成されます。
<Control Type="FieldControl" FieldName="System.State" Label="&State:" LabelPosition="Left">
<Link OpenInNewWindow="true" UrlRoot="http://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id="> <Param Index="0" Value="System.State" Type ="Original"/>
</Link>
</Control>
Web コンテンツの表示
Type 属性の WebpageControl オプションを使用して、Web コンテンツを独立した Web ページへのリンクではなく、コントロールとして作業項目フォームに表示できます。このコントロールは、チーム メンバーがレポート、ダッシュボード、またはその他の HTML ベースのコンテンツを表示するためのメトリクスを提供する場合に便利です。コンテンツにリンクすることも、CDATA タグ内に生の HTML コンテンツを埋め込むこともできます。
例: URI で提供されたコンテンツの表示
ページへの URL を指定すると、WebpageControlOptions と Link の要素のかを使用して Web ページのコンテンツを埋め込む方法を次の例に示します。
<Tab Label="Web">
<Group>
<Column PercentWidth="100">
<Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" Dock="Fill">
< WebpageControlOptions AllowScript="true">
<Link UrlRoot="http://www.msdn.com" />
</WebpageControlOptions >
</Control>
</Column>
</Group>
</Tab>
例: CDATA タグで提供されたコンテンツの表示
次の例では、HTML コンテンツを CDATA タグに格納された作業項目フォームに追加する方法を示しています。
<Control Type="WebpageControl">
<WebpageControlOptions>
<Content>
<![CDATA[Place HTML Formatted Content Here ]]
</Content>
</WebpageControlOptions >
</Control>
プロセス ガイダンスを使用します。
作業項目フォームでプロセス ガイダンスを使用できるようにする場合、作業項目の種類のワークフローおよび使用法に関する情報を含むタブを追加できます。この操作は、Type 属性の WebpageControl オプションを使用して行うことができます。このオプションでは、WebpageControlOptions 子要素および Content 子要素を使用して、リッチ形式のテキストとイメージをフォームに埋め込むことができます。
<FORM>
. . .
<TabGroup>
. . .
<Tab Label="Process Guidance">
<Group>
<Column PercentWidth="100">
<Control Type="WebpageControl">
<WebpageControlOptions >
<Content>
<![CDATA[Place HTML Formatted Process Guidance Content Here ]]>
</Content>
</WebpageControlOptions>
</Control>
</Column>
</Group>
</Tab>
. . .
</TabGroup>
. . .
</FORM>