사용자 지정 작업 항목 형식 수정 또는 추가(WIT)

아티클
06/10/2015

프로젝트 관리자는 다른 추적 요구 사항 또는 워크플로 프로세스를 지원하기 위해 기존 WIT(작업 항목 형식)를 수정할 수 있습니다. WIT를 수정하는 가장 일반적인 이유는 필드 집합이나 필드 규칙을 추가 또는 수정하거나, 워크플로를 변경하거나, 작업 항목 폼을 사용자 지정하기 위한 것입니다. 이러한 세 가지 이유가 WIT XML 정의 파일의 세 가지 주요 섹션(FIELDS, WORKFLOW 및 FORM)으로 구성되어 있습니다.

이러한 모든 수정을 수행하려면 WIT 정의를 편집해야 하며, 이는 TFS 온-프레미스 배포에 대해서만 수행할 수 있습니다. 이 항목에서는 사용자 지정할 수 있는 항목에 대한 개요 및 방법을 보여주는 내용에 대한 포인터를 제공합니다.

작업 항목 형식, 사용자 지정

필드, 필드 규칙, 레이블 또는 빈 텍스트 추가 또는 수정

FIELDS 섹션에 필드 및 필드 규칙을 추가합니다. 작업 항목 폼에 필드를 표시하려면 WIT 정의의 FORM 섹션에도 해당 필드를 추가해야 합니다.

예를 들어, 폼에 작업 항목 ID를 추가하려면 FORM 섹션에서 다음 XML 구문을 지정합니다.

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

필드 정의에 대한 자세한 내용은 쿼리, 보고서 및 워크플로를 지원하도록 필드 추가 또는 수정을 참조하십시오.

워크플로 상태, 이유, 전환 또는 추가 워크플로 필드 규칙 변경

WORKFLOW 내의 STATES 및 REASONS 섹션에서 상태 및 이유 필드에 선택 목록 값을 지정합니다. 이는 작업 항목의 상태를 추적합니다. TRANSITIONS 섹션에서 다음 그림과 같이 상태 간의 유효한 전환을 지정합니다. 정방향 및 회귀 전환을 모두 지정합니다.

예제 워크플로 상태 다이어그램

사용자 스토리 워크플로 상태, Agile 프로세스 템플릿

다음 목표에 맞게 워크플로를 변경합니다.

상태, 이유 또는 전환을 추가하거나 제거합니다.
상태, 이유 또는 전환을 변경하는 동안 적용할 필드의 값을 지정합니다.
상태, 이유 또는 전환을 기준으로 필드 할당을 자동화하는 사용자 지정 ACTION을 지정합니다.

워크플로를 사용자 지정할 경우 다음 두 단계를 수행하십시오.

WIT 정의 워크플로를 수정합니다.
새 워크플로 상태를 metastate에 매핑하도록 프로세스 구성을 수정합니다.

다음과 같은 경우에 이 두 번째 단계를 수행해야 합니다.
- Agile 계획 도구 페이지에 표시되는 WIT의 워크플로를 변경하는 경우. 이러한 WIT는 요구 사항 또는 작업 범주에 속합니다. 이러한 도구 구성에 대한 자세한 내용은 팀 프로젝트의 Agile 계획 도구 구성 및 사용자 지정을 참조하십시오.
- Visual Studio 2013.2 이하 버전에서 제공되는 Test Manager 클라이언트에서 작업하면서 테스트 계획 또는 테스트 도구 모음에 대한 워크플로를 변경하는 경우. 이러한 WIT는 응용 프로그램 계층 서버를 TFS 2013.3(Agile 계획 도구 페이지에 표시됨)으로 업데이트하면 제공됩니다.
  
  워크플로를 변경한 후 팀 프로젝트에 연결할 때 응용 프로그램에서 예기치 않은 오류를 발견했습니다. 오류가 발생하는 경우 새 워크플로 상태를 메타 상태에 매핑하면 해당 오류를 해결할 수 있습니다. 이 오류를 해결하려면 가져오기 및 내보내기 프로세스 구성[witadmin]를 참조하세요.

워크플로 필드 규칙

상태를 변경하거나, 이유를 지정하거나, 워크플로 전환 중에 필드 규칙을 적용할 수 있습니다.

예를 들어, EMPTY 규칙을 추가하면 상태가 활성으로 설정된 경우 닫힌 날짜 및 닫은 사람 필드를 자동으로 무효화하고 읽기 전용으로 전환할 수 있습니다. 이 기능은 닫힌 상태에서 작업 항목 폼을 다시 활성화하는 경우 유용합니다.

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>

