다음을 통해 공유


작업 항목 폼 컨트롤 지정

이 항목에서는 Control 요소, 해당 자식 요소 및 특성에 대한 빠른 참조를 제공합니다. 작업 항목 폼에 표시할 각 필드 또는 폼 컨트롤에 대해 Control 요소를 추가합니다.

팀에서 폼을 올바르게 사용하는 데 도움이 되는 정보를 표시하도록 작업 항목 폼을 사용자 지정할 수 있습니다. 추적하려는 데이터를 입력하고 볼 수 있게 하는 작업 항목 필드와 컨트롤을 추가할 수 있습니다.

Control 요소는 필드를 추가하거나, 일반 텍스트 또는 하이퍼링크 텍스트나 필드를 표시하는 데 사용하는 Type 특성에 대한 9개의 값을 제공합니다. 또한 링크와 첨부 파일을 추가하거나 웹 기반 콘텐츠를 표시하는 특수 컨트롤을 정의하거나, 컨트롤을 직접 만들어서 작업 항목 폼에 추가할 수 있습니다.

작업 항목 필드 추가

작업 항목 폼을 사용자 지정하는 경우 일반적으로 폼에 표시하려는 작업 항목 형식에 대해 정의된 작업 항목 필드의 하위 집합을 추가합니다. 표시되는 데이터 또는 폼에 입력할 수 있는 데이터에 대한 여러 부분을 필드 정의 컨트롤에서 제어합니다. 자세한 내용은 쿼리, 보고서 및 워크플로를 지원하도록 필드 수정 또는 추가을 참조하십시오.

각 작업 항목 필드는 데이터 형식과 연결됩니다. 다음 표의 정보를 사용하여 Type 요소의 Control 특성에서 지원되는 필드 형식을 확인할 수 있습니다. Label 특성은 컨트롤 옆에 표시되는 텍스트를 지정하는 데 사용되고 관련된 LabelPosition 특성은 컨트롤을 기준으로 레이블의 위치를 지정하는 데 사용됩니다. 자세한 내용은 작업 항목 필드의 표시 제어을 참조하십시오.

참고

시스템 필드의 값은 자동으로 업데이트되며 사용자가 변경할 수 없습니다.예를 들어 Created Date 및 Created By 필드는 작업 항목을 처음 저장할 때 정의됩니다.그러나 검색 조건에 이러한 필드를 사용할 수 없습니다.각 시스템 필드에 대한 자세한 내용은 Visual Studio ALM의 작업 항목 필드 참조을 참조하십시오.

필드 형식

Control 요소 Type 특성

용도

DateTime

FieldControl

DateTimeControl

FieldControl을 사용하여 DateTime 데이터 형식 필드의 입력 또는 표시에 대한 텍스트 필드를 제공합니다.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />

다음 그림과 같이 DateTimeControl을 사용하여 필드의 날짜를 선택하는 일정 선택 도구를 제공합니다.

일정 필드
<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />

Double

FieldControl

FieldControl을 사용하여 Double 필드의 입력 또는 표시에 대한 텍스트 필드를 제공합니다.

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

History

WorkItemLogControl

다음 그림과 같이 WorkItemLogControl을 사용하여 토론 스레드 및 기타 기록 정보를 추적하는 History 필드에 대한 컨트롤 필드를 제공합니다.

작업 항목 폼의 기록 탭 및 필드

이 컨트롤은 작업 항목의 기록 필드인 System.History 작업 항목 필드의 표시를 지원하는 데만 사용할 수 있습니다. 이 컨트롤을 사용하여 작업 항목의 수정 기록 정보를 확장하거나 축소할 수 있습니다. 기록 필드에 추가할 텍스트의 서식을 지정할 수도 있습니다.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

HTML

HTMLControl

다음 그림과 같이 HTMLControl을 사용하여 서식 있는 텍스트의 서식을 캡처할 수 있는 HTML 필드에 대한 컨트롤 필드를 제공합니다.

작업 항목 폼에 표시된 HTML 필드
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

Integer

FieldControl

FieldControl을 사용하여 정수 필드에 대한 컨트롤 필드를 제공합니다.

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

PlainText

FieldControl

FieldControl을 사용하여 255자가 넘는 설명을 포함하는 텍스트 상자와 같은 PlainText 필드에 대한 컨트롤 필드를 제공합니다.

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

String

FieldControl

FieldControl을 사용하여 String 필드에 대한 컨트롤 필드를 제공합니다. String 필드에는 최대 255자의 문자를 사용할 수 있습니다.

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

TreePath

WorkItemClassificationControl

WorkItemClassificationControl을 사용하여 TreePath 필드에 대한 컨트롤 필드를 제공합니다.

<Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

모든 컨트롤 형식의 선택적 컨트롤 요소 필드 특성

다음 선택적 특성은 나열된 해당 컨트롤 형식에만 지정할 수 있습니다.

특성

설명

Field

작업 항목 필드와 연결되는 컨트롤을 지정합니다.

Label

폼에서 컨트롤을 식별하는 표시되는 텍스트를 지정합니다. 80자를 초과하지 않는 문자열을 지정합니다.

참고

FieldControl을 사용하여 작업 항목 폼에 추가되는 필드의 레이블에 하이퍼링크를 추가할 수 있습니다.이 컨트롤은 필드를 사용하는 방법에 대한 정보에 링크를 제공할 경우 유용합니다.자세한 내용은 작업 항목 폼에서 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공을 참조하십시오.

LabelPosition

컨트롤 데이터를 기준으로 한 레이블의 위치를 지정합니다. Top, Bottom, Left 및 Right 값 중 하나에서 문자열을 지정합니다.

Dock

