작업 항목 형식 가져오기, 내보내기 및 관리[witadmin]

다음 witadmin 명령을 사용하면 팀 프로젝트의 작업 항목 형식을 관리할 수 있습니다.

• destroywitd: 작업 항목 형식을 제거하고 해당 형식의 모든 작업 항목을 복구할 수 없도록 영구적으로 제거합니다.

• exportwitd: 작업 항목 형식의 정의를 XML 파일 또는 명령 프롬프트 창으로 내보냅니다.

• importwitd: XML 정의 파일의 작업 항목 형식을 Team Foundation Server를 실행하는 서버의 팀 프로젝트로 가져옵니다. 이름이 같은 작업 항목 형식이 이미 있으면 새 작업 항목 형식 정의가 기존 정의를 덮어씁니다. 작업 항목 형식이 아직 없는 경우 이 명령은 새 작업 항목 형식을 만듭니다. 파일을 가져오지 않고 작업 항목 형식을 정의하는 XML의 유효성을 검사하려면 /v 옵션을 사용합니다.

• listwitd: 지정한 프로젝트의 작업 항목 형식 이름을 명령 프롬프트 창에 표시합니다.

• renamewitd: 특정 프로젝트 내의 작업 항목 형식 표시 이름을 변경합니다. 이 명령을 실행하고 나면 해당 형식의 작업 항목이 새 이름으로 표시됩니다.

witadmin 명령줄 도구를 실행하려면 Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

32비트 버전의 Windows에서는 **%programfiles(x86)%**를 **%programfiles%**로 바꿉니다.

작업 항목 형식에 대한 자세한 내용은 프로세스 템플릿에 작업 항목에 대한 형식 정의 추가을 참조하세요.

요구 사항

작업 항목 형식이 정의되는 팀 프로젝트에 대해 다음과 같은 권한 집합이 있어야 합니다.

• 작업 항목 형식을 내보내거나 나열하려면 Project Administrators 그룹의 멤버이거나 프로젝트 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.

• 작업 항목 형식을 제거하거나 가져오거나 이름을 바꾸려면 Team Foundation Administrators 보안 그룹 또는 Project Administrators 보안 그룹의 멤버여야 합니다.

자세한 내용은 Team Foundation Server에 대한 사용 권한 참조을 참조하십시오.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

매개 변수

설명

destroywitd 명령 사용 시에는 다음 개체가 모두 제거됩니다.

• 작업 항목 형식

• 해당 형식의 모든 작업 항목

• 작업 항목 테이블, 긴 텍스트 테이블 및 링크 테이블의 해당 항목

• 작업 항목 형식 메타데이터 캐시의 개체

예제

달리 지정하지 않은 경우 각 예제에 다음과 같은 값이 적용됩니다.

• 팀 프로젝트 컬렉션 URI: http://AdventureWorksServer:8080/tfs/DefaultCollection

• 프로젝트 이름: AdventureWorks

• 입력 또는 출력 파일 이름: myworkitems.xml

• 작업 항목 형식 이름: myworkitem

• 기본 인코딩: UTF-8

WIT의 정의 내보내기

다음 명령은 myworkitem의 정의를 myworkitems.xml 파일로 내보냅니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

다음 예에서는 유니코드(UTF-7) 인코딩을 사용하여 작업 항목을 내보냅니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

WIT의 정의 및 참조되는 전역 목록 내보내기

다음 예에서는 작업 항목 형식과 참조되는 전역 목록을 내보냅니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

WIT의 정의 나열

다음 예에서는 작업 항목 형식의 정의를 명령 프롬프트 창에 표시합니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

WIT 정의 가져오기

다음 예에서는 XML 파일에서 작업 항목 정의를 가져옵니다.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

WIT의 XML 정의 유효성 검사

다음 예에서는 작업 항목 형식을 정의하는 XML의 유효성을 검사하되 정의를 가져오지는 않습니다.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Q & A

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

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

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

Q: WIT와 연결된 색을 변경할 수 있나요?

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

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 계획 도구가 작동하지 않습니다.

자세한 내용은 I범주 가져오기 및 내보내기[witadmin]을 참조하십시오.

참고 항목

작업

작업 항목 형식 만들기

개념

팀 프로세스를 지원하도록 작업 추적 개체 사용자 지정

기타 리소스

witAdmin: 작업 추적을 위한 개체 사용자 지정 및 관리