다음 작업을 수행하는 워크플로 필드 규칙을 적용합니다.

CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY 및 REQUIRED를 지정하여 필드에 사용할 수 있는 값을 한정합니다.
COPY, DEFAULT 및 SERVERDEFAULT를 사용하여 값을 필드에 복사합니다.
필드를 수정할 수 있는 사용자를 제한합니다.
MATCH를 사용하여 문자열 필드에 패턴 일치를 적용합니다.
WHEN, WHENNOT, WHENCHANGED 및 WHENNOTCHANGED를 사용하여 다른 필드의 값에 따라 규칙을 조건부로 적용합니다.
특정 사용자 또는 그룹에 적용하도록 규칙을 제한합니다. 대부분의 규칙은 규칙을 적용할 사용자와 규칙을 적용하지 않을 사용자에 초점을 맞춘 for 또는 not 특성을 지원합니다.

워크플로 필드 규칙 적용에 대한 자세한 내용은 FIELD(워크플로) 요소를 참조하십시오.

작업 항목 폼 사용자 지정

다음 그림에서는 작업 항목 폼에 대해 가장 일반적인 요소를 강조 표시합니다. 제목 영역 및 폼 컨트롤을 제외한 모든 항목을 사용자 지정할 수 있습니다.

작업 항목 폼 요소 및 컨트롤

WIT 폼을 다음 목표에 맞게 사용자 지정할 수 있습니다.

필드를 추가 또는 제거하거나, 필드 레이블을 변경하거나, 폼에서 필드의 위치를 변경합니다. 자세한 내용은 작업 항목 폼 컨트롤 지정을 참조하십시오.
새 탭 또는 열을 추가하거나 필드 그룹을 탭 간에 이동합니다. 작업 항목 폼 디자인을 참조하십시오.
폼 채우기를 지원하는 정보 텍스트를 추가하거나, 세부 프로세스 지침을 하이퍼링크로 연결하거나, 폼에 html 텍스트를 포함하거나 동적 보고서를 표시합니다. 작업 항목 폼에서 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공을 참조하십시오.
작업 항목에 연결할 수 있는 링크 형식 또는 WIT를 제한하는 탭을 지정합니다. 링크 관계를 제한하기 위한 링크 컨트롤 정의을 참조하십시오.
파일 첨부를 지원하도록 첨부 파일 컨트롤을 추가 합니다. Attachments 컨트롤 추가을 참조하십시오.

WIT 정의 편집

WIT 정의를 편집하려면 WIT 정의 파일을 내보내고 수정한 후 가져옵니다.

WIT 개체를 사용자 지정하는 프로세스

witadmin을 사용하여 정의 파일을 가져오고 내보낼 수 있습니다. 개체에 대한 XML 구문을 수정하는 데 사용할 수 있는 다른 도구로는 TFS 파워 도구에서 다운로드하여 사용할 수 있는 프로세스 편집기 또는 CodePlex에서 사용 가능한 커뮤니티 리소스 프로젝트인 TFS Team Project Manager가 있습니다.

