다음을 통해 공유


모든 FORM XML 요소 참조

업데이트: 2011년 5월

이 항목의 정보를 작업 항목 형식의 폼을 제어하는 모든 요소와 주요 특성에 대한 빠른 참조로 사용할 수 있습니다. 작업 항목 형식 정의의 세 번째이자 마지막 주요 섹션인 FORM 요소 컨테이너에서 이러한 요소를 지정합니다. 많은 요소가 중첩되어 작업 항목 폼에서 그룹, 섹션 또는 탭을 형성합니다. 이러한 요소를 그룹화하는 방법에 대한 자세한 내용은 작업 항목 폼의 레이아웃 정의을 참조하십시오.

항목 내용

  • FORM 예제

  • FORM 요소 구문

  • FORM 요소로 지정되는 특성

  • 독립 실행형 레이블, 하이퍼링크, 웹 페이지 또는 HTML 콘텐츠를 지정하는 요소

  • 링크 관계를 필터링 및 표시하는 요소

FORM 예제

다음 예제에서는 FORM 요소의 전체 구조를 보여 줍니다. Layout 요소를 사용하여 폼의 레이아웃을 지정합니다. 서로 다른 클라이언트를 대상으로 하는 서로 다른 레이아웃을 지정할 수 있습니다. 예를 들어 Windows 클라이언트에 대한 레이아웃을 지정하고 Team Web Access에 대한 다른 레이아웃을 지정할 수 있습니다. 레이아웃은 일반적으로 폼의 상단과 탭 그룹으로 구성됩니다. 레이아웃 내에서 요소를 정의하는 순서에 따라 요소가 폼에 표시되는 순서가 결정됩니다.

GroupColumn 요소를 사용하여 열 내에 표시할 요소를 그룹화합니다. Control 요소를 사용하여 폼에 표시할 각 필드를 정의합니다. 기능적 Tab 요소를 사용하여 필드 그룹의 서로 다른 기능 영역을 지원합니다.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Form 요소

다음 표에 설명된 요소를 사용하여 작업 항목 폼에서 정보 및 작업 항목 필드를 그룹화하고 표시하는 방법을 지정할 수 있습니다.

참고

최상의 결과를 얻으려면 Group에서 Control 요소를 중첩하고 열의 범위가 폼의 전체 너비로 확장되는 경우에도 Column에서 Group 요소를 중첩해야 합니다. 또한 그룹에 표시되는 레이블이나 경계가 없더라도 Group의 모든 Column 섹션을 중첩해야 합니다.

요소

설명

필수 여부

Column

폼의 영역을 열로 분할합니다.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

권장

Control

작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다.

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

자세한 내용은 Control XML 요소 참조를 참조하십시오.

필수

FORM

최상위 폼 요소를 정의합니다.

<FORM>
   <Layout> . . . </Layout>
</FORM>

필수

Group

Windows GroupBox와 비슷한 시각적 요소 그룹을 제공합니다.

<Group Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Column> . . . </Column>
</Group >

권장

Layout

작업 항목 폼의 레이아웃을 정의합니다.

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ControlSpacing="Distance" LabelSpacing="Distance">
   <Group> . . . </Group>
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Layout>

필수

Splitter

두 형제 폼 요소를 지원하도록 폼을 두 영역으로 분할합니다.

Splitter Dock="Left" />

선택적

Tab

탭 그룹에서 단일 탭의 레이아웃을 정의합니다.

<Tab Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Tab>

선택적

TabGroup

폼에 대한 하나 이상의 탭을 정의합니다.

<TabGroup Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Tab> . . . </Tab>
</TabGroup>

선택적

맨 위로 이동

FORM 요소의 형식을 지정하는 데 사용되는 특성

다음 표에서 설명하는 특성을 지정하여 작업 항목 폼에 있는 여러 요소의 간격 및 크기를 제어할 수 있습니다. 자세한 내용은 작업 항목 폼의 레이아웃 정의을 참조하십시오.

특성

설명

적용 가능한 요소

ControlSpacing

선택적 요소로서, 컨트롤의 세로 오프셋을 지정합니다. 정수입니다.

Layout

Dock

선택적 요소로서, 필드 컨트롤 또는 분할자를 확장하여 컨테이너를 채웁니다. 유효한 필드 도킹 값은 Fill, Top, Bottom, Left 및 Right입니다.

  • Fill: 컨테이너가 채워지도록 필드를 정렬합니다.

  • Top: 컨테이너 위쪽에 필드를 정렬합니다.

  • Bottom: 컨테이너 아래쪽에 필드를 정렬합니다.

  • Left: 필드 또는 분할자를 컨테이너 왼쪽에 정렬합니다. 이 값은 SPLITTER 요소에 대해 지원되는 유일한 방향입니다.

  • Right: 필드 또는 분할자를 컨테이너 오른쪽에 정렬합니다.

