선택 목록 정의
업데이트: 2011년 1월
필드 정의의 일부로, 또는 워크플로 중의 특정 시점에 선택 목록을 정의하여 필드의 값 집합을 열거할 수 있습니다. 목록이 허용된 값만 포함하거나, 금지된 값을 포함할 수 없거나, 값을 제안하도록 지정할 수 있습니다. 값이 제안되는 경우 사용자는 선택 목록의 값과 다른 값을 지정할 수 있습니다.
또한 종속 선택 목록을 정의할 수도 있습니다. 이 경우 한 필드에 두 개 이상의 목록을 정의하지만 런타임에는 조건부 규칙의 적용에 따라 목록이 하나만 나타납니다.
항목 내용
선택 목록을 열거하기 위한 구문 구조
GLOBALLIST 및 LISTITEM 요소의 구문 구조
기존 값 허용
허용되는 값 집합 열거
종속 선택 목록 정의
선택 목록을 열거하기 위한 구문 구조
ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소를 사용하여 사용자가 필드의 값으로 지정해야 하거나 지정할 수 있거나 지정하면 안 되는 값의 목록을 지정할 수 있습니다. 이러한 각 요소를 사용할 경우 항목의 목록을 열거하거나 전역 목록을 지정할 수 있습니다. 선택 목록에서 항목을 제거할 경우 ALLOWEXISTINGVALUE를 사용하여 필드에 기존 값을 저장하도록 할 수 있습니다.
이러한 요소는 FIELD(정의) 또는 FIELD(워크플로) 요소의 자식 요소로 지정할 수 있습니다.
ALLOWEDVALUES를 사용하여 사용자가 작업 항목 폼에서 또는 쿼리 편집기에서 지정할 수 있는 값 목록을 정의합니다. 사용자는 GLOBALLIST 또는 LISTITEM 항목 집합에 있는 값 중 하나를 지정해야 합니다.
<ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups"> <GLOBALLIST name="globalListName" /> <LISTITEM value="Name1" /> <LISTITEM value="Name2" /> <LISTITEM value="Name3" /> . . . </ALLOWEDVALUES>PROHIBITEDVALUES를 사용하여 필드에 포함할 수 없는 값 목록을 정의합니다. 금지된 값이 필드에 포함되어 있으면 사용자는 작업 항목을 저장할 수 없습니다. 이전에는 허용되었지만 이제 더 이상 유효하지 않은 값의 사용을 제한하려는 경우 이 요소를 사용합니다.
<PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups"> <GLOBALLIST name="globalListName" /> <LISTITEM value="Name1" /> <LISTITEM value="Name2" /> <LISTITEM value="Name3" /> . . . </PROHIBITEDVALUES>SUGGESTEDVALUES를 사용하여 필드에 포함할 수 있는 값 목록을 정의합니다. 사용자는 제안된 값 이외의 값을 지정할 수 있습니다.
<SUGGESTEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups"> <GLOBALLIST name="globalListName" /> <LISTITEM value="Name1" /> <LISTITEM value="Name2" /> <LISTITEM value="Name3" /> . . . </SUGGESTEDVALUES>
이러한 각 요소에 대해 다음 표에서 설명하는 특성을 두 개 이상 지정할 수 있습니다.
특성 |
설명 |
|---|---|
for |
선택적 요소로서, 규칙을 적용할 Team Foundation의 사용자 또는 그룹 이름을 지정합니다. 유효한 이름은 1~255자를 포함하는 텍스트 문자열로 구성됩니다. 패턴 값: ^[^\\]+\\[^\\]+$ 패턴 값 예: Domain\UserID |
not |
선택적 요소로서, 규칙을 적용하지 않을 Team Foundation의 사용자 또는 그룹 이름을 지정합니다. 유효한 이름은 1~255자를 포함하는 텍스트 문자열로 구성됩니다. 패턴 값: ^[^\\]+\\[^\\]+$ 패턴 값 예: Domain\UserID |
expanditems |
선택적 요소로서, 목록에 하위 그룹을 포함하기 위해 LISTITEM 요소에서 식별된 그룹을 확장할지 여부를 지정합니다. 기본값은 true입니다. |
filteritems |
선택적 요소로서, 목록에 그룹 이름이 아닌 그룹 멤버만 포함되도록 지정합니다. 이 특성의 유일한 유효 값은 excludegroups입니다. |
자세한 내용은 목록, 선택 목록 및 전역 목록 정의 및 사용을 참조하십시오.
맨 위로 이동
GLOBALLIST 및 LISTITEM 요소의 구문 구조
GLOBALLIST 및 LISTITEM 요소를 사용하여 전역적으로 업데이트할 수 있거나 단일 필드와 관련된 항목 목록을 열거할 수 있습니다.
GLOBALLIST를 사용하여 팀 프로젝트 컬렉션에 대해 저장되며 해당 컬렉션의 모든 팀 프로젝트에서 사용할 수 있는 LISTITEM 요소 집합을 정의합니다. GLOBALLIST는 GLOBALLISTS 요소의 필수 자식 요소이며 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다. 전역 목록은 작업 항목 정의, 전역 목록 정의 또는 전역 워크플로 내에서 정의할 수 있습니다.
<GLOBALLIST name="globalListName"> <LISTITEM value="Name1" /> <LISTITEM value="Name2" /> <LISTITEM value="Name3" /> . . . </GLOBALLIST>globalListName: 1~255자를 포함하는 텍스트 문자열입니다.
중요
작업 항목 형식을 정의하는 XML 파일에 전역 목록을 정의할 경우에는 목록에 고유한 이름을 지정해야 합니다. 그러지 않으면 컬렉션에 대해 정의된 기존 전역 목록을 덮어쓰게 될 수 있습니다.
LISTITEM을 사용하여 값 집합을 열거합니다. LISTITEM은 GLOBALLIST 요소의 필수 자식 요소이며 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다.
<LISTITEM value="listName" />listName: 1~255자를 포함하는 텍스트 문자열입니다.
맨 위로 이동
기존 값 허용
ALLOWEDVALUES 요소를 사용하여 항목의 선택 목록을 지정한 후 ALLOWEXISTINGVALUE 요소를 사용하여 필드가 기존 값을 유지하도록 허용할 수 있습니다. ALLOWEXISTINGVALUE 요소를 지정하지 않은 경우 편집 시 사용자가 해당 필드에 대한 현재 유효 값 중 하나를 지정하도록 적용합니다. ALLOWEXISTINGVALUE 요소는 같은 블록의 요소만 수정합니다.
<ALLOWEXISTINGVALUE />
FIELD(워크플로) 요소에서 이 요소를 지정하여 필드에 정의된 규칙에 이 요소를 적용합니다. 이 응용 프로그램에는 필드의 STATE, TRANSITION, DEFAULTREASON 및 REASON 요소에서 지정하는 규칙이 포함됩니다. STATE 요소에서 이 요소를 지정하여 필드의 상태에 정의된 규칙뿐만 아니라 모든 상태 변환에 대한 필드에 정의된 규칙에 해당 요소를 적용합니다.
TRANSITION 요소에서 이 요소를 지정하여 필드에 대한 변환에 정의된 규칙뿐만 아니라 REASON 및 DEFAULTREASON 요소의 필드에 정의된 규칙에 해당 요소를 적용합니다.
맨 위로 이동
목록 열거
필드 목록은 개별 목록 항목으로 구성됩니다. 각 필드 목록에는 적어도 하나의 항목이 있어야 합니다.
참고
전역 목록은 범위가 프로젝트로 제한되지 않기 때문에 프로젝트 범위의 그룹을 포함하면 안 됩니다.
필드 목록의 항목을 지정하려면 <LISTITEM value=""> 요소를 사용합니다. 문자열, 사용자 이름 또는 그룹 이름을 지정할 수 있습니다.
<LISTITEM value="Emergency"/>
<LISTITEM value="Major"/>
<LISTITEM value="Minor"/>
<LISTITEM value="Domain\joe"/>
<LISTITEM value="[Global]\GlobalGroup" />
<LISTITEM value="[Project]\ProjectGroup" />
참고
런타임에 목록 내의 항목은 Visual Studio Team Foundation Server를 실행하는 서버의 언어를 기반으로 사전순으로 나타납니다.
맨 위로 이동
허용되는 값 집합 열거
이 예제에서는 Customer Severity 필드에 Emergency, Major, Minor라는 세 값 중 하나를 사용할 수 있습니다. 이 필드는 기본값이 Minor인 필수 필드로 정의되어 있습니다. 런타임에 사용자는 드롭다운 목록에서 이러한 값 중 하나를 지정할 수 있습니다.
<FIELD refname="System.Title" name="Title" type="String">
<HELPTEXT>Provide a brief description of the work item</HELPTEXT>
<REQUIRED/>
</FIELD>
<FIELD refname="MyCorp.CusSeverity" name="Customer Severity" type="String">
<HELPTEXT>Indicate the severity of the problem</HELPTEXT>
<ALLOWEDVALUES>
<LISTITEM value="Emergency">
<LISTITEM value="Major">
<LISTITEM value="Minor">
</ALLOWEDVALUES>
<DEFAULT from="value" value="Minor"/>
</FIELD>
맨 위로 이동
종속 선택 목록 정의
부모 조건부 절이 true인 경우에만 활성화되는 선택 목록을 정의할 수 있습니다. 다음 예제에서는 My Field에 대해 두 개의 선택 목록 집합을 정의합니다. 런타임에 MyCompany.MyTeam.Discipline 필드에 Requirements가 할당되었는지 여부에 따라 목록이 하나만 표시됩니다.
참고
이 예제에서 사용하는 WHEN 및 WHENNOT 규칙을 다른 규칙에 적용하여 해당 규칙을 실행할 시기를 지정할 수도 있습니다. 자세한 내용은 조건부 기준 값 및 규칙 할당을 참조하십시오.
<FIELD name="My Field" refname="MyCompany.MyProcess.MyField" type="String" reportable="dimension">
<WHEN field="MyCompany.MyTeam.Discipline" value="Requirements">
<ALLOWEDVALUES>
<LISTITEM value="Planning" />
<LISTITEM value="Review" />
</ALLOWEDVALUES>
</WHEN>
<WHENNOT field=" MyCompany.MyTeam.Discipline" value="Requirements">
<ALLOWEDVALUES>
<LISTITEM value="Process Management" />
<LISTITEM value="Planning" />
<LISTITEM value="Review" />
</ALLOWEDVALUES>
</WHENNOT>
</FIELD>
맨 위로 이동
참고 항목
개념
기타 리소스
변경 기록
날짜 |
변경 내용 |
이유 |
|---|---|---|
|
2011년 1월 |
구문 구조와 더 많은 예제가 추가되었습니다. |
향상된 기능 관련 정보 |