팀 프로젝트에 대해 관리 권한이 없는 경우 권한을 얻으십시오.
Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.
```
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
```
64비트 버전의 Windows에서는 %programfiles%를 %programfiles(x86)%로 바꿉니다. 여기로 이동하여 팀 탐색기를 무료로 다운로드할 수 있습니다.
필드를 수정하거나 추가할 WIT 정의 파일을 내보냅니다. WIT와 파일의 이름을 지정합니다.
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"
```
CollectionURL의 예로는 http://MyServer:8080/tfs/TeamProjectCollectionName이 있습니다.
파일을 편집합니다. 자세한 내용은 작업 항목 추적: XML 요소 정의에 대한 인덱스를 참조하십시오.

WIT 정의 파일을 가져옵니다.

witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

변경 내용을 보려면 TWA 또는 팀 탐색기를 엽니다. 클라이언트가 이미 열려 있는 경우 페이지를 새로 고칩니다.

팀 탐색기에서 새로 고침 단추를 선택합니다.

방금 가져온 변경 내용을 포함한 최신 업데이트를 서버에서 다운로드됩니다. 새로 고침이 완료될 때까지 몇 초 동안 기다리십시오.

witadmin 사용에 대한 자세한 내용은 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin]를 참조하십시오.

Q & A

Q: 태그를 사용하여 작업하려면 어떻게 해야 합니까?

A: 태그를 추가하고 목록을 필터링하는 방법에 대해 알아보려면 여기로 이동하십시오.

Q: TFS 업그레이드 후에 어떤 사용자 지정을 수행할 수 있으며 기능 구성 마법사를 계속 사용하여 팀 프로젝트를 업데이트할 수 있나요?

A: 사용자 지정 WIT를 추가하고 폼 레이아웃을 변경할 수 있습니다. 기능 구성 마법사에서는 팀 프로젝트를 업데이트하며, 그러면 최신 기능에 액세스할 수 있게 됩니다.

WIT 이름을 바꾸거나 워크플로를 변경하려면 팀 프로젝트 업데이트 시 몇 가지 수동 작업을 수행해야 할 수도 있습니다. 수행해도 안전한 기타 사용자 지정 작업과 수행하지 말아야 하는 작업에 대한 자세한 내용은 작업 추적 환경 사용자 지정: 사용자 지정 전에 유지 관리 및 업그레이드의 영향 파악을 참조하세요.

Q: 새 WIT를 추가하려면 어떻게 해야 합니까?

A: 기존 WIT를 복사한 다음 정의 파일을 수정하면 새 WIT를 가장 쉽게 추가할 수 있습니다. 예제를 보려면 작업 항목 형식 만들기를 참조하십시오.

Q: WIT의 이름을 바꿀 수 있습니까?

A: 예. 기존 WIT의 이름을 바꾸려면 witadmin renamewitd를 사용합니다. 예를 들어, 레이블이 “QoS Item”인 WIT의 이름을 “Service Agreement”로 바꿀 수 있습니다.

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

범주에 속하는 WIT의 이름을 바꾸면 새 이름이 반영되도록 팀 프로젝트에 대한 범주 정의를 업데이트해야 합니다. 특히, 범주 정의를 업데이트할 때까지 Agile 계획 도구가 작동하지 않습니다.

자세한 내용은 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin] 및 I범주 가져오기 및 내보내기[witadmin]를 참조하십시오.

Q: WIT를 비활성화하거나 사용하지 않도록 설정하려면 어떻게 할까요?사용자가 특정 형식의 작업 항목을 만들지 못하도록 제한하려면 어떻게 할까요?

A: 사용을 중지하려는 WIT가 있지만 해당 형식을 기반으로 생성된 작업 항목을 유지하려면 모든 유효한 사용자가 작업 항목 형식을 저장하지 못하도록 설정하는 규칙을 추가할 수 있습니다.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

특정 WIT 만들기를 사용자 그룹으로 제한하려면 다음과 같은 두 가지 방법으로 액세스를 제한할 수 있습니다.

Hidden Categories 그룹에 WIT를 추가하여 대부분의 참가자가 WIT를 만들지 못하도록 방지합니다. 사용자 그룹의 액세스를 허용하려면 작업 항목 폼을 여는 템플릿에 대한 하이퍼링크를 만들고 작업 항목 폼을 만들 수 있게 하려는 팀 멤버와 해당 링크를 공유합니다.
System.CreatedBy 필드의 경우 워크플로에 필드 규칙을 추가하여 사용자 그룹이 특정 형식의 작업 항목을 만들 수 없도록 효과적으로 제한합니다. 다음 예에서 보듯이 작업 항목을 저장하려면 작업 항목을 만드는 사용자는 Allowed Group에 속해야 합니다.
```
<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION> 
```

Q: WIT를 삭제하려면 어떻게 해야 합니까?

A: 팀 멤버가 작업 항목을 만들 때 특정 WIT를 사용하지 못하도록 방지하기 위해 팀 프로젝트에서 해당 WIT를 제거할 수 있습니다. witadmin destroywitd를 사용하는 경우 WIT를 사용하여 만든 모든 작업 항목과 WIT 자체를 영구적으로 제거합니다. 예를 들어, 팀에서 "장애"를 사용하지 않는 경우 Fabrikam 웹 사이트 프로젝트에서 "장애"라는 레이블이 지정된 WIT를 삭제할 수 있습니다.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

범주에 속하는 WIT를 삭제하는 경우 새 이름이 반영되도록 팀 프로젝트에 대한 범주 정의를 업데이트해야 합니다. 특히, 범주 정의를 업데이트할 때까지 Agile 계획 도구가 작동하지 않습니다.

자세한 내용은 작업 항목 형식 가져오기, 내보내기 및 관리[witadmin] 및 I범주 가져오기 및 내보내기[witadmin]를 참조하십시오.

Q: WIT와 연결된 색을 변경할 수 있습니까?

A: 예. Team Web Access에서 작업 항목은 쿼리 결과와 Agile 계획 도구의 백로그 및 보드 페이지에 표시됩니다. 기존 WIT와 연결된 색을 변경하거나 새 WIT에 사용할 색을 추가하려면 프로세스 구성을 편집합니다.

다른 작업 항목 형식에 색 지정

Q: 백로그 또는 작업 보드에서 WIT를 추가하거나 제거할 수 있습니까?

A: 예. Agile 계획 도구(제품 백로그, 스프린트 백로그 및 작업 보드 페이지)는 팀 프로젝트를 만드는 데 사용되는 프로세스 템플릿을 기반으로 특정 WIT를 표시합니다. 이러한 페이지에 표시할 WIT를 추가하거나 제거할 수 있습니다. 예를 들어, 팀 프로젝트에서 스크럼 WIT를 사용하는 경우 제품 백로그 팀과 버그가 모두 백로그 페이지에 표시됩니다. Agile, CMMI 또는 프로세스 템플릿을 사용하여 팀 프로젝트를 만든 경우 버그는 백로그 또는 작업 보드에 표시되지 않습니다.

예를 들어, 제품 백로그 페이지에서 버그를 추가할 수 있습니다.

버그 작업 항목 형식이 추가된 업데이트된 패널

백로그 또는 작업 보드에서 WIT를 추가하거나 제거하는 방법을 보려면 여기로 이동하십시오. 포트폴리오 백로그를 지원하기 위해 새 WIT를 추가하려면 여기로 이동하십시오.

Q: WIT를 수정하면 기존 작업 항목에 어떠한 영향을 미칩니까?

A: 다음 표에 필드 또는 WIT 정의를 수정하는 경우 기존 작업 항목에 미치는 영향이 요약되어 있습니다.

동작	기존 작업 항목에 미치는 영향
WIT에서 필드 제거	제거한 필드의 데이터는 데이터 저장소에 남아 있게 됩니다. 그러나 WIT 정의에서 제거했기 때문에 새 데이터를 추가할 수 없습니다.
필드 이름 바꾸기	이름을 바꾼 필드의 데이터는 데이터 저장소에 새로운 이름으로 남아 있게 됩니다.
필드 삭제	삭제한 필드의 데이터는 데이터 저장소에서 제거됩니다.
WIT 이름 바꾸기	모든 데이터가 새 이름으로 그대로 남아 있게 됩니다.
WIT 삭제	삭제한 WIT로 만든 작업 항목의 모든 데이터는 영구적으로 제거되며 복구할 수 없습니다.

데이터 저장소에서 필드를 완전히 제거하려면 witadmin deletefield 명령줄 도구를 사용합니다. 작업 항목 필드 관리[witadmin]을 참조하십시오.

Q: 기존 작업 항목의 형식을 변경하려면 어떻게 할까요?

A: 기존 작업 항목의 형식은 변경할 수 없지만, 작업 항목을 복사한 다음 새 형식을 지정할 수 있습니다. 예를 들어, 다음 그림과 같이 기존 제품 백로그 항목을 복사하여 형식을 버그로 변경할 수 있습니다.

작업 항목을 복사하고 새 형식을 지정합니다.

형식을 변경하려는 작업 항목이 여러 개 있는 경우 Excel을 사용하여 작업 항목을 내보낸 다음 새 형식으로 다시 추가할 수 있습니다.

Q: TFS에서 작업 항목을 삭제할 수 있습니까?

A: 예. witadmin destroywi를 사용하여 작업 항목을 데이터베이스에서 영구히 제거합니다.

Q: WIT 사용자 지정 및 TFS 업그레이드에 대해 알아야 할 사항은 무엇입니까?

A: 업그레이드된 팀 프로젝트가 새 기능에 액세스할 수 있도록 업데이트를 참조하십시오.

Q: 추가 질문이 있으면 어디에 문의해야 합니까?

A: Team Foundation Server - 프로젝트 관리 및 작업 항목 포럼에서 대답을 검색하거나 질문을 게시할 수 있습니다.

자세한 내용은 작업 항목 폼 컨트롤 지정을 참조하십시오.

TFS 파워 도구를 다운로드하면 사용할 수 있는 프로세스 편집기로 워크플로를 수정하거나 워크플로의 상태 다이어그램을 볼 수 있습니다.

다음을 통해 공유