Control

Splitter

FixedWidth

선택적 요소로서, 열 너비(픽셀 단위)입니다. PercentWidth와 FixedWidth는 함께 사용할 수 없습니다.

Column

Label

선택적 요소로서, 컨트롤 또는 그룹에 대해 표시되는 텍스트입니다. 레이블을 지정하면 컨트롤에 대한 메타데이터에서 필드와 연결된 모든 레이블이 재정의됩니다.

Tab 요소의 필수적 요소로서, 탭에 대해 표시되는 텍스트입니다.

LabelText는 1~80자를 포함하는 텍스트 문자열입니다.

Control

Group

Tab

LabelPosition

선택적 요소로서, 필드 데이터에 관련된 레이블 위치입니다. Top, Bottom, Left 및 Right 값만 사용할 수 있습니다.

Control

LabelSpacing

선택적 요소로서, 레이블과 컨트롤 편집 영역 사이의 픽셀 수를 지정합니다.

Layout

Margin

선택적 요소로서, 폼에서 컨트롤 둘레의 여백 크기와 컨트롤 간의 간격을 픽셀 단위로 지정하는 문자열입니다(left, top, right, bottom). 각 면의 여백 크기를 다르게 지정할 수 있습니다.

패턴 값: ^\(\d+\,\d+\,\d+\,\d+\)$

패턴 값 예: (2,0,2,0)

Control

Group

Layout

Tab

TabGroup

MinimumSize

선택적 요소로서, 폼의 문자열(width, height)입니다. 이 값은 폼 자체의 최소 크기를 지정합니다. 컨테이너 컨트롤의 크기가 이 값보다 작게 조정되면 가로 및 세로 스크롤 막대가 나타납니다.

Control

Layout

Name

선택적 요소로서, 컨트롤의 이름입니다. 이 특성을 지정하지 않으면 FieldName과 같은 이름으로 설정됩니다.

Control

Padding

선택적 요소로서, 폼에서 컨트롤의 바깥쪽 테두리 주위와 안쪽 테두리 주위의 여백 크기를 픽셀 단위로 지정하는 값입니다(left, top, right, bottom). 각 면의 여백 크기를 다르게 지정할 수 있습니다.

Control

Group

Layout

Tab

TabGroup

PercentWidth

선택적 요소로서, 포함하는 요소의 너비에 대한 백분율로 나타낸 열 너비입니다. PercentWidth와 FixedWidth는 함께 사용할 수 없습니다.

Column

ReadOnly

선택적 요소로서, 읽기 전용 필드를 컨트롤에 표시할 수 있습니다. 이 특성에 반응하는 방식은 컨트롤마다 약간씩 다릅니다.

Control

Target

선택적 요소로서, 이 레이아웃을 적용할 클라이언트를 지정하는 문자열입니다. Visual Studio에서는 Target 특성이 생략되거나 Windows Forms로 설정될 경우 이 레이아웃으로 이 작업 항목 형식을 표시합니다. 외부 클라이언트는 Visual Studio에서 무시하는 사용자 지정 Target 특성을 사용하여 추가 레이아웃을 지정할 수 있습니다.

유효한 값은 다음과 같습니다.

  • WinForms: 팀 탐색기 및 Team Explorer Everywhere에 폼을 적용합니다.

  • Web: Team Web Access에 폼을 적용합니다.

Layout

Type

필수적 요소로서, 컨트롤의 형식입니다. 자세한 내용은 Control XML 요소 참조를 참조하십시오.

Control

맨 위로 이동

독립 실행형 레이블, 하이퍼링크, 웹 페이지 또는 HTML 콘텐츠를 지정하는 요소

WebpageControlOptions 요소와 해당 자식 요소에는 다음과 같은 구문 구조가 포함됩니다.

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters">
      <Param index="IndexValue" value="ParamValue" type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

일반 텍스트 또는 하이퍼링크 레이블을 정의하거나, 필드에 하이퍼링크를 추가하거나, 작업 항목 폼에 웹 페이지 콘텐츠를 표시하려면 다음 표에 설명된 요소를 사용합니다. 자세한 내용은 도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공을 참조하십시오.

요소

필수 여부

설명

Content

선택적 WebpageControlOptions 요소입니다.

작업 항목 폼에 표시할 CDATA HTML 기반 콘텐츠를 지정합니다.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

자세한 내용은 WebpageControlOptions XML 요소 참조를 참조하십시오.

LabelText

type="LabelControl"인 경우 선택적 Control 요소입니다.

일반 레이블 또는 하이퍼링크 레이블을 정의합니다.

자세한 내용은 LabelText 및 Text XML 요소 참조를 참조하십시오.

Link

type="FieldControl"인 경우 선택적 Control 요소입니다.

