work item type [witadmin] 작업 항목 형식 가져오기, 내보내기 및 관리 (Import, export, and manage work item types)

황제낙엽 2016.03.23 17:27 조회 수 : 270

sitelink1 https://msdn.microsoft.com/en-us/library...20%29.aspx 
sitelink2 https://msdn.microsoft.com/ko-kr/library...20%29.aspx 
sitelink3  

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

Visual Studio 2013

다른 버전

 

다음 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%로 바꿉니다.

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

참고참고

Visual Studio의 강력한 도구인 프로세스 편집기를 사용하여 작업 항목 형식을 만들고 수정할 수 있습니다. 이 도구는 지원되지 않습니다. 자세한 내용은 Microsoft 웹 사이트의 Team Foundation Server 파워 도구 페이지를 참조하세요.

요구 사항

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

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

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

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

참고참고

관리 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에서 이 기능을 수행하려면 관리자 권한 명령 프롬프트 창을 열어야 합니다. 관리자 권한 명령 프롬프트 창을 열려면 시작을 선택하고 명령 프롬프트에 대한 바로 가기 메뉴를 연 다음 관리자 권한으로 실행을 선택합니다. 자세한 내용은 Microsoft 웹 사이트 사용자 액세스 제어를 참조하세요.

 
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]

 

매개 변수

매개 변수

설명

/collection:CollectionURL

팀 프로젝트 컬렉션의 URI를 지정합니다. URI의 형식은 다음과 같습니다. http://ServerName:Port/VirtualDirectoryName/CollectionName

가상 디렉터리를 사용하지 않는 경우 URI 형식은 다음과 같습니다.

http://ServerName:Port/CollectionName

/p: Project

작업 항목 형식을 관리할 팀 프로젝트입니다. 이 팀 프로젝트는 /collection 매개 변수에 의해 지정된 프로젝트 컬렉션에 정의되어야 합니다.

/v 옵션으로 importwitd 명령을 실행하는 경우가 아니면 /p 매개 변수를 사용해야 합니다.

/n: TypeName

제거하거나 내보내거나 가져오거나 이름을 바꿀 작업 항목 형식의 이름입니다.

/f: FileName

내보내거나 가져올 작업 항목 형식이 들어 있는 XML 정의 파일의 경로 및 파일 이름입니다. exportwitd 명령을 사용할 때 이 매개 변수를 생략하면 명령 프롬프트 창에 XML이 표시됩니다.

참고 참고

Windows Vista를 사용하는 경우에는 특정 폴더에 대한 권한이 없을 수 있습니다. 권한이 없는 위치로 작업 항목 형식을 내보내면 레지스트리 가상화 기술이 내보낸 파일을 자동으로 리디렉션하여 가상 저장소에 저장합니다. 이러한 리디렉션을 방지하려면 권한이 있는 위치로 파일을 내보내면 됩니다. 레지스트리 가상화에 대한 자세한 내용은 Microsoft 웹 사이트 레지스트리 가상화 및 Windows Vista의 일반 파일 및 레지스트리 가상화 문제를 참조하세요.

/e: Encoding

.NET Framework 2.0 인코딩 형식의 이름입니다. 이 명령은 지정된 인코딩을 사용하여 XML 데이터를 가져오거나 내보냅니다. 예를 들어 /e:utf-7은 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 생략하면 witadmin에서 인코딩 검색을 시도하고 검색에 실패하면 witadmin은 UTF-8을 사용합니다.

/exportgloballists

작업 항목 형식에서 참조하는 전역 목록 정의를 내보냅니다. 전역 목록 정의는 작업 항목 형식 정의 XML에 포함됩니다. 이 매개 변수를 지정하지 않으면 전역 목록의 정의를 생략합니다.

/v

작업 항목 형식을 정의하는 XML의 유효성을 검사하되 XML 정의 파일을 가져오지는 않습니다.

참고 참고

팀 프로젝트를 지정하지 않고 형식 정의의 유효성을 검사할 수 있습니다. 프로젝트 범위 그룹에 대한 참조는 무시됩니다.

/new: NewName

작업 항목 형식의 새 이름입니다.

/noprompt

확인 프롬프트가 표시되지 않도록 설정합니다.

/? 또는 help

명령 프롬프트 창에 명령에 대한 도움말을 표시합니다.

 

설명

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: 작업 추적을 위한 개체 사용자 지정 및 관리

이 게시물을
목록
쓰기 태그