작업 항목 폼 컨트롤 지정

TFS 2015 | TFS 2013

중요

이 항목은 온-프레미스 XML 프로세스 모델에 대한 프로젝트 사용자 지정에 적용됩니다. 호스트된 XML 프로세스 모델은 WebLayout 및 Control 요소를 참조하세요. 상속 프로세스 모델은 프로세스 사용자 지정을 참조하세요.

프로세스 모델에 대한 개요는 작업 추적 환경 사용자 지정을 참조하세요.

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

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

작업 항목 폼에서 텍스트 상자의 레이블 이름, 위치 및 크기와 일반 텍스트, 정수, 숫자, 날짜 및 트리 경로 작업 항목 필드의 다른 표시 컨트롤을 제어할 수 있습니다. 이러한 필드를 표시하려면 다음 옵션에서 올바른 Control 요소 Type 특성을 지정해야 합니다.

• FieldControl: 필드 형식Boolean이 , String, DoubleIdentityInteger, 및 인 필드에 대한 일반 텍스트 또는 숫자 필드 및 PlainText값 목록을 표시하는 데 사용됩니다.

• HtmlFieldControl: 필드 데이터 형식 HTML이 있는 필드의 여러 줄 서식 있는 텍스트 형식을 표시하는 데 사용됩니다.

• DateTimeControl: 필드 형식 DateTime이 .인 서식이 지정된 날짜 필드를 표시하는 데 사용됩니다.

• WorkItemClassificationControl 필드 형식 TreePath이 .인 계층적 경로 필드를 표시하는 데 사용됩니다.

작업 항목 필드 추가

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

각 작업 항목 필드는 데이터 형식과 연결됩니다. Label 이 특성을 사용하여 컨트롤 옆에 표시되는 텍스트를 지정합니다. 관련 LabelPosition 특성을 사용하여 컨트롤을 기준으로 레이블이 표시되는 위치를 지정합니다.

참고

자동으로 업데이트되는 시스템 필드의 값은 변경할 수 없습니다. 예를 들어 Created Date 및 Created By 필드는 작업 항목을 처음 저장할 때 정의됩니다. 그러나 검색 조건에 이러한 필드를 사용할 수 없습니다. 각 시스템 필드에 대한 설명은 작업 항목 필드 인덱스입니다.

숫자 필드 추가

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

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

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

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

일반 텍스트 또는 문자열 필드 추가

String 선택 목록이나 짧은 텍스트에 사용되는 문자열 필드를 255자로 제한할 때 컨트롤을 지정합니다.

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

PlainText 255자보다 큰 설명이 포함된 텍스트를 캡처하려는 경우 컨트롤을 지정합니다.

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

확인란 또는 부울 필드 추가

참고

기능 가용성: 부울 데이터 형식은 호스트된 XML(Azure DevOps Services) 및 온-프레미스 XML(TFS 2017.2 이상 버전)에 대해 지원됩니다.

다음 구문을 사용하여 WIT 정의의 FIELDS 섹션 내에 부울 필드를 추가합니다.

<FIELD name="Triage" refname="Fabrikam.Triage" type="Boolean" >
  <DEFAULT from="value" value="False" />
  <HELPTEXT>Triage work item</HELPTEXT>
</FIELD>

그런 다음 FORM 섹션 내에 다음 구문을 추가하여 양식에 필드가 표시되도록 합니다.

<Control Label="Triage" Type="FieldControl" FieldName="Fabrikam.Triage" /> 

필드가 양식에 확인란으로 표시됩니다.

날짜 또는 일정 필드 추가

이 형식을 DateTimeControl 사용하여 사용자에게 일정 선택기를 제공하여 필드의 날짜를 선택할 수 있습니다 DateTime . 이 컨트롤을 사용하여 필드의 날짜 및 시간을 빠르게 선택할 수 있습니다.

Format="Short"인 일정 필드

예를 들어, 이후에 원하는 시작 날짜 또는 검토 날짜를 지정할 수 있습니다.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"  
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />  
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"  
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />  

다음 표에 설명된 선택적 특성을 사용하여 필드의 DateTime 형식을 제어할 수 있습니다.

특성	설명
Format	DateTimePickerFormat 열거형의 값 중 하나에 해당하는 날짜/시간 필드의 서식을 지정합니다. 유효한 값은 다음과 같습니다. CustomLongShortTime 지정할 Custom때 특성도 설정 CustomFormat 해야 합니다.
CustomFormat	DateTimePicker.CustomFormat 속성에 대해 정의되는 구문에 해당하는 날짜/시간 필드에 사용할 사용자 지정 서식을 지정합니다. 예를 들어: Format="Custom" CustomFormat = "MMM dd, 'of the year' yyyy" 자세한 내용은 Microsoft 웹 사이트 DateTimePicker.CustomFormat 속성을 참조하세요.

서식 있는 텍스트(HTML) 필드 추가

