다음을 통해 공유

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

  • 아티클

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

[!참고]

전역 목록은 팀 프로젝트와 동일한 범위가 아니므로 프로젝트 범위의 보안 그룹을 포함하면 안 됩니다.

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

  • destroygloballist: 전역 목록을 소멸시킵니다.

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

  • importgloballist: XML 파일에서 전역 목록을 가져옵니다.서버에 이미 있는 전역 목록을 가져오려고 하면 서버에 있는 전역 목록을 덮어쓸 것인지 묻는 경고 메시지가 나타납니다.아직 존재하지 않는 전역 목록을 가져오려고 하면 명령은 새 전역 목록을 만듭니다.

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

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

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

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

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

[!참고]

프로세스 편집기, Visual Studio용 강력한 도구를 사용하여 전역 목록을 만들고 수정할 수 있습니다.이 도구는 지원되지 않습니다.자세한 내용은 Microsoft 웹 사이트에서 Team Foundation Server Power Tools 페이지에 나와 있다.

요구 사항

전역 목록이 정의된 팀 프로젝트 컬렉션의 경우 다음 사용 권한이 설정되어 있어야 합니다.

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

  • 전역 목록을 삭제하거나 가져오려면 Team Foundation Administrators 보안 그룹 또는 Project Administrators 보안 그룹의 멤버여야 합니다.

Team Foundation Server 권한 및 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

매개 변수

Parameter

설명

/collection:CollectionURL

팀 프로젝트 컬렉션의 URI를 지정합니다.URI에 대한 형식: http://ServerName:Port/VirtualDirectoryName/CollectionName

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

http://ServerName:Port/CollectionName.

/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]을 참조하십시오.

예제

별도로 지정하지 않으면 각 예제에서는 다음과 같은 값이 적용됩니다.

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

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

Dd236912.collapse_all(ko-kr,VS.110).gif전역 목록의 이름 표시

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

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

Dd236912.collapse_all(ko-kr,VS.110).gif전역 목록 정의 내보내기

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

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

Dd236912.collapse_all(ko-kr,VS.110).gif전역 목록 정의 가져오기

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

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