작업 항목 폼에서 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공
작업 항목 폼을 사용자 지정하는 경우 폼의 필드를 팀이 정의하는 데 도움이 되는 정보나 콘텐츠에 대한 정보를 제공하려고 할 수 있습니다. 폼에 정보를 포함하거나 정보를 쉽게 사용할 수 있게 하면 팀 멤버가 유용한 데이터를 보다 잘 추적할 수 있게 됩니다.
이 항목에 설명된 폼 컨트롤을 사용하여 개별 필드, 독립 실행형 텍스트 또는 하이퍼링크에 대한 도구 설명 텍스트를 웹 페이지에 추가하거나 폼에 HTML 콘텐츠 또는 웹 콘텐츠를 포함할 수 있습니다.
작업 항목 형식에 대한 정의를 수정하여 작업 항목 폼을 수정합니다. witadmin 명령줄 도구(작업 항목 형식 가져오기, 내보내기 및 관리[witadmin] 참조) 또는 프로세스 편집기를 사용할 수 있습니다.
프로세스 편집기는 다운로드하여 설치할 수 있는 강력한 Visual Studio용 도구 추가 기능입니다. 도구 메뉴 아래에 있는 프로세스 편집기는 Team Foundation Server에서 작업 항목을 추적하는 데 사용되는 개체를 사용자 지정하기 위한 그래픽 사용자 인터페이스를 제공합니다. 이 도구를 사용하여 작업 항목 형식을 가져오거나 내보내고 해당 정의를 수정할 수 있습니다. 자세한 내용은 Microsoft 웹 사이트의 Team Foundation Server Power Tools 페이지를 참조하십시오.
도움말 텍스트 또는 도구 설명 텍스트 제공
다음 두 가지 방법 중 하나로 도움말 텍스트를 제공할 수 있습니다. 첫 번째 방법에서는 형식 정의의 HELPTEXT 섹션에 있는 FIELD 요소에 FIELDS 요소를 자식으로 추가합니다. HELPTEXT를 사용하여 필드에 대한 도구 설명을 만듭니다. 이 방법의 경우 255자로 제한됩니다.
<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>
두 번째 방법에서는 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 옵션을 사용하여, 추가된 필드 레이블에 하이퍼링크를 연결할 수도 있습니다.
예: 일반 텍스트 레이블
다음 예에서는 "여기에 버그의 세부 정보를 채우세요. 필수가 아닌 필드는 채우는 것이 좋습니다."라는 일반 텍스트를 작업 항목 필드에 추가합니다.
<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개의 하이퍼링크를 추가하는 방법을 보여 줍니다.
<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>
웹 콘텐츠 표시
별도의 웹 페이지에 연결하는 대신 Type 특성 WebpageControl 옵션을 사용하여 작업 항목 폼의 웹 콘텐츠를 컨트롤로 표시할 수 있습니다. 이 표시는 보고서나 대시보드의 콘텐츠 또는 기타 HTML 기반 콘텐츠를 보는 팀 멤버를 지원하는 메트릭을 제공하는 데 유용할 수 있습니다. 콘텐츠에 대한 링크를 제공하거나 CDATA 태그에 원시 HTML 콘텐츠를 포함할 수 있습니다.
예: URI에서 제공하는 콘텐츠 표시
다음 예에서는 WebpageControlOptions 및 Link 요소를 통해 페이지에 대한 URL을 제공하여 웹 페이지의 콘텐츠를 포함하는 방법을 보여 줍니다.
<Tab Label="Web">
<Group>
<Column PercentWidth="100">
<Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" >
< WebpageControlOptions AllowScript="true">
<Link UrlRoot="http://www.msdn.com" />
</WebpageControlOptions >
</Control>
</Column>
</Group>
</Tab>
예: CDATA 태그에 제공되는 콘텐츠 표시
다음 예에서는 CDATA 태그에 포함된 작업 항목 폼에 HTML 콘텐츠를 추가하는 방법을 보여 줍니다.
<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>