다음을 통해 공유


도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공

업데이트: 2011년 5월

작업 항목 폼을 사용자 지정할 때는 팀이 폼에 필드를 정의할 수 있도록 콘텐츠에 대한 정보나 링크를 제공해야 할 수 있습니다. 폼에 정보를 포함하거나 정보를 쉽게 사용할 수 있도록 만들면 팀 멤버가 유용한 정보를 보다 효과적으로 추적할 수 있습니다."

이 항목에서 설명하는 폼 컨트롤을 사용하면 개별 필드에 대한 도구 설명 텍스트, 독립 실행형 텍스트 또는 웹 페이지에 대한 하이퍼링크를 추가하거나 HTML 콘텐츠 또는 웹 콘텐츠를 폼에 포함할 수 있습니다.

항목 내용

  • 도움말 텍스트 또는 도구 설명 텍스트 제공

  • 독립 실행형 텍스트 및 하이퍼링크 필드 레이블 추가

  • 웹 콘텐츠 표시

  • 프로세스 지침 포함

도움말 텍스트 또는 도구 설명 텍스트 제공

두 가지 방법 중 하나로 도움말 텍스트를 제공할 수 있습니다. 첫 번째 방법에서는 형식 정의의 FIELDS 섹션에 있는 FIELD 요소에 HELPTEXT 요소를 자식으로 추가합니다. 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 옵션을 사용하여 추가된 필드 레이블에 하이퍼링크를 첨부할 수도 있습니다.

예제: 일반 텍스트 레이블

다음 예제에서는 일반 텍스트 "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 2010 클라이언트의 경우 Text 태그는 Link 태그로 URL을 정의하는 하이퍼링크로 표시됩니다.

예제: 텍스트 일부에 하이퍼링크가 지정된 필드 레이블

다음 예제에서는 필드 레이블의 일부에 하이퍼링크를 추가하는 방법을 보여 줍니다. 이 예제에서는 특정 작업 항목을 기준으로 Param 요소에 할당되는 값에 의해 URL이 결정됩니다.

<Control Type="FieldControl" FieldName="System.IterationPath">
   <LabelText LabelPosition="Left">
      <Text>
         <Link UrlPath="http://{0}/sites/{1}/render.aspx?wit=bug&amp;topic=Iteration">
            <Param value="@Server"/>
            <Param value="System.Project"/>
         </Link>
            Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

예제: 하이퍼링크 텍스트 레이블

하이퍼링크 텍스트 레이블

독립 실행형 레이블에 적용된 하이퍼링크 예제

다음 예제에서는 작업 항목 폼에 표시된 텍스트에 하이퍼링크를 추가하는 방법을 보여 줍니다.

<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>

예제: 텍스트 및 하이퍼링크를 단일 레이블에 결합

텍스트 및 하이퍼링크를 단일 레이블에 결합

텍스트에 적용된 두 개의 하이퍼링크 예제

다음 예제에서는 작업 항목 폼에서 레이블의 일부에 하이퍼링크 두 개를 추가하는 방법을 보여 줍니다.

<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="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" URLRoot="http://{0}/sites/{1}/render.aspx?wit=bug&amp;state={2}">
      <Param value="@Server"/>
      <Param value="System.Project"/>
      <Param 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" Dock="Fill">
            < WebpageControlOptions AllowScript="false">
               <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>

참고 항목

참조

Control XML 요소 참조

FIELD(워크플로) 요소

개념

작업 항목 폼 컨트롤 지정

작업 항목 폼의 레이아웃 정의

프로젝트 추적 데이터, 폼, 워크플로 및 기타 개체 사용자 지정

기타 리소스

작업 항목 필드의 표시 제어

변경 기록

날짜

변경 내용

이유

2011년 5월

XML 구문에서 여러 요소 및 특성의 대/소문자가 수정되었습니다. 작업 항목을 추적하기 위한 스키마 정의는 FORM 요소의 모든 자식 요소를 카멜식 대/소문자로 정의하고 다른 모든 요소는 이름의 모든 문자를 대문자로 표시합니다.

콘텐츠 버그 수정