전역 목록 정의

  • 아티클

TFS(Team Foundation Server)에서 전역 목록을 사용하면 여러 WIT(작업 항목 형식)의 정의에 표시되는 목록을 업데이트하는 데 필요한 작업을 최소화할 수 있습니다. 전역 목록은 하나 이상의 필드와 WIT 정의 내에 포함할 수 있는 선택 목록입니다. 팀 프로젝트에 추가할 WIT 내에서 팀 프로젝트 컬렉션의 전역 목록으로 또는 전역 워크플로 내에서 전역 목록을 정의할 수 있습니다. 하나 이상의 GLOBALLIST 요소에 목록 항목을 포함하여 컬렉션의 여러 WIT 간에 목록 항목을 공유할 수 있습니다.

WIT를 정의할 때 일부 필드에서 같은 값을 공유하는 경우를 확인할 수 있습니다. 대부분의 경우 여러 WIT뿐만 아니라 여러 팀 프로젝트 간에도 값을 공유할 수 있습니다. 이와 같은 값 중에서 야간 빌드의 빌드 번호와 같은 일부 값은 자주 변경되므로 관리자가 여러 위치에서 이러한 목록을 자주 업데이트해야 합니다. 전역 목록은 외부 시스템에서 목록을 파생해야 하는 경우 특히 유용합니다. 회사에서 별도의 고객 데이터베이스를 유지 관리하는 경우를 예로 들어 보겠습니다. 고객이 발견한 버그를 파일로 작성할 때는 사용자 지정 Found By Customer 필드에 고객 이름을 입력합니다.

컬렉션의 전역 목록은 나열/가져오기/내보내기/삭제가 가능한 XML 파일로 관리할 수 있습니다. 각 전역 목록의 이름은 최대 254자의 유니코드 문자를 포함할 수 있으며 컬렉션 내에서 고유해야 합니다.

참고

시스템 정의 전역 목록은 없으며 TFS에서 제공하는 기본 프로세스 템플릿에도 미리 정의된 전역 목록은 없습니다.

요구 사항

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

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

  • 전역 목록을 추가하거나 수정하려면 witadmin 명령줄 도구를 사용하여 전역 목록의 정의를 가져오고 내보냅니다. 작업 항목 형식의 전역 목록 관리[witadmin]을 참조하세요. 전역 목록을 사용하려면 작업 항목 형식 내의 FIELD 정의에 전역 목록을 추가합니다. 모든 FIELD XML 요소 참조을 참조하세요.

전역 목록 추가 및 관리

전역 목록은 컬렉션 내의 모든 팀 프로젝트에서 전역적으로 사용하고 저장하는 LISTITEM 요소 집합입니다. 운영 체제, 발견된 빌드, 수정된 빌드 등 여러 작업 항목 형식 내에서 정의되는 필드의 경우 전역 목록을 사용하면 유용합니다.

다음 방법 중 하나로 전역 목록과 해당 항목을 정의할 수 있습니다.

  • 팀 프로젝트 컬렉션: 팀 프로젝트 컬렉션용으로 정의된 전역 목록을 내보내고 수정하고 삭제하고 가져올 수 있습니다. 컬렉션의 모든 팀 프로젝트에서 이러한 전역 목록을 사용할 수 있습니다.

  • 작업 항목 형식 정의: 팀 프로젝트를 만든 후에는 특정 작업 항목 형식에 대해 사용할 전역 목록을 작업 항목 형식의 정의에 추가할 수 있습니다.

  • 전역 워크플로 정의: 팀 프로젝트를 만든 후에는 모든 작업 항목 형식에 대해 사용할 전역 목록을 팀 프로젝트 또는 컬렉션에 대한 전역 워크플로 정의에 추가할 수 있습니다. 자세한 내용은 전역 워크플로 사용자 지정을 참조하십시오.

구문 구조

다음 표에서는 GLOBALLIST 및 LISTITEM 요소에 대해 설명합니다. 이러한 요소를 사용하여 사용자에게 항목 드롭다운 메뉴 또는 선택 목록으로 표시되는 값 목록을 열거할 수 있습니다.

요소

구문

설명

GLOBALLIST

 
<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

컬렉션에 대해 저장되며 컬렉션의 모든 팀 프로젝트에서 사용할 수 있는 LISTITEM 요소 집합을 정의합니다.

globalListName: 1~255자 사이의 텍스트 문자열입니다.

GLOBALLIST는 GLOBALLISTS 요소의 필수 자식 요소이자 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다. 자세한 내용은 선택 목록 정의을 참조하십시오.

LISTITEM

 
<LISTITEM value="Name" />

유효한 목록 값을 정의합니다.

참고

전역 목록은 프로젝트 범위로 지정되지 않으므로 프로젝트 범위 그룹을 포함해서는 안 됩니다.

LISTITEM은 GLOBALLIST 요소의 필수 자식 요소이자 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다.

예제 전역 목록

다음 구문을 추가하면 작업 항목 형식 또는 전역 워크플로에 대해 XML 정의 파일 내에 전역 목록을 정의할 수 있습니다.

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

다음 구문을 사용하면 작업 항목 형식에 대해 XML 정의 파일 내에서 전역 목록을 참조할 수 있습니다.

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

작업 항목 형식 또는 전역 워크플로의 정의 파일 구조와 위치에 대한 자세한 내용은 모든 WITD XML 요소 참조 또는 전역 워크플로 XML 요소 참조를 각각 참조하세요.

프로젝트 컬렉션에 대해 유지 관리되는 예제 전역 목록

프로젝트 컬렉션에 전역 목록을 추가하려는 경우 witadmin importgloballist 명령을 사용하여 다음 구문을 가져오면 됩니다.

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

전역 목록은 비워 둘 수 없습니다. 각 GLOBALLIST 요소에는 LISTITEM 요소가 한 개 이상 정의되어 있어야 합니다.

Q & A

Q: 전역 목록에는 데이터가 자동으로 채워지나요?

A: 예. 빌드를 실행할 때마다 이름이 빌드 – TeamProjectName인 전역 목록이 추가됩니다. 시간이 지남에 따라 목록이 매우 길어질 수 있으므로 목록에서 사용되지 않는 항목을 정기적으로 제거하는 것이 좋습니다.

이 목록을 사용하는 방법에 대한 자세한 내용은 테스트, 빌드 및 버전 제어와의 통합을 지원하는 필드를 참조하세요.

참고 항목

참조

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

개념

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