HTMLControl 다음 그림과 HTML 같이 서식 있는 텍스트 서식을 캡처할 필드를 추가할 필드를 지정합니다.

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

팁

세로로 쌓일 폼에 여러 HTMLFieldControl 요소를 추가하는 경우 각 필드 컨트롤의 MinimumSize 특성을 지정해야 합니다. 이 방법에서는 텍스트 상자를 모두 비슷한 크기로 지정할 수 있습니다. 그렇지 않으면 마지막 HTML 컨트롤 요소의 크기가 폼 크기에 맞게 조정되고 이전 요소는 작은 여러 텍스트 상자에 함께 표시됩니다.

일반 또는 하이퍼링크 텍스트 컨트롤 추가

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

자식 및 Link 컨테이너 요소를 사용하여 LabelText 텍스트가 하이퍼링크와 부분적으로 연결된 필드 또는 레이블의 텍스트, 하이퍼링크 및 위치를 지정합니다. 자세한 내용은 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠,LabelText 및 텍스트, 링크 및 매개 변수 제공을 참조하세요.

웹 페이지 컨트롤 추가

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

자세한 내용은 WIT 정의 편집을 참조하여 웹 콘텐츠를 작업 항목 양식, WebpageControlOptions 및 Link 및 Param에 추가합니다.

링크 컨트롤 추가

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

링크 목록을 표시하는 데 사용되는 열 필드의 링크 필터 및 레이아웃을 정의하는 데 사용할 LinksControlOptions 수도 있습니다. 자세한 내용은 링크 관계 및 LinksControlOptions를 제한하는 링크 컨트롤 정의를 참조하세요.

Storyboards 컨트롤 추가

StoryboardsControl 작업 항목에서 PowerPoint Storyboarding을 열고 네트워크 공유에 저장된 Storyboard 파일에 대한 링크를 사용할 수 있습니다. 다음 그림과 같이 이 컨트롤은 대개 자체 탭 그룹에 포함되어 있습니다.

섹션에 StoryboardsControlFORM 추가하려면 다음 코드 조각을 추가합니다.

<Tab Label="Storyboards">
     <Control Name="StoryboardsControl" Type="LinksControl">
        <LinksControlOptions>
           <WorkItemLinkFilters FilterType="excludeAll" />
           <ExternalLinkFilters FilterType="include">
              <Filter LinkType="Storyboard" />
           </ExternalLinkFilters>
           <LinkColumns>
              <LinkColumn RefName="System.Title" />
              <LinkColumn LinkAttribute="System.Links.Comment" />
           </LinkColumns>
        </LinksControlOptions>
     </Control>
  </Tab>

영역 및 반복 경로 추가(TreePath 컨트롤)

이 형식을 WorkItemClassificationControl 사용하여 데이터 형식이 .인 필드를 추가합니다 TreePath. 이 컨트롤은 영역 경로 필드 및 반복 경로 필드를 계층 구조의 중첩된 트리 형식으로 표시하는 데 사용됩니다. 트리에는 확장하거나 축소할 수 있는 계층적 노드가 표시됩니다.

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

참고

이 WorkItemClassificationControl 값을 사용하여 필드와 System.IterationPath 필드를 표시할 System.AreaPath 수 있습니다. 이 컨트롤을 사용하여 다른 형식의 필드 또는 사용자 지정 필드를 표시할 수 없습니다.

기록 컨트롤 추가

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

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

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

첨부 파일 컨트롤 추가

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

자세한 내용은 첨부 파일 추가 컨트롤을 참조하세요.

관련 문서

제공된 기본 제공 컨트롤 외에도 에서 사용할 수 있는 추가 컨트롤을 찾을 수 있습니다. 또는 사용자 고유의 컨트롤을 만들 수 있습니다. 작업 항목 양식 확장을 참조하세요.

• Control XML 요소 참조
• WebLayout 및 Control 요소
• 작업 항목 폼 레이아웃 변경
• 작업 항목 폼에 웹 콘텐츠를 추가하기 위한 WIT 정의 편집
• 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공
• 링크 관계를 제한하기 위한 링크 컨트롤 정의
• Attachments 컨트롤 추가

폼의 두 위치에서 필드 레이블 지정 및 필드 추가

각 양식 컨트롤에 대해 선택적 레이블 및 특성을 사용하여 LabelLabelPosition 레이블의 위치를 지정할 수 있습니다. 레이블은 요소에 의해 FIELD 할당된 이름과 다른 이름을 지정할 수 있습니다. 레이블을 지정하지 않으면 이름이 사용됩니다. 그러나 팀 멤버가 쿼리를 실행하여 작업 항목을 검색할 때는 항상 이름이 사용됩니다. 최대 레이블 크기는 80자입니다.

참고

동일한 그룹에 정의되는 모든 컨트롤에 동일한 레이블 위치를 정의해야 합니다.

폼의 위쪽 및 탭과 같이 폼의 둘 이상의 영역에 필드를 추가하려는 경우 특성을 사용하여 Name 필드를 추가할 수 있습니다. 이 특성은 Name 폼에 추가된 다른 컨트롤과 구별되는 컨트롤만 식별합니다.