컨테이너의 지정된 측면에 레이블 맞춤을 지정하거나, 필드를 확장하여 컨테이너를 채웁니다. Fill, Top, Bottom, Left 및 Right 값 중 하나에서 문자열을 지정합니다.

Padding

컨트롤 테두리 안쪽의 공간 크기를 픽셀 단위로 지정합니다. 위쪽, 아래쪽, 왼쪽 및 오른쪽에 해당하는 4개의 값을 제공합니다. 예: (2,0,2,0)

Margin

컨트롤 테두리 바깥쪽의 공간 크기를 픽셀 단위로 지정합니다. 위쪽, 아래쪽, 왼쪽 및 오른쪽에 해당하는 4개의 값을 제공합니다. 예: (2,0,2,0)

ReadOnly

필드를 읽기 전용으로 지정합니다. True 또는 False를 지정합니다.

MinimumSize

폼에서 컨트롤이 차지하는 픽셀의 최소 크기를 지정합니다. 너비 및 높이에 해당하는 2개의 값을 지정합니다. 예: (100,100)

Name

컨트롤을 고유하게 식별합니다. 폼에 있는 두 개 이상의 컨트롤이 동일한 작업 항목 필드와 연결되어 있는 경우 Name 특성이 필요합니다.

참고

Name 특성을 사용하여 폼에 있는 두 개 이상의 영역에 동일한 필드를 표시합니다.시스템이 각 컨트롤을 고유하게 식별하도록 두 컨트롤 항목의 Name 특성에 대해 고유한 값을 지정합니다.이렇게 하면 탭의 컨텍스트를 기반으로 다양한 위치에서 동일한 컨트롤을 표시하는 데 유용합니다.

특정 컨트롤 형식의 선택적 컨트롤 요소 필드 특성

다음 선택적 특성은 나열된 해당 컨트롤 형식에만 지정할 수 있습니다.

특성

컨트롤 형식

설명

NumberFormat

FieldControl

필드 컨트롤에 입력할 수 있는 문자를 지정합니다. 유효한 값은 WholeNumbers, SignedWholeNumbers, DecimalNumbers 및 SignedDecimalNumbers입니다.

MaxLength

FieldControl

필드 컨트롤에 사용할 수 있는 최대 문자 길이를 지정합니다.

Format

DateTimeControl

DateTimePickerFormat 열거형의 값 중 하나에 해당하는 날짜/시간 필드의 서식을 지정합니다. 유효한 값은 Custom, Long, Short, Time입니다.

CustomFormat

DateTimeControl

DateTimePicker.CustomFormat 속성에 대해 정의되는 구문에 해당하는 날짜/시간 필드에 사용할 사용자 지정 서식을 지정합니다.

특수 컨트롤 추가

다음 표에서는 첨부 파일 관리, 링크 만들기, 웹 기반 콘텐츠 표시 및 작업 항목 필드와 연결되지 않은 기타 데이터 보기를 지원하는 Control 요소 Type 특성에 대해 설명합니다.

Control 요소 Type 특성

용도

AttachmentsControl

작업 항목 폼에 파일을 첨부하기 위해 사용합니다. 다음 그림과 같이 이 컨트롤은 대개 자체 탭 그룹에 포함되어 있습니다.



첨부 파일 컨트롤

작업 항목에 파일 첨부

자세한 내용은 Attachments 컨트롤 추가을 참조하십시오.

LabelControl

다음 그림과 같이 필드와 연결되지 않은 일반 또는 하이퍼링크 텍스트를 표시하는 데 사용합니다.

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

LabelText 및 Link 자식 및 컨테이너 요소를 사용하여 텍스트가 하이퍼링크와 부분적으로 연결되는 필드 또는 레이블의 위치, 하이퍼링크 및 텍스트를 지정합니다. 자세한 내용은 작업 항목 폼에서 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공, LabelText 및 Text XML 요소 참조Link 및 Param XML 요소 참조을 참조하십시오.

LinksControl

작업 항목 간에 링크를 만들고 관리하기 위해 사용합니다. 다음 그림과 같이 이 컨트롤은 대개 자체 탭 그룹에 포함되어 있습니다.

작업 항목 폼에 추가된 링크 컨트롤 예제

LinksControlOptions를 사용하여 링크 목록을 표시하는 데 사용되는 열 필드의 레이아웃과 링크 필터를 정의합니다. 자세한 내용은 링크 관계를 제한하기 위한 링크 컨트롤 정의LinksControlOptions 요소를 참조하세요.

WebpageControl

작업 항목 폼에 웹 콘텐츠를 표시하기 위해 사용합니다. 이 컨트롤은 대개 자체 탭 그룹에 포함되어 있습니다. WebpageControlOptions 및 Link 자식 요소를 사용하여 작업 항목 폼에 웹 페이지 대상을 로드하는 데 필요한 컨트롤을 지정합니다.

자세한 내용은 작업 항목 폼에 웹 콘텐츠를 추가하기 위한 WIT 정의 편집, WebpageControlOptions XML 요소 참조Link 및 Param XML 요소 참조을 참조하십시오.

사용자 지정 컨트롤을 추가합니다.

기본 제공 컨트롤 외에 원하는 사용자 지정 컨트롤을 작업 항목 폼에 추가할 수 있습니다.

예를 들어 클립보드의 스크린 샷을 캡처하는 사용자 지정 컨트롤을 추가할 수 있습니다. 또는 목록 또는 메뉴에 표시되는 값에 대한 확인란을 추가하여 여러 값을 캡처하는 컨트롤을 제공할 수 있습니다.

사용자 지정 컨트롤을 구현하려면 Type 특성의 컨트롤 이름을 지정해야 합니다.

참고 항목

작업

작업 항목 폼 레이아웃 변경

작업 항목 폼에 웹 콘텐츠를 추가하기 위한 WIT 정의 편집

참조

Control XML 요소 참조