선택적 Text 요소입니다.

선택적 WebpageControl 요소입니다.

선택적 WebpageControlOptions 요소입니다.

작업 항목 폼에 표시할 필드, 레이블 또는 웹 브라우저 콘텐츠에 대한 하이퍼링크를 정의합니다.

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

자세한 내용은 Link 및 Param XML 요소 참조를 참조하십시오.

Param

선택적 Link 요소입니다.

URLPath가 Link 요소에 대해 지정되어 있을 때 하이퍼링크의 URL을 결정하는 값을 지정합니다.

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

자세한 내용은 Link 및 Param XML 요소 참조를 참조하십시오.

Text

선택적 LabelText 요소입니다.

작업 항목 폼에 표시할 정보 또는 레이블에 대한 컨테이너 요소입니다.

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

자세한 내용은 LabelText 및 Text XML 요소 참조를 참조하십시오.

WebpageControlOptions

type="WebpageControl"인 경우 선택적 Control 요소입니다.

웹 페이지 컨트롤에 대한 옵션을 지정하는 컨테이너 요소입니다.

자세한 내용은 WebpageControlOptions XML 요소 참조를 참조하십시오.

맨 위로 이동

링크 관계를 필터링 및 표시하는 요소

LinksControlOptions 요소를 사용하여 작업 항목에 추가할 수 있는 링크를 제어하는 옵션과 작업 항목의 링크 목록에 대해 표시할 기본 열을 정의합니다. 작업 항목 폼에 링크 컨트롤을 추가할 경우 사용자가 만들 수 있는 링크 형식과 링크를 만들 수 있는 작업 항목 형식을 제한하는 필터를 지정할 수 있습니다. LinksControlOptions 요소와 해당 자식 요소에는 다음과 같은 구조가 포함됩니다.

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

특히 다음 표에 요약된 요소를 사용합니다. 이러한 요소를 사용하는 방법에 대한 자세한 내용은 링크 관계를 제한하기 위한 링크 컨트롤 정의LinksControlOptions 요소를 참조하십시오.

요소

필수 여부

설명

LinksControlOptions

type="LinksControl"인 경우 선택적 Control 요소입니다.

작업 항목에 추가할 수 있는 링크를 제어하는 옵션과 작업 항목의 링크 목록에 대해 표시할 기본 열을 정의하는 요소에 대한 컨테이너를 제공합니다.

WorkItemLinkFilters

선택적 LinksControlOptions 요소입니다.

팀 프로젝트 컬렉션에 대해 정의되는 링크 형식에 사용할 링크 필터 기준을 지정하는 하나 이상의 Filter 요소에 대한 컨테이너를 제공합니다.

ExternalLinkFilters

선택적 LinksControlOptions 요소입니다.

다른 팀 프로젝트에 정의되는 링크 형식에 사용할 필터 기준을 지정하는 하나 이상의 Filter 요소에 대한 컨테이너를 제공합니다.

WorkItemTypeFilters

선택적 LinksControlOptions 요소입니다.

작업 항목 형식에 적용할 필터 기준을 지정하는 하나 이상의 Filter 요소에 대한 컨테이너를 제공합니다.

Filter(링크 형식)

FilterType 특성이 exclude 또는 include인 경우 필수적 WorkItemLinkFilters 요소입니다.

FilterType 특성이 exclude 또는 include인 경우 필수적 ExternalLinkFilters 요소입니다.

작업 항목에 대해 만들 수 있는 링크 집합에서 제외되거나 포함되는 링크 형식을 지정합니다.

Filter(작업 항목 형식)

FilterType 특성이 exclude 또는 include인 경우 선택적 WorkItemTypeFilters 요소입니다.

사용자가 연결할 수 있는 작업 항목 형식 집합에서 제외되거나 포함되는 작업 항목 형식을 지정합니다.

LinkColumns

선택적 LinksControlOptions 요소입니다.

하나 이상의 LinkColumn 태그에 대한 컨테이너를 제공합니다.

LinkColumn

필수적 LinkColumns 요소입니다.

링크 목록에 대해 작업 항목 폼에 표시할 작업 항목 필드 및 링크 형식 특성을 지정합니다.

맨 위로 이동

참고 항목

개념

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

작업 항목 폼 디자인 및 사용자 지정

기타 리소스

작업 항목 형식에 대한 XML 요소 정의의 인덱스

변경 기록

날짜

변경 내용

이유

2011년 5월

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

콘텐츠 버그 수정

2011년 1월

모든 FORM 요소에 대한 예제와 구문이 추가되었습니다. 제거된 항목에 대한 링크가 제거되었습니다.

향상된 기능 관련 정보

2010년 7월

이전 업데이트에서 추가된 항목에 대한 링크가 추가되었습니다.

향상된 기능 관련 정보