필드를 읽기 전용으로 설정

다음 중 한 가지 방법을 사용하여 필드를 읽기 전용으로 표시할 수 있습니다. 첫 번째 메서드에서는 요소를 형식 정의 섹션의 FIELD 요소에 FIELDS 자식으로 추가 READONLY 합니다. 요소를 사용하여 READONLY 특정 사용자가 필드를 수정할 수 있는지 여부를 지정할 수 있습니다. 다음 예제와 같이 프로그램 관리자만 Sub-Title 필드를 수정할 수 있습니다.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >  
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>  
</FIELD>  

두 번째 메서드에서는 요소의 ReadOnly 특성을 지정합니다 CONTROL . 이 방법에서는 모든 사용자가 필드를 수정할 수 없습니다.

<Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />  

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

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

참고

각 데이터 입력 필드의 전체 크기는 필드에 할당되는 특성, 컨테이너 크기, 폼의 다른 필드에 할당되는 영역 등의 여러 가지 요소에 의해 결정됩니다. 최소 크기를 지정하지 않을 경우 필드에 기본값이 할당됩니다. 폼의 다른 필드에 할당되는 특성이 필드의 크기에 영향을 줄 수 있습니다. 열의 수와 각 열에서 가장 큰 필드에 할당하는 가로 크기에 따라 폼의 가로 크기가 결정됩니다. 세로 그룹에서 지정하는 필드 수와 각 필드에 할당하는 세로 크기에 따라 폼의 위쪽 크기와 폼의 아래쪽 크기가 결정됩니다.

특성	설명
Field	작업 항목 필드와 연결되는 컨트롤을 지정합니다.
Label	폼에서 컨트롤을 식별하는 표시되는 텍스트를 지정합니다. 80자를 초과하지 않는 문자열을 지정합니다. 참고: 를 사용하여 작업 항목 양식에 추가되는 필드의 레이블에 하이퍼링크를 연결할 수 있습니다 . 이 컨트롤은 필드를 사용하는 방법에 대한 정보에 링크를 제공할 경우 유용합니다. 자세한 내용은 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공을 참조하세요.
LabelPosition	컨트롤 데이터를 기준으로 한 레이블의 위치를 지정합니다. 다음 값 중 하나에서 문자열을 지정합니다TopLeftBottomRight.
Dock	컨테이너의 지정된 측면에 레이블 맞춤을 지정하거나, 필드를 확장하여 컨테이너를 채웁니다. 다음 값 중 하나에서 문자열을 지정합니다FillRightTopBottomLeft.
Padding	컨트롤 테두리 안쪽의 공간 크기를 픽셀 단위로 지정합니다. 위쪽, 아래쪽, 왼쪽 및 오른쪽에 해당하는 4개의 값을 제공합니다. 예: (2,0,2,0)
Margin	컨트롤 테두리 바깥쪽의 공간 크기를 픽셀 단위로 지정합니다. 위쪽, 아래쪽, 왼쪽 및 오른쪽에 해당하는 4개의 값을 제공합니다. 예: (2,0,2,0)
ReadOnly	필드를 읽기 전용으로 지정합니다. True 또는 False를 지정합니다.
MinimumSize	폼에서 컨트롤이 차지하는 픽셀의 최소 크기를 지정합니다. 너비 및 높이에 해당하는 2개의 값을 지정합니다. 예: (100,100)
Name	컨트롤을 고유하게 식별합니다. 양식에서 Name 둘 이상의 컨트롤이 동일한 작업 항목 필드와 연결된 경우 이 특성이 필요합니다. 참고: 이 특성을 사용하여 양식에서 둘 이상의 영역에 동일한 필드를 표시합니다. 시스템에서 각 컨트롤을 Name 고유하게 식별할 수 있도록 두 컨트롤 항목 모두에 대한 특성의 고유 값을 지정합니다. 이렇게 하면 탭의 컨텍스트를 기반으로 다양한 위치에서 동일한 컨트롤을 표시하는 데 유용합니다.

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

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

특성	컨트롤 형식	설명
NumberFormat	FieldControl	필드 컨트롤에 입력할 수 있는 문자를 지정합니다. 다음 값은 유효합니다. WholeNumbersSignedWholeNumbersDecimalNumbersSignedDecimalNumbers
MaxLength	FieldControl	필드 컨트롤에 사용할 수 있는 최대 문자 길이를 지정합니다.
Format	DateTimeControl	DateTimePickerFormat 열거형의 값 중 하나에 해당하는 날짜/시간 필드의 서식을 지정합니다. 유효한 값은 다음과 LongShortTime같습니다. Custom
CustomFormat	DateTimeControl	DateTimePicker.CustomFormat 속성에 대해 정의되는 구문에 해당하는 날짜/시간 필드에 사용할 사용자 지정 서식을 지정합니다.