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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

• destroywitd: 작업 항목 유형을 삭제하고 복구 없이 해당 형식의 모든 작업 항목을 영구적으로 삭제합니다.
• exportwitd: 작업 항목 형식의 정의를 XML 파일 또는 명령 프롬프트 창으로 내보냅니다.
• importwitd: XML 정의 파일에서 프로젝트로 작업 항목 형식을 가져옵니다. 이름이 같은 작업 항목 형식이 이미 있는 경우 새 작업 항목 형식 정의가 기존 항목을 덮어씁니다. 작업 항목 형식이 없으면 새 작업 항목 형식이 만들어집니다. 작업 항목 형식을 정의하지만 파일을 가져오지 않는 XML의 유효성을 검사하려면 이 /v 옵션을 사용합니다.
• listwitd: 명령 프롬프트 창의 지정된 프로젝트에 있는 작업 항목 형식의 이름을 표시합니다.
• renamewitd: 특정 프로젝트 내에서 작업 항목 형식의 표시 이름을 변경합니다. 이 명령을 실행하면 이 유형의 작업 항목에 새 이름이 표시됩니다.

작업 항목 유형을 사용하여 작업을 추적하는 방법에 대한 자세한 내용은 Azure Boards 사용자 스토리, 문제, 버그, 기능 및 에픽에서 작업 항목 추적을 참조 하세요.

witadmin 명령줄 도구 실행

명령줄 도구를 실행 witadmin 하려면 Visual Studio가 설치된 명령 프롬프트 창을 엽니다. 명령줄 도구는 witadmin 모든 버전의 Visual Studio와 함께 설치됩니다. Visual Studio Community 또는 Visual Studio 팀 탐색기의 무료 버전을 설치하여 이 도구에 액세스할 수 있습니다.

Visual Studio 2022의 경우

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

또는 Professional Enterprise Community설치한 버전에 따라 대신

Visual Studio 2019의 경우

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

또는 Professional Enterprise Community설치한 버전에 따라 대신

Visual Studio 2017의 경우

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

또는 TeamExplorer Professional Enterprise설치한 버전에 따라 대신

32비트 버전의 Windows에서 %programfiles(x86)%를 %programfiles%로 대체합니다. Visual Studio Community(팀 탐색기에 대한 액세스 제공) 또는 Visual Studio Team Explorer 2017을 무료로 설치할 수 있습니다.

필수 조건

작업 항목 형식이 정의된 프로젝트의 경우 다음 사용 권한이 설정되어 있어야 합니다.

• 작업 항목 유형을 내보내거나 나열하려면 프로젝트 관리자 그룹의 구성원이거나 프로젝트 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.
• 작업 항목 유형을 삭제, 가져오기 또는 이름을 바꾸려면 Team Foundation Administrators 보안 그룹 또는 프로젝트 관리자 보안 그룹의 구성원이어야 합니다.

자세한 내용은 프로젝트 컬렉션 수준 권한 변경을 참조하세요.

구문

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]   
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportgloballists]  
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: 사용자 지정 WIT를 추가하고 양식 레이아웃을 변경할 수 있습니다. 기능 구성 마법사에서 프로젝트를 업데이트하고 최신 기능에 액세스할 수 있습니다.

워크플로를 변경하거나 WIT 이름을 변경하려면 프로젝트를 업데이트할 때 수동 작업을 수행해야 할 수 있습니다. 안전하게 만들 수 있는 사용자 지정과 피해야 할 사항에 대해 알아보려면 작업 추적 환경 사용자 지정을 참조 하세요. 사용자 지정하기 전에 유지 관리 및 업그레이드 의미를 이해하세요.

Q: WIT와 연결된 색을 변경할 어떻게 할까요? 있나요?

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

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

A: 사용 중지하려는 작업 항목 유형이 있지만 해당 형식에 따라 만들어진 작업 항목을 유지 관리하는 경우 모든 유효한 사용자가 작업 항목 유형을 저장하지 못하도록 하는 규칙을 추가할 수 있습니다.

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

특정 WIT 만들기를 사용자 그룹으로 제한하려는 경우 액세스를 제한하는 두 가지 방법이 있습니다.

• 숨김 범주 그룹에 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를 사용하여 작업 항목을 만들지 못하도록 하려면 프로젝트에서 제거할 수 있습니다. 사용할 witadmin destroywitd때 WIT 자체뿐만 아니라 해당 WIT를 사용하여 만든 모든 작업 항목을 영구적으로 제거합니다. 예를 들어 팀에서 장애를 사용하지 않는 경우 Fabrikam 웹 사이트 프로젝트에서 WIT 레이블이 지정된 장애를 삭제할 수 있습니다.

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

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

자세한 내용은 가져오기 및 내보내기 범주를 참조 하세요.

관련된 문서

• 작업 추적 환경 사용자 지정
• 작업 항목 필드 인덱스
• witAdmin: 추적 작업을 위해 개체 사용자 지정 및 관리