다음을 통해 공유


작업 항목 형식의 전역 목록 관리[witadmin]

전역 목록은 하나 이상의 필드와 작업 항목 형식에 포함할 수 있는 선택 목록입니다. 전역 목록을 사용하면 여러 작업 항목 형식에서 공유하는 목록을 업데이트해야 하는 작업을 최소화할 수 있습니다. 전역 목록은 팀 프로젝트 컬렉션에 대해 정의되므로 컬렉션 내의 모든 팀 프로젝트에 대한 작업 항목 형식에 포함될 수 있습니다.

자체 정의 파일, 작업 항목 형식의 정의 파일 또는 전역 워크플로에서 전역 목록을 정의할 수 있습니다. 전역 목록 정의는 컬렉션에 대해 정의된 전역 목록을 관리합니다. 전역 목록 정의에서는 witadmin 명령줄 도구의 다음 명령을 사용합니다.

  • destroygloballist: 전역 목록을 삭제합니다.

  • exportgloballist: 전역 목록을 XML 파일 또는 명령 프롬프트 창으로 내보냅니다. 이때 팀 프로젝트 컬렉션에 대해 정의된 모든 전역 목록이 포함된 단일 파일을 내보냅니다.

  • importgloballist: XML 파일에서 전역 목록을 가져옵니다. 서버에 이미 있는 전역 목록을 가져오려고 하면 서버에 있는 전역 목록을 덮어쓸지 묻는 경고가 표시됩니다. 서버에 없는 전역 목록을 가져오는 경우에는 새 전역 목록이 자동으로 만들어집니다.

  • listgloballist: 서버에 정의된 각 전역 목록의 이름을 표시합니다.

전역 목록 정의전역 워크플로 사용자 지정을 참조하십시오.

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

cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE

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

참고

Visual Studio용 강력한 도구인 프로세스 편집기를 사용하여 전역 목록을 만들고 수정할 수 있습니다.자세한 내용은 Team Foundation Server 파워 도구를 참조하세요.

요구 사항

전역 목록이 정의된 팀 프로젝트 컬렉션에 대해 다음 권한 집합이 있어야 합니다.

  • 전역 목록을 내보내거나 나열하려면 Project Collection Valid Users 그룹의 멤버이거나 컬렉션 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.

  • 전역 목록을 가져오려면 Project Administrators 보안 그룹의 멤버이거나 프로젝트 수준 정보 편집 권한이 허용으로 설정되어 있어야 합니다.

  • witadmin destroygloballist를 사용하여 전역 목록을 삭제하려면 Project Collection Administrators 보안 그룹의 멤버이거나 컬렉션 수준 정보 편집 권한이 허용으로 설정되어 있어야 합니다.

Team Foundation Server에 대한 사용 권한 참조을 참조하세요.

참고

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

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

매개 변수

매개 변수

설명

/collection:CollectionURL

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

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

http://ServerName:Port/CollectionName 형식의 URI를 지정해야 합니다.

/n:GlobalListName

삭제할 전역 목록의 이름입니다.

/f:FileName

내보내거나 가져올 전역 목록 XML 정의 파일의 경로 및 이름입니다.

참고

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

/e:Encoding

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

/noprompt

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

/? 또는 help

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

설명

존재하지 않는 전역 목록을 가져오면 목록이 만들어집니다. 목록이 이미 있는 경우에는 witadmin importgloballist 명령에서 현재 목록을 덮어쓰게 된다는 경고 메시지를 표시합니다. 기존 전역 목록을 업데이트하는 고유 프로그램을 작성하거나, 새 데이터로 전역 목록을 직접 업데이트할 수 있습니다.

새 전역 목록을 만들려면 다음 코드로 시작하여 필요에 따라 코드를 수정합니다. 다음 예제에서는 작업에 할당할 수 있는 분야의 전역 목록을 정의합니다.

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST> 
</gl:GLOBALLISTS>

전역 목록은 프로젝트가 아니라 컬렉션으로 범위가 지정되므로 프로젝트 범위의 보안 그룹을 전역 목록 내에 포함하지 마세요.

전역 목록을 필드에 추가하려면 다음 예제에 표시된 대로 해당 필드를 포함하는 작업 항목 형식에 대한 정의를 내보내 필드 정의에 추가합니다.

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

변경 내용을 보려면 형식 정의를 가져온 다음 브라우저 또는 클라이언트 캐시를 새로 고칩니다. 해당 필드를 참조하는 모든 작업 항목을 닫았다가 다시 열어야 할 수 있습니다.

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

예제

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

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

  • 서버 웹 사이트 포트 번호: 8080

전역 목록의 이름 표시

다음 예제에서는 서버에 정의된 전역 목록을 보여 줍니다. 이 예제에서는 기본 UTF-8 인코딩을 사용하여 전역 목록을 내보냅니다.

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection 

전역 목록 정의 내보내기

다음 예제에서는 전역 목록을 내보냅니다.

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

다음 예제에서는 유니코드(UTF-7) 인코딩을 사용하여 동일한 전역 목록을 동일한 서버에 내보냅니다.

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

전역 목록 정의 가져오기

다음 예제에서는 전역 목록을 가져옵니다.

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml 

다음 예제에서는 유니코드(UTF-7) 인코딩을 사용하여 동일한 전역 목록을 동일한 서버로 가져옵니다.

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

참고 항목

개념

전역 목록 정의

기타 리소스

전역 워크플로 사용자 지정

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